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,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向好/预算余量/滚动机会）——近期规划
+- 🟡 推送策略化（按角色/频率分级）——中期