kplam
51dc8dc4f6
- FastAPI + Qdrant + Redis + Ollama 技术栈 - L1→L2→L3→chunk 四层分层检索（dense + sparse RRF 融合） - 文档三级总结与 2.5 级回退 - query 解析路由与分类 - /admin 管理页面
19 lines
1.7 KiB
Markdown
19 lines
1.7 KiB
Markdown
# Tasks
|
||
|
||
- [x] Task 1: 配置 + IngestTaskManager：config 新增 ingest_max_concurrency/ingest_task_ttl_done/ingest_task_ttl_failed 与 .env.example 同步；新建 app/core/ingest_tasks.py——submit(doc)→task_id、asyncio 信号量限流后台执行、状态机（pending→summarizing→classifying→embedding→writing→done/failed）、Redis 主存储（failed TTL 7 天）+ Redis 故障降级进程内字典、get(task_id) 查询；单测（FakeIngester 成功/失败/IngestionError.stage 透传/partial_summary 保留/并发限流/Redis 降级）
|
||
- [x] SubTask 1.1: 配置项 + .env.example
|
||
- [x] SubTask 1.2: IngestTaskManager 实现 + 单测
|
||
- [x] Task 2: API 改造：POST /api/v1/documents 改 202 返回 {task_id,status}（校验失败仍同步 1001）；新增 GET /api/v1/documents/tasks/{task_id}（不存在 1004）；适配既有 test_document_api.py 与 test_e2e_integration.py 中入库断言为新契约；新增 tests/test_ingest_task_api.py
|
||
- [x] Task 3: 管理页入库区块改造：提交→展示 task_id 与状态→2s 轮询→done 展示结果/failed 展示 stage+message→轮询期禁重复提交→5 分钟超时提示；更新 test_admin_page.py 断言（含 tasks 轮询路径）
|
||
- [x] Task 4: 集成验证 + 文档：内存 Qdrant + FakeOllama 走通 提交→轮询至 done→文档可检索→删除 闭环；失败路径（FakeOllama 抛错）状态 failed 且 stage 正确；Redis 降级路径可用；CLAUDE.md API 清单更新（POST /documents 标注 202 异步、新增任务查询端点）；`uv run pytest` 全绿 + ruff 通过
|
||
|
||
# Task Dependencies
|
||
|
||
- [Task 2] depends on [Task 1]
|
||
- [Task 3] depends on [Task 2]
|
||
- [Task 4] depends on [Task 3]
|
||
|
||
# Parallelizable
|
||
|
||
- 各任务串行依赖，无并行项
|