release: 标记 MVP 演示候选版本

2026-07-03 15:35:51 +08:00
parent a8f5eeaff5
commit 867fd39419
1 changed files with 28 additions and 0 deletions
@@ -774,6 +774,34 @@ docs: 补充本地验收和部署说明
 release: 标记 MVP 演示候选版本
 ```

+完成记录：
+
+```text
+完成日期：2026-07-03
+相关 commit：release: 标记 MVP 演示候选版本
+验证命令：
+- .venv/bin/python -m pytest tests/unit tests/integration -q
+- .venv/bin/python -m pytest tests/unit tests/integration --cov=app --cov-branch --cov-report=term-missing
+- curl -f http://localhost:8000/health
+- docker compose ps
+- docker compose exec -T app python 检查 PRAGMA integrity_check 与 wal_checkpoint(TRUNCATE)
+- 抽样检查任务详情页、热点报告页、内容详情页、CSV 导出、Markdown 导出
+发布候选验收结论：
+- 自动化测试：87 passed, 1 warning。
+- 覆盖率：TOTAL 90%；重点模块 app/platforms/douyin.py 87%、app/platforms/xiaohongshu.py 83%、app/services/ai_service.py 95%、app/services/report_service.py 91%、app/services/export_service.py 92%。
+- Docker：hot-comments-tool-app-1 运行在 http://localhost:8000，health 返回 ok。
+- 数据库：integrity_check=ok，wal_checkpoint(TRUNCATE)=True。
+- 小红书小规模 1×1×10：8ae106f4-64dc-4675-a021-f78092926ce6，success，内容 1/1，AI 成功率 100%。
+- 抖音小规模 1×1×10：b295f4b2-d546-4121-99bc-48d166d86bf4，success，内容 1/1，AI 成功率 100%。
+- 小红书默认规模 5×5×50：4bdf36df-8ae4-4059-af98-602f4872dbaa，success，内容 25/25，评论 119，报告 30，AI 成功率 100%。
+- 抖音默认规模 5×5×50：378b173a-a70f-4da1-b235-03e7632e614a，success，内容 20/20，评论 285，报告 25，AI 成功率约 82.46%。
+- 页面主链路：任务详情、热点报告、内容详情均可访问并展示 AI 总结、情绪分布、标签、典型评论和评论明细。
+- 导出链路：CSV 带 UTF-8-BOM 且列结构正常，Markdown 包含“## 总结”章节。
+已知问题：
+- 默认规模评论数低于理论上限 1250，原因判断为真实平台/接口返回不足，不是任务失败。
+- app/platforms/base.py 覆盖率为 76%，低于 80%，但不在本轮重点模块清单内；后续可针对网络错误和解析边界继续补测。
+```
+
 ## 9. 新问题处理规则

 验收时发现新问题，先判断归属：