init: 管理会计OS初始代码
包含前后端完整代码： - 前端：Vue3+Vite+ElementPlus - 后端：FastAPI+SQLAlchemy - 模块：驾驶舱/KPI/战略地图/预警/预算/成本/预测/改善行动 - 当前版本：v1.0.0
This commit is contained in:
Hermes CI Fix
@@ -0,0 +1,158 @@
|
||||
# 战略地图配置器增强 — 技术方案 v1.0
|
||||
|
||||
## 1. 概述
|
||||
|
||||
在现有 StrategicMap 模型的基础上，补全 Epic 1 战略地图配置器的 6 个 Feature 缺口。
|
||||
本次开发覆盖 P0（因果连线 + 组织层级）+ P1（目标优化 + 版本管理）+ P2（模板加载 + 拖拽关联）。
|
||||
|
||||
## 2. 现有系统基础（不改动）
|
||||
|
||||
- `strategic_maps` 表：id, title, version, status, dimensions(JSON), canvas_data(JSON), created_at, updated_at
|
||||
- `kpi_definitions` 表：id, map_id(FK), kpi_code, kpi_name, dimension, objective, target_value ...
|
||||
- `MapList.vue` / `MapCanvas.vue`
|
||||
|
||||
## 3. 各 Feature 详细方案
|
||||
|
||||
---
|
||||
|
||||
### Feature 1.3 因果连线 (P0 RED)
|
||||
|
||||
#### 后端变更
|
||||
|
||||
**现状**：canvas_data.connections 字段存 JSON，但无独立 API
|
||||
|
||||
**方案**：不新增表，沿用 canvas_data.connections，但新增独立 CRUD API 来操作连线
|
||||
|
||||
```
|
||||
POST /api/cma/maps/{map_id}/connections body: {from_objective_id, to_objective_id}
|
||||
DELETE /api/cma/maps/{map_id}/connections/{idx}
|
||||
```
|
||||
|
||||
**连线数据模型**：
|
||||
```json
|
||||
{
|
||||
"connections": [
|
||||
{ "from": "learning-0", "to": "process-0", "style": "solid" },
|
||||
{ "from": "process-0", "to": "customer-1", "style": "solid" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
#### 前端变更
|
||||
|
||||
1. **集成 @vue-flow/core**（推荐）
|
||||
- 每个目标卡片作为 Flow 节点
|
||||
- 拖拽手柄生成连线
|
||||
- 支持 hover 高亮、右键删除
|
||||
|
||||
2. **备选：自建 SVG 交互层**
|
||||
- 点击目标A 进入连线模式 - 点击目标B 生成连线
|
||||
- hover 连线上出现删除按钮
|
||||
|
||||
---
|
||||
|
||||
### Feature 1.5 组织层级配置 (P0 RED)
|
||||
|
||||
#### 后端 — 新表
|
||||
|
||||
```sql
|
||||
CREATE TABLE org_nodes (
|
||||
id INT AUTO_INCREMENT PRIMARY KEY,
|
||||
parent_id INT DEFAULT NULL,
|
||||
name VARCHAR(100) NOT NULL,
|
||||
code VARCHAR(50) UNIQUE,
|
||||
level TINYINT NOT NULL, -- 1=集团 2=事业部 3=区域 4=部门 5=班组
|
||||
sort_order INT DEFAULT 0,
|
||||
enabled TINYINT(1) DEFAULT 1,
|
||||
path VARCHAR(500),
|
||||
remark VARCHAR(200),
|
||||
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
FOREIGN KEY (parent_id) REFERENCES org_nodes(id)
|
||||
);
|
||||
```
|
||||
|
||||
#### API
|
||||
|
||||
```
|
||||
GET /api/cma/org/tree # 全量树结构
|
||||
GET /api/cma/org/nodes # 平铺列表
|
||||
POST /api/cma/org/nodes # 新增节点
|
||||
PUT /api/cma/org/nodes/{id} # 修改节点
|
||||
DELETE /api/cma/org/nodes/{id} # 删除节点
|
||||
PUT /api/cma/org/nodes/{id}/toggle # 切换启用/禁用
|
||||
```
|
||||
|
||||
#### 前端
|
||||
|
||||
- Element Plus `<el-tree>` 组件展示树
|
||||
- 右键菜单：添加子节点 / 编辑 / 启用禁用 / 删除
|
||||
- 拖拽排序
|
||||
|
||||
---
|
||||
|
||||
### Feature 1.2 战略目标管理增强 (P1 YELLOW)
|
||||
|
||||
新建 map_objectives 表：
|
||||
|
||||
```sql
|
||||
CREATE TABLE map_objectives (
|
||||
id INT AUTO_INCREMENT PRIMARY KEY,
|
||||
map_id INT NOT NULL,
|
||||
dimension_key VARCHAR(50) NOT NULL,
|
||||
name VARCHAR(200) NOT NULL,
|
||||
description TEXT,
|
||||
icon VARCHAR(50) DEFAULT 'target',
|
||||
sort_order INT DEFAULT 0,
|
||||
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||
FOREIGN KEY (map_id) REFERENCES strategic_maps(id) ON DELETE CASCADE
|
||||
);
|
||||
```
|
||||
|
||||
API：GET/POST/PUT/DELETE /api/cma/maps/{map_id}/objectives
|
||||
前端：弹窗增加描述字段 + 图标选择器 + 拖拽排序
|
||||
|
||||
---
|
||||
|
||||
### Feature 1.6 版本管理 (P1 YELLOW)
|
||||
|
||||
```sql
|
||||
CREATE TABLE strategic_map_versions (
|
||||
id INT AUTO_INCREMENT PRIMARY KEY,
|
||||
map_id INT NOT NULL,
|
||||
version VARCHAR(20) NOT NULL,
|
||||
dimensions JSON NOT NULL,
|
||||
canvas_data JSON NOT NULL,
|
||||
comment VARCHAR(500),
|
||||
created_by INT,
|
||||
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||
FOREIGN KEY (map_id) REFERENCES strategic_maps(id) ON DELETE CASCADE
|
||||
);
|
||||
```
|
||||
|
||||
API：版本列表 + 创建快照 + 回滚
|
||||
前端：MapList 页增加版本历史按钮 + VersionListDialog
|
||||
|
||||
---
|
||||
|
||||
## 4. 开发顺序与依赖关系
|
||||
|
||||
```
|
||||
P0a: 因果连线 —— 无依赖
|
||||
P0b: 组织层级 —— 完全独立
|
||||
=> 两个P0可并行
|
||||
P1a: 目标管理增强 —— 依赖新 objectives 表
|
||||
P1b: 版本管理 —— 依赖 StrategicMap 已有结构
|
||||
P2: KPI拖拽关联 —— 依赖 objectives 模型
|
||||
```
|
||||
|
||||
推荐执行：P0a+P0b(并行) → P1a+P1b(并行) → P2
|
||||
|
||||
## 5. 风险
|
||||
|
||||
| 风险 | 应对 |
|
||||
|------|------|
|
||||
| @vue-flow/core 样式冲突 | 隔离CSS / 使用自建SVG |
|
||||
| 组织树 >500节点性能 | 后端懒加载 + el-tree lazy |
|
||||
| 版本快照膨胀 | 保留最近50版本 |
|
||||
| 回滚后画布状态不一致 | 回滚后强制刷新页面 |
|
||||
@@ -0,0 +1,76 @@
|
||||
# Epic 1 战略地图配置器 — 任务分配清单
|
||||
|
||||
> 状态: 🚀 已批准执行 | 日期: 2026-05-27
|
||||
> 技术方案: /root/cma-management/architecture/strategic-map-enhancement.md
|
||||
> 执行模式: 全部并行
|
||||
|
||||
---
|
||||
|
||||
## P0a: 因果连线 (Feature 1.3) ← dev-backend + dev-frontend
|
||||
|
||||
| 角色 | 任务ID | 内容 | 工作量 |
|
||||
|------|--------|------|--------|
|
||||
| dev-backend | A-1 | POST/DELETE /maps/{id}/connections API | 0.5天 |
|
||||
| dev-frontend | A-2 | @vue-flow/core 集成 + 拖拽连线交互 | 1.5天 |
|
||||
| dev-qa | A-3 | 连线创建/删除/持久/隔离/校验测试 | 0.5天 |
|
||||
|
||||
## P0b: 组织层级 (Feature 1.5) ← dev-backend + dev-frontend
|
||||
|
||||
| 角色 | 任务ID | 内容 | 工作量 |
|
||||
|------|--------|------|--------|
|
||||
| dev-backend | B-1 | OrgNode模型 + 示例数据 | 0.5天 |
|
||||
| dev-backend | B-2 | 组织 CRUD API 6个端点 | 1天 |
|
||||
| dev-frontend | B-3 | OrgManage.vue el-tree + 路由 | 1.5天 |
|
||||
| dev-qa | B-4 | 增删改/权限/树结构测试 | 0.5天 |
|
||||
|
||||
## P1a: 目标管理增强 (Feature 1.2+1.4) ← dev-backend + dev-frontend
|
||||
|
||||
| 角色 | 任务ID | 内容 | 工作量 |
|
||||
|------|--------|------|--------|
|
||||
| dev-backend | C-1 | MapObjective模型 | 0.5天 |
|
||||
| dev-backend | C-2 | objectives CRUD + 排序API | 0.5天 |
|
||||
| dev-backend | C-3 | KPI反向关联端点 | 0.5天 |
|
||||
| dev-frontend | C-4 | 弹窗增强(描述/图标/限制3) | 0.5天 |
|
||||
| dev-frontend | C-5 | KPI详情页反向关联 | 0.5天 |
|
||||
| dev-qa | C-6 | CRUD/数量限制/级联测试 | 0.5天 |
|
||||
|
||||
## P1b: 版本管理 (Feature 1.6) ← dev-backend + dev-frontend
|
||||
|
||||
| 角色 | 任务ID | 内容 | 工作量 |
|
||||
|------|--------|------|--------|
|
||||
| dev-backend | D-1 | StrategicMapVersion模型 + 快照/回滚API + 发布自动触发 | 1天 |
|
||||
| dev-frontend | D-2 | VersionDialog + 发布按钮 | 1天 |
|
||||
| dev-qa | D-3 | 快照/回滚/自动触发测试 | 0.5天 |
|
||||
|
||||
## P2: 模板加载 (Feature 1.1) ← dev-backend + dev-frontend
|
||||
|
||||
| 角色 | 任务ID | 内容 | 工作量 |
|
||||
|------|--------|------|--------|
|
||||
| dev-backend | E-1 | create-with-template API | 0.5天 |
|
||||
| dev-frontend | E-2 | 新建对话框radio选择模板 | 0.5天 |
|
||||
| dev-qa | E-3 | 模板加载完整性测试 | 0.25天 |
|
||||
|
||||
---
|
||||
|
||||
## 📊 总计预估
|
||||
|
||||
| 角色 | 总任务量 |
|
||||
|------|----------|
|
||||
| dev-backend | 约 4.5 天 |
|
||||
| dev-frontend | 约 5.5 天 |
|
||||
| dev-qa | 约 2.75 天 |
|
||||
|
||||
## 🎯 依赖关系（启动顺序）
|
||||
|
||||
- C-1(MapObjective模型) → C-2(CRUD API) → C-4/C-5(前端)
|
||||
- B-1(OrgNode模型) → B-2(CRUD API) → B-3(前端)
|
||||
- A-1(连线API) ↔ A-2(前端连线) 可独立并行
|
||||
- D-1(版本API+自动触发) → D-2(前端)
|
||||
|
||||
## 📋 评审节点
|
||||
|
||||
| 节点 | 时机 | 评审方式 |
|
||||
|------|------|----------|
|
||||
| 代码评审 | 每个任务PR提交 | dev-architect + dev-qa |
|
||||
| 集成测试 | 所有任务完成 | dev-qa 出报告 |
|
||||
| 上线评审 | 部署前 | dev-ops + dev-architect → 任总确认 |
|
||||
Reference in New Issue
Block a user