45 lines
2.1 KiB
Markdown
45 lines
2.1 KiB
Markdown
# 北极星四层逻辑地图 — 阅读导航
|
||
|
||
> 生成：项目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） |
|