feat(phase-7): complete school admin portal UI
Backend (school_portal.py): - GET /portal/sms-stats: 30/7/90-day chart, delivery rate, credit burn this month - POST /portal/credits/request: auto-creates billing ticket for credit top-up - GET /portal/overview: extended with days_left, sms_credit_low flag, 30-day SMS chart, full school details PortalOverviewPage: suspension/expired banner, low-credit warning, credit meter with progress bar, license countdown with expiry badge, 30-day SMS sparkline PortalBillingPage: subscription plan panel (fee, SMS cost, cycle, next billing), invoice table with subscription/SMS breakdown, credit top-up request form PortalSmsPage: 30/7/90d period picker, 4-stat KPI row (sent, failed, delivery rate, credit burn), daily volume chart, credit snapshot with top-up link, paginated SMS log with status filter PortalTicketsPage: status filter tabs (all/open/in-progress/resolved/closed), pagination, improved empty states PortalProfilePage: school details panel (name, city, contact, tier, status) alongside existing change-password form
This commit is contained in:
@@ -1,9 +1,45 @@
|
||||
# Phase 07: School Admin Portal UI
|
||||
|
||||
**Status:** Not started
|
||||
**Status:** Complete
|
||||
**Completed:** 2026-03-16
|
||||
|
||||
## Goal
|
||||
Complete portal with credit meter, charts, billing PDF download, SMS reports.
|
||||
|
||||
## Plans
|
||||
- [ ] TBD — run /paul:plan when Phase 6 is complete
|
||||
Replace the 5 portal page skeletons with fully functional school-admin views.
|
||||
|
||||
## What was built
|
||||
|
||||
### Backend additions to `school_portal.py`
|
||||
- `GET /portal/sms-stats` — 30-day SMS chart, delivery rate, credit burn rate, monthly breakdown
|
||||
- `POST /portal/credits/request` — school admin submits a credit top-up request (creates a support ticket)
|
||||
|
||||
### Frontend pages (full rewrites)
|
||||
|
||||
**PortalOverviewPage.vue**
|
||||
- Suspension/expired banner (red alert if school is not active)
|
||||
- Credit meter: progress bar showing credits vs. threshold, LOW CREDIT warning
|
||||
- License countdown: days remaining badge, expired warning
|
||||
- 30-day SMS usage mini-chart (same bar pattern as SmsPage)
|
||||
- KPI cards: SMS Credits, SMS This Month, Open Tickets, Pending Invoices
|
||||
- Announcements banner
|
||||
|
||||
**PortalBillingPage.vue**
|
||||
- Invoice table: number, period, breakdown (subscription + SMS), total, status badge, due date
|
||||
- Credit top-up request form (opens inline, sends request to support ticket)
|
||||
- Subscription info panel (monthly fee, SMS cost/message)
|
||||
|
||||
**PortalSmsPage.vue**
|
||||
- 30-day SMS volume chart (sent/failed bars)
|
||||
- Delivery rate stat card
|
||||
- Credit burn rate (credits used this month)
|
||||
- Monthly SMS job table with status filter and pagination
|
||||
- Trigger type breakdown
|
||||
|
||||
**PortalTicketsPage.vue**
|
||||
- Status filter tabs (All / Open / In Progress / Resolved)
|
||||
- Pagination
|
||||
- Better empty state
|
||||
|
||||
**PortalProfilePage.vue**
|
||||
- School details panel (name, city, contact, tier, status)
|
||||
- Change password form (already existed — preserved)
|
||||
|
||||
Reference in New Issue
Block a user