How community-vercel/ustaadpro-admin works
This is a Next.js admin console for UstaadPro: administrators sign in, then manage operational data and app configuration through domain pages, with requests delegated to shared API/resource clients. Sampled pages confirm dashboard reporting, service and shop catalogs, orders, complaints, providers, bot controls, and app settings; other listed admin sections are included as documented by the route tree, but their internal wiring was not sampled.
Main entry points: api.ts Backend API client · route.ts Admin login API · OverviewClient.tsx Dashboard · page.tsx Login page
Components 22
Admin access
- Login page
src/app/login/page.tsx - Admin login API
src/app/api/admin-login/route.ts - Session signing
src/lib/adminSession.ts - Admin auth gate
src/components/RequireAdminAuth.tsx
Operations
- Dashboard
src/app/OverviewClient.tsx - Service orders
src/app/orders/page.tsx - Payment receipts
src/app/payment-receipts/page.tsx - Subscriptions
src/app/subscriptions/page.tsx - Complaints
src/app/complaints/page.tsx - User accounts
src/app/users/page.tsx - Shop orders
src/app/shop-orders/page.tsx
Catalog management
- Service catalog
src/app/services/page.tsx - Shop products
src/app/shop-products/page.tsx - Provider resources
src/app/resources/page.tsx
Platform controls
- Broadcasts
src/app/broadcast/page.tsx - WhatsApp bot
src/app/whatsapp-bot/WhatsAppBotClient.tsx - App configuration
src/app/app-control/page.tsx
Shared runtime
- Backend API client
src/lib/api.ts - Firebase resources
src/lib/firebaseResources.ts
Other components
- Administrator
- UstaadPro API
- Firebase
Connections 28
- Administrator → Login page: opens
- Login page → Admin login API: submits credentials
- Admin login API → UstaadPro API: authenticates
- Admin login API → Session signing: creates session
- Admin auth gate → Session signing: validates cookie
- Administrator → Dashboard: views metrics
- Dashboard → Backend API client: loads summary
- Dashboard → Backend API client: requests cleanup
- Administrator → Service orders: manages orders
- Service orders → Backend API client: loads order pages
- Administrator → Complaints: reviews complaints
- Complaints → Backend API client: loads complaints
- Administrator → Service catalog: edits catalog
- Service catalog → Backend API client: saves services
- Administrator → Shop products: manages inventory
- Shop products → Backend API client: loads and saves
- Administrator → Provider resources: reviews providers
- Provider resources → Firebase resources: loads resources
- Administrator → WhatsApp bot: controls bot
- WhatsApp bot → Backend API client: controls and configures
- Administrator → App configuration: configures app
- App configuration → Backend API client: loads and saves settings
- Backend API client → UstaadPro API: sends requests
- Administrator → Payment receipts: reviews receipts
- Administrator → Subscriptions: manages plans
- Administrator → User accounts: manages users
- Administrator → Shop orders: reviews shop orders
- Administrator → Broadcasts: sends broadcasts