🛠️ AceSense Admin Panel
Platform Management Dashboard
:::info Repository Info
| Repo | Commit | Last Updated |
|---|---|---|
| acesense-admin | f503e2d | 2026-05-28 |
| ::: |
The AceSense Admin Panel is the central dashboard for managing the AceSense platform — monitoring video processing jobs, analyzing system health, governing user access, and browsing Firebase Storage. Built with React 19 and Vite for speed and visual clarity.
Live URL: https://admin.acesense.io
Quick Links
- Setup Guide - Local development setup
- Features - Feature documentation
- Deployment - Firebase Hosting deployment
🏗️ Architecture
🛠️ Technology Stack
| Technology | Version | Purpose |
|---|---|---|
| React | 19 | UI framework |
| TypeScript | Latest | Type safety |
| Vite | 7 | Build tool |
| React Router | v7 | Client-side routing |
| Recharts | Latest | Dashboard charts & analytics |
| Firebase | Latest | Auth, Firestore, Storage, Hosting |
| ESLint | Flat config | Code linting |
| CSS | Custom dark theme | Styling |
🔐 Authentication
The admin panel uses Google Sign-In with Firebase Auth. Only whitelisted admin emails have access:
| Role | |
|---|---|
admin@acesense.io | Admin |
akshay@akshaysarode.com | Admin |
akshay.sarode@anilata.com | Admin |
akshay.sarode18@gmail.com | Admin |
Allowlist enforcement is documented in compliance/admin-allowlist. Source of truth is acesense-frontend/firestore.rules isAdmin(); the same canonical 4-email list is mirrored in acesense-auth-function/shared/admin-auth.ts, acesense-launchpad/src/config/firebase.ts, and the admin Settings display constant. Preferred mechanism is the admin: true Firebase custom claim — set via the Settings → Admin Claims button.
📄 Pages
| Route | Page | Description |
|---|---|---|
/ | Dashboard | Top-level metrics, weekly job charts, status distribution, recent activity |
/users | Users | User management — drawer with plan dropdown, suspend toggle, password reset, data export, embedded API keys, bulk CSV |
/jobs | Jobs | Live job control via onSnapshot — drawer with raw JSON, signed-URL downloads, RunPod link, fetched result viewer, retry/manual-status/delete, bulk retry/delete/CSV |
/operations | Operations | Health checks (Cloud Functions / REST API / MCP), per-user quota table, recent quota_exceeded rejections |
/analytics | Analytics | Processing insights (success rate, avg times), jobs over time, peak hours, data distribution |
/storage | Storage | Firebase Storage browser — folder navigation, file preview, download, delete |
/audit-log | Audit Log | Tabbed view of signed_url_audit, moderation_audit, admin_audit with revoke + JSON-detail modals |
/developer | Developer | Per-user API key management (create / list / top-up / revoke) for the signed-in admin |
/admin-api-keys | API Keys (Admin) | Cross-user view of every API key — adjust balance, revoke, aggregate stats |
/research-decisions | Research Decisions | Internal compliance-driven decisions log |
/settings | Settings | Firebase/RunPod config readouts, admin whitelist, quick links |
See Features for the full per-page capability list.
📂 Project Structure
acesense-admin/
├── src/
│ ├── components/ # Reusable UI components (charts, tables, modals)
│ ├── config/ # Firebase configuration
│ ├── hooks/ # Custom React hooks (data fetching, state)
│ ├── pages/ # Page components (Dashboard, Users, Jobs, etc.)
│ └── App.tsx # Main application with routing
├── public/ # Static assets
├── dist/ # Production build output
├── firebase.json # Firebase Hosting config
├── package.json
└── tsconfig.json
📚 Related
- Setup Guide - Development environment setup
- Features - Detailed feature documentation
- Deployment - Firebase Hosting deployment
- Configuration Reference - Environment variables
- Firebase Functions - Backend functions