Frontend Artist

Related documentation: Artist Module Backend · Artist Product Vision · Artist Endpoint Map · Artist Source of Truth Registry

Runtime status

Frontend-Kisum-Artists is implemented.

The repo README is stale in places; the accurate current status comes from the repo TODO/changelog plus the live route tree.

Purpose

This is the artist / agency operational app.

It is the artist-side consumer of Backend-Kisum-Artists and should be read as:

• agency / management workflow UI
• not the promoter marketplace UI
• not a mock or planning-only repo

Implemented now

Shell and auth

• Next.js 16 + React 19 + Tailwind v4
• shared Kisum SSO cookie model
• Authorization: Bearer + x-org calling model
• sidebar app shell with company switching
• hard no-agency gate

Agency provisioning

• Settings -> Agency is live
• bridged mode: current agency summary + link into company detail
• not-bridged mode: claim sleeping agency, create new agency request, review own requests
• operational routes stay locked until the app can confirm the active Auth company is bridged to an artists-company

Directory and representation

• artists list + detail + edit
• companies list + detail
• people list + detail
• roster surface
• company claims
• artist representation claims / approve / reject / disputes

Workflow surfaces

• availability CRUD
• booking requests inbox + detail
• offers list + detail + holds
• bookings list + detail
• contract templates
• booking-linked contracts
• tours + routing/conflicts
• booking itinerary
• logistics submissions review
• relationships directory + detail + org-private notes/flags/ratings
• agency dashboard, activity, tasks
• booking finance visibility + handoff dialog

Current route model

Representative live route families include:

• /
• /activity
• /tasks
• /artists
• /artists/[id]
• /artists/[id]/edit
• /companies
• /companies/[id]
• /companies/[id]/contract-templates
• /people
• /people/[id]
• /availability
• /booking-requests
• /booking-offers
• /bookings
• /bookings/[id]
• /contracts
• /contracts/[id]
• /touring
• /tour-plans/[id]
• /logistics
• /logistics-submissions/[id]
• /relationships
• /relationships/[id]
• /finance-visibility
• /settings/agency

Backend-blocked or still pending

These items should be marked as not implemented yet, not described as shipped:

• delete itinerary item endpoint
• cross-booking logistics inbox endpoint
• edit/delete relationship notes, flags, ratings
• finance-handoff audit list
• people affiliations endpoints
• create/archive flows for some directory entities
• reference-data admin surfaces

Rules

• promoter UX stays out of this app
• private relationship inputs stay org-private
• Finance remains the upstream source of truth
• browser never sends internal API keys

Documentation note

Any doc that still describes this repo as a scaffold/chassis-only app is outdated.