Files
junhong_cmp_fiber/.scratch/ur36-bulk-package-purchase/issues/10-bulk-purchase-task-queries.md
2026-07-22 17:25:05 +09:00

2.4 KiB
Raw Blame History

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