kevin-asprec
b435847a39
feat(phase-2): school registry + license management UI
...
Plan 2-01: School create/edit modal + license editor
- SchoolsPage: full create/edit modal (name, city, address, tier, contact,
billing email, SMS sender name, student limit, status, notes); debounced
search + status filter; Edit button per row opens pre-filled modal
- SchoolDetailPage: Activate / Suspend / Edit quick-action buttons in header;
license panel with key copy, expiry, last seen (time-ago); license editor
(expiry date, max students, tier) calls PUT /api/licenses/{id}; Revoke
button calls POST /api/licenses/{id}/revoke
- Backend: GET /api/licenses/school/{school_id} — fetch license by school
- api.ts: getSchoolLicense added
Plan 2-02: Subscription setup + SMS credit top-up + ledger
- SchoolDetailPage: subscription panel (monthly fee, SMS cost per msg,
billing cycle, next billing date) upserts via billing API
- SMS Credits panel: color-coded credit meter (green/amber/red based on
balance), preset +100/+500/+1000 buttons, custom amount + note field,
recent 5 ledger entries, link to full SMS page
- All operations toast on success/error
PAUL: Phase 2 marked complete, STATE + ROADMAP updated
2026-03-16 08:09:59 +08:00
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
