# 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接口、业务流程的详细分析。*