Skip to content

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 viSố luậtNghĩa
ALL103toàn hệ thống
OWN39dữ liệu mình tạo
PUBLIC6không cần đăng nhập
SELF6chỉ chính mình
TEAM5trong nhóm của mình
ASSIGNED2những gì được giao
UNDECIDED1chư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
admin50
operations33
user31
super_admin23
finance22
sale17
sale_manager16
anonymous6
any_member6
marketing6
business_owner4
bi_viewer1
finance_manager1

Tài nguyên ​

Tài nguyênSố luật
order9
customer6
media6
sale_application5
payment4
privacy_request4
referral_link4
report4
deal4
mission4
spin4
finance_policy4
voucher4
refund4
auth3
point_adjust3
staff3
catalog3
cms3
application_document3

Kiểm soát bổ sung trên từng luật ​

CờSố luậtNghĩa
maker / checker17Người đề nghị và người duyệt phải là hai người khác nhau
MFA bước hai35Phải xác thực lại ngay trước hành động đó
Không tự thao tác13Đối tượng phải khác người thực hiện
Cần yêu cầu đã duyệt0Xuất dữ liệu phải có yêu cầu được duyệt trước
Có quy tắc PII21Dữ 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ềnVai tròVai
X-01customer.export.approveadminchecker
FPL-04finance_policy.approvechecker
FPL-03finance_policy.submitmaker
AD-04mfa_reset.approvesuper_adminchecker
AD-03mfa_reset.requestadminmaker
F-08payment.config.managechecker
F-05payment.override.approvefinancechecker
F-04payment.override.requestoperationsmaker
F-07point_adjust.approvefinancechecker
F-06point_adjust.requestoperationsmaker
ADT-04point_config.decidebusiness_ownerchecker
ADT-03point_config.proposefinancemaker
AD-02role_permission.approvesuper_adminchecker
AD-01role_permission.manageadminmaker
ADT-06tier_multiplier.decidebusiness_ownerchecker
VCH-04voucher.approvefinancechecker
VCH-03voucher.submitfinancemaker

Luật cần MFA bước hai ​

MãQuyềnVai trò
CAT-04catalog.history.exportsuper_admin
O-04customer.exportoperations admin
X-01customer.export.approveadmin
EKY-02ekyc.reviewadmin super_admin
FPL-04finance_policy.approve
FPL-03finance_policy.submit
AD-06membership.approveadmin super_admin
AD-11membership.rejectadmin super_admin
AD-04mfa_reset.approvesuper_admin
AD-03mfa_reset.requestadmin
F-08payment.config.manage
F-05payment.override.approvefinance
F-04payment.override.requestoperations
F-07point_adjust.approvefinance
F-06point_adjust.requestoperations
ADT-04point_config.decidebusiness_owner
ADT-03point_config.proposefinance
PRP-02point_report.settlefinance
PRV-07privacy.hold
PRV-06privacy.review
RFD-02refund.recoverfinance
RPT-04report_money.exportfinance
B-02report.pii.read
AD-02role_permission.approvesuper_admin
AD-01role_permission.manageadmin
RB-03role_permission.manageadmin
AD-07sale_application.reviewadmin super_admin
SPC-02sale_profile_change.reviewadmin super_admin
SAL-03sale.reviewadmin super_admin
AD-09staff.createadmin super_admin
AD-10staff.credential_issueadmin super_admin
ADT-06tier_multiplier.decidebusiness_owner
ADT-01tier.writesale_manager
VCH-04voucher.approvefinance
VCH-03voucher.submitfinance

Trạng thái luật ​

Trạng tháiSố luậtNghĩa
PROPOSED122hành vi đã có nguồn, tên quyền còn chờ chốt
DEFINED25có nguồn trong tài liệu thiết kế hoặc user story
GAP15từ 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ềnNguồn
F-08payment.config.managePD-08 s19 payment/bank config; roles unspecified (GAP-11)
MD-07storage.private.readPD-08 s15 storage.private.read; M-02 AC03 private files need their own permission; role mapping not sourced (GAP-18)
MD-08storage.private.writePD-08 s15 storage.private.write; deleting another account's private file; role mapping not sourced (GAP-18)
B-02report.pii.readPD-08 s29 needs reason+audit (GAP-12)
MS-04mission.assignP4-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-05privacy.reviewP1-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-06privacy.reviewP1-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-07privacy.holdP1-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-04affiliate_link.disableP4-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-01cms.readP4-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-01finance_policy.readP3-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-02finance_policy.writeP3-07; saveFinancePolicyDraft (UNDECIDED/INTERIM draft, never APPROVED). No story names who records a Finance policy version (GAP-71)
FPL-03finance_policy.submitP3-07; submitFinancePolicyVersion (maker). ADR-0004 maker != checker; DEC-FIN-* owners Finance/BO not mapped to a role (GAP-71)
FPL-04finance_policy.approveP3-07; approveFinancePolicyVersion (checker, never author/editor/maker; APPROVED is immutable). Approver of a G-FIN decision record unsourced (GAP-71)
MMO-01payment_simulator.controlP3-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.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17