docs: 项目规范文档+需求文档+CHANGELOG

2026-05-28 17:33:38 +08:00
parent 3dddd36866
commit f79db8ccba
6 changed files with 263 additions and 97 deletions
@@ -0,0 +1,33 @@
+# 战略回顾会
+
+> 在战略地图画布基础上，为CEO/财务总监提供周会月会用的复盘视图
+
+## 用户故事
+
+作为CEO/财务总监，我希望进入战略回顾会页面就能看到所有战略目标的红黄绿灯状态、KPI达成情况、改善行动进展，以便在周会月会上快速掌握全局异常并决策。
+
+## 功能列表
+
+- [x] 整体健康度卡片（绿色/黄色/红色目标数量+健康度百分比）
+- [x] 四维度矩阵展示（每个维度下的目标状态、关联KPI实际值/目标值）
+- [x] 需重点关注列表（红色/黄色目标按严重度排序）
+- [x] 改善行动进度表（状态、进度条、逾期标记）
+- [x] KPI详情弹出（实际值、目标值、达成率）
+- [x] 期间切换（本月/本季/本年）
+
+## 数据流
+
+1. 前端请求 `GET /maps/{id}/review`
+2. 后端从 `strategic_maps.dimensions` 读取目标和关联KPI编码
+3. 从 `kpi_definitions` + `kpi_values` 获取KPI定义和最新实际值
+4. 计算每个目标的红黄绿灯状态
+5. 从 `action_plans` 查询关联的改善行动
+6. 返回聚合数据
+
+## 验收标准
+
+- [x] 后端API返回完整的目标状态+KPI值+改善行动
+- [x] 前端页面正常渲染四个维度和目标卡片
+- [x] 红黄绿灯颜色正确
+- [x] 改善行动显示进度和逾期状态
+- [x] 支持从左侧栏直接进入和从画布跳转