xiongyuxing/gongxue-base
1
0
Fork 0
forked from wangziqi/gongxue-base
Code Pull Requests Activity

feat: add reconciliation issue workflow

Browse Source
This commit is contained in:
Codex
2026-06-29 19:05:18 +08:00
parent 7258e4a7d5
commit d696fc38b0
14 changed files with 924 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/refactor/auth-payment-provider-plan.md
View File

@@ -281,13 +281,17 @@ body: { "code": "<qq oauth code>", "redirectUri": "https://h5.example.com/auth/q
- `GET /api/commerce/reconciliation/batches`：查询对账批次。
- `GET /api/commerce/reconciliation/items`：查询逐行结果。
- `GET /api/commerce/reconciliation/anomalies`：查询金额不一致、状态不一致、供应商有本地无、本地有供应商无、重复行等异常。
- `POST /api/commerce/reconciliation/issues/create`：从异常明细创建差错工单，重复创建同一未关闭明细会返回现有工单。
- `GET /api/commerce/reconciliation/issues`：按状态、严重级别、负责人、批次、订单号筛选差错工单。
- `POST /api/commerce/reconciliation/issues/status`：执行 `start/assign/resolve/ignore/escalate/reopen` 状态流转。
- `GET /api/commerce/reconciliation/issues/events`：查看工单创建、分配、处理、解决、忽略、重开等事件轨迹。
权限点：
- `tenant:reconciliation:read`：查看/预览对账。
- `tenant:reconciliation:write`：导入对账批次。
- `tenant:reconciliation:write`：导入对账批次、创建/处理差错工单。
对账只生成差异台账，不自动修改订单、支付、退款和权益。真实生产中，微信/支付宝官方账单下载 adapter 应复用同一套 `commerce_reconciliation_batches/items`，下载后的 CSV/JSON 先规范化为 `rows`，再调用同一套匹配逻辑。差异处理、人工调整凭证、财务复核和异常订单运营台仍需要继续补。
对账和差错工单只生成差异台账、处理记录和审计，不自动修改订单、支付、退款和权益。`resolve/ignore` 只是财务审核结论，例如 `manual_adjustment`、`provider_confirmed`、`false_positive`，最终落账仍必须走退款状态机、支付补偿、手工支付确认或后续专门的人工调整命令。真实生产中，微信/支付宝官方账单下载 adapter 应复用同一套 `commerce_reconciliation_batches/items`，下载后的 CSV/JSON 先规范化为 `rows`，再调用同一套匹配逻辑。官方账单自动下载、人工调整凭证附件、财务复核报表和异常订单运营台仍需要继续补。
B 端合作商年费、服务费、服务器资源费不走学生端 `orders`，而是走平台账务：