kevin-asprec
73a17aaf9a
feat(phase-1): TapTrack Hub initial scaffold
...
Full project scaffold for TapTrack Hub — cloud SaaS control plane
for managing on-prem TapTrack school deployments.
## Infrastructure
- Docker Compose: backend (gunicorn+uvicorn), Celery worker + beat,
frontend (Vite build + nginx), PostgreSQL 15, Redis 7, nginx proxy
- Dockerfile for backend and frontend, nginx reverse proxy config
## Backend (FastAPI + SQLAlchemy async + Celery)
Database schema (10 tables):
hub_users, schools, licenses, sms_jobs, sms_credit_ledger,
invoices, invoice_line_items, school_subscriptions,
support_tickets, ticket_replies, audit_logs, announcements
Auth: JWT (python-jose) + bcrypt + role-based FastAPI dependencies
(get_current_user, require_super_admin, require_school_admin)
Routers (11): auth, schools, licenses, sms, billing, tickets,
users, dashboard, school_portal, announcements, sync
Celery tasks (6):
sms.process_queue, billing.generate_monthly_invoices,
billing.send_invoice_email, billing.check_overdue,
license.check_expiry, reports.send_monthly_reports
Services: SMTP email helper (smtplib + Jinja2)
Seed script: creates super admin admin@taptrack.io
## Frontend (Vue 3 + Vite + Pinia + Tailwind CSS)
Router: 14 routes across super admin + school portal layouts
Stores: Pinia auth store with localStorage persistence
API client: full axios client for all backend endpoints
Layouts: AppLayout (super admin), PortalLayout (school), AuthLayout
Components: AppSidebar, PortalSidebar, SidebarItem, KpiCard,
StatusBadge, ToastStack
Pages: Login, Dashboard, Schools, SchoolDetail, Licenses, SMS,
Billing, Tickets, TicketDetail, Users, Announcements, 404
Portal pages: Overview, Billing, SMS Reports, Tickets, Profile
## PAUL Planning Files
- .paul/ROADMAP.md: full 15-phase roadmap with detailed scope
- .paul/STATE.md: current position, tech stack, architecture notes
- .paul/phases/01-setup/01-PLAN.md: complete Phase 1 plan (done)
- .paul/phases/02 through 15: README stubs for all future phases
2026-03-16 07:26:06 +08:00
