docs: 区域发病统计（#22）变更记录与开发交接记录

2026-08-13 08:56:35 +08:00
parent 9c5af92619
commit 1a6bcd27fe
2 changed files with 27 additions and 0 deletions
@@ -497,6 +497,26 @@

 ---

+## 2026-08-13 模块：区域发病统计（计划 #22）
+
+### 做了什么
+
+- `rooms.region` 字段 + `GET /trace-records/region-stats`（近 N 天按区域聚合）；Web 溯源页顶部柱状图 + 病种饼图；蚕房表单区域字段。
+
+### 思路与决策
+
+- 区域数据由蚕房管理录入（不自动解析位置字符串，避免误判）；
+- v1 用 ECharts 统计图表表达热力趋势；真正乡镇/县级地图（GeoJSON 底图 + 坐标）需要地图服务或离线数据，后续按需接入；
+- 聚合纯逻辑独立（分组/降序/空区域剔除），便于单测与前端复用。
+
+### 验证与部署
+
+- 2 组聚合单测（TDD 红→绿）；三端构建通过；
+- 2026-08-13 第一次部署（schema 变更前 pg_dump `silk-20260813-0010.dump`）；冒烟：SmokeTown total=2、DiseaseA/B 各 1；
+- 相关提交：`7949f90`（后端）、`9c5af92`（Web）；回滚见服务器 README。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）

 - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。