Toàn lộ trình · CP – WS – Module – Feature · 06/7/2026

Sơ đồ phân rã WS · Module · Business Object · Action

Đề xuất tổng thể dựa trên nghiệp vụ trường lái xe phổ biến — không bám theo code hiện có. Bản chi tiết: markdown.

Nguyên tắc chia

Tầng	Ranh giới	Quy tắc quyết định
Workspace	Pháp nhân + cơ sở dữ liệu	Mỗi WS = 1 chủ thể chịu trách nhiệm pháp lý, 1 DB riêng. Chi nhánh (ma_csdt) là thuộc tính trong WS — không tách WS
Module	Đơn vị đóng gói – cài – bán/license	Tách khi: bán riêng theo gói · vòng đời nâng cấp riêng · người dùng chính khác · cài/gỡ độc lập
Feature	Nhóm quyền + mục menu	Mỗi feature ôm 1 nghiệp vụ con — là đơn vị gán quyền
Business Object	Chứng từ / đối tượng dữ liệu	Mỗi feature có 1 BO chính (+ BO phụ theo vòng đời)
Action	Thao tác trên BO	Bộ chuẩn view create edit delete import export approve assign configure report + action đặc thù khai qua customActions (chip vàng bên dưới)

✅ Trọng số 4 điều kiện tách module (bổ sung 20/7): điều kiện ③ "người dùng chính khác nhau" là yếu nhất — gần như không bao giờ đủ để tách module, vì tầng feature đã lo tách quyền theo người dùng rồi (dat.device cho kỹ thuật và dat.reconcile cho giáo vụ là hai permission key khác nhau, cùng một module). Chỉ ① bán riêng · ② vòng đời riêng · ④ cài–gỡ độc lập mới là lý do tách thật. Xem ví dụ áp dụng: Kiến trúc quản lý thiết bị §3.

⚠️ Cấm khai custom action trùng nghĩa core (print → dùng download; in phát hành/in lại = reprint có log) và verb workflow (submit·cancel·reject…) → mô hình hóa bằng trạng thái workflow (hồ sơ huy, báo cáo da_gui), quyền gate bằng action core trên feature.

▸ Phân biệt Feature vs BO (bổ sung 20/7)

Ví dụ xuyên suốt — nghiệp vụ "thu học phí đợt 1": Module tuition ── gói cài đặt/bán: "Học phí & công nợ" Feature receipt ── mục menu "Phiếu thu" + nhóm quyền BO Phiếu thu ── bản ghi dữ liệu (bảng tuition_phieu_thu), có vòng đời Action collect ── thao tác trên BO đó → quyền tuition.receipt.collect

	Feature	Business Object
Trả lời câu hỏi	"Ai được làm gì, ở mục menu nào?"	"Dữ liệu là cái gì, bản ghi gì?"
Là đơn vị của	quyền + menu (đơn vị gán quyền)	dữ liệu (bảng, form, vòng đời, trạng thái)
Xuất hiện ở	permission key module.feature.action · sidebar	tên bảng, grid, màn hình chi tiết
Bản chất / đặt tên	nghiệp vụ con — gọi bằng việc ("thu học phí", "đối soát")	chứng từ/đối tượng — gọi bằng tờ/bản ghi ("Phiếu thu", "Kết quả đối soát")
Tương đương thế giới	Tab/App + permission set (Salesforce) · menu+group (Odoo)	DocType (ERPNext) · Object (Salesforce) · Model (Odoo) · Table (Dataverse)

✅ Vì sao chèn tầng feature giữa quyền và bảng (khác ERPNext/Salesforce gán quyền thẳng trên từng DocType/Object): để quyền không vỡ vụn theo bảng — cấp student.hoso.view là thấy trọn BO chính + BO phụ của feature đó. Chuỗi quyền module.feature.action cố tình bỏ qua BO: mở cửa nào thì thấy trọn bộ BO sau cửa đó. Lưu ý: một BO hiện ở nhiều màn hình vẫn chỉ có 1 feature chủ (nơi khác chỉ tham chiếu/đọc); feature dạng cấu hình vẫn có BO (BO của notify.rule = Quy tắc nhắc hạn); feature quy trình lấy BO kết quả làm BO chính (dat.reconcile → Kết quả đối soát).

▸ 3 chỗ vá định nghĩa (review 20/7)

Lỗ hổng	Quy tắc vá
① Tiêu chí "BO phụ" mơ hồ chính sơ đồ đã "vi phạm": giayto/lichsu đi kèm vòng đời hồ sơ nhưng tách feature	BO phụ được thăng cấp thành feature khi và chỉ khi nó cần bộ quyền khác BO chính (giấy tờ cần verify riêng, lịch sử cần view-only audit riêng). "Đi kèm vòng đời" chỉ là điều kiện cần — phép thử quyết định là nhu cầu quyền riêng.
② Enrich chéo đi vòng qua quyền xem list học viên kèm tên khóa không cần course.course.view	Chấp nhận cho cột nhãn, nhưng chặn rò rỉ bằng quy tắc: contract view chỉ chứa cột định danh + nhãn hiển thị (mã, tên, trạng thái); dữ liệu nhạy cảm (tiền, lương, scan giấy tờ) không bao giờ vào contract view — đọc phải qua service API check quyền feature nguồn. → đã ghi thành quy tắc cứng trong Quan hệ module §4.
③ Quyền theo transition chưa có chỗ ai được duyệt ≠ ai được hủy ≠ ai được bàn giao — gate chung bằng edit/approve không phân biệt được	Khi một BO có >2 transition cần quyền khác nhau → khai transition đó như custom action của feature (hoso.huy, hoso.transfer — transfer đã đi đúng hướng này), không đẻ feature mới, không nhét chung vào edit. Tham khảo: ERPNext workflow gán role theo từng transition.

⚠️ Tuyên bố ngoài phạm vi — field-level security (ẩn cột lương với vai X): mô hình không hỗ trợ, xử lý bằng cách tách feature (①); chiều record-level đã có data-scope (ma_csdt, current_dept_id). Ghi rõ để sau này không ai vá chui bằng if-else trong UI.

Control Plane & số lượng Workspace

CONTROL PLANE (1) users · workspaces · RBAC · SSO · store/license │ ├── WS admin-console (1) vận hành nền tảng ├── WS demo/sandbox (1) trình diễn bán hàng │ ├── WS ĐÀO TẠO × N MỖI TRUNG TÂM ĐÀO TẠO = 1 WS │ GĐ1: Vĩnh An là WS đầu tiên · nhiều cơ sở → vẫn 1 WS (ma_csdt) │ └── WS SÁT HẠCH × M (v3) MỖI TRUNG TÂM SÁT HẠCH = 1 WS RIÊNG tách khỏi WS đào tạo dù cùng chủ đầu tư: chu kỳ kiểm chuẩn BCA riêng · dữ liệu kỳ thi thuộc hội đồng · phần mềm niêm phong theo phiên bản

✅ Có nên tách WS đào tạo / WS sát hạch? — Nên. Ranh giới đúng là tách theo "hệ được thẩm định": ôn luyện xe chip & vận hành cho-mượn-sân vẫn nằm trong WS đào tạo (tự do công nghệ, nguồn thu của trung tâm); chỉ hệ sát hạch chính thức (chấm thi, giám sát, truyền CSGT — phải thẩm định BCA) mới sang WS sát hạch.

WS đào tạo — module theo giai đoạn

MVP · 9 module v1.5 · +7 v2 · +5 v3 · +1 (bi) · chip vàng = action đặc thù · NEW = chưa có trong code · bấm tên module để xem chi tiết

▸ MVP — Lõi tuân thủ

catalogDanh mục dùng chung

license	Hạng GPLX (km/giờ, tuổi, hạn) viewcreateeditimport
doc-type	Loại giấy tờ + checklist theo hạng vieweditconfigure
khác	Hạng đào tạo · Trình độ · Môn học · Quy tắc sinh mã vieweditconfigure

studentHọc viên & hồ sơ

student	Học viên (danh bạ người) viewcreateeditexport
hoso	Hồ sơ ghi danh theo khóa (state machine) viewcreateeditapprovetransfer
giayto	Giấy tờ hồ sơ (scan, hạn) viewcreateverify
lichsu	Lịch sử trạng thái (audit) viewexport

courseKhóa học & xếp lớp

course	Khóa học viewcreateeditclose
enrollment	Ghi danh + phân công GV–xe viewcreateassign
plan	Kế hoạch đào tạo (trình Sở) viewcreateapprovereport

teacherGiáo viên

teacher	Giáo viên (hồ sơ nghiệp vụ) viewcreateeditexport
cert	Chứng chỉ GV + hạn vieweditconfigure
assignment	Phân công dạy (khớp đăng ký Sở) viewassignreport

vehicleXe tập lái

vehicle	Xe tập lái viewcreateeditexport
license-doc	Giấy phép xe, đăng kiểm, bảo hiểm (hạn) vieweditconfigure
device-bind	→ chuyển sang dat.binding (20/7); vehicle chỉ đọc dat_v_thiet_bi_theo_xe

datThiết bị & dữ liệu DATPainkiller

device	Thiết bị DAT (seri, sim, hạn) viewcreateedit
binding	Gắn/tháo thiết bị vào xe (lịch sử theo thời điểm) — từ vehicle viewassignexport
session	Phiên học DAT (km/giờ) viewimportexcludeexport
reconcile	Kết quả đối soát theo học viên/hạng viewreconcilereport
alert	Cảnh báo thiếu km/giờ, lệch GV/xe viewconfiguresend
log	Nhật ký truyền view

tuitionHọc phí & công nợNEW

pricelist	Bảng học phí theo hạng/khóa vieweditapprove
installment	Công nợ theo đợt viewcreateeditexport
receipt	Phiếu thu viewcollectrefundreprint
discount	Miễn giảm viewcreateapprove

reportBáo cáo Sở XDPainkillerNEW

template	Mẫu báo cáo (version theo thông tư) viewconfigure
so-xd	Báo cáo đã lập (KH đào tạo, DS học viên, tốt nghiệp) viewgenerateapprovedownload
registry	Sổ đã nộp (immutable) viewexport

notifyNhắc hạn & thông báoNEW

rule	Quy tắc nhắc hạn (giấy tờ GV/xe/HV) viewconfigure
message	Thông báo đã gửi (Zalo OA/SMS/app) viewsendexport

▸ v1.5 — LMS · App · Back-office

lmsLý thuyết chuẩn giám sát

class	Lớp/buổi lý thuyết viewcreateedit
attendance	Điểm danh khuôn mặt viewcheckinexport
question-bank	Ngân hàng 600 câu (config) viewimportconfigure
mock-exam	Thi thử + kết quả viewscore
result	Kết quả lý thuyết (xét điều kiện) viewapprovereport

crmTuyển sinh

lead	Lead (Zalo/FB/web) viewcreateassignconvert
campaign	Nguồn/chiến dịch vieweditreport
commission	Hoa hồng CTV viewapproveexport

financeKế toán & HĐĐT

invoice	Hóa đơn điện tử viewissuevoidexport
ledger	Sổ thu–chi, doanh thu viewreport
reconcile	Đối soát doanh thu viewreconcile

payrollLương giáo viên

timesheet	Bảng công từ giờ DAT/chip viewgenerateedit
salary	Bảng lương viewgenerateapproveexport

hrNhân sự

employee	Nhân viên (phòng, chức danh) viewcreateedit
org	Phòng ban · chức danh (cây) viewconfigure
contract	Hợp đồng, chứng chỉ tập huấn vieweditconfigure

fleetĐội xe & tài sản

fuel / maintenance	Nhiên liệu theo km DAT · Bảo dưỡng viewcreateapprove
cost / asset	Chi phí đầu xe · Tài sản, khấu hao, kho viewreportexport

portalBackend app học viên

account	Tài khoản app viewcreatereset
progress	Tra cứu tiến độ km/giờ view
booking	Đặt lịch bổ túc viewbookapprove
practice	Ôn 600 câu, thi thử view

▸ v2 — Sân bãi & bán thêm · v3 — BI

chipXe chip ôn luyện

device / lesson	Thiết bị chip · 12 bài sa hình (config) viewconfigure
session	Phiên ôn + kết quả/lỗi từng bài viewimportscoreexport

bookingThuê xe chip & sân

calendar / rent

Lịch sân/xe · Phiên thuê · Bảng giá viewbookcollectreport

examopsVận hành kỳ sát hạch (mượn sân)

exam / roster

Kỳ thi · DS thí sinh · Điều phối xe/sân · Doanh thu thuê viewcreateassignreport

paymentThanh toán online

transaction

Giao dịch cổng · Đối soát cổng viewrefundreconcile

certChứng chỉ nghề

program / issue

Chương trình nghề (config) · Chứng chỉ cấp (tái dùng student+lms) viewcreateapprovedownload

biDashboard đa module (v3)

dashboard

Tỷ lệ đậu theo GV/xe/khóa · hiệu suất sân · chi phí/học viên viewreportexport

WS sát hạch (v3) — 8 module

WS riêng cho mỗi trung tâm sát hạch — phần mềm thẩm định BCA, release theo phiên bản kiểm chuẩn (không cập nhật kiểu SaaS).

Module	Feature / BO chính	Action đặc thù
schedule	Kỳ sát hạch · hội đồng · ca thi · DS thí sinh	viewcreateassignlock
kiosk	Check-in thí sinh · đối chiếu khuôn mặt · số báo danh	viewcheckinverify
theory	Phòng máy · đề thi (trộn 600 câu, điểm liệt) · bài thi · biên bản	generatescoredownload
yard	Xe sát hạch · bài sa hình · kết quả chấm tự động · log niêm phong	scoresealexport
road	Lộ trình đường trường · kết quả chấm · bảng nút SH viên	scoreexport
moto	Sát hạch A1/A2 (sân mô tô)	scoreexport
monitor	Camera xe/sân/phòng thi · màn hình công khai điểm · lưu vết	viewbroadcastexport
gateway	Gói tin truyền Cục CSGT · nhật ký truyền/bù	transmitretryreport

Tổng hợp số lượng

Control Plane

2 + N + M

Workspace (hệ thống + đào tạo + sát hạch)

9 → 16 → 21

Module / WS đào tạo (MVP → v1.5 → v2)

Module / WS sát hạch (v3)

2–5

Feature / module

4–8

Action / BO (10 chuẩn + ~17 đặc thù)

⚠️ Đây là sơ đồ mục tiêu để định hướng đóng gói & bán theo gói. Khi implement từng giai đoạn có thể gộp/tách feature theo thực tế — miễn giữ nguyên tắc mục 0. Đối chiếu hiện trạng code: 6 module đã scaffold (catalog, student, course, teacher, vehicle, dat — cần thêm feature), GĐ1 cần scaffold mới tuition · report · notify.

▸ Đối chiếu với module đã có trong code (tham khảo)

Đề xuất	Hiện có trong ws_suns	Ghi chú
catalog, student, course, teacher, vehicle, dat	✅ đã scaffold (.ogapp)	student cần thêm feature hoso/giayto; dat cần thêm session/reconcile/alert
tuition, report, notify	❌ chưa có	GĐ1 phải scaffold (tuition/report đã có schema đề xuất)
hr, payroll, crm (v1.5)	✅ built-in hrm, crm phủ sẵn (18 model HRM)	Không scaffold mới — built-in + phần đặc thù mỏng (GV↔Employee, timesheet-DAT, convert lead→hồ sơ, hoa hồng CTV)
phòng ban / chức danh	✅ built-in org (OrganizationalUnit + Position)	Seed danh sách Vĩnh An vào org từ MVP — không tạo danh mục riêng
lms, finance, fleet, portal	❌ chưa có	v1.5 — còn 4 module mới (thay vì 7)
chip, booking, examops, payment, cert, bi	❌ chưa có	v2–v3
rfcard (hiện có)	—	giữ như module hạ tầng nhỏ, phục vụ điểm danh/DAT
workflow, workplace, system, iam (built-in)	✅ có sẵn lúc boot	workflow để dành (duyệt/connector); workplace disable ở Vĩnh An; system = quyền hạ tầng; iam chờ RT-16
account, base (hiện có)	—	demo, không cài