Frontend Venues

Related documentation: Venue Module Backend · Venue Module Backend API · Data ownership

Runtime status

Frontend-Kisum-Venues is implemented.

The repo TODO marks Phases 1–10 as shipped.

Purpose

This is the venue-operator CRM at venues.kisum.io.

It is not a public venue browser and not an admin control-plane app.

Implemented now

Shell and gating

• Next.js 16 + React 19 App Router app
• shared Auth bootstrap
• venue module gating
• app-shell no-venue gate with provisioning flow under Settings -> Venue
• centralized space-scope handling

Core operator surfaces

• venue settings editor
• spaces CRUD
• calendar + availability blocks CRUD
• bookings list, detail, create, status transitions
• customer overlays and consolidated customer profile
• deals list/detail/create/edit
• contracts list/detail/create/edit/generate/send/resend/status refresh
• deposits create/edit
• booking finance-status card
• events list/detail/create/edit/link-promoter
• operations checklist list/detail/create/edit
• operations templates list/detail/create/edit
• reports overview + utilization/revenue/profitability/customers

Current route model

Representative live route families:

• /dashboard
• /calendar
• /bookings
• /bookings/[id]
• /events
• /events/[id]
• /customers
• /customers/[id]
• /deals
• /deals/[id]
• /contracts
• /contracts/[id]
• /deposits
• /operations
• /operations/[id]
• /operations/templates
• /operations/templates/[id]
• /reports
• /reports/utilization
• /reports/revenue
• /reports/profitability
• /reports/customers
• /settings/venue
• /settings/spaces

Not implemented yet

These should stay marked as pending:

• PATCH /api/v1/customers/:id/overlays/:overlayId backed in-place overlay editing
• real Adobe Sign upstream instead of adapter-backed send/resend flow
• deeper Finance obligation/settlement ownership beyond the current Venue-side visibility and deposit sync contract

Ownership rules

• venue create/delete stays in Admin, not here
• Finance truth stays in Finance
• canonical shared-party master data stays outside this frontend
• canonical promoter event truth stays in the Promoter module; Venue links or creates placeholders

Documentation note

Older docs that say contracts, deposits, operations, reports, or events are still future-only are stale.