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

docs/northstar-layer-maps/01-data-ingestion.md

@@ -0,0 +1,41 @@
+# 北极星① 数据接入 — 一页纸逻辑地图
+
+> 定位：让数据进得来、进得对、进得全。任总10分钟消化层。
+
+## 数据流（箭头图）
+```
+财务软件(用友/金蝶/管家婆) ──R3调研中──┐
+Excel/手工录入 ──import-excel-smart──┤
+Bot写入 ──bot/kpi-value-with-check───┼─→ 数据源登记(value-sources)
+网银流水 ──cash/import/vouchers──────┤      ↓
+                                  数据质量检查(data-quality)
+                                      ↓
+                               KPI实际值归集(value-collect)
+                                      ↓
+                             进入CMA可分析数据池（KPI/预算/现金流）
+```
+
+## 关键API（核心5个）
+| 核心 | API | 作用 |
+|:--|:--|:--|
+| ⭐1 | `POST /data/import-excel-smart` | 智能导入Excel（含科目映射） |
+| ⭐2 | `POST /budget/value-collect/run` | 实际值自动归集 |
+| ⭐3 | `GET /data-quality/governance-check` | 数据治理检查（财务七规则） |
+| ⭐4 | `POST /cash/import/vouchers` | 凭证/流水导入 |
+| ⭐5 | `POST /bot/kpi-value-with-check` | Bot带校验写入KPI值 |
+
+## 决策点（需任总拍板 1-3个）
+1. 财务软件接口选型：接哪个软件（用友/金蝶/管家婆）→ R3调研后定
+2. 数据质量标准：治理检查评分阈值定多少（当前error-10/warning-5）
+3. 历史数据导入范围：导入多少个月的流水/凭证
+
+## 验证点
+- ✅ L1自动：data-quality/governance-check（脚本/cron每日）
+- ✅ L1自动：value-collect 归集正确性（幂等验证）
+- 🟡 L2 Bot验证：import-excel-smart 导入闭环（QA Bot造数验证）
+- 🔴 L3任总抽验：登录/切换企业/智能导入/治理检查 4项核心
+
+## 当前状态
+- ✅ 手工/Excel/Bot写入 已落地（2026-08-30）
+- ✅ 数据质量检查 已落地（财务七规则）
+- ⏳ 财务软件接口 调研中（R3，zhixiangtong适配器方案已出）

docs/northstar-layer-maps/02-multi-bot.md

@@ -0,0 +1,44 @@
+# 北极星② 多Bot互动 — 一页纸逻辑地图
+
+> 定位：14个Bot像同事一样读写CMA数据、协同干活。任总10分钟消化层。
+
+## 数据流（箭头图）
+```
+14Bot（研学/财务/项目/运维/创作/商务...）
+        │  bot/query  bot/kpis  bot/import
+        ▼
+   bot_bridge（A2A桥接层，X-BOT-KEY鉴权）
+        │  写：kpi-value-with-check / kpi-result / okr/create
+        │  读：budget/plans / cost/actual / okr/list
+        ▼
+   验证引擎（verify + bot-bridge/verify）
+        │  passed → 自动回填 + OKR联动 + 通知
+        │  failed → 打回Bot重试(≤3次) → 升级人工
+        ▼
+   CMA数据池（KPI/预算/OKR/ActionPlan）
+```
+
+## 关键API（核心5个）
+| 核心 | API | 作用 |
+|:--|:--|:--|
+| ⭐1 | `POST /bot/kpi-value-with-check` | Bot写KPI值+校验 |
+| ⭐2 | `GET /bot/overview` | Bot总览（各Bot权限内数据） |
+| ⭐3 | `POST /bot-bridge/verify/{plan_id}` | Bot侧轻量验证入口 |
+| ⭐4 | `POST /bot/okr/create` | Bot创建OKR |
+| ⭐5 | `POST /bot/import` | Bot批量导入 |
+
+## 决策点（需任总拍板 1-3个）
+1. Bot写入权限边界：哪个Bot能写哪些表（L1-L4分级已定，执行中）
+2. 验证失败打回策略：打回次数/升级阈值（当前默认3次）
+3. Bot间数据一致性：多Bot写同一KPI冲突时谁优先（唯一执行人铁律）
+
+## 验证点
+- ✅ L1自动：bot/iron-law 铁律KPI看板（每日聚合）
+- 🟡 L2 Bot验证：bot_bridge读写闭环（QA Bot造数验证）
+- 🔴 L3任总抽验：overview总览 / query查询 / 验证桥 3项核心
+
+## 当前状态
+- ✅ A2A + bot_bridge 已落地（14Bot互通）
+- ✅ verify引擎已上线（2026-08-30修复4缺陷，commit 6910d90）
+- ⏳ 失败打回Bot自动重试链路（cron残留修复派单中）
+- 🟡 Bot联合决策（同数据多Bot出结论）——中期规划

docs/northstar-layer-maps/03-data-finds-you.md

@@ -0,0 +1,50 @@
+# 北极星③ 数据找人 — 一页纸逻辑地图
+
+> 定位：异常和机会主动推送，不等任总来翻数据。任总10分钟消化层。
+
+## 数据流（箭头图）
+```
+CMA数据池（KPI/预算/现金流）
+        │
+        ▼
+  规则引擎（alert-rules + 动态阈值）
+        │  偏差>阈值 / 预测偏差 / 数据异常
+        ▼
+  预警中心（alerts：异常红/警告黄）
+        │  风险矩阵 / 超时升级
+        ├──────────────┐
+        ▼              ▼
+   AI分析（ai/ask、kpi-analysis、dashboard-analysis）
+        │              │
+        ▼              ▼
+   机会推送（预测向好/预算余量/滚动机会）──→  决策建议（ai/suggestions）
+        │                                        │
+        ▼                                        ▼
+   每日推送（企微）                       建议落地 apply → ④决策闭环
+```
+
+## 关键API（核心5个）
+| 核心 | API | 作用 |
+|:--|:--|:--|
+| ⭐1 | `GET /alerts` | 预警列表（异常+机会） |
+| ⭐2 | `POST /alert-rules/check-all` | 全量预警规则检查 |
+| ⭐3 | `POST /ai/suggestions` | AI决策建议生成 |
+| ⭐4 | `GET /dashboard/my-dashboard` | 工作台（数据找人入口） |
+| ⭐5 | `POST /predict/cash-forecast` | 现金流预测（提前预警） |
+
+## 决策点（需任总拍板 1-3个）
+1. 预警阈值校准：动态阈值（系统推荐）还是静态阈值（人工设定）？→ 建议动态+人工确认
+2. 推送频率：每日推送是否太频？红黄绿分级是否合理？
+3. AI建议落地权限：建议→KPI/预算/行动的"一键落地"是否需要二次确认（默认需要）
+
+## 验证点
+- ✅ L1自动：alert-rules/check-all（cron每日9:30）
+- ✅ L1自动：预测准确率（predict/accuracy 月度回测）
+- 🟡 L2 Bot验证：AI建议生成→落地闭环
+- 🔴 L3任总抽验：预警处理 / AI建议 / 工作台 / 现金流预测 4项核心
+
+## 当前状态
+- ✅ 异常预警（红黄绿）+ 偏差推送 已落地
+- ✅ AI建议生成 已上线（apply落地链路在④闭环）
+- ⏳ 机会推送扩大（R2：KPI向好/预算余量/滚动机会）——近期规划
+- 🟡 推送策略化（按角色/频率分级）——中期

docs/northstar-layer-maps/04-decision-loop.md

@@ -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）——近期重点
+- 🟡 决策复盘闭环（版本回滚+评审）——中期

docs/northstar-layer-maps/README.md

@@ -0,0 +1,44 @@
+# 北极星四层逻辑地图 — 阅读导航
+
+> 生成：项目Bot | 2026-08-31 | 目的：任总10分钟消化一层，398个API压缩成4张一页纸
+
+## 建议阅读顺序（从根到梢）
+```
+第1层：01-data-ingestion.md   ①数据接入 —— 数据怎么进来的（先懂源头）
+第2层：02-multi-bot.md        ②多Bot互动 —— 14个Bot怎么协同干活
+第3层：03-data-finds-you.md   ③数据找人 —— 数据怎么主动找任总
+第4层：04-decision-loop.md    ④决策闭环 —— 建议→决策→执行→留痕
+```
+
+## 四层关系一句话
+**数据进得来（①）→ Bot帮干活（②）→ 数据找人（③）→ 人拍板留痕（④）**，第④层闭环后新数据回流第①层，形成飞轮。
+
+## 每层核心API（每层5个，共20个=任总最该认识的）
+| 层 | 核心API | 一句话作用 |
+|:--|:--|:--|
+| ① | import-excel-smart | 智能导入Excel |
+| ① | value-collect/run | 实际值自动归集 |
+| ① | data-quality/governance-check | 数据治理检查 |
+| ② | bot/kpi-value-with-check | Bot带校验写KPI |
+| ② | bot-bridge/verify | Bot侧验证入口 |
+| ② | bot/overview | Bot总览 |
+| ③ | alerts | 预警列表 |
+| ③ | ai/suggestions | AI决策建议 |
+| ③ | predict/cash-forecast | 现金流预测 |
+| ④ | maps | 战略地图 |
+| ④ | okr | OKR目标 |
+| ④ | verify/{plan_id} | 自动验证闭环 |
+| ④ | action-plans | 行动方案跟踪 |
+
+## 验证分工（详见 api-verification-split.md）
+- 🔴 **L3 任总亲测 50个**（影响拍板的核心，唯一需要亲测的）
+- 🟡 L2 项目Bot/QA Bot 169个（业务流程闭环）
+- ✅ L1 脚本/cron 175个（数据完整性/计算正确性，异常才找人）
+
+## 当前系统状态速览
+| 层 | 状态 | 下一步 |
+|:--|:--|:--|
+| ①数据接入 | ✅手工/Excel/Bot | ⏳财务软件接口（R3调研中） |
+| ②多Bot互动 | ✅A2A+verify引擎 | ⏳失败打回自动重试 |
+| ③数据找人 | ✅异常预警+AI建议 | ⏳机会推送扩大（R2） |
+| ④决策闭环 | ✅全链路已落地 | ⏳AI建议一键落地（R1） |