docs(v2): add migration and api schema drafts

This commit is contained in:
phamnazage-jpg
2026-05-22 13:43:46 +08:00
parent 485b6e7a6b
commit 9cdb7e1112
3 changed files with 769 additions and 2 deletions

View File

@@ -148,6 +148,8 @@
**文档**`docs/2026-05-21-BATCH_AUTO_IMPORT_SPEC.md`(需求规格)
**TDD 计划**`docs/2026-05-21-BATCH_AUTO_IMPORT_TDD_PLAN.md`(实现路径,已确认开放问题)
**技术架构**`docs/2026-05-22-BATCH_AUTO_IMPORT_V2_ARCHITECTURE.md`运行态状态库、结果页、API、页面字段布局
**Migration 草案**`docs/2026-05-22-BATCH_AUTO_IMPORT_V2_MIGRATION_DRAFT.md`SQLite 新表、索引、lease/retry 字段、legacy link
**API Schema 细稿**`docs/2026-05-22-BATCH_AUTO_IMPORT_V2_API_SCHEMAS.md`run/item 响应结构、筛选参数、badge 文案、错误语义)
**本轮设计收敛**
- 已把真实验收中的三类高频问题写入 v2 方案:
@@ -169,8 +171,9 @@
- OpenAPI 已补齐 `/api/batch-import/runs*`legacy `/api/import-batches/*` 降级为 v1/legacy
**当前剩余项**
- [ ] 按收口后的 canonical contract 输出数据库 migration 草案
- [ ] 按收口后的 OpenAPI 与 projection 字段开始实现
- [x] 按收口后的 canonical contract 输出数据库 migration 草案
- [x] 补齐 run/item API response schema 细稿
- [ ] 按收口后的 OpenAPI、migration、projection 字段开始实现
- [ ] 进入实现前再做一次实现前审阅,确认没有新增分叉
**实现前 Gate**:文档级 review 问题已收口,当前可以进入“按文档写 migration / 接口 / worker”的实现准备阶段