Giao diện
Hạng thành viên
Trang sinh tự động
Phần nghiệp vụ viết tay; API, dữ liệu, quyền, đường dẫn và file nguồn do bộ sinh điền từ source tại ad83b0aea.
Làm gì
Bộ hạng có phiên bản, quyền lợi theo hạng và hệ số nhân điểm. Hạng được đánh giá lại theo kỳ; lô điểm xếp hạng có thể bị trừ khi đơn bị huỷ hoặc hoàn.
Quy mô
| Domain API | tier, tier-admin |
| Query / Mutation | 21 / 8 |
| Nguồn dữ liệu | loyalty/tier, loyalty/rank, public.member_tier_history |
| Bảng | 16 |
| Luật phân quyền | 3 |
| Đường dẫn Web Admin | 9 |
Thao tác (mutation)
| Mutation | Domain | Mô tả |
|---|---|---|
createMembershipTier | tier-admin | Add a Tier (direct save, DEC-U28-05). Requires tier.write (ADT-01, MFA step-up). |
decidePointConfigVersion | tier-admin | A different checker approves or rejects the unchanged payload. Requires point_config.decide (ADT-04: business_owner, never the maker, MFA step-up). |
deleteMembershipTier | tier-admin | Delete a non-Standard Tier; history keeps its name. Requires tier.write (ADT-01, MFA step-up). |
publishTierVersion | tier-admin | Requires tier.write (ADT-01). DRAFT -> PUBLISHED (frozen); closes the predecessor window. |
savePointConfigVersion | tier-admin | Maker proposes / edits an open global cap or rate version. Requires point_config.propose (ADT-03: finance, MFA step-up). |
saveTierVersion | tier-admin | Create / edit a DRAFT Tier version. Requires tier.write (ADT-01). Multipliers need an approved policy (SPEC-01). |
updateMembershipTier | tier-admin | Edit a Tier (Standard: name / coefficient / description only). Requires tier.write (ADT-01, MFA step-up). |
updateRankPointPolicy | tier-admin | Change N for credits posted from now on. Requires tier.write (ADT-01, MFA step-up). |
Phép đọc (query)
| Query | Domain | Mô tả |
|---|---|---|
memberRankLots | tier | One member's rank lots (Admin). tier.read (TIR-02). |
membershipCustomer | tier-admin | One customer's Tier and rank (detail). Requires tier.read (TIR-02). |
membershipCustomers | tier-admin | Customers with their Tier and rank. Requires tier.read (TIR-02). |
membershipTier | tier-admin | One Tier of the set (detail). Requires tier.read (TIR-02). |
membershipTierChangePreview | tier-admin | Impact of a create / update / delete before the confirmation. Requires tier.read (TIR-02). |
membershipTierHistory | tier-admin | Tier change history of one customer. Requires tier.read (TIR-02). |
membershipTierSet | tier-admin | The customer Tier set with N and the latest re-evaluation. Requires tier.read (TIR-02). |
memberTier | tier | One member's Tier and active rank (Admin). tier.read (TIR-02). |
memberTierHistory | tier | One member's Tier assignment history with evaluation evidence (Admin). tier.read (TIR-02). |
myTier | tier | The caller's current Tier and active rank in this app. tier.read (own). |
myTierHistory | tier | The caller's Tier assignment history, newest first. tier.read (own). |
myTierProgress | tier | The caller's progress toward the next Tier in this app. tier.read (own). |
pointConfigVersions | tier-admin | Global cap / rate versions, newest first. Requires point_config.read (ADT-02: finance, business_owner). |
rankLots | tier | The caller's rank lots in this app; ACTIVE lists the soonest to expire first. tier.read (own). |
rankPointHistory | tier-admin | Rank point entries of one customer. Requires tier.read (TIR-02). |
rankPointPolicy | tier-admin | N in force; null when none. Requires tier.read (TIR-02). |
tier | tier-admin | One Tier. Requires tier.read (TIR-02). |
tierMembers | tier-admin | Members of a Tier system, optionally of one Tier, newest assignment first. Requires tier.read (TIR-02). |
tierMultiplierChanges | tier-admin | Multiplier change proposals, open ones first. Requires tier_multiplier.read (ADT-05: sale_manager, business_owner). |
tierReevaluation | tier-admin | Poll one re-evaluation job. Requires tier.read (TIR-02). |
tiers | tier-admin | A Tier system's Tiers with versions and member counts. Requires tier.read (TIR-02). |
Dữ liệu
- Nhóm
loyalty/tier— 11 bảng - Nhóm
loyalty/rank— 4 bảng - Một bảng:
member_tier_history— thuộc domainloyalty, nhómkhác
Bảng được tham chiếu nhiều nhất trong module:
| Bảng | Cột | Được trỏ tới | RLS |
|---|---|---|---|
tier_versions | 16 | 8 | ✓ |
tier_definitions | 8 | 5 | ✓ |
tier_set_versions | 10 | 3 | ✓ |
tier_assignments | 11 | 2 | ✓ |
tier_evaluations | 15 | 2 | ✓ |
rank_lots | 17 | 2 | ✓ |
tier_reevaluations | 19 | 1 | ✓ |
rank_debits | 15 | 1 | ✓ |
rank_policy_versions | 8 | 1 | ✓ |
member_tier_history | 19 | 1 | ✓ |
Quyền
| Mã | Quyền | Ứng dụng | Vai trò | Phạm vi | Trạng thái |
|---|---|---|---|---|---|
ADT-01 | tier.write | WEB_ADMIN | sale_manager | ALL | PROPOSED |
TIR-01 | tier.read | APP_USER, APP_SALE | user sale | OWN | PROPOSED |
TIR-02 | tier.read | WEB_ADMIN | sale_manager | ALL | PROPOSED |
Danh sách đầy đủ và cách đọc các cờ: Ma trận quyền.
Giao diện Web Admin
| Đường dẫn | Hằng số |
|---|---|
/tiers | TIERS |
/tiers/:id | TIER_DETAIL |
/tiers/:id/edit | TIER_EDIT |
/tiers/expiry | TIER_EXPIRY |
/tiers/members | TIER_MEMBERS |
/tiers/members/:accountId | TIER_MEMBER |
/tiers/members/:accountId/lots | TIER_LOTS |
/tiers/new | TIER_NEW |
/tiers/rewards | TIER_REWARDS |
File nguồn
Backend:
code/apps/api/supabase/functions/graphql/domains/tier/code/apps/api/supabase/functions/graphql/domains/tier-admin/
Dữ liệu: bảng thuộc domain loyalty/tier, loyalty/rank, public.member_tier_history — xem Cơ sở dữ liệu.