Hermes CI Fix
3dddd36866
包含前后端完整代码： - 前端：Vue3+Vite+ElementPlus - 后端：FastAPI+SQLAlchemy - 模块：驾驶舱/KPI/战略地图/预警/预算/成本/预测/改善行动 - 当前版本：v1.0.0
240 lines
7.7 KiB
Markdown
240 lines
7.7 KiB
Markdown
# 管理会计OS — 工单列表
|
|
|
|
生成日期: 2026-05-26
|
|
排查依据: 架构全景扫描 + API实际验证 + 数据库探查
|
|
|
|
---
|
|
|
|
## P0 — 紧急
|
|
|
|
### Ticket 1: ERP数据自动同步
|
|
**负责人**: dev-fullstack
|
|
**预计工时**: 3-5天
|
|
**优先级**: P0
|
|
|
|
**现状**:
|
|
- `erp_schema` 表已有11条ERP表结构记录（MasterBill 15003行、ListOrder、ListInvoice、Units、Product等）
|
|
- `data_source_config` 表为空（0条记录）
|
|
- `kpi_values` 有54条手动导入数据
|
|
- ERP API网关 `erp-api.sxbh.ltd` 已部署
|
|
|
|
**要求**:
|
|
1. 新建同步脚本 `/root/cma-management/backend/scripts/erp_sync.py`，支持:
|
|
- 从 `data_source_config` 读取ERP连接配置
|
|
- 通过ERP API网关拉取数据
|
|
- 按 `kpi_definitions.formula` 和 `data_source_config.api_endpoint` 进行字段映射计算
|
|
- 计算结果写入 `kpi_values`
|
|
2. 更新 `data_source_config` 表结构：增加 `sync_interval`(分钟) 和 `last_sync_at` 字段
|
|
3. 创建 systemd timer 或 cron 实现定时同步（最快每10分钟一次）
|
|
4. 配置 `data_source_config` 至少1条数据源记录用于测试验证
|
|
5. 在 `/api/cma/data/sync/{source_id}` 增加手动触发同步的端点
|
|
|
|
**验收标准**:
|
|
- 执行同步脚本后，`kpi_values` 新增对应的ERP数据记录
|
|
- 定时任务按配置间隔自动执行
|
|
- 手动触发同步接口返回成功
|
|
- 同步失败时有日志和状态标记
|
|
|
|
---
|
|
|
|
### Ticket 2: 阈值建议前端集成
|
|
**负责人**: dev-fullstack → dev-frontend
|
|
**预计工时**: 1天
|
|
**优先级**: P0
|
|
|
|
**现状**:
|
|
- 后端阈值建议接口 `GET /api/cma/thresholds/suggest/{kpi_id}` 已实现
|
|
- 但前端 KPI 编辑/详情页没有任何调用
|
|
|
|
**要求**:
|
|
1. 修改 `KPIList.vue` 或 `KPIDetail.vue`，在KPI编辑表单中增加"自动建议阈值"按钮
|
|
2. 点击后调 `api.get('/thresholds/suggest/' + kpiId)`
|
|
3. 返回的 threshold_green / threshold_yellow / threshold_red 自动填入表单
|
|
4. 已有阈值时可一键覆盖
|
|
|
|
**验收标准**:
|
|
- 打开任意KPI编辑页能看到"自动建议阈值"按钮
|
|
- 点击后自动填入阈值建议值
|
|
- 保存后数据库里 `kpi_definitions.threshold_*` 字段更新
|
|
|
|
---
|
|
|
|
## P1 — 重要
|
|
|
|
### Ticket 3: Redis缓存接入
|
|
**负责人**: dev-backend
|
|
**预计工时**: 2天
|
|
**优先级**: P1
|
|
|
|
**现状**:
|
|
- Redis容器已运行(db1分配CMA使用)，内存仅1.48M使用
|
|
- 后端代码无任何Redis引用
|
|
- AI分析每次调用DeepSeek API，耗时1-3秒
|
|
|
|
**要求**:
|
|
1. 在 `app/utils/cache.py` 中封装Redis工具类
|
|
2. 对以下场景启用缓存:
|
|
- AI分析结果: 相同角色+相同KPI数据状态下，缓存有效期10分钟
|
|
- KPI计算中间结果: 缓存5分钟
|
|
- 驾驶舱 dashboard summary: 缓存30秒
|
|
3. 缓存key命名规范: `cma:cache:{module}:{key}`
|
|
4. 增加 `POST /api/cma/admin/cache/clear` 清空缓存接口
|
|
|
|
**验收标准**:
|
|
- 首次调用AI分析后，二次调用在10分钟内走缓存、不调DeepSeek
|
|
- 驾驶舱数据30秒内不走数据库
|
|
- 清空缓存后立即重新计算
|
|
|
|
---
|
|
|
|
### Ticket 4: 数据源配置UI
|
|
**负责人**: dev-frontend
|
|
**预计工时**: 2天
|
|
**优先级**: P1
|
|
|
|
**现状**:
|
|
- `DataManage.vue` 存在但仅有Excel导入功能
|
|
- 后端 `GET /api/cma/data/sources` 和 `POST /api/cma/data/import-excel` 已就绪
|
|
- 缺少 `data_source_config` 的增删改查UI
|
|
|
|
**要求**:
|
|
1. 在 `DataManage.vue` 中增加"数据源管理"Tab页
|
|
2. 数据源列表: 显示名称、类型、API地址、上次同步时间、状态
|
|
3. 新增/编辑数据源: 名称、类型(erp/business/excel)、API endpoint、同步频率
|
|
4. 删除数据源: 二次确认
|
|
5. 数据源列表调 `api.get('/data/sources')`
|
|
6. 增删改调 `api.post/put/delete('/data/sources')`（后端对应接口需要补）
|
|
|
|
**验收标准**:
|
|
- 在数据管理页能看到数据源Tab
|
|
- 可新增、编辑、删除数据源
|
|
- 操作后数据库 `data_source_config` 表对应更新
|
|
|
|
---
|
|
|
|
### Ticket 5: AI分析流式输出
|
|
**负责人**: dev-backend + dev-frontend
|
|
**预计工时**: 1-2天
|
|
**优先级**: P1
|
|
|
|
**现状**:
|
|
- AI分析请求需要等DeepSeek完整响应才返回，耗时3-10秒
|
|
- 前端显示Loading状态，用户等待时间长
|
|
|
|
**要求**:
|
|
1. 后端: AI分析接口改为SSE(Server-Sent Events)流式输出，边生成边推送
|
|
- 保留原有非流式接口作为fallback
|
|
- 新接口路径: `GET /api/cma/ai/dashboard-analysis-stream`
|
|
2. 前端: Dashboard.vue 用 EventSource 或 fetch + ReadableStream 消费SSE
|
|
- 实时展示已生成的分析内容
|
|
- 支持手动中断
|
|
|
|
**验收标准**:
|
|
- 流式模式下用户能看到分析内容逐段出现
|
|
- 非流式模式仍然可用（向后兼容）
|
|
|
|
---
|
|
|
|
## P2 — 功能增强
|
|
|
|
### Ticket 6: 多用户角色权限
|
|
**负责人**: dev-backend + dev-frontend
|
|
**预计工时**: 3天
|
|
**优先级**: P2
|
|
|
|
**现状**:
|
|
- 数据库 `users.role` 已设计4种角色: ceo / finance / business / it
|
|
- 后端API无任何权限校验（只有一个认证token检查）
|
|
- 前端菜单和页面也无角色区分
|
|
|
|
**要求**:
|
|
1. 后端: 增加角色中间件 `app/utils/authz.py`，在router依赖中注入权限校验
|
|
- ceo: 所有权限
|
|
- finance: KPI管理、数据管理、预警
|
|
- business: KPI查看、驾驶舱、预警
|
|
- it: 用户管理、数据源配置
|
|
2. 前端: `api/index.ts` 响应拦截器增加403处理
|
|
3. 侧边栏菜单根据角色动态显示/隐藏
|
|
4. 页面级路由守卫检查角色
|
|
|
|
**验收标准**:
|
|
- 不同角色登录后看到不同的菜单和页面
|
|
- 越权访问API返回403
|
|
- 前端捕获403后提示无权限
|
|
- seeder脚本已有4个角色各一个用户
|
|
|
|
---
|
|
|
|
### Ticket 7: 预警通知推送
|
|
**负责人**: dev-fullstack
|
|
**预计工时**: 2天
|
|
**优先级**: P2
|
|
|
|
**现状**:
|
|
- `kpi_alerts` 表有6条预警记录，但只有系统内列表展示
|
|
- 无任何外部通知（企微/邮件）
|
|
|
|
**要求**:
|
|
1. 在 `app/utils/notifier.py` 中实现通知推送:
|
|
- 企微机器人Webhook推送（优先）
|
|
- 邮件推送（备选）
|
|
2. 在预警生成时(`alert_rules.py` 的 check 流程中）自动触发通知
|
|
3. 通知内容: KPI名称、触发维度、当前值 vs 阈值、严重级别
|
|
4. 在 `operation_logs` 中记录通知发送历史
|
|
|
|
**验收标准**:
|
|
- 新增一条预警时，企微群收到对应的预警消息
|
|
- 通知内容包含KPI名称、当前值、阈值、严重级别
|
|
- 通知发送记录写入 `operation_logs`
|
|
|
|
---
|
|
|
|
### Ticket 8: 移动端适配
|
|
**负责人**: dev-frontend
|
|
**预计工时**: 3天
|
|
**优先级**: P2
|
|
|
|
**现状**:
|
|
- 全部页面基于Element Plus桌面端组件
|
|
- 手机浏览器访问时布局错乱
|
|
|
|
**要求**:
|
|
1. Dashboard.vue: ECharts图表在手机端自适应宽度，表格改为卡片排列
|
|
2. KPIList.vue 和 AlertList.vue: 表格增加响应式，窄屏时转为列表布局
|
|
3. MainLayout.vue: 侧边栏在窄屏自动折叠为底部导航或汉堡菜单
|
|
4. Login.vue: 手机端居中显示，输入框适配小屏
|
|
|
|
**验收标准**:
|
|
- iPhone SE / Android 主流分辨率下所有页面可正常浏览和操作
|
|
- 图表可缩放查看
|
|
- 表单在小屏下不溢出
|
|
|
|
---
|
|
|
|
## 项目依赖图
|
|
|
|
```
|
|
Ticket 1 (ERP同步) ────→ Ticket 4 (数据源UI) — 需要后端先补data_source CRUD
|
|
│
|
|
├──→ Ticket 3 (Redis缓存) — 独立，可并行
|
|
├──→ Ticket 7 (预警推送) — 依赖Ticket 1完成后预警才会自动生成
|
|
│
|
|
Ticket 2 (阈值建议) ──→ 独立，仅前端修改
|
|
|
|
Ticket 5 (流式输出) ──→ 后端改SSE，前端改消费
|
|
|
|
Ticket 6 (权限) ──────→ 独立，改动面较大
|
|
|
|
Ticket 8 (移动端) ────→ 独立，仅前端CSS/布局调整
|
|
```
|
|
|
|
## 授权
|
|
|
|
以上工单由任总(任富海)签发，授权数字员工团队按优先级执行。
|
|
数字员工分工:
|
|
- dev-backend: 后端API、数据库、缓存
|
|
- dev-frontend: 前端Vue页面、交互
|
|
- dev-fullstack: ERP对接、计算引擎、通知
|
|
- dev-qa: 验收测试
|
|
- dev-ops: 部署、定时任务、监控
|