feat: 优化导出文件质量

2026-07-03 15:29:55 +08:00
parent 11f129c4aa
commit b14834e806
5 changed files with 54 additions and 4 deletions
@@ -598,6 +598,27 @@ fix: 增强 SQLite 数据库恢复与异常提示
 feat: 优化导出文件质量
 ```

+完成记录：
+
+```text
+完成日期：2026-07-03
+相关 commit：feat: 优化导出文件质量
+验证命令：
+- .venv/bin/python -m pytest tests/unit/test_export.py tests/integration/test_routes.py::test_result_pages_render_seeded_data tests/integration/test_routes.py::test_report_pages_render_empty_state_when_report_missing tests/integration/test_routes.py::test_export_routes_return_csv_and_markdown -q
+- .venv/bin/python -m pytest tests/unit tests/integration -q
+- docker compose up -d --build
+- curl -f http://localhost:8000/health
+- 抽样检查内容 CSV UTF-8-BOM、CSV 列数、Markdown 总结章节和页面 downloadExport 按钮
+- .venv/bin/python -m pytest tests/unit tests/integration --cov=app --cov-branch --cov-report=term-missing
+验收结论：
+- CSV 导出已覆盖 =、+、-、@ 公式注入前缀防护。
+- CSV 导出会替换 \n、\r、\r\n，避免单条评论破坏行结构。
+- CSV 导出使用 UTF-8-BOM，抽样文件以 BOM 开头。
+- 热点/内容报告和评论导出按钮使用 downloadExport，报告缺失时 Markdown 按钮置灰并提示“报告尚未生成”。
+- Markdown 导出读取预生成 report.markdown_content，抽样包含“## 总结”章节。
+遗留问题：评论为空时 CSV 仍返回只有表头的文件，后续可在 WO-09 文档说明空文件语义。
+```
+
 ### WO-08 Docker 与部署前清理

 优先级：P1