Admin Guide
Version: 2.0.0 | Last Updated: January 2026 | Audience: Admin Users
Table of Contents
1. Getting Started
Accessing the Admin Panel
User Roles
| Role | Access Level | Key Permissions |
|---|---|---|
| SUPER_ADMIN | Full Access | User management, system health, audit export |
| ADMIN | Management | Orders, tickets, products, analytics, settings |
| STAFF | Operational | View orders, scan tickets, view customers |
2. Dashboard
The dashboard provides a real-time overview of key business metrics.
Dashboard Metrics
| Metric | Description | Update Frequency |
|---|---|---|
| Total Revenue | Sum of all completed orders | Real-time |
| Today's Orders | Orders placed today with comparison | Real-time |
| Active Tickets | Valid unused tickets in system | Every 15 min |
| Pending Payments | Orders awaiting payment confirmation | Real-time |
| New Customers | Customers registered this month | Daily |
| Low Stock Alerts | Products below threshold | Hourly |
Quick Actions
- Scan Tickets: One-click access to scanner
- New Order: Create manual admin orders
- Send Campaign: quick campaign launch
- View Reports: Download daily/weekly reports
Charts & Visualizations
- Revenue Chart: Line graph showing daily/weekly/monthly revenue trends
- Ticket Sales: Bar chart comparing ticket types
- Session Distribution: Pie chart showing Tuesday vs Friday bookings
- Recent Activity: Timeline of latest orders and scans
3. Orders Management
| Status | Color | Description |
|---|---|---|
| PENDING | Yellow | Awaiting payment |
| PROCESSING | Blue | Payment received, preparing |
| SHIPPED | Purple | Products shipped |
| COMPLETED | Green | Order fulfilled |
| CANCELLED | Gray | Order cancelled |
Tip: Manual Payment Confirmation
When confirming manual payments, the customer will automatically receive an email with their tickets.
Warning: Cancelling Orders
Cancelling an order will automatically INVALIDATE all associated tickets. This action cannot be easily undone.
4. Ticket Management
Use the built-in scanner to validate tickets at the door.
Scanner Features
- QR Code Scanning: Camera-based or manual entry
- Real-time Validation: Instant status check against database
- Session Day Enforcement: Only allows scans on valid days (Tue/Fri)
- Scan History: View all scans with timestamps
Scan Results
| Result | Meaning | Action |
|---|---|---|
| VALID | Ticket is active and valid | Allow entry |
| EXPIRED | Past validity date | Deny entry, offer purchase |
| WRONG DAY | Valid but not session day | Return on Tue/Fri |
5. Customer Management
View and manage all registered customers.
Customer Actions
- View Profile: Full customer details, order history, total spent
- Order History: All orders with status and amounts
- Verification Status: Document upload verification for certain features
- Export: Download customer data as CSV
6. Product Management
Manage shop products, categories, and inventory.
Product Fields
| Field | Description |
|---|---|
| Name & Description | Product title and details |
| Price & Sale Price | Regular and discounted pricing |
| Images | Multiple product images |
| Sizes | Size variants with individual pricing |
| Stock | Inventory quantity and low-stock threshold |
7. Inventory Management
Monitor stock levels and receive low-stock alerts.
Key Features
- Stock Overview: All products with current quantities
- Low Stock Alerts: Highlighted items below threshold
- Adjustment: Manual stock corrections with notes
- History: Audit trail of all inventory changes
8. Task Management
Assign and track administrative tasks with calendar integration.
Task Features
- Create Task: Title, description, due date, priority
- Role Assignment: Assign to specific role (ADMIN, STAFF)
- Calendar View: FullCalendar integration for visual planning
- Status Tracking: Pending → In Progress → Completed
9. Analytics & Reports
Comprehensive business metrics and data export.
Available Metrics
- Revenue: Daily, weekly, monthly trends with targets
- Tickets: Sales, scans, expiry rates
- Customers: New registrations, retention
- Products: Best sellers, inventory turnover
Export Options
- Orders CSV
- Tickets CSV
- Customers CSV
- Scan History CSV
10. Email & Campaigns
Manage email templates and marketing campaigns.
Template Management
- Create/Edit: Rich text editor with variable support
- Preview: Test emails before sending
- Variables: Dynamic placeholders for personalization
Campaign Features
- Subscriber Lists: Newsletter subscribers and customers
- Scheduling: Send immediately or schedule
- Analytics: Open rates, click rates
11. Settings
System-wide configuration (ADMIN/SUPER_ADMIN only).
Configuration Areas
| Section | Settings |
|---|---|
| General | Business name, address, contact info |
| SMTP config, sender name, branding | |
| Tickets | Validity days, max scans, pricing |
| Payments | Gateway keys, bank details |
12. Audit Logs
View system activity logs (SUPER_ADMIN only).
Log Features
- Filter by Date: Select date range
- Filter by Action: Login, Order, Ticket, Settings
- Filter by User: Search by admin user
- Export: Download logs as CSV
13. Troubleshooting
| Issue | Resolution |
|---|---|
| Ticket Won't Scan | Check if EXPIRED, CANCELLED, or Payment PENDING. |
| Payment Stuck (Pending) | Use "Confirm Payment" button with reference from bank. |
| Email Not Delivered | Check System Health for 'Failed Jobs' in Email Queue. |