同步相关内容

docs/7月迭代/7月迭代技术方案-标准评审稿.md

@@ -1,6 +1,6 @@
 # 7月迭代技术方案（标准评审稿）
 
-> 状态：待评审  
+> 状态：已评审  
 > 最后更新：2026-07-20
 > 分支：`Iteration/7-11`  
 > 系统：`junhong_cmp_fiber` 及配套后台、代理端、C 端前端  
@@ -1350,10 +1350,12 @@ sequenceDiagram
 
 - 代理只能为当前店铺主钱包充值，最低 `10000` 分（100 元）。
 - 支持微信 Native 和支付宝 `alipay.trade.precreate`，创建本地充值单和 `tb_payment(order_type=agent_recharge)` 后再预下单。
-- 后端统一返回 `qr_content` 和过期时间，前端使用二维码组件渲染，不生成后端图片文件。
+- 每次主动创建都生成新的充值单和支付单；`request_id` 只防同一次 HTTP 提交重试，不按金额或已有待支付单复用。后端原样返回第三方 `qr_content`，前端使用二维码组件渲染，不生成后端图片文件。
+- 不返回 `expires_at`，也不展示本地推算的精确倒计时；支付是否成功、关闭或失效以第三方回调和受控查单结果为准。前端每 3 秒轮询的轻量接口只读取本地状态，不直接触发第三方查单。
 - 微信/支付宝回调按支付单类型分发，校验渠道、支付配置、金额、第三方交易号和业务单关联。
-- 支付单、充值单、代理主钱包、钱包版本、唯一钱包流水和 Audit Event 在同一事务推进；重复回调只返回渠道成功，不重复加钱。
-- 支付成功但钱包事务失败时保持已支付并由可靠任务补齐；二维码过期后关闭原充值单，重新生成必须创建新支付单。
+- 支付确认和钱包入账分成两个可靠事务：第一阶段固化支付单已支付、充值单已支付、处理状态和入账 Outbox；第二阶段由 Worker 原子更新代理主钱包、版本、唯一流水、充值完成状态和资金 Audit Event。重复回调或任务不重复加钱。
+- 支付成功但钱包事务失败时保持已支付并由可靠任务补齐；第三方明确关闭或失效时支付单沿用 `2=已失败`、充值单改为已关闭，不新增支付“已关闭”状态。已关闭后收到可核验的迟到成功回调仍按真实收款事实幂等入账。
+- 钱包实际入账成功后向目标代理店铺主账号发送站内到账通知；在线真实提交人不是主账号时也接收，按充值单和接收人防重。
 
 ```text
 GET  /api/admin/agent-recharges/payment-methods
@@ -1361,7 +1363,7 @@ POST /api/admin/agent-recharges
 GET  /api/admin/agent-recharges/{id}/payment-status
 ```
 
-代理在线充值详情固定 `approval_source=none`，前端每 3 秒轮询轻量支付状态，页面不可见时暂停。
+代理在线充值详情固定 `approval_source=none`。前端每 3 秒轮询本地轻量支付状态，页面不可见时暂停；响应分别返回支付状态和统一 `processing_status`，不提供同义字段 `wallet_posting_status`。
 
 #### 平台员工线下代充值
 
@@ -1399,11 +1401,13 @@ sequenceDiagram
 关键规则：
 
 - 企微通过后自动增加代理主钱包余额并写钱包流水，无操作密码。
+- 线下金额只要求大于 0且不超过 100 万元；目标店铺、固定金额和 1～5 个结构化付款凭证必填，备注选填且最多 500 字。企微只能同意或拒绝，不能修改金额。
 - Worker 使用 `recharge:{recharge_no}` 幂等键和处理租约。
 - 钱包余额、版本、充值单和资金流水必须在同一事务更新。
 - 若资金流水已存在但充值单状态未完成，重试只补齐状态，不再次入账。
-- 驳回改为已驳回；撤销/删除改为已关闭，可重新创建充值申请。
+- 驳回改为已驳回并终结原单；不增加已退回状态或原单重提接口，修正后必须重新创建。撤销/删除改为已关闭，可重新创建充值申请。
 - 通过后撤销且已经入账时不自动扣回，记录严重异常并通知财务；尚未入账时终止任务。
+- 钱包实际入账成功后向目标代理店铺主账号发送站内到账通知；企微审批结果另行通知真实业务提交人。
 
 旧接口在停机发布后不再注册：