feat(M08-B): 补保洁微信转账回调与轮询
This commit is contained in:
Codex
@@ -58,6 +58,14 @@
|
||||
- 新增 `2026062729_m08b_cleaning_transfer_state` 迁移，为保洁结算单增加 `payout_state` 和 `payout_package_info`，记录 `SUCCESS`、`FAIL`、`WAIT_USER_CONFIRM`、`PROCESSING` 等微信转账中间态。
|
||||
- 新增 `POST /admin-api/cleaning/settlements/:settlementId/wechat-transfer`，管理员可对 `CONFIRMED` 结算单发起微信转账；成功直接落 `PAID`，失败记录失败原因，待用户确认/处理中则保留 `CONFIRMED` 并写入中间态和微信 package 信息，便于后续查询或回调闭环。
|
||||
|
||||
## 2026-06-29 微信转账回调与轮询增量
|
||||
|
||||
- `WechatPayClient` 新增商户单号查询微信商家转账接口，按 `out_bill_no` 调用微信查询 API 并解析商户号、微信转账单号、状态、失败原因和转账金额。
|
||||
- `CleaningPayoutService.syncWechatTransfer` 新增主动轮询闭环：管理员可对已发起微信转账的 `CONFIRMED` 结算单同步微信状态；`SUCCESS` 自动标记 `PAID`，`FAIL` 记录失败原因，其它中间态继续保留 `CONFIRMED` 并更新 `payout_state`。
|
||||
- `CleaningPayoutService.processWechatTransferNotification` 新增微信转账通知处理：按微信平台证书序列号选择凭据、验签解密原始通知、校验商户号，再通过商户单号或微信转账单号定位结算单并写回成功、失败或中间态。
|
||||
- 新增 `POST /admin-api/cleaning/settlements/:settlementId/wechat-transfer/sync`，用于后台手动同步或后续定时轮询调用。
|
||||
- 新增 `POST /app-api/cleaning/wechat-transfer/notify`，免登录接收微信转账回调，使用流式 `preParsing` 捕获原始 body，避免验签因 JSON 重序列化失效。
|
||||
|
||||
## 验收结果
|
||||
|
||||
- `npm run build`（`backend/`）：PASS。
|
||||
@@ -89,14 +97,19 @@
|
||||
- 微信转账适配增量后 `node tests/migration-runner.test.mjs`：PASS。
|
||||
- 微信转账适配增量后 `node scripts/check-miniapp-m08-a.mjs`：PASS。
|
||||
- 微信转账适配增量后 `npm test`（`backend/`）：PASS。
|
||||
- 微信转账回调与轮询增量后 `npm run build`（`backend/`）：PASS。
|
||||
- 微信转账回调与轮询增量后 `node tests/wechat-pay.test.mjs`：PASS，覆盖商户单号查询转账单请求。
|
||||
- 微信转账回调与轮询增量后 `node tests/cleaning-payout-service.test.mjs`：PASS，覆盖主动同步成功/失败/处理中和微信通知成功落库。
|
||||
- 微信转账回调与轮询增量后 `node tests/cleaning-route.test.mjs`：PASS，覆盖后台同步路由和免登录微信通知路由。
|
||||
- 微信转账回调与轮询增量后 `npm test`（`backend/`）：PASS。
|
||||
|
||||
## 状态
|
||||
|
||||
M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员任务查询、指派、验收、驳回、超时回收、多人协作分账、待结算候选、正式结算单生成、确认、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库和非生产 Mock 门禁；微信转账回调/轮询闭环、真实商户场景报备联调和后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。
|
||||
M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员任务查询、指派、验收、驳回、超时回收、多人协作分账、待结算候选、正式结算单生成、确认、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调和非生产 Mock 门禁；真实商户场景报备联调和后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。
|
||||
|
||||
## 提交
|
||||
|
||||
- 工程提交：`M08-B微信转账适配增量`
|
||||
- 工程提交：`M08-B微信转账回调与轮询增量`
|
||||
- 远端校验：待本轮 push 后执行 `HEAD == origin/main`。
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user