jackyu66gitandCursor
882c01d81a
membership_plans 表、admin 套餐页、Grant/CreateOrder 读表； Loop continuous 自动 Approve/Closed。Next：ECR-015 RedemptionCode。 Co-authored-by: Cursor <cursoragent@cursor.com>
78 lines
2.3 KiB
Markdown
78 lines
2.3 KiB
Markdown
# Feature Spec: 会员套餐 MembershipPlan（Ops · ECR-014）
|
||
|
||
> Status: `Active`（Loop continuous · Approved · coding）· Map: `§7` · Phase: `Ops-D`
|
||
> Parent: **WAVE0-FROZEN** · Predecessor: **ECR-013B Closed**
|
||
> ESS: `docs/ECR/ECR-014-membership-plan.md`
|
||
> Capability: `CommerceEntitlement` · BC: `Membership_Orders`
|
||
> 授权：`docs/WAVE0/LOOP_AUTHORIZATION.md`
|
||
|
||
---
|
||
|
||
## ESS 门禁
|
||
|
||
1. L2 · Loop continuous：契约齐 → 自动 Approve + coding
|
||
2. **不含** 真支付 · 兑换码 · Entitlement 矩阵 · ask_pack 价目表
|
||
|
||
---
|
||
|
||
## L0 Capability
|
||
|
||
| 字段 | 内容 |
|
||
|------|------|
|
||
| Capability ID | `CommerceEntitlement` |
|
||
| Purpose | 运营可配置成长会员套餐时长与标价（mock 履约仍用既有支付） |
|
||
| Why now | planDays/金额硬编码；013B 完成后进入 Commerce 配置面最小切片 |
|
||
| Non-goals | 真支付网关 · RedemptionCode · Entitlement 细权 · ask_pack |
|
||
|
||
---
|
||
|
||
## L1 Bounded Context
|
||
|
||
| Primary BC | `Membership_Orders` |
|
||
| owns | `MembershipPlan` |
|
||
| does_not_own | `UserStatus` · `Payment` 适配器 · `AdminRole` |
|
||
| allowed | `Admin_Auth_Audit.write_audit` |
|
||
| forbidden | 真支付 · UGC |
|
||
|
||
---
|
||
|
||
## L2 Domain
|
||
|
||
| Entity | 不变式 |
|
||
|--------|--------|
|
||
| `MembershipPlan` | `code` ∈ {month,quarter,year} 本切片冻结；`duration_days`>0；`amount_cents`≥0；`active` 布尔 |
|
||
|
||
---
|
||
|
||
## L3 API
|
||
|
||
| Method | Path | 权限 | 语义 |
|
||
|--------|------|------|------|
|
||
| GET | `/admin/membership-plans` | `admin.membership.plans.read` | 列表 |
|
||
| GET | `/admin/membership-plans/:code` | `admin.membership.plans.read` | 详情 |
|
||
| PUT | `/admin/membership-plans/:code` | `admin.membership.plans.write` | 更新 title/days/amount/active + AuditLog |
|
||
|
||
履约：`GrantMembership` / membership `CreateOrder` 读表（缺行回退旧硬编码）。
|
||
|
||
`contract_diff`：`docs/CONTRACT_DIFF/ECR-014.yaml`
|
||
|
||
---
|
||
|
||
## L4 AC
|
||
|
||
| ID | Then |
|
||
|----|------|
|
||
| AC-F-01 | GET plans 含 month/quarter/year |
|
||
| AC-F-02 | PUT month days/amount → GET 一致 |
|
||
| AC-F-03 | GrantMembership 使用表内 duration_days |
|
||
| AC-S-01 | 无 write 权限 PUT → 403 |
|
||
| AC-S-02 | 无 Admin → 401 |
|
||
| AC-P-01 | GET list P95 < 500ms 本机 |
|
||
| AC-O-01 | PUT 成功 → AuditLog `membership.plans.update` |
|
||
|
||
---
|
||
|
||
## Implementation Notes
|
||
|
||
Migration `membership_plans` + RBAC additive permissions · admin-h5 最小列表编辑页
|