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

北极星① 数据接入 — 一页纸逻辑地图

定位：让数据进得来、进得对、进得全。任总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适配器方案已出）