huang
505b30aa8f
- 新增 realname_policy 字段到 tb_iot_card、tb_device、tb_iot_card_import_task、tb_device_import_task 四张表 - 策略枚举：none(无需实名)、before_order(先实名后充值/购买)、after_order(先充值/购买后实名) - C端充值拦截：before_order 策略下未实名用户禁止充值 - C端订单拦截：before_order 策略下未实名用户禁止购买套餐 - C端实名链接拦截：after_order 策略下无充值/订单用户禁止实名认证 - Admin API：PATCH /api/admin/assets/:identifier/realname-mode - 新增错误码 CodeRealnameNotAvailable=1189
3.0 KiB
MODIFIED Requirements
Requirement: C3 充值预检接口
系统 SHALL 提供 GET /api/c/v1/wallet/recharge-check?identifier=xxx，并且 MUST 要求个人客户认证。接口 MUST 在资产解析与归属校验后，新增实名策略检查：
- 获取生效实名策略（
GetEffectiveRealnamePolicy） - 生效策略为
before_order且real_name_status=0：MUST 返回CodeNeedRealname - 生效策略为
after_order或none：跳过实名检查，继续执行强充规则计算
通过实名检查后，接口 MUST 复用 recharge.Service.GetRechargeCheck() 计算强充规则。响应体 SHALL 包含 need_force_recharge、force_recharge_amount、trigger_type、min_amount、max_amount、message。错误码/消息 MUST 至少包含：INVALID_PARAM/参数错误、FORBIDDEN/无权限操作该资产或资源不存在、NEED_REALNAME/该套餐需实名认证后充值。
Scenario: 返回强充预检结果
- WHEN 资产命中强充规则
- THEN 系统返回
need_force_recharge=true与对应强充金额和触发类型
Scenario: before_order 未实名时充值预检被拦截
- WHEN 生效策略为 before_order 且 real_name_status=0
- THEN 系统返回 CodeNeedRealname，不返回强充预检结果
Requirement: C4 创建充值订单接口
系统 SHALL 提供 POST /api/c/v1/wallet/recharge，并且 MUST 要求个人客户认证。请求体 MUST 包含：identifier、amount（100~10000000 分）、payment_method=wechat、app_type。
接口 MUST 在归属校验后、OpenID 查询前，新增实名策略检查：
- 生效策略为
before_order且real_name_status=0：MUST 返回CodeNeedRealname，充值订单不创建 - 生效策略为
after_order或none：继续执行后续流程
接口 MUST 禁止客户端传入 OpenID，并由后端按 customer_id + app_type 查询 OpenID。订单创建时 MUST 写入：operator_type=personal_customer 与资产当前 generation 快照。响应体 SHALL 返回 recharge 与 pay_config，其中 recharge 至少含 recharge_id、recharge_no、amount、status，pay_config 为微信 JSAPI 拉起参数。错误码/消息 MUST 至少包含：INVALID_PARAM/参数错误、OPENID_NOT_FOUND/未找到微信授权信息，请先完成授权、FORBIDDEN/无权限操作该资产或资源不存在、PAYMENT_NOT_SUPPORTED/仅支持微信支付、NEED_REALNAME/该套餐需实名认证后充值。
Scenario: 后端查 OpenID 并返回支付参数
- WHEN 客户传入合法参数且后端成功查询到 OpenID
- THEN 系统创建充值单并返回
recharge + pay_config
Scenario: before_order 未实名时充值订单创建被拦截
- WHEN 生效策略为 before_order 且 real_name_status=0，用户调用充值下单接口
- THEN 系统返回 CodeNeedRealname（1187），充值单不创建
Scenario: after_order 模式充值放行
- WHEN 生效策略为 after_order 且 real_name_status=0，用户调用充值下单接口
- THEN 系统正常创建充值单，不检查实名状态