Admin portal overview
Everything under /admin in the web app. Pages live in
apps/web/src/app/[locale]/(main)/admin/; the sidebar is defined in
AdminLayoutClient.tsx, and access to each page is decided by PAGE_ACCESS in
packages/core/src/lib/rbac.ts.
Nav groups
Section titled “Nav groups”As defined in AdminLayoutClient.tsx (indented items there are children of the
item before them):
| Group | What it covers |
|---|---|
| Overview | Dashboard, Analytics |
| Events | Events (Auctions, Artwork, Bundles), Artists (Signing Config), Sponsors, Stamp Rally (Vendor Directory), Contests, Lucky Draws (Merch Sales) |
| Bookings | Signing Bookings, Entry Bookings, Paid, No Booking, Grading Bookings, Revenue (Artist Signing, Bookings), Sales Update |
| Finance | Finance dashboard, Payment Requisitions, Supplier Bills, Expense Claims, Suppliers / Payees |
| Event Day | Signing Scanners (Entry, Exit, Slip, Payment Checker, Prize Scanner), Signing Queue (Scan Monitor), Entry Tickets (Walk-In Booking, Entrance Gate, Ticket Check-In) |
| Engagement | CRM (Email Inbox, WhatsApp, AI Chatbot, Vendor Contacts), CDP, Sponsor Metrics, Vendors (Applications, Vendor Page), Collaborate, Vouchers |
| Content | News (Newsletter), Petition, Testimonials, Legal Pages |
| Mobile App | Reports, Posts, Comments, Ads, Badges, Promo Cards, Wallpapers, Hub Banners, Card Shops, Feed Algorithm, App Config, Push Notifications |
| System | Users, Settings (Email Previews), Audit Trail |
Where each feature is documented
Section titled “Where each feature is documented”| Feature | Admin pages | Docs |
|---|---|---|
| Events, bookings, revenue | /admin/events, /admin/bookings/*, /admin/revenue/* |
Events, artists and bookings |
| Lucky draws and merch sales | /admin/lucky-draws, /admin/merch-purchases |
Events, artists and bookings, Lucky draw flow |
| Push notifications (mobile) | /admin/mobile/notifications |
REST /v1, push notifications |
| Finance | /admin/finance/* |
Finance |
| Feature flags | /admin/feature-flags |
Feature flags |
| Petition | /admin/petition |
Petition flow |
| Vendor contacts, WhatsApp blasts, Sales Desk | /admin/vendor-contacts |
WhatsApp outreach and the Sales Desk |
Two rules for every admin change
Section titled “Two rules for every admin change”- Register the page in
PAGE_ACCESS. A 403 on a page you just added is almost always this. See Roles and access. - Audit-log every create, update and delete with
logAudit(ctx, {...}). It is a compliance requirement andbun run check:audit-coverageenforces it in CI.
Adding a page
Section titled “Adding a page”The admin-crud skill scaffolds the router, page and data table in the house style. The manual version is in Your first task.
