feat: add provider bill download reconciliation jobs

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

@@ -281,6 +281,8 @@ 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/provider-bills/request`：创建微信/支付宝官方账单下载任务，body 为 `{ provider, billDate, billType }`。
+- `GET /api/commerce/reconciliation/provider-bills/jobs`：查看官方账单下载任务状态、下载域名、hash、行数和生成的对账批次 ID。
 - `POST /api/commerce/reconciliation/issues/create`：从异常明细创建差错工单，重复创建同一未关闭明细会返回现有工单。
 - `GET /api/commerce/reconciliation/issues`：按状态、严重级别、负责人、批次、订单号筛选差错工单。
 - `POST /api/commerce/reconciliation/issues/status`：执行 `start/assign/resolve/ignore/escalate/reopen` 状态流转。
@@ -290,8 +292,11 @@ body: { "code": "<qq oauth code>", "redirectUri": "https://h5.example.com/auth/q
 
 - `tenant:reconciliation:read`：查看/预览对账。
 - `tenant:reconciliation:write`：导入对账批次、创建/处理差错工单。
+- `tenant:reconciliation:download`：创建微信/支付宝官方账单下载任务。
 
-对账和差错工单只生成差异台账、处理记录和审计，不自动修改订单、支付、退款和权益。`resolve/ignore` 只是财务审核结论，例如 `manual_adjustment`、`provider_confirmed`、`false_positive`，最终落账仍必须走退款状态机、支付补偿、手工支付确认或后续专门的人工调整命令。真实生产中，微信/支付宝官方账单下载 adapter 应复用同一套 `commerce_reconciliation_batches/items`，下载后的 CSV/JSON 先规范化为 `rows`，再调用同一套匹配逻辑。官方账单自动下载、人工调整凭证附件、财务复核报表和异常订单运营台仍需要继续补。
+官方账单下载由 `apps/worker --job provider-bills` 执行。API 只创建 `commerce_bill_download_jobs`，不会在前端返回供应商 `download_url`、商户私钥、微信 API v3 key 或支付宝应用私钥。worker 使用租户 `tenant_payment_accounts.config_public.secretRef` 找到 `app_private.tenant_secrets(secret_scope='payment')`，在后端签名申请下载 URL，校验微信返回的 `hash_type/hash_value`，解析 JSON/CSV/ZIP 账单后复用 `importReconciliationBatch` 写入 `commerce_reconciliation_batches/items`，`source='provider_download'`。
+
+对账和差错工单只生成差异台账、处理记录和审计，不自动修改订单、支付、退款和权益。`resolve/ignore` 只是财务审核结论，例如 `manual_adjustment`、`provider_confirmed`、`false_positive`，最终落账仍必须走退款状态机、支付补偿、手工支付确认或后续专门的人工调整命令。人工调整凭证附件、财务复核报表、异常订单运营台和真实生产账单格式抽样验收仍需要继续补。
 
 B 端合作商年费、服务费、服务器资源费不走学生端 `orders`，而是走平台账务：