test: 补充 WO-11 页面错误兜底测试

docs/MVP-WorkOrders.md

@@ -978,6 +978,26 @@ fix: 修复页面刷新和按钮点击的 500 错误
 
 - 用户需要提供或复现最容易触发 500 的页面 URL 与按钮名称；如果无法提供，则开发时先从当前浏览器打开的任务详情页开始排查。
 
+完成记录：
+
+- 完成日期：2026-07-03
+- 相关改动：
+  - 补充路由回归测试，覆盖任务详情页、热点报告页、内容详情页、导出接口在数据库 I/O error 下的 503 兜底。
+  - 补充缺失任务、缺失热点、缺失内容页面的 404 兜底测试，确保不是裸 500。
+  - 核查当前实现已有 `OperationalError` / `SQLAlchemyError` 全局 handler：API 返回 503 JSON，HTML 页面返回数据库不可用友好页。
+- 验证命令：
+  - `docker cp tests/. hot-comments-tool-app-1:/app/tests/`
+  - `docker exec hot-comments-tool-app-1 sh -lc 'python -m pytest /app/tests/integration/test_routes.py -q'`
+- 验证结果：
+  - `19 passed, 1 warning`
+- 验收结论：
+  - 已知高频页面路由和导出入口在数据库 I/O error 下不会返回裸 `Internal Server Error`。
+  - 缺失任务、热点、内容不会返回 500。
+  - 服务端日志仍保留异常信息，页面/API 返回可理解错误。
+- 遗留问题：
+  - 轮询接口偶发 503 时，前端当前只是静默返回，用户看不到“最近一次同步失败”提示；归入 WO-19 / WO-13 前端提示优化。
+  - 当前本机 Python `.venv` 仍未完成依赖安装，本轮测试通过运行容器执行。
+
 ### WO-12 导出 Markdown / CSV 点击失效修复
 
 优先级：P0