FLYER Teacher · PRD · Sprint 110
💰 Tài chính & Học phí
Khép kín dòng tiền trung tâm: thu học phí (tạo phiếu → gửi đa kênh → phụ huynh thanh toán → đối soát), hồ sơ ngân hàng nhận tiền (BankHub/SePay), ví xu trả cho dịch vụ AI/tài khoản, trang gói dịch vụ.
📈 Số liệu production (15/08/2026)16 phiếu thu đã tạo (2 đã thanh toán)10 lô hoá đơn⚠️ adoption rất thấp — cần điều tra
🔗 Link mẫu trên productQuản lý học phí ↗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
Khép kín dòng tiền trung tâm: thu học phí (tạo phiếu → gửi đa kênh → phụ huynh thanh toán → đối soát), hồ sơ ngân hàng nhận tiền (BankHub/SePay), ví xu trả cho dịch vụ AI/tài khoản, trang gói dịch vụ.
- Số hoá thu học phí đa kênh (đặc biệt Zalo)
- Tiền về thẳng tài khoản trung tâm
- Ví xu thống nhất cho mọi dịch vụ FLYER
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Chủ trường | Tạo phiếu thu cả lớp, gửi Zalo/Email, theo dõi ai chưa đóng. | P0 |
| Phụ huynh | Nhận phiếu và thanh toán online. | P0 |
| Owner | Nạp/chuyển xu giữa chi nhánh, mời GV nhận thưởng. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Học phí + hồ sơ ngân hàng + ví + gói | Done |
| Phase 2 | Sửa content + tooltips Tuition (104); autopayment cho tool (backlog 106) | Cần build |
| Phase 3 | Bổ sung chi phí cho thu học phí — cần thống nhất cách bán (backlog 108) | Đề xuất |
4Luồng sản phẩm
- Thiết lập hồ sơ ngân hàng 1 lần → tạo phiếu thu tháng → gửi Zalo/Email/app → phụ huynh trả → đối soát trạng thái
5Spec UI — cho Designer
- Học phí: StatCards doanh thu (so hôm qua) + tabs trạng thái + bảng phiếu; wizard tạo phiếu 2 cột chọn HS ↔ preview TẠM TÍNH/TỔNG
- Hồ sơ thanh toán: stepper 2 bước; kết nối BankHub embed hoặc form nhập tay; card tài khoản với "Mặc định"
- Ví sidebar: số dư + lượt chấm + nút Nạp xu; billing 3 tab Tổng quan/Gói/Lịch sử
- 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 |
|---|---|
| Kênh gửi phiếu | Email / ứng dụng / Zalo ZNS 500đ/tin |
| Tính tiền | Học phí mặc định + riêng từng học sinh, chiết khấu, VAT |
| Gate | Cả cụm: Admin + flag tuition_fees, ẩn Lite; Ví chỉ Admin/Owner; chuyển xu + mời GV chỉ Owner |
7Data & API — cho Developer
- REST v3 school-finance; BankHub SDK (proxy /api/sepay-*); thanh toán gói Polar
- Route: /tuition-management(+/create,/group/[id]), /bank-account, /sepay, /billing, /billing-parent, /package(+-ai-speaking), /transfer-diamond, /invite-teachers
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Phiếu quá hạn | Tab Quá hạn + popup nhắc phía phụ huynh |
| ZNS gửi lỗi | Trạng thái gửi hiển thị, không trừ phí tin lỗi |
| Chuyển xu giữa trường | Confirm 2 bước + lịch sử ghi nhận |
| 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
- Phiếu tính đúng chiết khấu + VAT từng học sinh
- ZNS trừ đúng 500đ/tin có trạng thái
- Phụ huynh thanh toán xong trạng thái đổi realtime
- Chuyển xu trừ/cộng đúng 2 đầu + lịch sử
10Ngoài phạm vi / tương lai
- Autopayment + bảng giá tool (backlog 106)
- Chi phí (expense) trong thu học phí (backlog 108)
- Đối soát tự động qua BankHub webhook
← 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.