提案以及归档

openspec/specs/client-order-purchase/spec.md

@@ -4,8 +4,16 @@
 
 ### Requirement: D1 创建套餐购买订单接口
 
-系统 SHALL 提供 `POST /api/c/v1/orders/create`，并且 MUST 要求个人客户认证。**[BREAKING]** 请求体改为使用资产标识符（identifier），废弃 `iot_card_id`/`device_id` 主键字段和 `order_type` 字段。请求体 MUST 包含 `identifier`、`package_ids[]`、`payment_method`。接口流程 MUST 按顺序执行：归属校验 → 套餐校验（含加油包前置）→ 实名校验 → OpenID 查询 → 幂等检查 → 强充检查 → 分流创建。实名不满足时 MUST 返回 `NEED_REALNAME`。OpenID 缺失时 MUST 返回 `OPENID_NOT_FOUND`。幂等 MUST 使用 Redis 业务键 + 分布式锁。分流规则 MUST 为：
+系统 SHALL 提供 `POST /api/c/v1/orders/create`，并且 MUST 要求个人客户认证。**[BREAKING]** 请求体改为使用资产标识符（identifier），废弃 `iot_card_id`/`device_id` 主键字段和 `order_type` 字段。请求体 MUST 包含 `identifier`、`package_ids[]`、`payment_method`。接口流程 MUST 按顺序执行：归属校验 → 套餐校验（含加油包前置）→ **实名策略检查（新增）** → OpenID 查询 → 幂等检查 → 强充检查 → 分流创建。
 
+**实名策略检查（新增，替代 REALNAME-03 注释代码）**：
+- 获取生效实名策略（`GetEffectiveRealnamePolicy`）
+- 生效策略为 `before_order` 且 `real_name_status=0`（未实名）：MUST 返回 `CodeNeedRealname`（错误码 1187），消息"该套餐需实名认证后购买"，订单不创建
+- 生效策略为 `after_order` 或 `none`：跳过实名检查，继续后续流程
+
+原 `REALNAME-03` 注释代码 SHALL 被删除，由此策略检查替代。
+
+实名不满足时 MUST 返回 `NEED_REALNAME`。OpenID 缺失时 MUST 返回 `OPENID_NOT_FOUND`。幂等 MUST 使用 Redis 业务键 + 分布式锁。分流规则 MUST 为：
 - 无强充：创建套餐订单并返回 `order_type="package"`、`order`、`pay_config`
 - 需强充：创建充值单并返回 `order_type="recharge"`、`recharge`、`pay_config`、`linked_package_info`
 
@@ -45,6 +53,14 @@
 - **WHEN** 个人客户发送的 identifier 对应的资产不属于该客户
 - **THEN** 系统返回 HTTP 403"无权限操作该资源"
 
+#### Scenario: before_order 策略未实名时购买被拦截
+- **WHEN** 生效策略为 before_order 且 real_name_status=0，用户调用创建订单接口
+- **THEN** 系统返回 CodeNeedRealname（1187），订单不创建
+
+#### Scenario: after_order 策略购买放行
+- **WHEN** 生效策略为 after_order 且 real_name_status=0，用户调用创建订单接口
+- **THEN** 系统正常创建订单，不检查实名状态
+
 ---
 
 ### Requirement: D2 套餐订单列表接口