Files
junhong_cmp_fiber/docs/unified-export-task-system/验收记录.md
huang fe4c545308
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 7m55s
修正数据
2026-04-27 18:10:08 +08:00

1.7 KiB
Raw Blame History

统一导出任务验收记录

1. 验收范围

  • 代码编译验证
  • 数据库迁移验证PostgreSQL MCP
  • OpenAPI 生成验证
  • 手工接口链路验证准备(受环境变量约束)

2. 已完成结果

2.1 编译结果

  • 命令:go build ./...
  • 结果:通过

2.2 OpenAPI 结果

  • 命令:go run cmd/gendocs/main.go
  • 结果:通过
  • 产物:docs/admin-openapi.yaml

2.3 数据库迁移结果

  • 命令:migrate -path migrations -database <...> up 1
  • 结果:135/u create_export_task_tables

2.4 PostgreSQL MCP 结构校验

已确认:

  • 存在 tb_export_task
  • 存在 tb_export_shard_task
  • 表注释和字段注释已生效

已确认索引:

  • idx_export_task_no(唯一,软删条件)
  • idx_export_task_scene_status_created_at
  • idx_export_task_creator_user_id
  • idx_export_task_creator_shop_id
  • idx_export_task_creator_enterprise_id
  • idx_export_shard_task_task_shard_no(唯一,软删条件)
  • idx_export_shard_task_task_status

3. 待手工执行项(环境阻塞)

以下项已准备 curl/Postman 清单与模板,但当前环境缺少 API 启动所需配置(JUNHONG_REDIS_ADDRESSJUNHONG_JWT_SECRET_KEY 等),暂未执行:

  • 接口契约验证(创建/列表/详情/取消)
  • 异步状态流转观察dispatch/shard/finalize
  • 两个场景(device / iot_card)各 xlsxcsv 完整导出
  • 取消场景回归(待处理取消、处理中取消、重复取消)

可复现命令与模板见:

  • docs/unified-export-task-system/手工验证清单.md
  • docs/unified-export-task-system/验收记录模板.md
  • docs/unified-export-task-system/验证数据样本.md