Skip to content

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.

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
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
  1. Register the page in PAGE_ACCESS. A 403 on a page you just added is almost always this. See Roles and access.
  2. Audit-log every create, update and delete with logAudit(ctx, {...}). It is a compliance requirement and bun run check:audit-coverage enforces it in CI.

The admin-crud skill scaffolds the router, page and data table in the house style. The manual version is in Your first task.