MES/yawei-mes/.tasks/2025-09-26_新BOM模块后端实现总结.md

新BOM模块后端实现总结

概述

根据前端页面的功能需求和API接口调用，完整实现了新BOM模块的后端代码，包括数据表设计、实体类、Mapper接口、Service层和Controller层。

实现的功能

1. 基础CRUD操作

   • 新增、修改、删除、查询BOM
   • BOM明细管理
   • 分页查询和条件筛选

2. 高级功能

   • BOM复制
   • BOM版本管理
   • BOM成本计算和分析
   • BOM完整性验证
   • BOM树形结构查询
   • 替代料管理
   • 用量分析
   • 导入导出功能

3. 状态管理

   • 草稿、已发布、已废弃三种状态
   • 版本发布和废弃操作

数据表结构

1. 新BOM主表 (md_new_bom)

CREATE TABLE `md_new_bom` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `material_id` bigint(20) NOT NULL COMMENT '产品物料ID',
  `product_code` varchar(100) NOT NULL COMMENT '产品编码',
  `product_name` varchar(200) NOT NULL COMMENT '产品名称',
  `specification` varchar(500) DEFAULT NULL COMMENT '规格型号',
  `version` varchar(50) NOT NULL COMMENT 'BOM版本',
  `bom_type` varchar(20) NOT NULL DEFAULT 'PRODUCTION' COMMENT 'BOM类型',
  `base_quantity` decimal(12,3) NOT NULL DEFAULT '1.000' COMMENT '基本数量',
  `unit_name` varchar(50) DEFAULT NULL COMMENT '单位名称',
  `total_cost` decimal(12,4) DEFAULT '0.0000' COMMENT '总成本',
  `material_cost` decimal(12,4) DEFAULT '0.0000' COMMENT '材料成本',
  `labor_cost` decimal(12,4) DEFAULT '0.0000' COMMENT '人工成本',
  `manufacturing_cost` decimal(12,4) DEFAULT '0.0000' COMMENT '制造费用',
  `status` char(1) NOT NULL DEFAULT '0' COMMENT '状态(0:草稿,1:已发布,2:已废弃)',
  `valid_from` date DEFAULT NULL COMMENT '有效期开始',
  `valid_to` date DEFAULT NULL COMMENT '有效期结束',
  `parent_id` bigint(20) DEFAULT NULL COMMENT '父级BOM ID',
  `has_children` tinyint(1) DEFAULT '0' COMMENT '是否有子级',
  `sort_order` int(11) DEFAULT '0' COMMENT '排序',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_product_version` (`material_id`, `version`),
  KEY `idx_material_id` (`material_id`),
  KEY `idx_bom_type` (`bom_type`),
  KEY `idx_status` (`status`),
  KEY `idx_parent_id` (`parent_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='新BOM主表';

2. 新BOM明细表 (md_new_bom_item)

CREATE TABLE `md_new_bom_item` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `bom_id` bigint(20) NOT NULL COMMENT 'BOM主表ID',
  `material_id` bigint(20) NOT NULL COMMENT '物料ID',
  `material_code` varchar(100) NOT NULL COMMENT '物料编码',
  `material_name` varchar(200) NOT NULL COMMENT '物料名称',
  `specification` varchar(500) DEFAULT NULL COMMENT '规格型号',
  `quantity` decimal(12,3) NOT NULL DEFAULT '1.000' COMMENT '用量',
  `unit_name` varchar(50) DEFAULT NULL COMMENT '单位名称',
  `loss_rate` decimal(5,2) DEFAULT '0.00' COMMENT '损耗率(%)',
  `unit_price` decimal(12,4) DEFAULT '0.0000' COMMENT '单价',
  `total_cost` decimal(12,4) DEFAULT '0.0000' COMMENT '小计成本',
  `material_type` varchar(20) DEFAULT 'PURCHASED' COMMENT '物料类型',
  `is_key_component` tinyint(1) DEFAULT '0' COMMENT '是否关键件',
  `supplier_id` bigint(20) DEFAULT NULL COMMENT '供应商ID',
  `supplier_name` varchar(200) DEFAULT NULL COMMENT '供应商名称',
  `alternative_materials` text DEFAULT NULL COMMENT '替代料信息',
  `process_route` varchar(500) DEFAULT NULL COMMENT '工艺路线',
  `sort_order` int(11) DEFAULT '0' COMMENT '排序',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  KEY `idx_bom_id` (`bom_id`),
  KEY `idx_material_id` (`material_id`),
  KEY `idx_supplier_id` (`supplier_id`),
  KEY `idx_material_type` (`material_type`),
  CONSTRAINT `fk_bom_item_bom_id` FOREIGN KEY (`bom_id`) REFERENCES `md_new_bom` (`id`) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='新BOM明细表';

3. 其他辅助表

• md_new_bom_version: BOM版本历史表
• md_new_bom_cost_analysis: BOM成本分析表
• md_new_bom_substitute: 替代料关系表

后端代码结构

1. 实体类 (Domain)

• NewBom.java - BOM主实体
• NewBomItem.java - BOM明细实体
• NewBomVersion.java - BOM版本实体
• NewBomCostAnalysis.java - BOM成本分析实体

2. Mapper接口层

• NewBomMapper.java - BOM主表数据访问接口
• NewBomItemMapper.java - BOM明细表数据访问接口
• 对应的XML映射文件：
  • NewBomMapper.xml
  • NewBomItemMapper.xml

3. Service业务层

• INewBomService.java - BOM业务接口
• NewBomServiceImpl.java - BOM业务实现类

4. Controller控制层

• NewBomController.java - BOM控制器

API接口列表

基础CRUD接口

• GET /masterdata/newBom/list - 查询BOM列表
• GET /masterdata/newBom/{id} - 获取BOM详情
• POST /masterdata/newBom - 新增BOM
• PUT /masterdata/newBom - 修改BOM
• DELETE /masterdata/newBom/{ids} - 删除BOM

高级功能接口

• POST /masterdata/newBom/copy/{id} - 复制BOM
• POST /masterdata/newBom/export - 导出BOM
• POST /masterdata/newBom/import - 导入BOM
• GET /masterdata/newBom/tree/{parentId} - 获取BOM树结构
• GET /masterdata/newBom/cost/{id} - 计算BOM成本
• GET /masterdata/newBom/versions/{bomId} - 获取BOM版本历史
• POST /masterdata/newBom/publish - 发布BOM版本
• GET /masterdata/newBom/substitutes/{materialId} - 获取替代料列表
• GET /masterdata/newBom/analysis/{id} - 获取BOM用量分析
• GET /masterdata/newBom/validate/{id} - 验证BOM完整性

主要特性

1. 成本计算

• 自动计算明细成本：用量 × 单价 × (1 + 损耗率/100)
• 总成本 = 材料成本 + 人工成本 + 制造费用
• 支持成本占比分析

2. 版本管理

• 支持多版本BOM管理
• 版本状态控制（草稿、已发布、已废弃）
• 版本复制功能
• 版本历史查询

3. 数据验证

• BOM完整性验证
• 唯一性约束（物料+版本）
• 业务规则验证

4. 权限控制

• 基于角色的权限控制
• 细粒度操作权限
• 数据安全保障

使用说明

1. 执行数据表创建SQL语句
2. 确保相关依赖项存在：
   • Material（物料）表和相关服务
   • Supplier（供应商）表和相关服务
   • 权限管理系统
3. 配置权限：
   • masterdata:newBom:list - 查询权限
   • masterdata:newBom:add - 新增权限
   • masterdata:newBom:edit - 修改权限
   • masterdata:newBom:remove - 删除权限
   • masterdata:newBom:export - 导出权限
   • masterdata:newBom:import - 导入权限
   • 其他功能权限...

注意事项

1. 数据完整性：BOM明细与主表通过外键关联，删除主表时会级联删除明细
2. 版本控制：已发布的BOM不能直接删除，需要先废弃
3. 成本计算：成本计算为实时计算，可考虑加入缓存机制
4. 并发控制：修改BOM时需要注意并发更新问题
5. 性能优化：大量数据时建议添加适当索引

扩展建议

1. 审批流程：可以增加BOM审批流程
2. 变更记录：增加BOM变更历史记录
3. 模板功能：支持BOM模板功能
4. 批量操作：支持批量导入导出明细
5. 集成功能：与ERP、PLM等系统集成