> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theroyalglow.in/llms.txt
> Use this file to discover all available pages before exploring further.
# Pages & Routes
> Complete map of all 104 pages and API routes in the Royal Glow platform.
# Pages & Routes
The platform spans two Next.js apps: the customer site `@rgss/web` (`theroyalglow.in`) and the admin portal `@rgss/admin` (`admin.theroyalglow.in`). Together they cover \~104 pages plus the API layer.
The customer site uses Next.js App Router **route groups** (folders in parentheses) to share a layout without affecting the URL. The admin portal is a **separate app** served from `admin.theroyalglow.in` at root paths — the subdomain provides the admin namespace, so there is no `/admin` prefix. Legacy `theroyalglow.in/admin/*` paths 301-redirect to the subdomain. Staff self-service lives at `/me/*` within the admin app. Admin routes are RBAC-gated; everything else is public or customer-authenticated.
## Route Groups (`@rgss/web` — `theroyalglow.in`)
| Group | URL Pattern | Layout | Auth |
| ------------ | -------------------------------------- | ----------------------------- | -------- |
| `(customer)` | `/`, `/services`, `/bookings`, etc. | Header + footer + nav | Optional |
| `(auth)` | `/sign-in`, `/onboarding` | Minimal centered card | — |
| `(landing)` | `/book` | No nav — conversion-optimised | — |
| `(legal)` | `/privacy`, `/terms`, `/refund-policy` | Minimal | — |
The admin portal (`@rgss/admin`, `admin.theroyalglow.in`) is a standalone app: admin pages at root paths under a sidebar + RBAC layout (`receptionist+`), and staff self-service pages at `/me/*` (`staff+`).
## Page & API Map
Select an area of the platform.
### Public (No Auth Required)
| Route | Page | Rendering | Notes |
| ------------------ | -------------- | --------- | ------------------------------------------------ |
| `/` | Homepage | SSR | Hero, services overview, reviews, booking CTA |
| `/services` | Services | SSR | Salon/SPA toggle, category filter, service cards |
| `/services/[slug]` | Service Detail | SSG + ISR | Individual service with booking CTA |
| `/about` | About | SSG | Story, team gallery |
| `/contact` | Contact | SSG | Map, phone, email, contact form |
| `/faq` | FAQ | SSG | FAQPage JSON-LD, accordion |
| `/gallery` | Gallery | SSR | Photo grid from Payload CMS |
| `/offers` | Offers | SSR | Active offers and combos |
| `/blog` | Blog | SSR + ISR | Posts from Payload CMS |
| `/blog/[slug]` | Blog Post | SSG + ISR | Individual post with BlogPosting JSON-LD |
| `/offline` | Offline | Static | PWA offline fallback page |
### Authenticated (Customer)
| Route | Page | Notes |
| ---------------- | -------------- | ----------------------------------------- |
| `/bookings` | My Bookings | Upcoming + past, cancel/reschedule |
| `/bookings/[id]` | Booking Detail | Status timeline, services, invoice link |
| `/membership` | My Membership | Tier, hours remaining, session history |
| `/gems` | Gems | Balance, transaction history, catalogue |
| `/favorites` | Favourites | Saved favourite services |
| `/notifications` | Notifications | Notification list, mark read |
| `/profile` | Profile | Editable fields, notification preferences |
### Auth Pages
| Route | Page | Notes |
| ------------- | ---------- | ------------------------------------------------------------- |
| `/sign-in` | Sign In | Google OAuth button |
| `/onboarding` | Onboarding | First-time profile setup (name, phone, DOB, gender, consents) |
### Landing & Legal (SSG)
| Route | Page | Notes |
| ---------------- | ---------------------------- | ----------------------------------------------------- |
| `/book` | Lead Capture | Meta/Instagram ad landing page — 3-field form, no nav |
| `/privacy` | Privacy Policy | DPDP Act 2023 |
| `/terms` | Terms of Service | — |
| `/refund-policy` | Refund & Cancellation Policy | — |
All admin routes are served from `admin.theroyalglow.in` at **root paths** (no `/admin` prefix) and require authentication with minimum role `receptionist`. The paths below are relative to `admin.theroyalglow.in`.
| Route | Min. Role | Page |
| ------------------- | ------------ | ------------------------------------------------------------------------------------------------------------- |
| `/` | Receptionist | Dashboard — today's bookings, revenue, pending actions |
| `/bookings` | Receptionist | Booking list with filters |
| `/bookings/[id]` | Receptionist | Booking detail — approve/reject/assign/complete |
| `/bookings/new` | Receptionist | Walk-in booking creation |
| `/customers` | Receptionist | Customer list — search, filter, sort by LTV |
| `/customers/[id]` | Receptionist | Customer profile — history, notes, tags |
| `/leads` | Receptionist | Lead pipeline — kanban view |
| `/leads/[id]` | Receptionist | Lead detail — notes, UTM, WhatsApp link |
| `/memberships` | Receptionist | Membership list |
| `/memberships/[id]` | Receptionist | Membership detail — session recording |
| `/memberships/new` | Receptionist | Create new membership |
| `/billing` | Receptionist | Invoice list and detail |
| `/billing/[id]` | Receptionist | Invoice detail |
| `/leave` | Receptionist | Leave request queue — approve/reject |
| `/waitlist` | Receptionist | Waitlist management |
| `/services` | Manager | Redirect to the Payload CMS `service` collection — the catalogue is authored in the CMS, not the admin portal |
| `/offers` | Manager | Offer creation and management |
| `/staff` | Manager | Staff list and profiles |
| `/schedule` | Manager | Weekly staff availability grid |
| `/reports` | Manager | Revenue, bookings, staff performance |
| `/settings` | Manager | System settings |
| `/branches` | Owner | Branch management |
| `/users` | Owner | User management and role assignment |
| `/integrations` | Developer | Integration configuration |
| `/logs` | Developer | Audit logs |
Staff self-service pages live at `/me/*` within the admin app (`admin.theroyalglow.in`).
| Route | Min. Role | Page |
| -------------- | --------- | ---------------------------------- |
| `/me/schedule` | Staff | Own weekly schedule |
| `/me/leave` | Staff | Submit and view own leave requests |
Customer API routes (below) are served from `theroyalglow.in/api/*` by `@rgss/web`. Admin API routes are served from `admin.theroyalglow.in/api/*` by `@rgss/admin` — there is **no `/api/admin/` segment**.
### Public (No Auth) — `theroyalglow.in`
| Endpoint | Method | Description |
| ---------------------- | ------ | ------------------------------------------------ |
| `/api/services` | GET | All categories + services (KV cached, 5-min TTL) |
| `/api/services/[slug]` | GET | Single service detail |
| `/api/availability` | GET | Available slots for date + service |
| `/api/leads` | POST | Campaign lead capture from `/book` form |
| `/api/health` | GET | System health check |
### Authenticated (Customer) — `theroyalglow.in`
| Endpoint | Method | Description |
| ------------------------------- | ---------- | --------------------------------------- |
| `/api/bookings` | GET, POST | List bookings / create booking |
| `/api/bookings/[id]` | GET | Booking detail |
| `/api/bookings/[id]/cancel` | POST | Cancel booking |
| `/api/bookings/[id]/reschedule` | POST | Reschedule booking |
| `/api/membership` | GET | Customer's active membership |
| `/api/gems` | GET | Gems balance + catalogue |
| `/api/gems/redeem` | POST | Redeem gems against a catalogue service |
| `/api/offers` | GET | Active offers for the customer |
| `/api/contact` | POST | Contact form submission |
| `/api/notifications` | GET, PATCH | Notifications list + mark read |
| `/api/profile/preferences` | PATCH | Update notification preferences |
| `/api/push/subscribe` | POST | Register push subscription |
| `/api/push/subscribe` | DELETE | Remove push subscription |
| `/api/ably/token` | POST | Scoped Ably JWT (Token Auth) |
| `/api/onboarding/complete` | POST | Save onboarding data |
| `/api/revalidate` | POST | On-demand ISR revalidation |
### Admin (Role-Gated) — `admin.theroyalglow.in`
Served from `admin.theroyalglow.in/api/*`. There is no `/api/admin/` segment — the subdomain is the namespace. Paths below are relative to `admin.theroyalglow.in`.
| Endpoint | Method | Min. Role | Description |
| ---------------------------------- | ------------- | ------------ | -------------------------------- |
| `/api/bookings` | GET, POST | Receptionist | List / create booking |
| `/api/bookings/new` | POST | Receptionist | Walk-in booking creation |
| `/api/bookings/[id]` | PATCH | Receptionist | Approve, reject, assign staff |
| `/api/bookings/[id]/complete` | POST | Receptionist | Mark completed + invoice + gems |
| `/api/bookings/[id]/noshow` | POST | Receptionist | Mark no-show |
| `/api/customers` | GET | Receptionist | Customer list with search/filter |
| `/api/customers/[id]` | GET | Receptionist | Customer detail |
| `/api/customers/[id]/notes` | POST | Receptionist | Add CRM note |
| `/api/customers/[id]/tags` | POST | Receptionist | Add tag |
| `/api/customers/[id]/tags/[tagId]` | DELETE | Receptionist | Remove tag |
| `/api/leads` | GET, POST | Receptionist | Lead list / create manual lead |
| `/api/leads/[id]` | PATCH | Receptionist | Update lead status |
| `/api/leads/[id]/notes` | POST | Receptionist | Add lead note |
| `/api/billing` | GET | Receptionist | Invoice list |
| `/api/billing/[id]` | GET | Receptionist | Invoice detail |
| `/api/memberships` | GET, POST | Receptionist | List / create membership |
| `/api/memberships/[id]` | GET | Receptionist | Membership detail |
| `/api/memberships/[id]/sessions` | POST | Receptionist | Record session |
| `/api/memberships/[id]/cancel` | POST | Manager | Cancel membership |
| `/api/membership-tiers` | GET | Receptionist | SPA membership tiers |
| `/api/leave` | GET, POST | Receptionist | Leave queue / submit leave |
| `/api/leave/[id]` | PATCH | Receptionist | Approve / reject leave |
| `/api/me/leave` | GET, POST | Staff | Own leave list / submit |
| `/api/me/leave/[id]` | PATCH | Staff | Update own leave |
| `/api/me/schedule` | GET | Staff | Own schedule |
| `/api/schedule` | GET | Receptionist | Staff schedule for date |
| `/api/waitlist` | GET, POST | Receptionist | Waitlist list / add |
| `/api/waitlist/[id]` | PATCH, DELETE | Receptionist | Update / remove waitlist entry |
| `/api/tags` | GET | Receptionist | Available CRM tags |
| `/api/notifications` | GET, PATCH | Receptionist | Notifications list + mark read |
| `/api/offers` | GET, POST | Manager | List / create offer |
| `/api/offers/[id]` | PATCH, DELETE | Manager | Update / delete offer |
| `/api/services` | GET, POST | Manager | Service list / create |
| `/api/services/all` | GET | Manager | All services (incl. inactive) |
| `/api/services/[id]` | PATCH, DELETE | Manager | Update / delete service |
| `/api/service-categories` | GET, POST | Manager | Category list / create |
| `/api/service-categories/[id]` | PATCH, DELETE | Manager | Update / delete category |
| `/api/staff` | GET, POST | Manager | Staff list / create |
| `/api/staff/all` | GET | Manager | All staff |
| `/api/staff/[id]` | GET, PATCH | Manager | Staff detail / update |
| `/api/staff/[id]/services` | GET, PATCH | Manager | Staff service assignments |
| `/api/reports` | GET | Manager | Reports data |
| `/api/branches` | GET | Manager | Branch list |
| `/api/branches/[id]` | PATCH | Owner | Update branch |
| `/api/settings` | GET, PATCH | Manager | System settings |
| `/api/users` | GET | Owner | User list / role management |
| `/api/integrations` | GET | Developer | Integration configuration |
| `/api/logs` | GET | Developer | Audit logs |
| `/api/health` | GET | — | Admin health check |
| `/api/ably/token` | POST | Receptionist | Scoped Ably JWT (Token Auth) |
QStash signature required. Hosted in `@rgss/admin` and served from `admin.theroyalglow.in/api/jobs/*`. **19 jobs total: 14 QStash scheduled + 4 QStash triggered + 1 GitHub Actions cron.**
#### Scheduled (14 — QStash)
| Endpoint | Description |
| ----------------------------------- | ------------------------------- |
| `/api/jobs/appointment-reminders` | 24h + 1h push + email reminders |
| `/api/jobs/membership-expiry` | 30d/7d/1d expiry alerts |
| `/api/jobs/birthday-emails` | Birthday offer emails |
| `/api/jobs/membership-usage-nudges` | Usage nudge emails |
| `/api/jobs/lead-followups` | Stale lead alerts |
| `/api/jobs/daily-sales-report` | Daily report |
| `/api/jobs/weekly-report` | Weekly summary |
| `/api/jobs/gems-expiry-reminder` | 7-day gems expiry push |
| `/api/jobs/nightly-sales-summary` | Nightly sales rollup |
| `/api/jobs/membership-auto-expire` | Hard-expire lapsed memberships |
| `/api/jobs/offer-auto-expire` | Expire ended offers |
| `/api/jobs/gems-auto-expire` | Expire gems past 365 days |
| `/api/jobs/session-cleanup` | Purge stale auth sessions |
| `/api/jobs/monthly-gst-summary` | Monthly GST summary |
#### Triggered (4 — QStash, event-driven with delay)
| Endpoint | Trigger | Description |
| ------------------------------------- | --------------------- | --------------------------- |
| `/api/jobs/post-service-followup` | +24h after completion | Review request |
| `/api/jobs/stale-booking-alert` | +2h after pending | Stale pending booking alert |
| `/api/jobs/noshow-check` | +15min after end time | No-show check |
| `/api/jobs/membership-expired-notice` | +1h after expiry | Expired notice |
#### GitHub Actions cron (1)
`pprd` DB sync — resets the `pprd` Neon branch from `prod` and strips PII. Runs in GitHub Actions, not as an HTTP route.
An internal `/api/jobs/invoice-pdf` route also exists: it hands invoice rendering to the `@rgss/invoicing` Cloud Run PDF service. It is a support route, not one of the 19 scheduled/triggered business jobs.
| Route | Description |
| -------------------- | ---------------------------------------------------------- |
| `/api/auth/[...all]` | Better Auth catch-all (login, callback, session, sign-out) |
| `/llms.txt` | AI agent discovery file |
| `/llms-full.txt` | Detailed AI agent file with full service list |
| `/sitemap.xml` | Auto-generated by Next.js |
| `/robots.txt` | Auto-generated by Next.js |
| `/manifest.json` | PWA manifest |
| `/sw.js` | Service worker (PWA offline support) |
## Related Pages
Component architecture and design system behind these pages
Full request/response contracts per endpoint
Schedules and behaviour of all 19 jobs
## Related topics
- [Frontend](/content/docs/frontend.md)
- [Authentication & Roles](/content/docs/authentication.md)
- [Background Jobs](/content/docs/background-jobs.md)
- [Error Handling](/content/docs/error-handling.md)
- [High-Level Design](/content/docs/system-design/high-level-design.md)