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

1.7 KiB
Raw Permalink Blame History

项目进度

当前阶段: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,不在本任务 提前实现。