docs: API验证分工表+北极星四层地图（项目Bot产出）

2026-08-31 07:44:27 +08:00
parent 136fe3811f
commit df93b635b3
6 changed files with 712 additions and 0 deletions
@@ -0,0 +1,51 @@
+# 北极星④ 决策闭环 — 一页纸逻辑地图
+
+> 定位：从建议到决策到执行到留痕，全链路可追溯。任总10分钟消化层。
+
+## 数据流（箭头图）
+```
+③数据找人推送的建议/预警
+        │
+        ▼
+  决策入口（战略地图 maps + OKR目标）
+        │  北极星四层泳道：财务/客户/流程/学习
+        ▼
+  决策落地（AI建议 apply → 预算/行动方案）
+        │  建议→写库+操作日志留痕
+        ▼
+  执行跟踪（ActionPlan 行动方案）
+        │  auto_verify 自动验证（规则引擎）
+        ▼
+  验证闭环（passed → 自动回填KPI + OKR进度 / failed → 打回重试≤3次）
+        │
+        ▼
+  复盘留痕（操作日志 + 版本快照 + 评审记录）
+        │
+        └────→ 回到①数据接入（新数据进池），形成PDCA飞轮
+```
+
+## 关键API（核心5个）
+| 核心 | API | 作用 |
+|:--|:--|:--|
+| ⭐1 | `GET /maps` | 战略地图（决策主画布） |
+| ⭐2 | `GET /okr` | OKR目标（KPI阈值=验证规则） |
+| ⭐3 | `POST /budget/versions/approve` | 预算版本审批（拍板点） |
+| ⭐4 | `POST /verify/{plan_id}` | 自动验证（规则引擎闭环） |
+| ⭐5 | `GET /action-plans` | 行动方案（决策执行跟踪） |
+
+## 决策点（需任总拍板 1-3个）
+1. 预算版本审批：年度预算编制完成→任总审批（versions/approve）→锁定
+2. 战略目标与预算差异：>10%黄 / >20%红，需说明原因（2026-08-27已拍板）
+3. 自动验证是否开启auto_close：默认false，防误闭环（已固化）
+
+## 验证点
+- ✅ L1自动：verify/{plan_id}（cron每日9:30，4缺陷已修复）
+- ✅ L1自动：预算偏差报告（deviation-report）
+- 🟡 L2 Bot验证：建议apply→预算/行动 落地闭环
+- 🔴 L3任总抽验：战略地图 / OKR / 预算审批 / 行动方案 4项核心
+
+## 当前状态
+- ✅ 战略地图+OKR+预算+行动方案 全链路已落地
+- ✅ verify引擎 4缺陷修复完成（2026-08-31 cron残留派单中）
+- ⏳ AI建议→一键落地（R1）——近期重点
+- 🟡 决策复盘闭环（版本回滚+评审）——中期