Central admin UI

App: SaaS-Frontend (React 19 + Vite).

Central Application routes are prefixed with /central. Tenant auth uses root paths (/login, /register, …). See authentication/authentication-developer.md.

Navigation

Group	Screens	Route
Overview	Dashboard	/central/dashboard
Platform	Tenants, Users, Roles	/central/tenants, /central/users, /central/roles
Catalog	Marketplace, Modules	/central/marketplace, /central/modules
Billing	Dashboard, Invoices, Payments, Transactions, Refunds, Payment Methods, Payment Gateways, Coupons, Taxes, Billing Logs	/central/billing, /central/billing/*
Settings	Settings, Profile	/central/settings, /central/profile

Tenant Application uses the same AppLayout shell with its own nav (/dashboard, /leads, /tasks, /settings, /profile). Workspace Settings (/settings) covers General, Branding, and Mail with Central fallbacks — see settings/tenant-settings.md. Shared shell notes: ui/shared-layout.md.

Auth:

Screen	Route
Central login	/central/login
Central forgot / reset	/central/forgot-password, /central/reset-password/{token}
Tenant login / register	/login, /register
Tenant forgot / reset	/forgot-password, /reset-password/{token}
Tenant dashboard	/dashboard
Registration closed	/registration-closed

Removed from navigation: Plans, Limits, Tenant Subscriptions.

Not in the sidebar (reached via in-page links): /central/tenants/:id, /central/roles/matrix.

Screen ↔ API map

Screen	Primary APIs
Tenants	/tenants, archive/unarchive/restore/force
Tenant details	/tenants/{id}, /tenants/{id}/entitlements, /tenants/{id}/invoices, /tenants/{id}/payments, /tenants/{id}/modules, /tenants/{id}/impersonate
Marketplace	/marketplace/modules, /marketplace/modules/{id}, install via /tenants/{id}/modules
Module subscriptions	/module-subscriptions, cancel/deactivate
Users	/users, invite, activity, suspend, change-password
Roles	/roles, clone, permissions-matrix
Modules (admin catalog)	/modules
Dashboard	/dashboard
Settings	/system-settings
Billing dashboard	/payment-gateways, /invoices, /payments
Payment Gateways	/payment-gateways, enable/disable/default/config/mode/test-connection/logs; Product Mapping for Stripe (price_…) and Creem (prod_…)
Invoices / Payments (global)	/invoices, /payments

Marketplace (/marketplace)

• Lists published modules from GET /marketplace/modules (search, category filter)
• Detail drawer/page: GET /marketplace/modules/{id}?tenant_id= for dependency + install state
• Install to workspace: select tenant → POST /tenants/{tenant}/modules with module_id, optional billing_cycle
• Today only Leads/Tasks appear (included, non-billable); UI supports future paid modules

Tenants

Tenant details (/tenants/:id)

Tabbed layout:

Tab	Content	APIs
Overview	Contact, domain, localization, logo, timeline	GET /tenants/{id}
Modules	Installed subscriptions — status, source, price; cancel/deactivate actions	installed_modules on tenant, /module-subscriptions/...
Billing	Invoice and payment history tables	/tenants/{id}/invoices, /tenants/{id}/payments

Header actions:

• Lifecycle: edit, archive, delete, restore, force-delete
• Impersonate (impersonation.start): reason dialog → POST /tenants/{id}/impersonate; end via POST /impersonation/{id}/end

Plan subscription and usage-limit cards removed.

Modules (admin catalog)

List (/modules): name, slug, status, default-included / billable flags, pricing.

Module form

Fields: name, slug, description, icon, category, monthly/yearly price, status, is_default_included, is_billable, sort order, active.

Only Leads and Tasks exist in the seeded catalog. Modules are licensing products only — user access is managed via Spatie Roles & Permissions.

Dashboard

• Welcome hero, growth chart, quick actions (Tenants / Users / Modules / Marketplace)
• Recent tenants, recent activity
• Revenue from billable module subscriptions (MRR is 0 while only included modules exist)

Settings

Tabs: General, Localization, Mail, Branding, Security, Maintenance, Billing.

Tab	Behavior
General	Application Name (title/sidebar), Company Name (copyright/emails), searchable timezone/locale/currency, registration toggle
Localization	Predefined date formats + 12/24h time — drives formatAppDate / formatAppDateTime app-wide
Mail	Full SMTP + From identity; send test email
Branding	Button color (CSS --primary), support email, logo/favicon file uploads with preview
Security	Session timeout minutes; min password length; require special character
Maintenance	Tenant-only. Central remains operational. Optional ETA.
Billing	Invoice prefix, proration mode, default gateway, trial/Stripe flags

Public routes: /register shows the dedicated “We are not currently accepting new registrations.” page when registration is off. /maintenance renders branded tenant maintenance copy from public settings.

Bootstrap: GET /public/settings loads branding/formats on app start (Central never enters Laravel maintenance mode from this flag).

Command palette

⌘K / Ctrl+K — permission-filtered nav items.

No CRM/tenant-product UI in Central.