FLYER Teacher · PRD · Sprint 110
⚙️ Thiết lập trường học
Bộ công cụ quản trị cho Owner/Admin: tài khoản thành viên, ma trận phân quyền, thương hiệu riêng (logo/màu/tên miền), cổng đa chi nhánh, thông báo và toàn bộ hệ thống onboarding.
📈 Số liệu production (15/08/2026)42.256 trường/chi nhánh23.044 giáo viên703 tên miền white-label đã duyệt
🔗 Link mẫu trên productThiết lập trường ↗Demo ↗tài khoản demo GV: 984855668 (CB Cái Bè) · bản demo tĩnh không cần đăng nhập
1Bối cảnh & mục tiêu
Bộ công cụ quản trị cho Owner/Admin: tài khoản thành viên, ma trận phân quyền, thương hiệu riêng (logo/màu/tên miền), cổng đa chi nhánh, thông báo và toàn bộ hệ thống onboarding.
- Owner tự vận hành trường không cần FLYER can thiệp
- White-label cho trung tâm lớn
- Chuỗi nhiều chi nhánh quản trên 1 cổng
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Owner | Mời GV, duyệt yêu cầu tham gia, phân quyền vai trò. | P0 |
| Chủ chuỗi | Chuyển chi nhánh, so KPI các trường một cổng. | P0 |
| Trung tâm | Thương hiệu riêng: logo, màu, tên miền. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Thành viên + phân quyền + settings + cổng đa trường | Done |
| Phase 2 | Quyền admin đổi tên & mật khẩu (104); onboarding v4 (107) | Done |
| Phase 3 | Landing page riêng cho trung tâm vd helen.flyer.us (backlog 107) | Đề xuất |
4Luồng sản phẩm
- Owner tạo trường → mời GV → phân quyền → tuỳ biến thương hiệu → thêm chi nhánh → vận hành qua cổng
5Spec UI — cho Designer
- Quản lý tài khoản: bảng thành viên + trạng thái Chờ xác nhận, modal mời nhiều người (phẩy cách)
- Phân quyền: ma trận vai trò × chức năng với toggle từng ô, lưu tức thì
- Settings 3 tab: Tài khoản (OTP) / Giao diện (logo + màu + ngôn ngữ) / Tên miền
- Cổng đa trường: KPI tổng + bảng trường/GV/HS + chart hiệu năng
- Toàn bộ theo design system FLYER Teacher: antd 6 + Tailwind, màu chủ đạo tím
#955DCB(primary), chữ#212B36, phụ#637381, viền#EEF0F2, bo góc 8–16px, font Public Sans. - Song ngữ VI/EN qua next-translate; mọi trạng thái lọc/tab persist trên URL để share được link.
6Business rules
| Rule | Định nghĩa |
|---|---|
| Vai trò | Owner ⊃ Admin ⊃ Teacher; landing sau login: Admin → /report |
| Duyệt tham gia | Thành viên mới phải được duyệt |
| Gate khu vực | Toàn bộ khu: Admin/Owner + ẩn ở Lite |
| Tên miền | Hiện theo điều kiện gói (canShowDomainSetting) |
7Data & API — cho Developer
- GraphQL v2 school/roles/permissions + forceSyncUser sau đổi quyền; remote config bật billing; driver.js tours
- Route: /school-setup, /teacher/list, /permission-management, /settings, /school-portal(+/system-performance), /notification-list, /onboarding, /quick-start
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Tự tắt quyền của chính mình | Đồng bộ lại quyền ngay (forceSync) tránh kẹt UI |
| Trường >1 chưa chọn | Auto-redirect về school-portal |
| Đổi màu chủ đạo | Áp dụng biến CSS toàn giao diện tức thì |
| Trạng thái rỗng | Mọi bảng/danh sách có Empty state riêng kèm CTA hành động kế tiếp |
| Đang tải | Skeleton/Spin cho khối dữ liệu; nút hành động disable khi thiếu điều kiện |
9Acceptance criteria
- Yêu cầu tham gia phải duyệt mới vào
- Tắt quyền ẩn đúng chức năng tương ứng
- Đổi logo/màu áp dụng toàn giao diện
- Chuyển trường refresh đúng dữ liệu + vai trò
10Ngoài phạm vi / tương lai
- Landing page riêng từng trung tâm (helen.flyer.us — backlog 107)
- Teado gom về teacher.teado.ai switch lite/full (định hướng 107)
← Danh mục 20 tính năng · Nguồn: quét trực tiếp codebase branch dev + backlog sprint 104–108 · 14/08/2026.