2026-09-01 14:02:53 +08:00

43 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 项目进度
当前阶段:Knowledge Retrieval Demo v0.1
已完成:DEMO-001、DEMO-002、DEMO-003
进行中:无
阻塞:无
下一任务:DEMO-004
完整 V1 待办将在 Demo Scope 完成后继续执行。当前任务顺序以
`docs/demo/DEMO_SCOPE.md` 为准。
## 任务记录
### DEMO-001
- 建立 Python 3.12/uv 工具链与依赖锁文件,新增 FastAPI 应用、类型化配置、
健康检查、OpenAPI 地址和可执行的 Make 命令。
- 新增可重复执行的单元测试、集成测试及 Evaluation 种子数据校验。
- 已验证格式、Lint、严格类型检查、测试、依赖锁、API 启动、健康检查响应及
版本化 OpenAPI 输出。
### DEMO-002
- 新增 canonical Document 元数据、简化的处理状态、SQLAlchemy 数据库/Session
工厂,以及首个只向前执行的 Alembic 迁移。
- 新增与 Provider 无关的 ObjectStorage 接口和本地适配器,支持禁止覆盖、拒绝
不安全路径并清理写入中断产生的半文件。
- 新增模型、数据库、存储、迁移及 Schema Drift 测试;无需连接生产数据库即可
验证 PostgreSQL 方言的迁移 SQL。
### DEMO-003
- 新增 PDF、DOCX、TXT、MD 单文件上传应用服务,完成文件名、扩展名、媒体类型、
空文件和流式大小限制校验。
- 上传使用 UUID 隔离的不可覆盖 storage key,并将原始文件与 `uploaded` 状态的
Document 元数据关联保存。
- 数据库写入失败时自动回滚并删除已保存文件;新增四类文件、拒绝规则、大小限制
和失败补偿集成测试。
- Parser 触发与公开上传 REST API 分别留在 DEMO-004 和 DEMO-009,不在本任务
提前实现。