888 lines
29 KiB
Markdown
888 lines
29 KiB
Markdown
# KCDRSmomi_tob_sim 数据库设计分析报告
|
||
|
||
**文档生成时间:** 2026-03-05
|
||
**系统名称:** KCDRSmomi_tob_sim 制丝仿真管理系统
|
||
**技术栈:** Java Spring Boot + Vue3 + MySQL
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
1. [项目概述](#项目概述)
|
||
2. [数据表结构说明](#数据表结构说明)
|
||
3. [后端API接口分析](#后端API接口分析)
|
||
4. [前端Vue组件分析](#前端Vue组件分析)
|
||
5. [接口与表的映射关系](#接口与表的映射关系)
|
||
6. [业务流程说明](#业务流程说明)
|
||
|
||
---
|
||
|
||
## 项目概述
|
||
|
||
本系统是制丝仿真管理系统 (KCDRSmomi_tob_sim)，主要用于烟草制造工艺的仿真规划和生产调度。系统包含以下核心功能模块：
|
||
|
||
- **仿真工程管理**: 管理制丝仿真工程，包括工程创建、配置和状态管理
|
||
- **数据包管理**: 管理仿真数据包，存储工单数据和计划数据
|
||
- **产线建模**: 建立生产线的数字孪生模型，包括设备、工段、仓库等
|
||
- **工单管理**: 管理生产工单，包括任务配置和规则设置
|
||
- **基础数据管理**: 管理物料、工艺过程、工作日历等基础数据
|
||
- **仿真执行**: 执行仿真任务，生成仿真结果和分析报告
|
||
|
||
---
|
||
|
||
## 数据表结构说明
|
||
|
||
### 仿真核心表
|
||
|
||
#### 表名: sim_project (制丝仿真工程表)
|
||
|
||
**说明**: 存储制丝仿真工程的基本信息和状态
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键，UUID |
|
||
| code | VARCHAR(50) | 工程编号 |
|
||
| target_type | INT | 仿真对象类型 (1:制丝, 2:卷包, 3:嘴棒, 12:制丝+卷包, 23:卷包+嘴棒, 88:全工序) |
|
||
| state | INT | 状态 (1:新建, 3:就绪, 8:取消) |
|
||
| sim_plmog_package_id | VARCHAR(32) | 产线建模编号 |
|
||
| sim_plmog_package_code | VARCHAR(50) | 产线建模编码 |
|
||
| create_datetime | DATETIME | 创建时间 |
|
||
| create_user_id | VARCHAR(32) | 创建人ID |
|
||
| modify_datetime | DATETIME | 修改时间 |
|
||
| modify_user_id | VARCHAR(32) | 修改人ID |
|
||
| remark | TEXT | 工程说明/描述 |
|
||
|
||
#### 表名: sim_data_package (制丝仿真数据包表)
|
||
|
||
**说明**: 存储仿真数据包信息，关联工单和计划数据
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键，UUID |
|
||
| code | VARCHAR(50) | 数据包编号 |
|
||
| state | INT | 状态 (1:新建, 3:就绪, 8:取消) |
|
||
| sim_project_id | VARCHAR(32) | 仿真工程编号 |
|
||
| sim_project_code | VARCHAR(50) | 仿真工程编码 |
|
||
| sim_plmog_package_id | VARCHAR(32) | 产线建模编号 |
|
||
| sim_plmog_package_code | VARCHAR(50) | 产线建模编码 |
|
||
| tob_workcalendar_version | VARCHAR(50) | 工作日历版本 |
|
||
| create_datetime | DATETIME | 创建时间 |
|
||
| create_user_id | VARCHAR(32) | 创建人ID |
|
||
| modify_datetime | DATETIME | 修改时间 |
|
||
| modify_user_id | VARCHAR(32) | 修改人ID |
|
||
| remark | TEXT | 说明/描述 |
|
||
|
||
#### 表名: sim_tob_task (生产工单表)
|
||
|
||
**说明**: 存储生产工单信息
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键，UUID |
|
||
| code | VARCHAR(50) | 工单编号 |
|
||
| sim_datapackage_code | VARCHAR(50) | 数据包编号 |
|
||
| sim_project_id | VARCHAR(32) | 仿真工程编号 |
|
||
| mat_code | VARCHAR(50) | 物料编码 |
|
||
| mat_name | VARCHAR(100) | 物料名称 |
|
||
| work_date | DATE | 工作日期 |
|
||
| plan_qty | DECIMAL | 计划数量 |
|
||
| state | INT | 状态 |
|
||
| create_datetime | DATETIME | 创建时间 |
|
||
| modify_datetime | DATETIME | 修改时间 |
|
||
|
||
#### 表名: sim_tob_cigsilk_plan (烟丝生产计划表)
|
||
|
||
**说明**: 存储烟丝生产计划数据
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| sim_datapackage_code | VARCHAR(50) | 数据包编号 |
|
||
| mat_code | VARCHAR(50) | 物料编码 |
|
||
| work_date | DATE | 工作日期 |
|
||
| work_month | VARCHAR(10) | 工作月份 |
|
||
| plan_qty | DECIMAL | 计划数量 |
|
||
| actual_qty | DECIMAL | 实际数量 |
|
||
| ... | ... | ... |
|
||
|
||
### 基础数据表
|
||
|
||
#### 表名: com_material_type (物料类型表)
|
||
|
||
**说明**: 管理物料类型分类
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键，UUID |
|
||
| code | VARCHAR(50) | 物料类型编码 |
|
||
| name | VARCHAR(100) | 物料类型名称 |
|
||
| parent_code | VARCHAR(50) | 父类型编码 |
|
||
| level | INT | 层级 |
|
||
| enable | INT | 启用状态 (1:启用, 0:停用) |
|
||
| sort_order | INT | 排序 |
|
||
| create_datetime | DATETIME | 创建时间 |
|
||
| create_user_id | VARCHAR(32) | 创建人ID |
|
||
| modify_datetime | DATETIME | 修改时间 |
|
||
| modify_user_id | VARCHAR(32) | 修改人ID |
|
||
|
||
#### 表名: com_material_grade (物料等级表)
|
||
|
||
**说明**: 管理物料等级（重点牌号、一类烟等）
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键，UUID |
|
||
| code | VARCHAR(50) | 编码 |
|
||
| name | VARCHAR(100) | 名称（1：重点牌号 2：一类烟 3：常用牌号） |
|
||
| enable | INT | 启用状态（1启用，0停用） |
|
||
| create_datetime | DATETIME | 创建时间 |
|
||
| create_user_id | VARCHAR(32) | 创建人ID |
|
||
| modify_datetime | DATETIME | 修改时间 |
|
||
| modify_user_id | VARCHAR(32) | 修改人ID |
|
||
|
||
#### 表名: com_semi_material (半成品物料表)
|
||
|
||
**说明**: 管理半成品物料信息
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键，UUID |
|
||
| code | VARCHAR(50) | 物料编码 |
|
||
| name | VARCHAR(100) | 物料名称 |
|
||
| mat_type_code | VARCHAR(50) | 物料类型编码 |
|
||
| mat_grade_code | VARCHAR(50) | 物料等级编码 |
|
||
| enable | INT | 启用状态 |
|
||
| ... | ... | ... |
|
||
|
||
#### 表名: com_group (班组表)
|
||
|
||
**说明**: 管理班组信息
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| code | VARCHAR(50) | 班组编码 |
|
||
| name | VARCHAR(100) | 班组名称 |
|
||
| enable | INT | 启用状态 |
|
||
| ... | ... | ... |
|
||
|
||
#### 表名: com_shift (班次表)
|
||
|
||
**说明**: 管理班次信息
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| code | VARCHAR(50) | 班次编码 |
|
||
| name | VARCHAR(100) | 班次名称 |
|
||
| start_time | TIME | 开始时间 |
|
||
| end_time | TIME | 结束时间 |
|
||
| enable | INT | 启用状态 |
|
||
| ... | ... | ... |
|
||
|
||
### 工艺定义表
|
||
|
||
#### 表名: tob_process_define (制丝工艺过程定义表)
|
||
|
||
**说明**: 管理制丝工艺过程定义
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键，UUID |
|
||
| vers_code | VARCHAR(50) | 版本号（编码规则：tobpdefine_四位数字） |
|
||
| vers_des | VARCHAR(200) | 版本说明 |
|
||
| code | VARCHAR(50) | 过程编码 |
|
||
| name | VARCHAR(100) | 过程名称 |
|
||
| tgt_seg_code | VARCHAR(50) | 应用工艺段 |
|
||
| enable | INT | 启用状态（1启用，0停用） |
|
||
| create_datetime | DATETIME | 创建时间 |
|
||
| create_user_id | VARCHAR(32) | 创建人ID |
|
||
| modify_datetime | DATETIME | 修改时间 |
|
||
| modify_user_id | VARCHAR(32) | 修改人ID |
|
||
|
||
#### 表名: tob_process_bom (工艺过程BOM表)
|
||
|
||
**说明**: 管理工艺过程BOM（物料清单）
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| process_define_id | VARCHAR(32) | 工艺过程定义ID |
|
||
| mat_code | VARCHAR(50) | 物料编码 |
|
||
| mat_name | VARCHAR(100) | 物料名称 |
|
||
| ratio | DECIMAL | 配比 |
|
||
| ... | ... | ... |
|
||
|
||
### 产线建模表
|
||
|
||
#### 表名: phmm_production (生产单元表)
|
||
|
||
**说明**: 管理生产单元（设备建模单元）
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| plmog_package_id | VARCHAR(32) | 产线建模包ID |
|
||
| code | VARCHAR(50) | 生产单元编码 |
|
||
| name | VARCHAR(100) | 生产单元名称 |
|
||
| type | VARCHAR(50) | 类型 |
|
||
| ... | ... | ... |
|
||
|
||
#### 表名: phmm_storage (存储单元表)
|
||
|
||
**说明**: 管理存储单元（仓库）
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| plmog_package_id | VARCHAR(32) | 产线建模包ID |
|
||
| code | VARCHAR(50) | 存储单元编码 |
|
||
| name | VARCHAR(100) | 存储单元名称 |
|
||
| capacity | DECIMAL | 容量 |
|
||
| ... | ... | ... |
|
||
|
||
#### 表名: phmm_connection (设备连接表)
|
||
|
||
**说明**: 管理设备间的连接关系
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| plmog_package_id | VARCHAR(32) | 产线建模包ID |
|
||
| source_id | VARCHAR(32) | 源设备ID |
|
||
| target_id | VARCHAR(32) | 目标设备ID |
|
||
| connect_type | VARCHAR(50) | 连接类型 |
|
||
| ... | ... | ... |
|
||
|
||
### 仿真结果表
|
||
|
||
#### 表名: phmm_sim_record (仿真历史记录表)
|
||
|
||
**说明**: 记录仿真执行的历史数据
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| sim_datapackage_code | VARCHAR(50) | 数据包编号 |
|
||
| work_date | DATE | 工作日期 |
|
||
| mat_code | VARCHAR(50) | 物料编码 |
|
||
| production_code | VARCHAR(50) | 生产单元编码 |
|
||
| input_qty | DECIMAL | 输入数量 |
|
||
| output_qty | DECIMAL | 输出数量 |
|
||
| ... | ... | ... |
|
||
|
||
#### 表名: sim_seg_production_analyse_result (工段生产分析结果表)
|
||
|
||
**说明**: 存储工段生产分析结果
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| sim_datapackage_code | VARCHAR(50) | 数据包编号 |
|
||
| seg_code | VARCHAR(50) | 工段编码 |
|
||
| work_date | DATE | 工作日期 |
|
||
| ... | ... | ... |
|
||
|
||
#### 表名: sim_storage_production_analyse_result (存储生产分析结果表)
|
||
|
||
**说明**: 存储存储生产分析结果
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | VARCHAR(32) | 主键 |
|
||
| sim_datapackage_code | VARCHAR(50) | 数据包编号 |
|
||
| storage_code | VARCHAR(50) | 存储单元编码 |
|
||
| work_date | DATE | 工作日期 |
|
||
| ... | ... | ... |
|
||
|
||
---
|
||
|
||
## 后端API接口分析
|
||
|
||
系统共检测到 **432** 个API接口，分布在 **64** 个Controller中。
|
||
|
||
### 核心仿真模块
|
||
|
||
#### SimProjectController - 制丝仿真工程管理
|
||
- `GET /api/tob/sim/project/simPackage/selectByKey` - 按主键查询
|
||
- `GET /api/tob/sim/project/simPackage/selectPage` - 分页查询
|
||
- `POST /api/tob/sim/project/simPackage/create` - 新增制丝仿真工程
|
||
- `POST /api/tob/sim/project/simPackage/updateById` - 修改制丝仿真工程
|
||
- `POST /api/tob/sim/project/simPackage/{id}` - 通过id删除制丝仿真工程
|
||
|
||
**操作表**: sim_project
|
||
**业务说明**: 管理制丝仿真工程的CRUD操作，按主键查询、分页查询、新增、修改、删除
|
||
|
||
#### SimDataPackageController - 数据包管理
|
||
- `GET /api/tob/sim/project/simDataPackage/selectByKey` - 按主键查询
|
||
- `GET /api/tob/sim/project/simDataPackage/selectPage` - 分页查询
|
||
- `POST /api/tob/sim/project/simDataPackage/save` - 保存数据包
|
||
- `POST /api/tob/sim/project/simDataPackage/updateById` - 更新数据包
|
||
- `POST /api/tob/sim/project/simDataPackage/del/{id}` - 删除数据包
|
||
- `POST /api/tob/sim/project/simDataPackage/clone/{id}` - 克隆数据包
|
||
|
||
**操作表**: sim_data_package
|
||
**业务说明**: 管理仿真数据包，包括创建、更新、删除、克隆操作
|
||
|
||
#### SimController - 执行仿真
|
||
- `GET /api/tob/sim/project/TobSim/executeEasySimTask` - 执行仿真，通过ps执行仿真，生成仿真结果
|
||
- `GET /api/tob/sim/project/TobSim/getSimDateForSelect` - 根据数据包编号检索可仿真时间（选择器）
|
||
- `GET /api/tob/sim/project/TobSim/selectCompletedSimDate` - 根据数据包查询工单已经仿真的日期
|
||
- `GET /api/tob/sim/project/TobSim/verifyTaskOfWorkcalendarConfigBySimDatapackageCode` - 根据数据包编号验证工单工段是否设置工厂日历（仿真启动验证）
|
||
- `GET /api/tob/sim/project/TobSim/verifySimConfig` - 根据数据包编号验证是否完成数据包配置（仿真工程-工单配置）
|
||
|
||
**操作表**: sim_project, sim_data_package, sim_tob_task
|
||
**业务说明**: 执行仿真任务，获取仿真日期，验证配置
|
||
|
||
### 工单管理模块
|
||
|
||
#### SimTobCigsilkPlanController - 烟丝生产计划
|
||
- `GET /api/tob/sim/project/simTobCigsilkPlan/selectByKey` - 按主键查询
|
||
- `GET /api/tob/sim/project/simTobCigsilkPlan/selectPage` - 分页查询
|
||
- `GET /api/tob/sim/project/simTobCigsilkPlan/verifyCigsilkPlanConfig` - 验证烟丝计划配置
|
||
- `POST /api/tob/sim/project/simTobCigsilkPlan/save` - 保存
|
||
- `POST /api/tob/sim/project/simTobCigsilkPlan/updateById` - 更新
|
||
- `POST /api/tob/sim/project/simTobCigsilkPlan/{id}` - 删除
|
||
- `POST /api/tob/sim/project/simTobCigsilkPlan/deleteByIds` - 批量删除
|
||
- `POST /api/tob/sim/project/simTobCigsilkPlan/download` - 下载
|
||
- `POST /api/tob/sim/project/simTobCigsilkPlan/import` - 导入
|
||
- `GET /api/tob/sim/project/simTobCigsilkPlan/selectBySimDatapackageCodeAndWorkMonth` - 根据数据包编号和工作月份查询
|
||
|
||
**操作表**: sim_tob_cigsilk_plan
|
||
**业务说明**: 管理烟丝生产计划，导入导出计划数据
|
||
|
||
#### SimTobTaskController - 生产工单
|
||
- 包含工单的查询、新增、更新、删除等基础CRUD操作
|
||
|
||
**操作表**: sim_tob_task
|
||
**业务说明**: 管理生产工单，查询、新增、更新、删除工单
|
||
|
||
#### SimTobTaskRuleConfigController - 工单规则配置
|
||
- 配置工单仿真规则
|
||
|
||
**操作表**: sim_tob_task_rule_config
|
||
**业务说明**: 管理工单规则配置，设置仿真参数
|
||
|
||
### 产线建模模块
|
||
|
||
#### SimPlmogPackageController - 产线建模包
|
||
- `GET /api/tob/support/simmodel/simPlmogPackage/selectByKey`
|
||
- `GET /api/tob/support/simmodel/simPlmogPackage/selectPage`
|
||
- `POST /api/tob/support/simmodel/simPlmogPackage/save`
|
||
- `POST /api/tob/support/simmodel/simPlmogPackage/updateById`
|
||
- `POST /api/tob/support/simmodel/simPlmogPackage/del/{id}`
|
||
|
||
**操作表**: sim_plmog_package
|
||
**业务说明**: 管理产线建模包
|
||
|
||
#### SimModelerController - 产线建模器
|
||
- 产线建模器接口
|
||
|
||
**操作表**: sim_plmog_*
|
||
**业务说明**: 提供建模器功能接口
|
||
|
||
### 基础数据管理模块
|
||
|
||
#### ComMaterialTypeController - 物料类型
|
||
- 物料类型的CRUD操作
|
||
|
||
**操作表**: com_material_type
|
||
**业务说明**: 管理物料类型分类
|
||
|
||
#### ComMaterialGradeController - 物料等级
|
||
- 物料等级的CRUD操作
|
||
|
||
**操作表**: com_material_grade
|
||
**业务说明**: 管理物料等级（重点牌号、一类烟等）
|
||
|
||
#### ComSemiMaterialController - 半成品物料
|
||
- 半成品物料的CRUD操作
|
||
|
||
**操作表**: com_semi_material
|
||
**业务说明**: 管理半成品物料
|
||
|
||
#### TobProcessDefineController - 工艺过程定义
|
||
- 工艺过程定义的CRUD操作
|
||
|
||
**操作表**: tob_process_define
|
||
**业务说明**: 管理制丝工艺过程定义
|
||
|
||
#### TobProcessBomController - 工艺过程BOM
|
||
- 工艺BOM的CRUD操作
|
||
|
||
**操作表**: tob_process_bom
|
||
**业务说明**: 管理工艺过程BOM
|
||
|
||
#### TobWorkcalendarController - 工作日历
|
||
- 工作日历的CRUD操作
|
||
|
||
**操作表**: tob_workcalendar
|
||
**业务说明**: 管理工作日历
|
||
|
||
#### ComGroupController - 班组管理
|
||
- 班组的CRUD操作
|
||
|
||
**操作表**: com_group
|
||
**业务说明**: 管理班组信息
|
||
|
||
#### ComShiftController - 班次管理
|
||
- 班次的CRUD操作
|
||
|
||
**操作表**: com_shift
|
||
**业务说明**: 管理班次信息
|
||
|
||
### 设备建模模块
|
||
|
||
#### PhmmProductionController - 生产单元
|
||
- 生产单元的CRUD操作
|
||
|
||
**操作表**: phmm_production
|
||
**业务说明**: 管理生产单元
|
||
|
||
#### PhmmStorageController - 存储单元
|
||
- 存储单元的CRUD操作
|
||
|
||
**操作表**: phmm_storage
|
||
**业务说明**: 管理存储单元（仓库）
|
||
|
||
#### PrcmGroupStorageController - PRCM组存储
|
||
- PRCM组存储配置
|
||
|
||
**操作表**: prcm_group_storage
|
||
**业务说明**: 管理PRCM组存储配置
|
||
|
||
#### PrcmLineController - PRCM产线
|
||
- PRCM产线的CRUD操作
|
||
|
||
**操作表**: prcm_line
|
||
**业务说明**: 管理PRCM产线
|
||
|
||
#### PrcmSegmentController - PRCM工段
|
||
- PRCM工段的CRUD操作
|
||
|
||
**操作表**: prcm_segment
|
||
**业务说明**: 管理PRCM工段
|
||
|
||
#### PrcmUnitController - PRCM工序单元
|
||
- PRCM工序单元的CRUD操作
|
||
|
||
**操作表**: prcm_unit
|
||
**业务说明**: 管理PRCM工序单元
|
||
|
||
#### PhmmConnectionController - 设备连接
|
||
- 设备连接关系的CRUD操作
|
||
|
||
**操作表**: phmm_connection
|
||
**业务说明**: 管理设备连接关系
|
||
|
||
### 历史记录和统计模块
|
||
|
||
#### PhmmSimRecordController - 仿真历史记录
|
||
- 仿真历史记录的CRUD操作
|
||
|
||
**操作表**: phmm_sim_record
|
||
**业务说明**: 记录生产历史数据
|
||
|
||
#### SimReportRecordController - 仿真报告记录
|
||
- 仿真报告记录的CRUD操作
|
||
|
||
**操作表**: sim_report_record
|
||
**业务说明**: 记录仿真报告数据
|
||
|
||
#### SimStatisticController - 仿真统计
|
||
- 仿真数据统计
|
||
|
||
**操作表**: sim_statistic
|
||
**业务说明**: 仿真数据统计分析
|
||
|
||
#### SimSegProductionAnalyseResultController - 工段生产分析
|
||
- 工段生产分析的CRUD操作
|
||
|
||
**操作表**: sim_seg_production_analyse_result
|
||
**业务说明**: 工段生产分析结果
|
||
|
||
#### SimStorageProductionAnalyseResultController - 存储生产分析
|
||
- 存储生产分析的CRUD操作
|
||
|
||
**操作表**: sim_storage_production_analyse_result
|
||
**业务说明**: 存储生产分析结果
|
||
|
||
### 系统管理模块
|
||
|
||
#### SysMenuController - 系统菜单
|
||
- 系统菜单管理
|
||
|
||
**操作表**: sys_menu
|
||
**业务说明**: 管理系统菜单
|
||
|
||
#### SysRoleController - 角色管理
|
||
- 角色管理的CRUD操作
|
||
|
||
**操作表**: sys_role
|
||
**业务说明**: 管理系统角色
|
||
|
||
#### SysUserController - 用户管理
|
||
- 用户管理的操作
|
||
|
||
**操作表**: sys_user
|
||
**业务说明**: 管理系统用户
|
||
|
||
#### DictionaryController - 数据字典
|
||
- 数据字典的CRUD操作
|
||
|
||
**操作表**: sys_dictionary
|
||
**业务说明**: 管理数据字典
|
||
|
||
#### AuthorizationController - 认证授权
|
||
- `GET /api/tob/common/auth/info` - 获取认证信息
|
||
|
||
**操作表**: 系统相关表
|
||
**业务说明**: 处理用户认证和授权
|
||
|
||
---
|
||
|
||
## 前端Vue组件分析
|
||
|
||
系统包含 **110** 个Vue视图组件，负责前端页面展示和用户交互。
|
||
|
||
### 主要组件分类
|
||
|
||
#### 仿真建模相关组件
|
||
- `plan-simulation-modeling/index.vue` - 仿真建模主页面
|
||
- `plan-simulation-modeling/components/Diagram.vue` - 仿真流程图组件
|
||
- `plan-simulation-modeling/components/equ-attribute-config/` - 设备属性配置组件目录
|
||
- `PhmmPropertyPanel.vue` - PHMM属性面板
|
||
- `PrcmPropertyPanel.vue` - PRCM属性面板
|
||
- `general-equipment-panel-details/` - 通用设备面板详情
|
||
- `gp-panel-details/` - GP面板详情
|
||
- `linefeednode-panel-details/` - 线路供料节点面板详情
|
||
- `prcmgp-panel-details/` - PRCM GP面板详情
|
||
- `prcmsegment-panel-details/` - PRCM工段面板详情
|
||
- `prcmunit-panel-details/` - PRCM工序单元面板详情
|
||
- `prcmwarehouse-panel-details/` - PRCM仓库面板详情
|
||
- `production-panel-details/` - 生产面板详情
|
||
- `relationlink-panel-details/` - 关联链接面板详情
|
||
|
||
#### 其他页面组件
|
||
- 系统管理相关页面
|
||
- 基础数据管理页面
|
||
- 工单管理页面
|
||
- 仿真报告页面
|
||
|
||
---
|
||
|
||
## 接口与表的映射关系
|
||
|
||
### 5.1 仿真工程管理
|
||
| Controller | 操作表 | 业务说明 |
|
||
|------------|--------|----------|
|
||
| SimProjectController | sim_project | 管理制丝仿真工程的CRUD操作，按主键查询、分页查询、新增、修改、删除 |
|
||
| SimDataPackageController | sim_data_package | 管理仿真数据包，包括创建、更新、删除、克隆操作 |
|
||
| SimController | sim_project, sim_data_package | 执行仿真任务，获取仿真日期，验证配置 |
|
||
|
||
**业务流程**:
|
||
1. 创建仿真工程 (sim_project)
|
||
2. 创建数据包 (sim_data_package) 并关联到工程
|
||
3. 导入工单数据到数据包
|
||
4. 执行仿真任务
|
||
5. 查看仿真结果
|
||
|
||
### 5.2 工单管理
|
||
| Controller | 操作表 | 业务说明 |
|
||
|------------|--------|----------|
|
||
| SimTobTaskController | sim_tob_task | 管理生产工单，查询、新增、更新、删除工单 |
|
||
| SimTobTaskRuleConfigController | sim_tob_task_rule_config | 管理工单规则配置，设置仿真参数 |
|
||
| SimTobCigsilkPlanController | sim_tob_cigsilk_plan | 管理烟丝生产计划，导入导出计划数据 |
|
||
|
||
**业务流程**:
|
||
1. 接收ERP/MES提供的生产工单
|
||
2. 导入到 sim_tob_task 表
|
||
3. 配置工单规则 (sim_tob_task_rule_config)
|
||
4. 生成烟丝生产计划 (sim_tob_cigsilk_plan)
|
||
5. 关联到仿真数据包
|
||
|
||
### 5.3 产线建模
|
||
| Controller | 操作表 | 业务说明 |
|
||
|------------|--------|----------|
|
||
| SimPlmogPackageController | sim_plmog_package | 管理产线建模包 |
|
||
| SimDataPlmogPackageConfigController | sim_data_plmog_package_config | 配置数据包关联的产线建模 |
|
||
| SimModelerController | sim_plmog_* | 产线建模器接口 |
|
||
| PhmmProductionController | phmm_production | 管理生产单元 |
|
||
| PhmmStorageController | phmm_storage | 管理存储单元（仓库）|
|
||
| PhmmConnectionController | phmm_connection | 管理设备连接关系 |
|
||
| PrcmLineController | prcm_line | 管理PRCM产线 |
|
||
| PrcmSegmentController | prcm_segment | 管理PRCM工段 |
|
||
| PrcmUnitController | prcm_unit | 管理PRCM工序单元 |
|
||
|
||
**业务流程**:
|
||
1. 创建产线建模包 (sim_plmog_package)
|
||
2. 建立生产单元 (phmm_production)
|
||
3. 建立存储单元 (phmm_storage)
|
||
4. 配置PRCM模型 (prcm_line, prcm_segment, prcm_unit)
|
||
5. 配置设备连接关系 (phmm_connection)
|
||
6. 建模器实时预览和编辑
|
||
|
||
### 5.4 基础数据管理
|
||
| Controller | 操作表 | 业务说明 |
|
||
|------------|--------|----------|
|
||
| ComMaterialTypeController | com_material_type | 管理物料类型分类 |
|
||
| ComMaterialGradeController | com_material_grade | 管理物料等级（重点牌号、一类烟等）|
|
||
| ComSemiMaterialController | com_semi_material | 管理半成品物料 |
|
||
| TobProcessDefineController | tob_process_define | 管理制丝工艺过程定义 |
|
||
| TobProcessBomController | tob_process_bom | 管理工艺过程BOM |
|
||
| TobWorkcalendarController | tob_workcalendar | 管理工作日历 |
|
||
| ComGroupController | com_group | 管理班组信息 |
|
||
| ComShiftController | com_shift | 管理班次信息 |
|
||
|
||
**业务流程**:
|
||
1. 配置物料类型和等级
|
||
2. 维护物料基础信息
|
||
3. 定义工艺过程 (tob_process_define)
|
||
4. 配置工艺BOM (tob_process_bom)
|
||
5. 配置工作日历、班组、班次
|
||
|
||
### 5.5 历史记录和统计
|
||
| Controller | 操作表 | 业务说明 |
|
||
|------------|--------|----------|
|
||
| PhmmSimRecordController | phmm_sim_record | 记录生产历史数据 |
|
||
| SimReportRecordController | sim_report_record | 记录仿真报告数据 |
|
||
| SimStatisticController | sim_statistic | 仿真数据统计分析 |
|
||
| SimSegProductionAnalyseResultController | sim_seg_production_analyse_result | 工段生产分析结果 |
|
||
| SimStorageProductionAnalyseResultController | sim_storage_production_analyse_result | 存储生产分析结果 |
|
||
|
||
**业务流程**:
|
||
1. 仿真执行后，生成历史记录 (phmm_sim_record)
|
||
2. 统计分析生成结果 (sim_seg_production_analyse_result)
|
||
3. 生成仿真报告 (sim_report_record)
|
||
4. 数据统计展示 (sim_statistic)
|
||
|
||
---
|
||
|
||
## 业务流程说明
|
||
|
||
### 6.1 仿真规划流程
|
||
|
||
```
|
||
开始
|
||
↓
|
||
1. 创建仿真工程 [SimProjectController]
|
||
- 创建 sim_project 记录
|
||
- 设置工程编号、类型、状态
|
||
↓
|
||
2. 配置产线建模 [SimPlmogPackageController]
|
||
- 创建 sim_plmog_package 记录
|
||
- 建立生产单元、存储单元 [PhmmProductionController, PhmmStorageController]
|
||
- 配置PRCM模型 [PrcmLineController, PrcmSegmentController, PrcmUnitController]
|
||
- 配置设备连接关系 [PhmmConnectionController]
|
||
↓
|
||
3. 创建数据包 [SimDataPackageController]
|
||
- 创建 sim_data_package 记录
|
||
- 关联工程和产线建模
|
||
↓
|
||
4. 工单配置 [SimTobTaskController, SimTobTaskRuleConfigController]
|
||
- 导入工单数据到 sim_tob_task
|
||
- 配置工单规则到 sim_tob_task_rule_config
|
||
↓
|
||
5. 日历配置 [TobWorkcalendarController]
|
||
- 配置工作日历到 tob_workcalendar
|
||
↓
|
||
6. 验证配置 [SimController]
|
||
- verifySimConfig - 验证数据包配置
|
||
- verifyTaskOfWorkcalendarConfigBySimDatapackageCode - 验证日历配置
|
||
↓
|
||
结束
|
||
```
|
||
|
||
### 6.2 仿真执行流程
|
||
|
||
```
|
||
开始
|
||
↓
|
||
1. 选择仿真日期 [SimController]
|
||
- getSimDateForSelect - 获取可仿真的日期列表
|
||
↓
|
||
2. 执行仿真任务 [SimController]
|
||
- executeEasySimTask - 启动仿真引擎
|
||
- 读取 sim_tob_task 工单数据
|
||
- 根据 prcm_*, phmm_* 模型进行仿真计算
|
||
↓
|
||
3. 生成仿真结果
|
||
- 生成 phmm_sim_record 历史记录
|
||
↓
|
||
4. 分析结果
|
||
- 生成 sim_seg_production_analyse_result 工段分析
|
||
- 生成 sim_storage_production_analyse_result 存储分析
|
||
↓
|
||
5. 生成报告
|
||
- 保存到 sim_report_record
|
||
- 导出报告
|
||
↓
|
||
结束
|
||
```
|
||
|
||
### 6.3 基础数据维护流程
|
||
|
||
```
|
||
开始
|
||
↓
|
||
1. 物料管理
|
||
- ComMaterialTypeController - 物料类型
|
||
- ComMaterialGradeController - 物料等级
|
||
- ComSemiMaterialController - 半成品物料
|
||
↓
|
||
2. 工艺配置
|
||
- TobProcessDefineController - 定义工艺过程
|
||
- TobProcessBomController - 配置工艺BOM
|
||
↓
|
||
3. 设备建模
|
||
- PhmmProductionController - 生产单元
|
||
- PhmmStorageController - 存储单元
|
||
- PhmmConnectionController - 设备连接
|
||
↓
|
||
4. 资源配置
|
||
- ComGroupController - 班组
|
||
- ComShiftController - 班次
|
||
- TobWorkcalendarController - 工作日历
|
||
↓
|
||
结束
|
||
```
|
||
|
||
### 6.4 数据流向说明
|
||
|
||
| 数据流 | 源表 | 目标表 | 说明 |
|
||
|--------|------|--------|------|
|
||
| 工程 -> 数据包 | sim_project | sim_data_package | 每个数据包关联一个仿真工程 |
|
||
| 工程 -> 产线建模 | sim_project | sim_plmog_package | 工程关联具体的产线建模配置 |
|
||
| 数据包 -> 工单 | sim_data_package | sim_tob_task | 数据包包含多个生产工单 |
|
||
| 工单 -> 计划 | sim_tob_task | sim_tob_cigsilk_plan | 工单关联烟丝生产计划 |
|
||
| 工单 -> 历史 | sim_tob_task | phmm_sim_record | 仿真工单生成历史记录 |
|
||
| 历史 -> 分析 | phmm_sim_record | sim_seg_production_analyse_result | 历史数据经计算生成分析结果 |
|
||
| 建模包 -> 生产单元 | sim_plmog_package | phmm_production | 建模包包含多个生产单元 |
|
||
| 建模包 -> 存储单元 | sim_plmog_package | phmm_storage | 建模包包含多个存储单元 |
|
||
| 产线 -> PRCM模型 | sim_plmog_package | prcm_line, prcm_segment, prcm_unit | 产线关联PRCM模型 |
|
||
|
||
### 6.5 表与表之间的关键关系
|
||
|
||
```
|
||
sim_project (工程)
|
||
├── sim_data_package (数据包) [1:N]
|
||
│ └── sim_tob_task (工单) [1:N]
|
||
│ └── sim_tob_cigsilk_plan (计划) [1:N]
|
||
│
|
||
└── sim_plmog_package (产线建模包) [1:1]
|
||
├── phmm_production (生产单元) [1:N]
|
||
├── phmm_storage (存储单元) [1:N]
|
||
├── phmm_connection (连接关系) [1:N]
|
||
├── prcm_line (PRCM产线) [1:N]
|
||
├── prcm_segment (PRCM工段) [1:N]
|
||
└── prcm_unit (PRCM工序单元) [1:N]
|
||
|
||
com_material_type (物料类型)
|
||
└── com_material_grade (物料等级)
|
||
|
||
tob_process_define (工艺过程)
|
||
└── tob_process_bom (工艺BOM)
|
||
|
||
sim_tob_task (工单)
|
||
└── phmm_sim_record (仿真记录) [1:N]
|
||
└── sim_seg_production_analyse_result (工段分析) [N:M]
|
||
└── sim_storage_production_analyse_result (存储分析) [N:M]
|
||
```
|
||
|
||
---
|
||
|
||
## 附录
|
||
|
||
### A. 数据库表清单
|
||
|
||
#### 仿真核心表 (10+ 张)
|
||
- sim_project - 制丝仿真工程
|
||
- sim_data_package - 仿真数据包
|
||
- sim_tob_task - 生产工单
|
||
- sim_tob_cigsilk_plan - 烟丝生产计划
|
||
- sim_tob_task_rule_config - 工单规则配置
|
||
- sim_plmog_package - 产线建模包
|
||
- sim_report_record - 仿真报告记录
|
||
- sim_statistic - 仿真统计
|
||
- sim_seg_production_analyse_result - 工段生产分析结果
|
||
- sim_storage_production_analyse_result - 存储生产分析结果
|
||
|
||
#### 基础数据表 (10+ 张)
|
||
- com_material_type - 物料类型
|
||
- com_material_grade - 物料等级
|
||
- com_semi_material - 半成品物料
|
||
- com_group - 班组
|
||
- com_shift - 班次
|
||
- com_state_info - 状态信息
|
||
- tob_process_define - 工艺过程定义
|
||
- tob_process_bom - 工艺过程BOM
|
||
- tob_workcalendar - 工作日历
|
||
- tob_workcalendar_dtl - 工作日历明细
|
||
- tob_mat_product_define - 物料产品定义
|
||
- tob_segment_mat_adapt - 工段物料适配
|
||
|
||
#### 产线建模表 (10+ 张)
|
||
- phmm_production - 生产单元
|
||
- phmm_storage - 存储单元
|
||
- phmm_connection - 设备连接
|
||
- phmm_line_fbyn - PHMM产线
|
||
- phmm_production_channel - 生产通道
|
||
- phmm_storage_channel - 存储通道
|
||
- prcm_line - PRCM产线
|
||
- prcm_segment - PRCM工段
|
||
- prcm_unit - PRCM工序单元
|
||
- prcm_area - PRCM区域
|
||
- prcm_group_storage - PRCM组存储
|
||
|
||
#### 历史记录表 (5+ 张)
|
||
- phmm_sim_record - 仿真历史记录
|
||
- phmm_storage_feedandoutput - 存储投料产出
|
||
- sim_report_record - 仿真报告记录
|
||
|
||
#### 系统管理表 (10+ 张)
|
||
- sys_menu - 系统菜单
|
||
- sys_role - 角色
|
||
- sys_user - 用户
|
||
- sys_dictionary - 数据字典
|
||
- sys_log - 系统日志
|
||
|
||
### B. API接口统计
|
||
|
||
按功能模块分类统计：
|
||
- 仿真工程管理: ~20接口
|
||
- 工单管理: ~35接口
|
||
- 产线建模: ~80接口
|
||
- 基础数据管理: ~100接口
|
||
- 历史记录和统计: ~50接口
|
||
- 系统管理: ~50接口
|
||
- 其他: ~97接口
|
||
|
||
总计: **432个API接口**
|
||
|
||
### C. 技术栈说明
|
||
|
||
**后端技术栈:**
|
||
- 开发语言: Java
|
||
- 框架: Spring Boot
|
||
- ORM框架: MyBatis Plus
|
||
- API文档: Swagger
|
||
- 数据库: MySQL
|
||
|
||
**前端技术栈:**
|
||
- 框架: Vue 3
|
||
- 路由: Vue Router
|
||
- 状态管理: Vuex
|
||
- UI组件: Element UI / Ant Design Vue
|
||
- 图表: ECharts
|
||
|
||
**开发工具:**
|
||
- 构建工具: Maven / Gradle
|
||
- 版本控制: Git
|
||
- IDE: IntelliJ IDEA / VS Code
|
||
|
||
---
|
||
|
||
**文档结束**
|
||
|
||
*本文档由自动化工具生成，包含了系统数据库表结构、API接口、业务流程的详细分析。*
|