PRD 00 · Tổng quan và kiến trúc

Thiết kế đề xuất

Bộ khung này là lớp vỏ mà mọi PRD còn lại đặt vào: một thanh trên cùng với bộ chuyển chi nhánh, một sidebar chung cho toàn bộ mô-đun, và trang Tổng quan thay đổi theo vai trò đăng nhập; phụ huynh và giáo viên có giao diện di động riêng thay vì dùng lại sidebar.

1 · Lớp vỏ ứng dụng · Tổng quan của chủ trung tâm

/dashboard · desktop

2 · Bộ chuyển chi nhánh và phạm vi dữ liệu

/dashboard · desktop

3 · Trang chủ theo vai trò · Quản lý chi nhánh

/dashboard · desktop

4 · Trang chủ theo vai trò · Kế toán

/dashboard · desktop

5 · Cổng phụ huynh

/parent · mobile

6 · Giáo viên hôm nay

/teach · mobile

1Tầm nhìn sản phẩm

Trường Số (truongso.net) là hệ điều hành của FLYER cho các trung tâm tiếng Anh và trường tư nhỏ tại Việt Nam. Sản phẩm bắt đầu từ CRM tuyển sinh đang hoạt động tại b2c.truongso.net và phát triển thành công cụ sử dụng hằng ngày cho toàn trung tâm: nhân viên lễ tân làm thủ tục nhập học cho một học viên, giáo vụ xây dựng thời khoá biểu, giáo viên điểm danh trên điện thoại, kế toán thu học phí và đôn đốc công nợ, và chủ trung tâm xem một tổng quan duy nhất trên tất cả chi nhánh.

Đường tham chiếu cạnh tranh là nhóm phần mềm quản lý trung tâm tại Việt Nam (PSE ONE và các đối thủ tương tự) quảng cáo bảy mô-đun: tuyển sinh, học viên, đào tạo, báo cáo, kho, tài chính và sổ liên lạc phụ huynh, bán theo bậc số lượng học viên với giá khoảng 199.000 đến 1.000.000 VND mỗi tháng. Trường Số bao phủ cùng phạm vi vận hành đó, nhưng có ba điểm khác biệt mà các đơn vị dẫn đầu thị trường chưa có:

1. Dữ liệu học tập nằm ngay trong hồ sơ vận hành. Mọi học viên đều có một Tài khoản FLYER. Điểm kiểm tra xếp lớp, bài tập được giao, tỷ lệ hoàn thành và kết quả chấm nói, viết bằng AI đã có sẵn trên nền tảng FLYER và hiển thị ngay trong hồ sơ học viên mà không cần thêm công việc tích hợp.
2. Tiền được luân chuyển qua chuyển khoản đã xác minh. Liên kết tài khoản ngân hàng SePay và mã QR thanh toán hiện có giúp phiếu thu tự đối soát; tiền mặt là ngoại lệ, không phải phương thức mặc định.
3. Một hệ thống thiết kế duy nhất. Cloud theme dùng trên toàn bộ sản phẩm giáo viên của FLYER cũng là ngôn ngữ giao diện ở đây, nên một trung tâm đã dùng teacher.flyer.us sẽ nhận ra mọi màn hình.

Chỉ số thành công (12 tháng sau khi P1 ra mắt)

2Đối tượng sử dụng và vai trò

3Đa chi nhánh (tenant)

Backend hiện có đã sẵn hai lớp chứa: Center của CRM (center_id, id dạng chuỗi, được tạo khi onboarding) và School của FLYER (school_id, kiểu int64, đơn vị sở hữu lớp học, học viên, học phí và thành viên giáo viên). Customer của CRM mang cả hai id này, và GET /v3/crm/me/accessible-schools hiện đã trả về nhiều school cho một người dùng CRM.

4Vai trò và ma trận phân quyền

CRM hiện đã có vai trò do tenant định nghĩa với một danh mục quyền (GET /v3/crm/permissions-catalog, các mã quyền được nhóm theo module) và phạm vi theo từng người dùng own | team | all. Thành viên trong school dùng enum cố định SchoolRole OWNER / ADMIN / TEACHER. Quyết định D2: một danh mục vai trò duy nhất. Mô hình vai trò của CRM được mở rộng thêm các mã quyền của những mô-đun mới; vai trò thành viên school được suy ra (cờ teacher, cờ admin) khi một vai trò Trường Số được gán, để các ứng dụng giáo viên của FLYER tiếp tục hoạt động.

Các vai trò mặc định đi kèm mọi tenant (có thể sao chép, không thể xoá):

Danh sách đầy đủ mã quyền theo từng mô-đun nằm trong phần Phân quyền của mỗi PRD và được hợp nhất tại PRD 10.

5Kiến trúc thông tin và bản đồ điều hướng

Sidebar hiện tại hiển thị Tổng quan, Khách hàng, Nhập dữ liệu và Cài đặt trung tâm. File constants đã khai báo route cho học viên, lớp học, điểm danh và học phí với nhãn điều hướng tiếng Việt, được nhóm thành Tổng quan / CRM & Hiệu suất / Quản lý trường học / Tài chính / Cài đặt. Điều hướng mục tiêu giữ nguyên cách nhóm này và bổ sung các mô-đun mới.

Ghi chú về tiền tố route: các route CRM hiện có vẫn giữ dưới /crm/* để các liên kết trong thông báo và bookmark tiếp tục hoạt động. Các mô-đun mới nằm ở gốc (/students, /classes ...) trong cùng layout (dashboard). Cài đặt được hợp nhất dưới /settings với một redirect từ /crm/settings/*.

Tổng quan mô hình đối tượng

6Hiện trạng so với những gì PRD bổ sung

Các điểm chưa nhất quán cần xử lý trong P1

• Có hai cách triển khai PermissionGate; bản stub trong src/components/crm luôn cho phép. Cần loại bỏ bản stub này.
• Thuật ngữ phạm vi quyền chưa đồng nhất: bộ sửa ma trận dùng none/read/write/manage, còn /me/permissions trả về own/team/all. PRD 10 chuẩn hoá thuật ngữ về own | branch | all cộng với mã hành động.
• Nhãn trạng thái kiểm tra xếp lớp trong i18n (scheduled) không khớp với enum của API (not_started, in_progress, completed, cancelled).
• Các endpoint được frontend tham chiếu nhưng không có trong spec: customers/{id}/convert, do-not-call, transfer-school, tasks, meetings, saved-views, users/{id}/school-access. PRD 01 và 10 quy định cách thay thế.
• Một số nội dung cài đặt và form đang hard-code bằng tiếng Anh; toàn bộ chuỗi văn bản sẽ được chuyển vào file message vi/en.

7Phân kỳ triển khai

8Các quyết định cần phê duyệt

1. D1 Tenant = Center, Branch = School (phần 3).
2. D2 Một danh mục vai trò duy nhất mở rộng từ vai trò CRM; vai trò school được suy ra (phần 4).
3. D3 Ưu tiên danh sách hơn board: pipeline vẫn giữ Kanban như một lựa chọn, nhưng mọi mô-đun mới ra mắt với giao diện dạng bảng trước và không có board.
4. D4 Học viên nhập học chính là hồ sơ learner của FLYER; việc chuyển đổi luôn tạo mới hoặc liên kết một tài khoản learner để dữ liệu học tập được gắn kèm từ ngày đầu.
5. D5 Buổi học là các dòng dữ liệu cụ thể được sinh ra từ lịch học của lớp, và điểm danh cùng bảng công gắn vào buổi học, không gắn vào mẫu lịch học.
6. D6 Tài chính tái sử dụng mô hình Tuition và GroupInvoice; gói buổi là một loại gói học phí, và số dư buổi của học viên là một số liệu tổng hợp được duy trì.
7. D7 Phụ huynh được liên hệ qua Zalo ZNS trước, trong ứng dụng thứ hai, email thứ ba; SMS không được xây dựng.
8. D8 Các route CRM hiện có vẫn giữ dưới /crm; các mô-đun mới là route ở gốc trong cùng một shell.
9. D9 Tiếng Việt là ngôn ngữ chính của sản phẩm; tiếng Anh là locale thứ hai đầy đủ từ ngày đầu, và toàn bộ chuỗi văn bản nằm trong file message.
10. D10 Kho, lương nhân sự và hoá đơn điện tử thuộc phase 2; phase 1 ra mắt vòng lặp vận hành hằng ngày gồm nhập học, xếp lịch, điểm danh, thu tiền, báo cáo.