feat: add commerce reconciliation ledger

docs/refactor/auth-payment-provider-plan.md

@@ -272,6 +272,23 @@ body: { "code": "<qq oauth code>", "redirectUri": "https://h5.example.com/auth/q
 - 支付成功事务内更新 `orders`、`payments`、`payment_events`、`entitlements`。
 - 支付密钥只允许放在 `app_private.tenant_secrets` 或生产 KMS/Vault。
 
+### 资金对账
+
+当前后端已提供租户级资金对账基础能力：
+
+- `POST /api/commerce/reconciliation/preview`：预览供应商账单行和本地订单/支付/退款的匹配结果。
+- `POST /api/commerce/reconciliation/import`：确认导入对账批次和明细，写入审计。
+- `GET /api/commerce/reconciliation/batches`：查询对账批次。
+- `GET /api/commerce/reconciliation/items`：查询逐行结果。
+- `GET /api/commerce/reconciliation/anomalies`：查询金额不一致、状态不一致、供应商有本地无、本地有供应商无、重复行等异常。
+
+权限点：
+
+- `tenant:reconciliation:read`：查看/预览对账。
+- `tenant:reconciliation:write`：导入对账批次。
+
+对账只生成差异台账，不自动修改订单、支付、退款和权益。真实生产中，微信/支付宝官方账单下载 adapter 应复用同一套 `commerce_reconciliation_batches/items`，下载后的 CSV/JSON 先规范化为 `rows`，再调用同一套匹配逻辑。差异处理、人工调整凭证、财务复核和异常订单运营台仍需要继续补。
+
 B 端合作商年费、服务费、服务器资源费不走学生端 `orders`，而是走平台账务：
 
 - `platform_saas_plans`：平台售卖给合作商的 SaaS 套餐。