admin/PlantAI-rag-new
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1e94de7464de13a99cdac0f63afed7a929ad8c9f
PlantAI-rag-new/docs/ACCEPTANCE.md
T
jerryandClaude Fable 5 1e94de7464 PlantAI-rag-new 首次提交：文献知识工作台 
- BFF 薄适配层（FastAPI，8090）：QA 代理/SSE 中继/Neo4j 直连/抽取代理/会话持久化
- Vue3 前端：五相位检索流水线、文献来源与证据链、知识图谱、提取任务四 tab
- 四档响应式（桌面/笔记本/平板/手机）、深浅主题
- 81 个 FR 全部实现，测试追溯矩阵 81/81，后端 121 测/前端 156 测
- 真实凭据已脱敏，运行时配置在 backend/.env（不入 git）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-25 20:47:52 +08:00

3.4 KiB
Raw Blame History

ACCEPTANCE.md —— M5 最终验收记录

验收人：PM ｜ 日期：2026-08-25 ｜ 结论：通过

1. 验收范围与结果

验收项 结果 证据
生产形态（BFF 静态托管单进程） ✅ :8090/ 渲染 AppShell、同源 /api/health 200、无 JS 错误
桌面：真实 SQLite 会话列表 ✅ 7 条会话（T 已清理测试污染数据）
桌面：历史恢复（markdown/相位卡/引用） ✅ 相位卡 5/5 done 恢复、md-text 渲染、引用 chip → 来源 tab 高亮定位
真实问答全链路 ✅ 五相位终态全 done、答案 698 字、内联引用 chip 4 个、无 JS 错误
三档视口档位 ✅ mobile（drawers-mode+mobile+has-tools）/ tablet（drawers-mode）/ desktop 全正确
自动化验收脚本 ✅ deploy/m5_acceptance.js 15/15 通过

历史验收基线（前序里程碑，全部通过）：

  • M2 deploy/m2_e2e.js 12/12（真实端到端 + 刷新恢复 + 相位推进）
  • M3 deploy/m3_e2e.js 16/16（真实 KG 浏览 + 抽取 + 三档交互 + 主题）
  • M4 R2 全量：后端 121/121（行覆盖 87%）、前端 156/156（80.59%）、Playwright 48 条（35 pass/12 skip 依赖充值/1 环境性 flake 复跑通过）、上游 smoke 7/7、FR 追溯 81/81 双向零失配

2. 测试门禁终态

门禁 要求 实际 判定
FR→TC 追溯矩阵 81/81 双向完整 81/81 零失配 ✅
后端行覆盖 ≥85% 87% ✅
前端行覆盖 ≥80% 80.59% ✅
产品缺陷 0 未修复 R1 的 8 项全部修复并在 R2 确认 ✅

3. 已知限制（验收时明确，不视为缺陷）

  1. DeepSeek LLM 余额用尽（402） 已于 2026-08-25 解决：换用 PlantAI-dev 的 NEW_API_KEY（余额充足），QA 服务经官方脚本 start_plantAI_RAG.sh 重启后自然语言答案完全恢复（实测：PlantAI-rag-new 答案 1379 字 + 15 来源；PlantAI-dev 答案 2671 字 + 14 来源，超时配置提至 600s）。详见 CHANGELOG「DeepSeek 恢复与 QA 修复」。
  2. 上游 QA 无 token 级流式：打字机为客户端揭示动画（设计内既定）。
  3. 每次提问独立检索（max_rounds:1），无多轮上下文（设计内既定）。
  4. 移动端覆盖层内 BenchPanel 自带 tab 已 CSS 隐藏，以外壳 tab 条为准（已验收）。
  5. Laptop 档（1024–1279px）无独立 Playwright project（T 遗留建议，不影响验收；该档行为已由 CSS + AppShell 逻辑覆盖并经人工走查）。

4. 验收执行记录

  • 验收脚本：deploy/m5_acceptance.js（15 断言，chromium headless）
  • 运行位置：远端（真实 BFF 8090 生产形态 + Vite 5180 开发形态双链路）
  • 用时：约 3 分钟（含一次真实 QA ≈ 50s）
  • 期间修复：BFF 静态托管 dist 路径解析（backend/frontend/dist → 项目根解析，2026-08-25 PM）

5. 结论

PlantAI-rag-new 通过最终验收。 所有需求功能点（PRD 81 FR）有测试覆盖且通过；生产形态可部署；三档视口可用；外部依赖（DeepSeek 余额）恢复后无需任何代码改动即可获得完整体验。

下一步建议（用户决策，不在本次范围）：

  • DeepSeek 充值 → 验证自然语言答案质量
  • 长期运行监控（/api/health 轮询、上游探活）
  • 可选：laptop 档 E2E project 补齐、tests/backend L2 respx 独立测试
Reference in New Issue View Git Blame Copy Permalink