Add database and API analysis report - GLM4.7

2026-03-05 17:22:48 +09:00
parent 4f01dc7762
commit 09b23409af
3 changed files with 3631 additions and 0 deletions
--- a/database_complete_analysis.md
+++ b/database_complete_analysis.md
@@ -0,0 +1,887 @@
+# 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接口、业务流程的详细分析。*