jerryandClaude Fable 5
1e94de7464
- 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>
53 lines
3.4 KiB
Markdown
53 lines
3.4 KiB
Markdown
# 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 独立测试
|