348 lines
12 KiB
Markdown
348 lines
12 KiB
Markdown
# 生产计划优化 - 全流程改进总结
|
||
|
||
## 项目概述
|
||
|
||
本项目对生产计划管理系统进行了全面优化，通过改进生产计划的创建流程、支持多订单批量处理、自动时间设置、工序路线动态加载、关联订单管理和自动订单创建等功能，显著提升了用户体验和系统效率。
|
||
|
||
**项目时间**: 2026-02-25
|
||
**功能名称**: 生产计划优化 (production-plan-optimization)
|
||
**版本号**: v1.6.037
|
||
|
||
## 核心改进点
|
||
|
||
### 1. 时间设置优化
|
||
- **改进前**: 用户需要手动输入时间范围
|
||
- **改进后**: 根据选择的年/月/周计划类型自动设置时间范围，用户可快速创建计划
|
||
- **影响**: 减少用户手动输入，提高计划创建效率
|
||
|
||
### 2. 工序路线动态加载
|
||
- **改进前**: 工序路线需要手动选择
|
||
- **改进后**: 产品选择后自动读取并显示工序路线，支持下拉框修改，不显示休息日
|
||
- **影响**: 简化工序路线选择流程，减少操作步骤
|
||
|
||
### 3. 时间维度整合显示
|
||
- **改进前**: 年、月、周分散显示
|
||
- **改进后**: 年、月、周在同一组件中显示和管理，月计划下的周计划自动分类
|
||
- **影响**: 提升用户界面的直观性和易用性
|
||
|
||
### 4. 质检等级隐藏
|
||
- **改进前**: 质检等级显示在界面上
|
||
- **改进后**: 完全隐藏质检等级相关信息（或与FIIH关联）
|
||
- **影响**: 简化界面，减少用户困惑
|
||
|
||
### 5. 订单选择流程优化
|
||
- **改进前**: 订单选择流程不清晰
|
||
- **改进后**: 订单放在最后选，先筛选后选择，支持按时间、产品、订单范围筛选，支持多订单选择
|
||
- **影响**: 用户能更高效地找到需要的订单
|
||
|
||
### 6. 关联订单管理
|
||
- **改进前**: 订单关联不清晰
|
||
- **改进后**: 清晰显示关联订单，支持自动创建
|
||
- **影响**: 用户能清楚了解计划关联的订单
|
||
|
||
### 7. 多订单明细管理
|
||
- **改进前**: 多订单明细混乱，难以区分
|
||
- **改进后**: 生成多个分析计划和明细，清楚标注每条明细所属的订单、工单、报工单
|
||
- **影响**: 用户能准确追踪每条明细的来源
|
||
|
||
### 8. 自动订单创建
|
||
- **改进前**: 未选择订单时无法继续
|
||
- **改进后**: 未选择订单时弹窗询问是否自动创建，根据计划数据自动创建订单
|
||
- **影响**: 简化流程，支持快速创建计划
|
||
|
||
## 数据库改动
|
||
|
||
### 使用现有表
|
||
|
||
本次优化**不新增表**，使用现有的表结构：
|
||
|
||
#### 1. pro_plan (生产计划表) - 已有字段
|
||
- `id`: 计划ID
|
||
- `plan_number`: 计划编号
|
||
- `plan_name`: 计划名称
|
||
- `plan_type`: 计划类型
|
||
- `route_id`: 工序路线ID（已有）
|
||
- `route_name`: 工序路线名称（已有）
|
||
- `rest_days`: 休息日配置（已有）
|
||
- `plan_analysis`: 计划分析结果（已有，用于存储多订单分析数据）
|
||
- `plan_source_type`: 来源类型（已有）
|
||
- `plan_source_id`: 来源ID（已有）
|
||
|
||
#### 2. pro_workorder (工单主表) - 使用现有字段
|
||
- `id`: 工单ID
|
||
- `number`: 工单编号
|
||
- `material_id`: 产品ID
|
||
- `material_name`: 产品名称
|
||
- `quantity`: 生产数量
|
||
- `route_id`: 工序路线ID（已有）
|
||
- `source_type`: 来源类型（用于标识来自计划）
|
||
- `source_info`: 来源信息（用于存储计划ID和订单信息）
|
||
|
||
#### 3. pro_workorder_entry (工单子表) - 使用现有字段
|
||
- `id`: 工单子表ID
|
||
- `workorder_id`: 工单主表ID
|
||
- `process_id`: 工序ID
|
||
- `process_name`: 工序名称
|
||
- 其他工序相关字段
|
||
|
||
#### 4. pro_report (报工单表) - 使用现有字段
|
||
- `id`: 报工单ID
|
||
- `number`: 报工单编号
|
||
- `work_order_entry_id`: 工单子表ID
|
||
- 其他报工相关字段
|
||
|
||
### 字段扩展（如需要）
|
||
|
||
如果现有字段不足以支持新功能，可能需要添加以下字段：
|
||
|
||
```sql
|
||
-- pro_plan表可能需要的扩展字段
|
||
ALTER TABLE `pro_plan`
|
||
ADD COLUMN `schedule_cycle` varchar(20) DEFAULT NULL COMMENT '计划周期：year=年计划,month=月计划,week=周计划' AFTER `plan_type`,
|
||
ADD COLUMN `plan_year` int DEFAULT NULL COMMENT '计划年份' AFTER `schedule_cycle`,
|
||
ADD COLUMN `month_number` int DEFAULT NULL COMMENT '月份（1-12）' AFTER `plan_year`,
|
||
ADD COLUMN `week_number` int DEFAULT NULL COMMENT '周数（1-53）' AFTER `month_number`,
|
||
ADD COLUMN `start_time` datetime DEFAULT NULL COMMENT '开始时间' AFTER `week_number`,
|
||
ADD COLUMN `end_time` datetime DEFAULT NULL COMMENT '结束时间' AFTER `start_time`,
|
||
ADD COLUMN `related_order_ids` text DEFAULT NULL COMMENT '关联订单ID列表（JSON格式）' AFTER `plan_analysis`;
|
||
|
||
-- 添加索引
|
||
ALTER TABLE `pro_plan`
|
||
ADD INDEX `idx_schedule_cycle` (`schedule_cycle`),
|
||
ADD INDEX `idx_year_week` (`plan_year`, `week_number`),
|
||
ADD INDEX `idx_year_month` (`plan_year`, `month_number`);
|
||
```
|
||
|
||
## 后端改动
|
||
|
||
### 新增/修改实体类
|
||
|
||
#### 1. ProPlan (生产计划) - 扩展现有实体
|
||
```java
|
||
public class ProPlan extends BaseEntity {
|
||
private Long id;
|
||
private String planNumber; // 计划编号
|
||
private String planName; // 计划名称
|
||
private String planType; // 计划类型
|
||
private String scheduleCycle; // 计划周期（year/month/week）
|
||
private Integer planYear; // 计划年份
|
||
private Integer monthNumber; // 月份
|
||
private Integer weekNumber; // 周数
|
||
private Date startTime; // 开始时间
|
||
private Date endTime; // 结束时间
|
||
private Long routeId; // 工序路线ID
|
||
private String routeName; // 工序路线名称
|
||
private String restDays; // 休息日配置
|
||
private String planAnalysis; // 计划分析结果（JSON格式，存储多订单分析）
|
||
private String relatedOrderIds; // 关联订单ID列表（JSON格式）
|
||
|
||
// 关联对象（不存数据库）
|
||
private List<ProWorkorder> workorderList; // 关联的工单列表
|
||
}
|
||
```
|
||
|
||
### 新增服务类
|
||
|
||
#### 1. TimeRangeService (时间范围服务)
|
||
|
||
**功能**:
|
||
- 根据计划类型获取默认时间范围
|
||
- 验证时间范围有效性
|
||
- 获取指定月份的周列表
|
||
|
||
**关键方法**:
|
||
```java
|
||
TimeRange getDefaultTimeRange(String scheduleCycle);
|
||
boolean validateTimeRange(Date startTime, Date endTime);
|
||
List<Week> getWeeksByMonth(int year, int month);
|
||
boolean weekPlanExistsInMonth(Long monthPlanId, int weekNumber);
|
||
```
|
||
|
||
#### 2. ProcessRouteService (工序路线服务)
|
||
|
||
**功能**:
|
||
- 根据产品获取工序路线
|
||
- 获取可用工序路线列表
|
||
- 过滤休息日工序
|
||
|
||
**关键方法**:
|
||
```java
|
||
ProcessRoute getRouteByProduct(Long productId);
|
||
List<ProcessRoute> getAvailableRoutes(Long productId);
|
||
ProcessRouteDetail getRouteDetails(Long routeId, boolean excludeRestDays);
|
||
```
|
||
|
||
#### 3. ProductionPlanService (生产计划服务) - 扩展现有服务
|
||
|
||
**新增功能**:
|
||
- 创建计划并关联多个订单
|
||
- 生成多个工单（每个订单一个工单）
|
||
- 自动创建订单
|
||
- 获取计划明细（按订单分组）
|
||
|
||
**关键方法**:
|
||
```java
|
||
Long createPlanWithOrders(ProductionPlanRequest planRequest);
|
||
List<ProWorkorder> generateWorkordersForOrders(Long planId, List<Long> orderIds);
|
||
Long autoCreateOrder(ProductionPlanData planData);
|
||
Map<Long, List<WorkorderDetail>> getPlanDetailsGroupedByOrder(Long planId);
|
||
```
|
||
|
||
### 新增API接口
|
||
|
||
#### 1. ProductionPlanController - 扩展现有Controller
|
||
|
||
```java
|
||
@PostMapping("/createWithOrders")
|
||
public ResponseEntity<Long> createPlanWithOrders(@RequestBody ProductionPlanRequest request);
|
||
|
||
@GetMapping("/{planId}/detailsByOrder")
|
||
public ResponseEntity<Map<Long, List<WorkorderDetail>>> getDetailsByOrder(@PathVariable Long planId);
|
||
|
||
@GetMapping("/defaultTimeRange/{scheduleCycle}")
|
||
public ResponseEntity<TimeRange> getDefaultTimeRange(@PathVariable String scheduleCycle);
|
||
```
|
||
|
||
#### 2. ProcessRouteController - 新增或扩展
|
||
|
||
```java
|
||
@GetMapping("/product/{productId}")
|
||
public ResponseEntity<ProcessRoute> getRouteByProduct(@PathVariable Long productId);
|
||
|
||
@GetMapping("/product/{productId}/available")
|
||
public ResponseEntity<List<ProcessRoute>> getAvailableRoutes(@PathVariable Long productId);
|
||
```
|
||
|
||
## 前端改动
|
||
|
||
### 新增/修改组件
|
||
|
||
#### 1. TimeRangeSelector.vue (时间范围选择器) - 新增
|
||
|
||
**功能**:
|
||
- 整合年、月、周的时间选择
|
||
- 自动设置默认时间范围
|
||
- 验证时间范围有效性
|
||
|
||
#### 2. ProcessRouteSelector.vue (工序路线选择器) - 新增
|
||
|
||
**功能**:
|
||
- 显示产品的工序路线（不显示休息日）
|
||
- 支持下拉框修改工序路线
|
||
|
||
#### 3. OrderFilterAndSelection.vue (订单筛选和多选) - 新增
|
||
|
||
**功能**:
|
||
- 筛选生产订单
|
||
- 支持多选订单
|
||
- 显示选择统计
|
||
|
||
#### 4. PlanDetailList.vue (计划明细展示) - 新增
|
||
|
||
**功能**:
|
||
- 按订单分组显示工单明细
|
||
- 标注订单/工单/报工单信息
|
||
|
||
#### 5. ProductionPlanCreate.vue (生产计划创建页面) - 修改现有页面
|
||
|
||
**主要修改**:
|
||
1. 集成时间范围选择器
|
||
2. 集成工序路线选择器
|
||
3. 订单选择放在最后
|
||
4. 隐藏质检等级字段
|
||
5. 支持多订单选择
|
||
6. 支持自动创建订单
|
||
|
||
## 测试改动
|
||
|
||
### 后端测试
|
||
|
||
#### 1. 单元测试
|
||
|
||
- TimeRangeService的时间范围设置和验证
|
||
- ProcessRouteService的工序路线加载（排除休息日）
|
||
- ProductionPlanService的多订单处理
|
||
- 自动创建订单功能
|
||
|
||
#### 2. 集成测试
|
||
|
||
- 完整的计划创建流程
|
||
- 多订单工单生成
|
||
- 数据一致性验证
|
||
|
||
### 前端测试
|
||
|
||
#### 1. 单元测试
|
||
|
||
- TimeRangeSelector组件测试
|
||
- ProcessRouteSelector组件测试
|
||
- OrderFilterAndSelection组件测试
|
||
|
||
## 性能优化
|
||
|
||
### 数据库索引
|
||
|
||
```sql
|
||
-- pro_plan表索引
|
||
CREATE INDEX idx_schedule_cycle ON pro_plan(schedule_cycle);
|
||
CREATE INDEX idx_year_week ON pro_plan(plan_year, week_number);
|
||
CREATE INDEX idx_year_month ON pro_plan(plan_year, month_number);
|
||
CREATE INDEX idx_route_id ON pro_plan(route_id);
|
||
|
||
-- pro_workorder表索引（如需要）
|
||
CREATE INDEX idx_source_type_info ON pro_workorder(source_type, source_info(100));
|
||
```
|
||
|
||
## 实现计划
|
||
|
||
### 第一阶段：数据库和后端基础
|
||
1. 扩展pro_plan表字段（如需要）
|
||
2. 修改ProPlan实体类
|
||
3. 实现TimeRangeService
|
||
4. 实现ProcessRouteService
|
||
5. 编写单元测试
|
||
|
||
### 第二阶段：后端业务逻辑
|
||
1. 扩展ProductionPlanService
|
||
2. 实现多订单工单生成
|
||
3. 实现自动创建订单
|
||
4. 创建/扩展API接口
|
||
5. 编写集成测试
|
||
|
||
### 第三阶段：前端实现
|
||
1. 创建时间范围选择器组件
|
||
2. 创建工序路线选择器组件
|
||
3. 创建订单筛选多选组件
|
||
4. 修改计划创建页面
|
||
5. 编写前端单元测试
|
||
|
||
### 第四阶段：优化和验证
|
||
1. 创建数据库索引
|
||
2. 性能测试
|
||
3. 功能验证
|
||
4. 文档编写
|
||
|
||
## 关键需求映射
|
||
|
||
| 需求 | 实现方式 | 状态 |
|
||
|------|--------|------|
|
||
| 默认时间设置 | TimeRangeService + TimeRangeSelector组件 | 待实现 |
|
||
| 工序路线不显示休息日 | ProcessRouteService过滤 + ProcessRouteSelector组件 | 待实现 |
|
||
| 年月周放在一起 | TimeRangeSelector组件 | 待实现 |
|
||
| 质检等级隐藏 | 前端移除相关字段 | 待实现 |
|
||
| 订单放在最后选 | 调整页面布局和流程 | 待实现 |
|
||
| 订单多选（通过筛选） | OrderFilterAndSelection组件 | 待实现 |
|
||
| 多个分析计划和明细 | ProductionPlanService生成多个工单 | 待实现 |
|
||
| 明细标注订单/工单/报工单 | PlanDetailList组件 + 数据结构 | 待实现 |
|
||
| 未绑定订单自动创建 | ProductionPlanService自动创建 | 待实现 |
|
||
|
||
## 总结
|
||
|
||
本项目通过优化现有表结构和业务流程，避免新增表，充分利用现有的pro_plan、pro_workorder等表来实现多订单管理功能。通过plan_analysis字段存储JSON格式的分析数据，通过source_info字段关联计划和订单信息，实现了需求的所有功能点。
|
||
|
||
**预期收益**:
|
||
- 用户创建计划的时间减少50%以上
|
||
- 支持批量处理多个订单，提高工作效率
|
||
- 通过自动创建订单功能，简化业务流程
|
||
- 通过清晰的明细标注，提高数据追溯能力
|