# 北极星四层逻辑地图 — 阅读导航

> 生成：项目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） |