Business owner

A business owner is a paying tenant of the Nexus platform. They were provisioned by an Innerlight admin and received a WorkOS invite. They manage their business from portal-business.

Authentication

App: portal-business (Vite SPA) — served by portal-business-web at admin.stage.innerlight.dev
Provider: WorkOS AuthKit; organization-scoped JWT
Role: owner within their WorkOS org
Token flow: AuthKit → WorkOS JWT → Fastify BFF validates → proxies to scheduler-api admin surface

Onboarding journey

flowchart LR
    Invite[Receive WorkOS invite] --> SignIn[Sign in via AuthKit]
    SignIn --> Wizard[Onboarding wizard]
    Wizard --> BillingCheck{Billing type?}
    BillingCheck -->|subscription| AddCard[Add payment method\nStripe Connect]
    BillingCheck -->|invoice / free| Skip[Skip payment step]
    AddCard --> Complete[Wizard complete]
    Skip --> Complete
    Complete --> Dashboard[Business dashboard]

See Business onboarding flow for the full sequence diagram.

Day-to-day capabilities

Scheduling

Feature	Description
Calendar view	Full calendar (FullCalendar v6) showing all bookings
Booking management	View, reschedule, cancel, mark no-show
Availability rules	Configure services, staff, and time slots
Staff management	Invite staff members, set roles

Commerce

Feature	Description
Service catalog	Define services + pricing
Customer list	View + manage customer records
Payment setup	Stripe Connect for accepting payments
Analytics	Charts powered by Recharts (bookings, revenue)

Configuration

Feature	Description
Business profile	Name, slug, contact info
Custom domain	Register + verify a custom domain (Porkbun)
Billing	View current billing mode/status, update payment method
Notifications	Configure which notifications go to which channels

Key flows

Billing

A business carries a billingMode and billingStatus. See Billing types for what those values mean and how the state machine transitions.