Built-in module · WS runtime · 08/7/2026

org — Tổ chức (built-in) BUILT-IN

Nguồn duy nhất về cơ cấu tổ chức: cây phòng ban, chức danh, định biên — đúng thiết kế dữ liệu WS0. student (bàn giao hồ sơ), hrm (nhân viên), data-scope theo phòng đều tham chiếu về đây.

🎯 Dùng ngay từ MVP — nguồn duy nhất cho WS0. Hiện trạng: bảng có sẵn nhưng chưa module domain nào trỏ vào.
1

Feature / BO / Action

FeatureBO chínhAction
unitĐơn vị / phòng ban (cây cha–con)viewcreateeditconfigure
positionChức danh / vị tríviewcreateedit
org-chartSơ đồ tổ chứcviewexport
headcountĐịnh biên theo phòngviewconfigurereport
2

Manifest — khai báo permissions

Permission key theo convention org.<group>.<feature>.<action>. fields/scopeVars theo plan data-scope (manifest v1.1).

{ "key": "org", "name": "Tổ chức", "version": "1.1.0 (đích)", "permissions": [ { "group": "organization", "feature": "unit", "label": "Đơn vị / Phòng ban", "actions": [ "view", "create", "edit", "configure" ] }, { "group": "organization", "feature": "position", "label": "Chức danh / Vị trí", "actions": [ "view", "create", "edit" ] }, { "group": "organization", "feature": "org-chart", "label": "Sơ đồ tổ chức", "actions": [ "view", "export" ] }, { "group": "organization", "feature": "headcount", "label": "Định biên", "actions": [ "view", "configure", "report" ] } ] }
3

Dữ liệu chính

▸ Phòng ban (khớp WS0 §4.1)

TrườngKiểuBắt buộcGhi chú
Mã phòngtextDuy nhất trong trung tâm
Tên phòngtext
Phòng charefCây cha–con; trống = cấp cao nhất
Loại phòngenumtuyển sinh / đào tạo / kế toán / nhân sự / kỹ thuật / sát hạch
Thứ tự hiển thịnumber
Trạng tháiboolĐang hoạt động / ngừng

▸ Chức danh (khớp WS0 §2)

TrườngKiểuBắt buộcGhi chú
Mã chức danhtextGD, PGD, TP, PP, TT, KTT, NV, GV_LT, GV_TH, KTV, CTV
Tên chức danhtext
CấpenumBan GĐ / quản lý / nhân viên / ngoài biên chế
Ghi chútext

▸ Định biên

TrườngKiểuBắt buộcGhi chú
Phòng banref
Chức danhref
Số lượng kế hoạchnumber
Thực tếnumber (view)Đếm từ hrm.Employee — không nhập tay
4

Ma trận quyền — vai trò × feature

Vai trò theo WS0. R xem · W tạo/sửa · A duyệt · — không có quyền.

FeatureQTHTGIAM_DOCQL_DAO_TAOTUYEN_SINHGIAO_VUGIAO_VIENKE_TOANNHAN_SU
unitWRRRRRRW
positionWRRW
org-chartRRRRRRRR
headcountRRRW

¹ chỉ bản ghi mình phụ trách · ² chỉ của chính mình · W·A = tạo/sửa + duyệt

5

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

Quy tắc

  • Không tạo danh mục phòng/chức danh ở nơi khác — catalog/hrm/student đều tham chiếu org
  • Seed template trường lái (cây WS0) lúc provision workspace; sửa theo thực tế từng trung tâm
  • Không xóa cứng phòng đã có tham chiếu — chỉ ngừng hoạt động
  • student.phong_phu_trach_id và biến data-scope current_dept_id đọc từ org

Liên kết chéo

  • hrm — Employee gắn 1 phòng + 1 chức danh chính
  • student — bàn giao hồ sơ theo phòng
  • rt-authz — biến ctx current_dept_id/subtree
  • WS0 — tài liệu dữ liệu nguồn

⚠ Câu hỏi mở

  • Danh sách phòng ban Vĩnh An (việc #3) → nhập cây thật
  • Headcount có cần cho trung tâm nhỏ không hay ẩn (config)?