2.4 KiB
2.4 KiB
10 — 提供任务汇总与逐行明细查询
What to build: 通过现有后台认证的调用方可以查询批量订购任务汇总及逐行结果,在刷新或重新打开页面后恢复进度。接口按固定行号顺序分页,支持状态和资产标识精确筛选,并返回套餐、结算代理、金额、订单及中文失败信息,不暴露存储凭证、钱包余额或底层错误。
Blocked by: .scratch/ur36-bulk-package-purchase/issues/09-wallet-bulk-row-purchase-recovery.md — 09 — 逐行完成钱包批量订购与崩溃恢复
Status: ready-for-agent
架构通道: Query。
完整业务边界: 本票收口批量订购任务详情和明细读取模型、DTO 与后台路由。明确不建立通用任务中心、不修改任务状态、不增加任务创建人隔离或新的 RBAC、不迁移其他任务查询。
- 任务详情返回任务号、请求 ID、套餐快照、支付方式、状态与中文名称、源文件摘要、凭证引用、操作者、计数、涉及代理数、成功金额、安全错误和起止时间。
- 明细查询默认第 1 页、每页 20 条且最大 100,始终按
row_no ASC;前端不能改变业务处理顺序。 status只接受公共行处理状态,asset_identifier去除首尾空白后仅在当前任务内对原始或规范标识精确匹配;多个筛选使用 AND。- 每行返回行号、资产类型、原始标识、资产 ID、规范标识、结算代理快照、金额、状态与中文名称、订单、失败码、中文原因和处理时间。
- 汇总从明细事实计算或校准,始终满足
processed_count = success_count + fail_count;解析阶段允许总数为 0,部分成功不增加私有状态。 - 查询只复用现有后台认证与公共数据范围,不新增批量权限码、账号类型拦截或按创建人隔离;无权与不存在遵循项目统一安全语义。
- 响应不包含 SQL、底层错误、永久对象访问凭证、Redis Key、预签名 URL、其他代理钱包余额或环境秘密。
- 新 Handler 同步后台路由及两个 OpenAPI 文档生成入口;DTO 枚举说明从公共常量原文复制并包含所有
status_name。 - HTTP 测试覆盖默认与最大分页、固定排序、状态与标识 AND 筛选、任务汇总、认证失效、跨创建人查询语义和安全字段边界。