Module · WS đào tạo · 07/7/2026

catalog — Danh mục dùng chung MVP

Kho danh mục quy định (regulation-as-config) cho mọi module — km/giờ theo hạng, checklist giấy tờ, bộ mã. Mục tiêu: thông tư đổi → sửa danh mục trong vài ngày, không sửa code. Mọi module đều depends catalog.

✅ Trạng thái code: đã scaffold (4 danh mục, hạng GPLX đã seed theo quy định mới) — cần bổ sung: loại giấy tờ + checklist, quy tắc mã, cột km/giờ/tuổi.

Feature / BO / Action

Feature	BO chính	Action
license	Hạng GPLX	viewcreateeditdeleteimport
training-category	Hạng đào tạo	viewcreateeditdelete
doc-type	Loại giấy tờ + Checklist theo hạng	viewcreateeditdeleteconfigure
edu-level · subject	Trình độ học vấn · Môn học	viewcreateeditdelete
code-rule	Quy tắc sinh mã (học viên/khóa/phiếu)	viewconfigure

Dữ liệu chính

▸ Hạng GPLX — đã có, cần thêm cột quy định đào tạo (*)

Trường	Kiểu	Bắt buộc	Ghi chú
Mã hạng · tên · mô tả	text	✔	B, C1, C, D1, D2, A1, A2… (đã seed theo quy định mới)
Hạn sử dụng (năm)	number	—	—
Tuổi tối thiểu *	number	✔	Validate hồ sơ (student)
Km / giờ thực hành tối thiểu *	number	✔	Chuẩn đối soát DAT
Hiệu lực từ *	date	✔	Version theo thông tư
Trạng thái	bool	✔	—

▸ Loại giấy tờ + Checklist theo hạng — mới

Trường	Kiểu	Bắt buộc	Ghi chú
Mã / tên loại giấy tờ	text	✔	đơn ĐK, CCCD, khám SK, ảnh thẻ, GPLX cũ…
Có hạn sử dụng	bool	✔	giấy khám SK có hạn
Checklist: hạng × giấy tờ	ref×ref	✔	áp dụng (mới/nâng hạng/cả hai) + bắt buộc

▸ Quy tắc sinh mã — mới

Đối tượng (học viên/khóa/phiếu) + mẫu mã, vd HV-{ma_csdt}-{YYYY}-{seq5} — giữ tương thích mã cũ khi migrate.

Quy tắc nghiệp vụ & liên kết

Quy tắc

Danh mục có hiệu lực theo thời gian — bản mới không ghi đè bản cũ (hồ sơ cũ tham chiếu đúng quy định thời điểm của nó)
Không xóa cứng danh mục đã tham chiếu — chỉ ngừng hiệu lực
Checklist là nguồn duy nhất cho màn hình tiếp nhận hồ sơ

Liên kết chéo module

Mọi module tham chiếu bằng mã danh mục (ma_hang, mã giấy tờ…) — không FK cứng. Giáo vụ trưởng cấu hình; module khác chỉ đọc.

⚠ Câu hỏi mở

Quy tắc mã học viên/khóa Vĩnh An (việc #2)?
Bộ giấy tờ theo NĐ 94/2026 + TT 17/2026 → seed checklist

Quyền

Ma trận phân quyền — ốp vào manifest & seed role

Khối permissions[] dán vào manifest.json; bảng dưới là gán quyền theo vai trò (seed rt_role). Permission key đầy đủ: catalog.main.<feature>.<action>.

▸ permissions[] — manifest.json

[ { "group": "main", "feature": "license", "label": "Hạng GPLX", "actions": [ "view", "create", "edit", "delete", "import" ] }, { "group": "main", "feature": "training-category", "label": "Hạng đào tạo", "actions": [ "view", "create", "edit", "delete" ] }, { "group": "main", "feature": "doc-type", "label": "Loại giấy tờ & checklist", "actions": [ "view", "create", "edit", "delete", "configure" ] }, { "group": "main", "feature": "edu-level", "label": "Trình độ học vấn", "actions": [ "view", "create", "edit", "delete" ] }, { "group": "main", "feature": "subject", "label": "Môn học", "actions": [ "view", "create", "edit", "delete" ] }, { "group": "main", "feature": "code-rule", "label": "Quy tắc sinh mã", "actions": [ "view", "configure" ] } ]

▸ Ma trận vai trò × feature

Feature	QTHT	GIAM_DOC	QL_DAO_TAO	GIAO_VU	TUYEN_SINH
license	W	R	W	R	R
training-category	W	R	W	R	R
doc-type	W	R	W	R	R
edu-level	W	R	R	R	R
subject	W	R	R	R	R
code-rule	W	R	R	—	—

R xem · W tạo/sửa · A duyệt · — không có quyền · ¹ dữ liệu phân công · ² của chính mình · ³ theo trạng thái hồ sơ. Vai trò không liệt kê = không có quyền.

W của QTHT gồm cả delete·import·configure