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,36 @@
+# 个人工作台
+
+> 为每个用户提供个人维度的KPI看板、改善行动和待办提醒
+
+## 用户故事
+
+作为业务经理/财务人员，我希望登录后第一眼看到我负责的KPI状态、我的改善行动进展，以及需要我处理的待办事项，以便快速开始一天的工作。
+
+## 功能列表
+
+- [x] 我的KPI列表（红黄绿灯+进度条+实际值/目标值）
+- [x] 我的改善行动（状态、进度、逾期标记）
+- [x] 待办提醒（逾期行动+红色预警KPI）
+- [x] 角色预设KPI（CEO/财务/业务各有内置关键指标）
+- [x] 首次登录自动弹出引导遮罩
+
+## 数据流
+
+1. 前端请求 `GET /dashboard/my-dashboard`
+2. 后端匹配 `kpi_definitions.responsible_user` 拿到我的KPI
+3. 补充角色预设KPI（从 `ROLE_PRESET_KPIS` 定义中读取）
+4. 从 `action_plans.assignee` 匹配我的改善行动
+5. 计算逾期和红黄灯生成待办提醒
+
+## 验收标准
+
+- [x] 页面展示用户关联的KPI
+- [x] 页面展示用户关联的改善行动
+- [x] 待办提醒准确（逾期红色、预警黄色）
+- [x] 无关联KPI时显示预设指标
+
+## 后续扩展
+
+- 管理员可配置每个角色的预设KPI列表
+- 增加周报提交功能
+- 增加日历待办视图