Giao diện
Phân quyền
Trang sinh tự động
Đo trên source và trên schema sau khi chạy 820 migration, tại commit ad83b0aea. Luật đọc từ code/apps/api/supabase/functions/_shared/contracts/permission-matrix.json — chính file Edge Function nạp lúc chạy, không phải bản mô tả lại.
162 luật, 12 vai trò, 3 ứng dụng, 7 mức phạm vi.
Mô hình
Quyền hiệu lực là các grant (quyền, phạm vi) còn sống của người gọi, đọc lại ở mỗi request. Token không chứa vai trò hay quyền, nên thu hồi có tác dụng ngay chứ không phải chờ token hết hạn.
Mặc định là từ chối: root field không có luật nào thì luôn forbidden.
Quyền đặt tên tài_nguyên.hành_động, tối đa ba đoạn (user.read, payment.refund.approve).
Phạm vi
| Phạm vi | Số luật | Nghĩa |
|---|---|---|
ALL | 103 | toàn hệ thống |
OWN | 39 | dữ liệu mình tạo |
PUBLIC | 6 | không cần đăng nhập |
SELF | 6 | chỉ chính mình |
TEAM | 5 | trong nhóm của mình |
ASSIGNED | 2 | những gì được giao |
UNDECIDED | 1 | chưa quyết — từ chối cho tới khi có quyết định |
Vai trò
| Vai trò | Số luật nhắc tới |
|---|---|
admin | 50 |
operations | 33 |
user | 31 |
super_admin | 23 |
finance | 22 |
sale | 17 |
sale_manager | 16 |
anonymous | 6 |
any_member | 6 |
marketing | 6 |
business_owner | 4 |
bi_viewer | 1 |
finance_manager | 1 |
Tài nguyên
| Tài nguyên | Số luật |
|---|---|
order | 9 |
customer | 6 |
media | 6 |
sale_application | 5 |
payment | 4 |
privacy_request | 4 |
referral_link | 4 |
report | 4 |
deal | 4 |
mission | 4 |
spin | 4 |
finance_policy | 4 |
voucher | 4 |
refund | 4 |
auth | 3 |
point_adjust | 3 |
staff | 3 |
catalog | 3 |
cms | 3 |
application_document | 3 |
Kiểm soát bổ sung trên từng luật
| Cờ | Số luật | Nghĩa |
|---|---|---|
| maker / checker | 17 | Người đề nghị và người duyệt phải là hai người khác nhau |
| MFA bước hai | 35 | Phải xác thực lại ngay trước hành động đó |
| Không tự thao tác | 13 | Đối tượng phải khác người thực hiện |
| Cần yêu cầu đã duyệt | 0 | Xuất dữ liệu phải có yêu cầu được duyệt trước |
| Có quy tắc PII | 21 | Dữ liệu cá nhân bị che trừ khi có quyền đọc |
"Hai người khác nhau" so sánh con người, không so id tài khoản: cùng số điện thoại là cùng người. Điều này cần thiết vì một nhân viên có thể vừa có tài khoản STAFF vừa có tài khoản khách hàng.
Luật cần hai người
| Mã | Quyền | Vai trò | Vai |
|---|---|---|---|
X-01 | customer.export.approve | admin | checker |
FPL-04 | finance_policy.approve | checker | |
FPL-03 | finance_policy.submit | maker | |
AD-04 | mfa_reset.approve | super_admin | checker |
AD-03 | mfa_reset.request | admin | maker |
F-08 | payment.config.manage | checker | |
F-05 | payment.override.approve | finance | checker |
F-04 | payment.override.request | operations | maker |
F-07 | point_adjust.approve | finance | checker |
F-06 | point_adjust.request | operations | maker |
ADT-04 | point_config.decide | business_owner | checker |
ADT-03 | point_config.propose | finance | maker |
AD-02 | role_permission.approve | super_admin | checker |
AD-01 | role_permission.manage | admin | maker |
ADT-06 | tier_multiplier.decide | business_owner | checker |
VCH-04 | voucher.approve | finance | checker |
VCH-03 | voucher.submit | finance | maker |
Luật cần MFA bước hai
| Mã | Quyền | Vai trò |
|---|---|---|
CAT-04 | catalog.history.export | super_admin |
O-04 | customer.export | operations admin |
X-01 | customer.export.approve | admin |
EKY-02 | ekyc.review | admin super_admin |
FPL-04 | finance_policy.approve | |
FPL-03 | finance_policy.submit | |
AD-06 | membership.approve | admin super_admin |
AD-11 | membership.reject | admin super_admin |
AD-04 | mfa_reset.approve | super_admin |
AD-03 | mfa_reset.request | admin |
F-08 | payment.config.manage | |
F-05 | payment.override.approve | finance |
F-04 | payment.override.request | operations |
F-07 | point_adjust.approve | finance |
F-06 | point_adjust.request | operations |
ADT-04 | point_config.decide | business_owner |
ADT-03 | point_config.propose | finance |
PRP-02 | point_report.settle | finance |
PRV-07 | privacy.hold | |
PRV-06 | privacy.review | |
RFD-02 | refund.recover | finance |
RPT-04 | report_money.export | finance |
B-02 | report.pii.read | |
AD-02 | role_permission.approve | super_admin |
AD-01 | role_permission.manage | admin |
RB-03 | role_permission.manage | admin |
AD-07 | sale_application.review | admin super_admin |
SPC-02 | sale_profile_change.review | admin super_admin |
SAL-03 | sale.review | admin super_admin |
AD-09 | staff.create | admin super_admin |
AD-10 | staff.credential_issue | admin super_admin |
ADT-06 | tier_multiplier.decide | business_owner |
ADT-01 | tier.write | sale_manager |
VCH-04 | voucher.approve | finance |
VCH-03 | voucher.submit | finance |
Trạng thái luật
| Trạng thái | Số luật | Nghĩa |
|---|---|---|
PROPOSED | 122 | hành vi đã có nguồn, tên quyền còn chờ chốt |
DEFINED | 25 | có nguồn trong tài liệu thiết kế hoặc user story |
GAP | 15 | từ chối cho tới khi có quyết định |
15 luật ở trạng thái GAP — đang từ chối
Những quyền này chưa được quyết, nên hệ thống từ chối mọi lời gọi liên quan. Đây là lựa chọn có chủ ý: thà chặn còn hơn đoán.
| Mã | Quyền | Nguồn |
|---|---|---|
F-08 | payment.config.manage | PD-08 s19 payment/bank config; roles unspecified (GAP-11) |
MD-07 | storage.private.read | PD-08 s15 storage.private.read; M-02 AC03 private files need their own permission; role mapping not sourced (GAP-18) |
MD-08 | storage.private.write | PD-08 s15 storage.private.write; deleting another account's private file; role mapping not sourced (GAP-18) |
B-02 | report.pii.read | PD-08 s29 needs reason+audit (GAP-12) |
MS-04 | mission.assign | P4-02; catalog assignMission; MT-01 window starts at assignment; no story names who assigns a Mission to a member (A-MIS-01..04 cover configure, list/deactivate and progress) (GAP-45) |
PRV-05 | privacy.review | P1-14; A-SEC-05 Privacy Operator intake queue (AD-CUST-07); privacyRequests for staff; 'Privacy Operator' is not a PD-08 s14 role (GAP-59); SQL privacy.reviewer_roles() empty |
PRV-06 | privacy.review | P1-14; catalog reviewPrivacyRequest; A-SEC-05 verify/approve, PD-08 s19 bulk export/anonymisation maker != checker (Ops/Privacy maker, Privacy/Data Owner checker); reviewer role unmapped (GAP-59); SQL refuses a self-review regardless |
PRV-07 | privacy.hold | P1-14; registry legal_holds PERM_GATED privacy.hold; AD-CUST-08-hold 'only Legal/Privacy releases a hold'; Legal/Privacy is not a PD-08 s14 role (GAP-59); setLegalHold/releaseLegalHold not in the catalog; SQL privacy.hold_roles() empty |
ATR-04 | affiliate_link.disable | P4-11; admin handoff AD-ATTR-01-stop 'Ngưng Affiliate link: reason required, blocks new opens only, rewards untouched' is a PO proposal naming no role; owner self-disable is not sourced; DEC-S-LOCKED-LINKS open (GAP-58) |
CMS-01 | cms.read | P4-17; A-CMS-03 AC09 / A-CMS-05..07 name separate read/create/update/publish/delete permissions and a read-only CMS user, but no role is sourced for read-only CMS access (GAP-61). Not used by any guard: CMS reads use MK-01 cms.manage; SQL cms.actor_can('read') = MK-01 or MK-02 roles. |
FPL-01 | finance_policy.read | P3-07; list/detail of Finance policy versions (funds/vouchers, refund thresholds, tolerance; ADR-0004, G-FIN). No story names who reads them (GAP-71) |
FPL-02 | finance_policy.write | P3-07; saveFinancePolicyDraft (UNDECIDED/INTERIM draft, never APPROVED). No story names who records a Finance policy version (GAP-71) |
FPL-03 | finance_policy.submit | P3-07; submitFinancePolicyVersion (maker). ADR-0004 maker != checker; DEC-FIN-* owners Finance/BO not mapped to a role (GAP-71) |
FPL-04 | finance_policy.approve | P3-07; approveFinancePolicyVersion (checker, never author/editor/maker; APPROVED is immutable). Approver of a G-FIN decision record unsourced (GAP-71) |
MMO-01 | payment_simulator.control | P3-03; UW-PAY-02 'scenario controls are limited to QA/operator test roles in nonproduction' (EC02 buyer calling the scenario endpoint is blocked), UW-PAY-06 'QA injects scenarios in nonproduction; read access does not grant injection rights' (EC01). QA/operator test role is not a PD-08 s14 role (GAP-75). Not used by any guard: no API exposes the simulator controls; the server-side harness drives them (simulator/driver.ts) |
122 luật ở trạng thái PROPOSED
Hành vi đã có nguồn nhưng tên quyền còn chờ chốt. Chúng đang hoạt động, chỉ là tên có thể đổi.
Bảng đầy đủ 162 luật: Ma trận quyền.