Initial commit: QMDSearch 分层信息检索服务

- FastAPI + Qdrant + Redis + Ollama 技术栈
- L1→L2→L3→chunk 四层分层检索（dense + sparse RRF 融合）
- 文档三级总结与 2.5 级回退
- query 解析路由与分类
- /admin 管理页面

.trae/specs/add-async-ingest-tasks/checklist.md

@@ -0,0 +1,31 @@
+# Checklist
+
+## 配置与任务管理器
+
+- [x] config 含 ingest_max_concurrency(默认 2)/ingest_task_ttl_done(默认 86400)/ingest_task_ttl_failed(默认 604800)，.env.example 同步
+- [x] submit 返回 task_id 且状态初始 pending；后台任务按信号量限流（超额保持 pending）
+- [x] 状态机按流水线阶段推进：pending→summarizing→classifying→embedding→writing→done
+- [x] 成功后 result 为完整 IngestionResult；失败 error 含 stage 与 message，partial_summary（已产出总结）保留
+- [x] 状态写 Redis：done TTL 24h、failed TTL 7 天；Redis 故障降级内存字典且接口不报错
+
+## API
+
+- [x] POST /api/v1/documents 合法请求返回 HTTP 202 + {task_id, status:"pending"}，不再同步等待流水线
+- [x] POST 空文本等校验失败仍同步返回 code=1001（不进任务队列）
+- [x] GET /api/v1/documents/tasks/{task_id} 返回状态/时间戳；done 附 result；failed 附 error.stage/message
+- [x] 查询不存在 task_id 返回 code=1004
+- [x] 既有入库相关测试全部适配新契约且通过
+
+## 管理页面
+
+- [x] 入库提交后展示 task_id 与状态，2s 轮询直至 done/failed
+- [x] done 展示 category/置信度/tags/总结层级/chunks_count；failed 展示 stage 与 message
+- [x] 轮询期间禁止重复提交；5 分钟超时停止轮询并提示
+- [x] 页面测试覆盖 tasks 轮询路径与新交互标记
+
+## 集成与文档
+
+- [x] 内存闭环：提交→轮询 done→GET /documents/{doc_id} 可查→检索命中→删除 全通
+- [x] 失败路径：FakeOllama 抛错 → 任务 failed、stage 正确、failed TTL=7 天
+- [x] CLAUDE.md API 清单反映 POST /documents 202 异步与任务查询端点
+- [x] `uv run pytest` 全部通过；`uv run ruff check app tests scripts` 无错误