23 lines
2.4 KiB
Markdown
23 lines
2.4 KiB
Markdown
# 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 筛选、任务汇总、认证失效、跨创建人查询语义和安全字段边界。
|
||
|