feat: 路线图R1决策建议一键落地+R2机会推送+R5预算闭环

R1(P0): AI建议一键应用到KPI/预算/行动方案 - 新表 ai_suggestions + AISuggestion 模型(init_db自动建) - /api/cma/ai/suggestions CRUD + /{id}/apply(复用kpis/budget/action_plans) + dismiss - 应用写 OperationLog(action=ai_suggestion_apply, detail含suggestion_id/before/after) - 规则驱动建议生成 generate_rule_suggestions(低执行率/高执行率/预算超支/pending预警) - 幂等: 同entity+type+target_id+title+unapplied不重复建; applied后拒绝重复应用 - 前端: Dashboard AI面板建议卡(应用到/忽略) + 建议中心页 /ai-suggestions R2(P1): 数据找人扩大-机会类推送 - scripts/opportunity_detector.py: KPI向好(执行率>110%)/预算余量(<70%且actual>0)/预测上行 - scripts/daily_push.py: 异常+机会每日9:15推企微(8800/send, --dry-run调试) - crontab: 15 9 * * * (alert_generator 9:00之后) R5(P0): 预算闭环加固 - auto-decompose批量幂等: 只取年度行(period=YYYY-00)+同KPI多版本取一行 - scripts/closed_loop_check.py: 预算执行率异常→检查现金流/行动同步→缺失提示+报告 - scripts/verify_decompose_idempotent.py: 幂等验证脚本测试: test_ai_suggestions(10例)+test_roadmap_r2r5(14例); 修test_budget幂等契约适配年度行全量: 673 passed
2026-08-30 12:05:36 +08:00
parent 5b920df8a0
commit ad68471b29
22 changed files with 2170 additions and 25 deletions
@@ -0,0 +1,84 @@
+# CMA 产品愿景与实施路线图 v1.0（2026-08-30 固化）
+
+> 提出：任富海 | 整理：项目Bot | 状态：✅ 已确认（北极星）+ 战略全景（8方向）
+
+## 一、产品愿景（北极星）
+
+**一句话**：CMA = 管理会计操作系统——数据接入(接口/手工) → 多Bot互动数据 → 数据找人(主动) → 决策建议 → 决策修改+检查(闭环可审计)。
+
+**四层北极星**：
+```
+① 数据接入(财务软件接口/手工录入)
+   ↓
+② 多Bot互动(14Bot协作处理数据)
+   ↓
+③ 数据找人(异常+机会主动推送)
+   ↓
+④ 决策建议 → 决策修改+检查(闭环)
+```
+
+**价值主张**：让管理团队从"被数据淹没"到"数据找人、人做决策、决策留痕"——每项决策可追溯（谁/何时/依据什么/结果如何）。
+
+## 二、战略全景（8 补充方向）
+
+| 方向 | 定位 | 优先级 |
+|:--|:--|:--:|
+| A 产品化/商业化 | CMA→可交付产品（SaaS/私有/实施） | 🔴 |
+| B 行业纵深 | 白酒经销→贸易→制造（行业包） | 🟠 |
+| C 数据资产化 | 博海+客户数据→数据产品（DAMA治理） | 🟠 |
+| D 决策智能 | 提建议→预测决策（敏感性/因果/复盘） | 🔴 |
+| E AI原生组织方法论 | **护城河**：14Bot/铁律/闭环体系产品化 | 🟡 |
+| F 生态联盟 | 财务软件对接（用友/金蝶）+渠道 | 🟡 |
+| G 信任合规 | PIPL/等保/AI可信/审计链 | 🟠 |
+| H 技术前瞻 | 数字员工/AI同事/Agent自动执行 | 🟡 |
+
+## 三、实施路线图（按优先级）
+
+### 🔴 近期（1-3个月）——北极星核心闭环
+| # | 方向 | 目标 | 关键动作 | 验收 |
+|:--|:--|:--|:--|:--|
+| R1 | ④决策智能 | AI建议→一键落地 | ai_analysis 建议可"应用到KPI/预算/行动"（写库+留痕） | 建议生成→点击落地→操作日志可查 |
+| R2 | ③数据找人 | 主动推送扩大 | 机会/趋势推送（不止异常）：KPI向好/预算余量/滚动机会 | 每日推送含异常+机会两类 |
+| R3 | ①数据接入调研 | 财务软件接口方案 | 调研用友/金蝶/管家婆开放API+实施成本 | 接口可行性报告 |
+| R4 | A产品化准备 | 酣客试点成案例 | 试点数据闭环+试点报告（作首个客户案例） | 案例文档+官网可引用 |
+| R5 | 预算bug修复链 | 系统稳定 | 年度分解幂等+预算/现金流/行动闭环加固 | pytest全绿 |
+
+### 🟠 中期（3-6个月）——产品化+合规
+| # | 方向 | 目标 | 关键动作 | 验收 |
+|:--|:--|:--|:--|:--|
+| M1 | A产品化 | CMA可交付形态 | SaaS多租户完善/私有部署包/实施文档 | 第2-3个客户可用 |
+| M2 | B行业复制 | 白酒经销行业包 | 行业KPI库/OKR模板/科目模板校准（酣客数据） | 行业包v1 |
+| M3 | G合规 | 信任背书 | 数据安全分级/PIPL清单/审计链完善 | 合规清单 |
+| M4 | ①数据接入落地 | 财务软件接口 | 按R3方案接入1个财务软件 | 接口联调通过 |
+
+### 🟡 远期（6-12个月）——方法论+生态
+| # | 方向 | 目标 | 关键动作 | 验收 |
+|:--|:--|:--|:--|:--|
+| F1 | E方法论 | AI原生组织产品 | 评估+实施+运营三件套方法论文档化 | 方法论v1可售 |
+| F2 | F生态 | 渠道伙伴 | 代账/咨询/本地IT渠道首批 | 3家伙伴 |
+| F3 | H前瞻 | 数字员工试点 | AI同事（自动执行例行决策）试点 | 试点报告 |
+| F4 | D完整版 | 预测性成本智能完整 | 宏观数据回归校准+预测偏差告警完善 | IMA对标 |
+
+## 四、依赖与飞轮
+
+```
+R4酣客案例 → M1产品化 → F1方法论 → F2生态
+     ↑____________↑___________________↓
+          数据/案例反哺（B行业包）
+```
+
+**飞轮起点**：近期 R1-R5（决策闭环+稳定+案例）——先让内部系统达到"决策可落地可追溯"，再谈产品化。
+
+## 五、北极星四层 → 落地项（映射）
+
+| 层 | 近期 | 中期 | 远期 |
+|:--|:--|:--|:--|
+| ①数据接入 | R3调研 | M4接口落地 | 多软件适配 |
+| ②多Bot互动 | 保持 | Bot联合决策 | Agent自动执行(F3) |
+| ③数据找人 | R2推送扩大 | 推送策略化 | AI同事(F3) |
+| ④决策闭环 | R1建议落地+R5稳定 | 决策复盘闭环 | 预测决策(F4) |
+
+## 六、节奏建议
+- **月度检查点**：每月对照路线图验收（R/M/F 项完成度）
+- **北极星校验**：每季度问"数据找人了吗？决策落地了吗？可追溯吗？"
+- **资源配置**：近期全栈Bot集中 R1/R2/R5（代码）；项目Bot R3调研+R4案例（方案）
@@ -0,0 +1,26 @@
+# CMA 路线图近期任务清单（R1-R5，2026-08-30 派单）
+
+> 依据：docs/cma-product-vision-roadmap-v1.md 近期🔴项
+
+## 已派全栈Bot（代码执行）
+
+| 任务 | 内容 | 优先级 |
+|:--|:--|:--:|
+| **cma-roadmap-r1r2r5-20260830.md** | R1 AI建议→一键落地（应用KPI/预算/行动+留痕）<br>R2 数据找人扩大（机会类推送：KPI向好/预算余量）<br>R5 预算闭环加固（年度分解幂等确认+闭环自检） | P0/P1 |
+| **data-quality-api-plus-v72-20260830.md** | ⓪预算年度分解累加bug（P0）<br>①数据质量API 7规则<br>②扫描脚本v7.2补做<br>③执行人中文名兼容 | P1 |
+
+## 项目Bot负责（方案/调研/案例）
+
+### R3 财务软件接口调研（✅ 已完成初步结论）
+- **结论：可行**——用友/金蝶云有开放平台API（标准连接器），管家婆有API（erp.btype.list等），金蝶云星空支持表单查询/保存/提交/审核
+- 2026 ERP API 开放性评估：用友/金蝶表现突出
+- **待确认**：酣客实际使用哪套财务软件（用友/金蝶/管家婆/其他）→ 决定先接哪个适配器
+
+### R4 酣客试点成案例（⏳ 待数据确认）
+- 方案已出：docs/hanke-pilot-plan-20260829.md（3天节奏）
+- 待你确认：KPI目标值 / 真实实际值来源 / 节奏
+- 完成后产出：试点报告 = 首个客户案例（产品化飞轮起点）
+
+## 执行顺序建议
+1. 全栈：先修 ⓪ 预算分解bug（P0，用户已遇到）→ R1（决策闭环核心）→ R2/R5/数据质量
+2. 项目Bot：R3 等你告知酣客财务软件 → R4 试点数据确认
@@ -0,0 +1,79 @@
+# CMA 战略愿景全景规划（2026-08-30）
+
+> 提出：任富海 | 整理：项目Bot | 北极星：**数据接入→多Bot互动→数据找人→决策建议→决策修改检查**（四层愿景已确认）
+
+## 一、北极星愿景（已确认，四层）
+
+```
+① 数据接入(财务软件接口/手工录入)
+   ↓
+② 多Bot互动(14Bot协作处理数据)
+   ↓
+③ 数据找人(异常+机会主动推送)
+   ↓
+④ 决策建议 → 决策修改+检查(闭环可审计)
+```
+
+## 二、补充战略方向（8个，超越功能层面）
+
+### A. 产品化与商业化（🔴 最高优先级——让能力变现）
+- 现状：CMA 是内部系统，但官网已有 6 服务模块（含AI智能体/数据治理）可承接
+- 方向：CMA → 可交付产品（SaaS/私有部署/实施服务三模式）
+- 抓手：酣客试点成功 = 首个可复制案例；行业包 4 类（trading/it_service/manufacturing/general）已具雏形
+
+### B. 行业纵深复制
+- 白酒经销(酣客) → 贸易/流通 → 制造业/服务业
+- 每个行业：KPI库/OKR模板/科目模板/预警规则 行业包（已有基础）
+- 案例链：酣客成功 → 同行业客户 → 跨行业
+
+### C. 数据资产化
+- 博海自身资产：知识库/文章/系统数据 → 数据产品
+- 客户侧：DAMA 数据治理服务（官网已上线）→ 治理→增值
+- 企业数据资产盘点方法论 = 可售服务
+
+### D. 决策智能升级（北极星④的深化）
+- 从"提建议"→"预测决策"：敏感性/情景模拟（已雏形）→ 完整预测性成本智能（IMA）
+- 因果链验证（已建）→ 决策优化建议
+- AI 复盘 → 组织学习闭环
+
+### E. AI 原生组织方法论（差异化护城河）
+- 博海自身 = AI 原生组织样板（14Bot/铁律/闭环）
+- 对外输出"AI 原生组织落地方法论"（评估+实施+运营）
+- 这是竞品（传统财务软件商）无法快速复制的能力
+
+### F. 生态与联盟
+- 财务软件生态：对接用友/金蝶/管家婆（当前**未接**，北极星①的关键缺口）
+- 渠道伙伴：代账公司/咨询公司/本地IT服务商
+- 区域深耕：陕西本地企业数字化
+
+### G. 信任与合规（销售必要条件）
+- 数据安全：PIPL/等保/数据分类分级
+- AI 可信：RAG幻觉治理（Recall 100%已证）+ 验证铁律 = 可信AI叙事
+- 审计链：操作日志/决策留痕（已有）
+
+### H. 技术前瞻
+- 数字员工：AI 同事（分域扫描已发现 CopilotKit/OpenBot 趋势）
+- Agent 自动执行：决策→自动调度 Bot 执行（北极星②④融合）
+- 预测智能：KPI趋势/宏观敏感性（已上线 MVP）→ 完整版
+
+## 三、战略优先级与时间线
+
+| 阶段 | 方向 | 关键动作 |
+|:--|:--|:--|
+| **近期(1-3月)** | A产品化 + D决策智能 + 北极星① | 财务软件接口调研；AI建议→行动一键落地；酣客试点成案例 |
+| **中期(3-6月)** | B行业复制 + G合规 | 白酒经销行业包完善；数据安全/等保认证；第2-3个客户 |
+| **远期(6-12月)** | E AI原生组织 + F生态 + H前瞻 | AI原生组织方法论产品化；渠道伙伴；数字员工/AI同事产品 |
+
+## 四、北极星落地路线（四层 → 实施项）
+
+| 层 | 当前状态 | 下一步 |
+|:--|:--|:--|
+| ① 数据接入 | 手工/Excel/Bot | **财务软件接口**（用友/金蝶/管家婆适配器） |
+| ② 多Bot互动 | A2A/bot_bridge已有 | Bot联合决策（同数据多Bot出结论） |
+| ③ 数据找人 | 预警/偏差/预测告警 | 主动推送扩大（机会+趋势，不止异常） |
+| ④ 决策闭环 | 复盘持久化刚补 | **AI建议→一键落地**（建议落到KPI/预算/行动）+审计 |
+
+## 五、关键洞察
+1. **护城河不是 CMA 功能，是"AI原生组织方法论"**（E）——我们自己在用的整套体系（Bot协作/铁律/闭环/验证）就是最强差异化产品
+2. **产品化（A）是其他一切的前提**——案例→行业包→方法论→生态
+3. **北极星①（财务软件接口）是技术最大缺口**——直接影响"数据接入"自动化
@@ -0,0 +1,32 @@
+# R3 财务软件接口调研（智享通·友加畅捷）2026-08-30 结论
+
+> 酣客实际财务软件：**智享通**（成都友加畅捷，youjiasoft.com）
+
+## 一、产品画像
+- 公司：成都友加畅捷科技有限公司
+- 产品线：U+通用财务 / T1飞跃（进销存+财务）/ U+分销 / U+云商(SaaS) / U+移动
+- **架构：本地 C/S 部署**（T1飞跃明确 C/S 架构）——非云 SaaS
+- **开放 API：官网无开发者平台/公开API文档**（对比用友/金蝶有开放平台）
+
+## 二、对接路径评估（3选1）
+
+| 路径 | 说明 | 可行性 | 工作量 |
+|:--|:--|:--|:--|
+| **A. Excel导出→CMA导入** ✅推荐 | 智享通导出科目余额/凭证Excel → CMA现有导入（data import已建） | 🟢 **零开发可用** | 0.5天（模板映射） |
+| B. 数据库直读 | 本地部署 DB（SQL Server等）直接读财务数据 | 🟡 需账套密码+技术配合 | 2-3天 |
+| C. 官方API | 联系友加畅捷确认是否有接口 | 🟠 官网未见，需商务确认 | 不确定 |
+
+## 三、推荐方案（北极星①落地路径）
+**阶段一（立即）**：方案 A——财务每月导出科目余额/凭证 Excel → CMA 导入 → KPI 实际值自动更新
+- CMA 已有 import-excel 能力（data.py/bot_bridge），只需**模板映射**（智享通导出列 → CMA 科目/KPI）
+- 实现：建"智享通导出模板"映射表（科目编码→KPI/科目）+ 导入验证
+
+**阶段二（可选）**：方案 B/C——财务数据量大了再评估直读/官方接口
+
+## 四、影响
+北极星①"财务软件接口"对智享通的现实路径 = **导出导入（半自动）** 而非 API 直连（软件无开放API）。这是中小财务软件的现实——CMA 以"导入适配器"覆盖，不依赖厂商 API。
+
+## 五、待办
+- [ ] 向酣客财务要一份**智享通导出样例**（科目余额/凭证 Excel 各一）
+- [ ] 建映射模板（样例列→CMA 字段）
+- [ ] 全栈实现"智享通导入适配器"（模板映射+校验）