Skip to content

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 APItier, tier-admin
Query / Mutation21 / 8
Nguồn dữ liệuloyalty/tier, loyalty/rank, public.member_tier_history
Bảng16
Luật phân quyền3
Đường dẫn Web Admin9

Thao tác (mutation) ​

MutationDomainMô tả
createMembershipTiertier-adminAdd a Tier (direct save, DEC-U28-05). Requires tier.write (ADT-01, MFA step-up).
decidePointConfigVersiontier-adminA different checker approves or rejects the unchanged payload. Requires point_config.decide (ADT-04: business_owner, never the maker, MFA step-up).
deleteMembershipTiertier-adminDelete a non-Standard Tier; history keeps its name. Requires tier.write (ADT-01, MFA step-up).
publishTierVersiontier-adminRequires tier.write (ADT-01). DRAFT -> PUBLISHED (frozen); closes the predecessor window.
savePointConfigVersiontier-adminMaker proposes / edits an open global cap or rate version. Requires point_config.propose (ADT-03: finance, MFA step-up).
saveTierVersiontier-adminCreate / edit a DRAFT Tier version. Requires tier.write (ADT-01). Multipliers need an approved policy (SPEC-01).
updateMembershipTiertier-adminEdit a Tier (Standard: name / coefficient / description only). Requires tier.write (ADT-01, MFA step-up).
updateRankPointPolicytier-adminChange N for credits posted from now on. Requires tier.write (ADT-01, MFA step-up).

Phép đọc (query) ​

QueryDomainMô tả
memberRankLotstierOne member's rank lots (Admin). tier.read (TIR-02).
membershipCustomertier-adminOne customer's Tier and rank (detail). Requires tier.read (TIR-02).
membershipCustomerstier-adminCustomers with their Tier and rank. Requires tier.read (TIR-02).
membershipTiertier-adminOne Tier of the set (detail). Requires tier.read (TIR-02).
membershipTierChangePreviewtier-adminImpact of a create / update / delete before the confirmation. Requires tier.read (TIR-02).
membershipTierHistorytier-adminTier change history of one customer. Requires tier.read (TIR-02).
membershipTierSettier-adminThe customer Tier set with N and the latest re-evaluation. Requires tier.read (TIR-02).
memberTiertierOne member's Tier and active rank (Admin). tier.read (TIR-02).
memberTierHistorytierOne member's Tier assignment history with evaluation evidence (Admin). tier.read (TIR-02).
myTiertierThe caller's current Tier and active rank in this app. tier.read (own).
myTierHistorytierThe caller's Tier assignment history, newest first. tier.read (own).
myTierProgresstierThe caller's progress toward the next Tier in this app. tier.read (own).
pointConfigVersionstier-adminGlobal cap / rate versions, newest first. Requires point_config.read (ADT-02: finance, business_owner).
rankLotstierThe caller's rank lots in this app; ACTIVE lists the soonest to expire first. tier.read (own).
rankPointHistorytier-adminRank point entries of one customer. Requires tier.read (TIR-02).
rankPointPolicytier-adminN in force; null when none. Requires tier.read (TIR-02).
tiertier-adminOne Tier. Requires tier.read (TIR-02).
tierMemberstier-adminMembers of a Tier system, optionally of one Tier, newest assignment first. Requires tier.read (TIR-02).
tierMultiplierChangestier-adminMultiplier change proposals, open ones first. Requires tier_multiplier.read (ADT-05: sale_manager, business_owner).
tierReevaluationtier-adminPoll one re-evaluation job. Requires tier.read (TIR-02).
tierstier-adminA Tier system's Tiers with versions and member counts. Requires tier.read (TIR-02).

Dữ liệu ​

Bảng được tham chiếu nhiều nhất trong module:

BảngCộtĐược trỏ tớiRLS
tier_versions168✓
tier_definitions85✓
tier_set_versions103✓
tier_assignments112✓
tier_evaluations152✓
rank_lots172✓
tier_reevaluations191✓
rank_debits151✓
rank_policy_versions81✓
member_tier_history191✓

Quyền ​

MãQuyềnỨng dụngVai tròPhạm viTrạng thái
ADT-01tier.writeWEB_ADMINsale_managerALLPROPOSED
TIR-01tier.readAPP_USER, APP_SALEuser saleOWNPROPOSED
TIR-02tier.readWEB_ADMINsale_managerALLPROPOSED

Danh sách đầy đủ và cách đọc các cờ: Ma trận quyền.

Giao diện Web Admin ​

Đường dẫnHằng số
/tiersTIERS
/tiers/:idTIER_DETAIL
/tiers/:id/editTIER_EDIT
/tiers/expiryTIER_EXPIRY
/tiers/membersTIER_MEMBERS
/tiers/members/:accountIdTIER_MEMBER
/tiers/members/:accountId/lotsTIER_LOTS
/tiers/newTIER_NEW
/tiers/rewardsTIER_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.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17