wjq/PlantAI-rag-new
1
0
Fork 0
forked from admin/PlantAI-rag-new
Code Pull Requests Activity
Files
main
PlantAI-rag-new/docs/ACCEPTANCE.md
T
jerryandClaude Fable 5 0875bb036c P0/M1: 四部分重构——frontend→ui、backend→sdk 改名 + 引用修复 + 骨架 
- git mv 保留历史：ui/(Vue3+Vite)、sdk/(BFF 中间层)
- 路径语义修正：db_path/figures_cache 改相对 sdk/(BFF cwd)，
  历史库 sdk/backend/data 迁移至 sdk/data/(会话/图片缓存无损)
- 引用修复 ~15 处：config.py、deploy/*.sh、vitest/playwright 配置、
  单测导入路径、docs、README、gitignore、.env.example
- 骨架：agent/{qa,methodology,legacy-rag,vendor}、knowledge/manifest.yaml、
  tooling/{compile,kb,crypto,assemble,audit,tools,scripts} + README
- 门禁验证：sdk pytest 125 通过、ui vitest 158 通过、
  生产 BFF 脚本重启四上游全绿 + 静态托管 + 会话库无损

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-31 12:56:47 +08:00

3.3 KiB
Raw Permalink 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 路径解析（sdk/ui/dist → 项目根解析，2026-08-25 PM）

5. 结论

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

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

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