Hermes CI Fix
ad68471b29
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
33 lines
2.0 KiB
Markdown
33 lines
2.0 KiB
Markdown
# 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 字段）
|
||
- [ ] 全栈实现"智享通导入适配器"（模板映射+校验）
|