geMoldInsight/docs/TASKS_ALUMINUM_FOAM_MOLD.md

# 铝制家电包装泡沫模具分模功能开发任务清单

## 文档信息

| 项目 | 内容 |
|------|------|
| **文档名称** | 铝制家电包装泡沫模具分模功能开发任务清单 |
| **版本** | 1.0 |
| **日期** | 2026-03-13 |
| **项目** | geMoldInsight 模具分模功能增强 |

---

## 任务总览

| 阶段 | 任务数 | 预计工期 |
|------|--------|----------|
| 第一阶段：基础框架 | 8 | 2 周 |
| 第二阶段：分模算法 | 10 | 2 周 |
| 第三阶段：质量检测 | 6 | 2 周 |
| 第四阶段：可视化和交互 | 8 | 2 周 |
| 第五阶段：数据接口和测试 | 6 | 1 周 |
| **总计** | **38** | **9 周** |

---

## 第一阶段：基础框架搭建 (1-2 周)

### 任务 1.1：创建铝泡沫模具参数类

**任务描述**：创建专门针对铝泡沫材料的参数配置类

**详细说明**：
- 在 `src/core/mold_generator.py` 中添加 `AluminumFoamMoldParams` 类
- 定义铝泡沫专用参数（发泡倍率、目标密度、成型温度等）
- 实现参数验证和默认值设置

**验收标准**：
- 参数类包含所有铝泡沫专用参数
- 参数验证通过

**预计工时**：4 小时

**依赖任务**：无

---

### 任务 1.2：创建铝泡沫材料数据库

**任务描述**：建立铝泡沫材料数据库，包含常用材料参数

**详细说明**：
- 创建材料数据库类 `FoamMaterialDatabase`
- 添加 AlSi10Mg、AlSi12、纯铝泡沫等常用材料
- 支持材料查询和参数获取

**验收标准**：
- 数据库包含至少 5 种铝泡沫材料
- 支持按名称查询材料参数

**预计工时**：4 小时

**依赖任务**：1.1

---

### 任务 1.3：扩展现有模具生成器

**任务描述**：扩展 `MoldCavityGenerator` 类支持铝泡沫参数

**详细说明**：
- 添加铝泡沫参数到构造函数
- 添加材料设置方法 `set_foam_material()`
- 适配现有的分模流程

**验收标准**：
- 可以使用铝泡沫参数创建生成器
- 参数正确传递给分模流程

**预计工时**：4 小时

**依赖任务**：1.1, 1.2

---

### 任务 1.4：创建参数配置 API 接口

**任务描述**：添加前端参数配置 API

**详细说明**：
- 在 `src/api/routes.py` 中添加参数相关路由
- 实现参数获取、设置、验证接口
- 支持参数模板保存和加载

**验收标准**：
- API 可以获取和设置分模参数
- 参数验证正确返回错误信息

**预计工时**：4 小时

**依赖任务**：1.3

---

### 任务 1.5：前端参数面板开发

**任务描述**：在 Web 界面中添加分模参数配置面板

**详细说明**：
- 在 `static/vue-app.js` 中添加参数配置组件
- 实现滑块、输入框、选择框等控件
- 支持参数实时预览

**验收标准**：
- 界面显示所有可配置参数
- 参数修改正确提交到后端

**预计工时**：8 小时

**依赖任务**：1.4

---

### 任务 1.6：参数模板功能

**任务描述**：实现参数模板保存和加载功能

**详细说明**：
- 创建预设参数模板（快速、经济、高精度等）
- 支持用户保存自定义模板
- 模板存储到数据库

**验收标准**：
- 至少 3 个预设模板可用
- 用户可以保存和加载模板

**预计工时**：4 小时

**依赖任务**：1.4, 1.5

---

### 任务 1.7：参数验证逻辑

**任务描述**：实现参数合法性验证

**详细说明**：
- 验证数值范围（角度、容差等）
- 验证参数组合合法性
- 返回详细的验证错误信息

**验收标准**：
- 所有参数都有验证逻辑
- 错误信息清晰明了

**预计工时**：4 小时

**依赖任务**：1.1

---

### 任务 1.8：阶段一集成测试

**任务描述**：测试参数系统的完整性

**详细说明**：
- 测试参数设置和获取
- 测试参数验证
- 测试前端交互

**验收标准**：
- 所有功能正常运行
- 无明显 bug

**预计工时**：4 小时

**依赖任务**：1.1-1.7

---

## 第二阶段：分模算法优化 (3-4 周)

### 任务 2.1：改进法向量分析算法

**任务描述**：改进分型面检测的法向量分析算法

**详细说明**：
- 添加高斯权重计算
- 支持多点采样
- 识别主分型方向

**验收标准**：
- 算法能正确处理复杂几何产品
- 分型方向准确率 > 90%

**预计工时**：8 小时

**依赖任务**：无

---

### 任务 2.2：实现多分型面检测

**任务描述**：支持复杂产品的多个分型面

**详细说明**：
- 识别需要多次分模的区域
- 正确处理分型面优先级
- 生成有序的分型面列表

**验收标准**：
- 能正确检测 2 个以上分型面
- 分型面顺序正确

**预计工时**：12 小时

**依赖任务**：2.1

---

### 任务 2.3：倒扣区域检测

**任务描述**：自动识别产品倒扣区域

**详细说明**：
- 分析产品几何特征
- 标记倒扣区域位置
- 提供处理建议

**验收标准**：
- 能识别常见的倒扣类型
- 提供准确的倒扣位置

**预计工时**：8 小时

**依赖任务**：2.1

---

### 任务 2.4：改进拔模角计算

**任务描述**：实现完整的拔模角计算和应用

**详细说明**：
- 使用 OpenCASCADE 拔模功能
- 支持不同拔模方向
- 处理拔模干涉

**验收标准**：
- 拔模角正确应用到模型
- 无明显变形或错误

**预计工时**：12 小时

**依赖任务**：无

---

### 任务 2.5：铝泡沫收缩补偿

**任务描述**：针对铝泡沫实现特殊的收缩补偿

**详细说明**：
- 基于发泡倍率计算收缩
- 多向收缩补偿
- 补偿后尺寸验证

**验收标准**：
- 收缩补偿量准确
- 补偿后模型无异常

**预计工时**：8 小时

**依赖任务**：1.2

---

### 任务 2.6：型腔分离优化

**任务描述**：改进型腔和型芯的分离算法

**详细说明**：
- 精确的布尔运算
- 处理复杂几何
- 分离结果验证

**验收标准**：
- 型腔/型芯分离正确
- 分离过程无错误

**预计工时**：8 小时

**依赖任务**：无

---

### 任务 2.7：模具块生成

**任务描述**：生成完整的模具块结构

**详细说明**：
- 计算模具尺寸
- 添加余量
- 生成 A/B 板结构

**验收标准**：
- 模具块尺寸合理
- 包含必要的结构元素

**预计工时**：8 小时

**依赖任务**：2.6

---

### 任务 2.8：分型线平滑处理

**任务描述**：对分型线进行平滑处理

**详细说明**：
- B 样条曲线拟合
- 尖角处理
- 平滑度验证

**验收标准**：
- 分型线平滑无毛刺
- 保持原始几何精度

**预计工时**：6 小时

**依赖任务**：2.2

---

### 任务 2.9：算法性能优化

**任务描述**：优化分模算法性能

**详细说明**：
- 并行计算支持
- 缓存优化
- 增量计算

**验收标准**：
- 分模时间 < 30 秒
- 内存占用 < 1GB

**预计工时**：8 小时

**依赖任务**：2.1-2.8

---

### 任务 2.10：阶段二集成测试

**任务描述**：测试分模算法的完整流程

**详细说明**：
- 使用测试产品验证
- 对比不同参数结果
- 性能测试

**验收标准**：
- 算法稳定运行
- 结果准确合理

**预计工时**：8 小时

**依赖任务**：2.1-2.9

---

## 第三阶段：质量检测模块 (5-6 周)

### 任务 3.1：创建质量检测器类

**任务描述**：创建 `MoldQualityInspector` 质量检测类

**详细说明**：
- 设计检测器架构
- 定义检测接口
- 实现结果数据结构

**验收标准**：
- 类结构完整
- 接口定义清晰

**预计工时**：4 小时

**依赖任务**：无

---

### 任务 3.2：分模面平滑度检测

**任务描述**：检测分模面的平滑度

**详细说明**：
- 曲率分析
- 凹凸检测
- 评分计算

**验收标准**：
- 正确识别不平滑区域
- 给出评分 (0-100)

**预计工时**：8 小时

**依赖任务**：3.1

---

### 任务 3.3：分模面连续性检测

**任务描述**：检测分模面的连续性

**详细说明**：
- 边界检查
- 间隙检测
- 完整性验证

**验收标准**：
- 能识别间隙和断点
- 报告位置和大小

**预计工时**：6 小时

**依赖任务**：3.1

---

### 任务 3.4：模具结构合理性检测

**任务描述**：检测模具结构的合理性

**详细说明**：
- 模具尺寸检查
- 壁厚检查
- 干涉检查

**验收标准**：
- 识别所有结构问题
- 提供修改建议

**预计工时**：8 小时

**依赖任务**：3.1

---

### 任务 3.5：生产可行性评估

**任务描述**：评估模具的生产可行性

**详细说明**：
- 注塑压力计算
- 锁模力计算
- 成型周期估算

**验收标准**：
- 估算值在合理范围
- 提供改进建议

**预计工时**：8 小时

**依赖任务**：3.1

---

### 任务 3.6：质量报告生成

**任务描述**：生成完整的质量检测报告

**详细说明**：
- 汇总各项检测结果
- 生成 PDF 格式报告
- 支持导出

**验收标准**：
- 报告内容完整
- 格式规范

**预计工时**：6 小时

**依赖任务**：3.2-3.5

---

## 第四阶段：可视化和交互 (5-6 周)

### 任务 4.1：分型面可视化增强

**任务描述**：改进分型面的可视化效果

**详细说明**：
- 分型面颜色和透明度设置
- 边缘高亮
- 动态效果

**验收标准**：
- 分型面清晰可见
- 与产品形成对比

**预计工时**：4 小时

**依赖任务**：无

---

### 任务 4.2：分型线可视化增强

**任务描述**：改进分型线的可视化

**详细说明**：
- 线条颜色和粗细
- 端点标记
- 动态绘制效果

**验收标准**：
- 分型线清晰可见
- 便于观察细节

**预计工时**：4 小时

**依赖任务**：无

---

### 任务 4.3：交互式分型面调整

**任务描述**：支持用户拖拽调整分型面

**详细说明**：
- 鼠标拖拽事件
- 实时更新模型
- 撤销/重做支持

**验收标准**：
- 拖拽响应流畅
- 模型正确更新

**预计工时**：12 小时

**依赖任务**：4.1

---

### 任务 4.4：交互式参数调整

**任务描述**：支持实时调整参数并预览效果

**详细说明**：
- 滑块实时更新
- 参数变化动画
- 效果对比

**验收标准**：
- 调整流畅无延迟
- 效果正确显示

**预计工时**：8 小时

**依赖任务**：1.5

---

### 任务 4.5：剖视图功能

**任务描述**：添加剖视图功能

**详细说明**：
- 沿分型面剖切
- 内部结构显示
- 剖面编辑

**验收标准**：
- 剖视图正确显示
- 切换流畅

**预计工时**：8 小时

**依赖任务**：4.1

---

### 任务 4.6：测量工具

**任务描述**：添加测量工具

**详细说明**：
- 距离测量
- 角度测量
- 测量结果标注

**验收标准**：
- 测量结果准确
- 操作便捷

**预计工时**：8 小时

**依赖任务**：无

---

### 任务 4.7：视角控制增强

**任务描述**：改进视角控制

**详细说明**：
- 预设视角
- 动画过渡
- 自动对准

**验收标准**：
- 视角切换流畅
- 自动对准准确

**预计工时**：4 小时

**依赖任务**：无

---

### 任务 4.8：导出视图功能

**任务描述**：支持导出当前视图

**详细说明**：
- PNG 图片导出
- 高清截图
- 报告插图

**验收标准**：
- 导出图片清晰
- 格式正确

**预计工时**：4 小时

**依赖任务**：4.1-4.7

---

## 第五阶段：数据接口和测试 (7-8 周)

### 任务 5.1：STEP 导出接口

**任务描述**：实现 STEP 格式导出

**详细说明**：
- 使用 PythonOCC 导出 STEP
- 包含分模后模型
- 验证导出正确性

**验收标准**：
- 导出文件可被 CAD 打开
- 几何正确

**预计工时**：8 小时

**依赖任务**：无

---

### 任务 5.2：JSON 数据导出

**任务描述**：实现 JSON 格式导出

**详细说明**：
- 导出分模参数
- 导出几何数据
- 导出质量报告

**验收标准**：
- JSON 格式正确
- 数据完整

**预计工时**：4 小时

**依赖任务**：无

---

### 任务 5.3：PDF 报告导出

**任务描述**：实现 PDF 格式报告导出

**详细说明**：
- 质量检测报告
- 包含图表和说明
- 模板支持

**验收标准**：
- PDF 生成成功
- 内容完整

**预计工时**：8 小时

**依赖任务**：3.6

---

### 任务 5.4：IGES 格式支持

**任务描述**：添加 IGES 格式支持

**详细说明**：
- IGES 导入
- IGES 导出
- 格式验证

**验收标准**：
- 导出文件可被 CAM 软件使用

**预计工时**：6 小时

**依赖任务**：5.1

---

### 任务 5.5：集成测试

**任务描述**：完整的系统集成测试

**详细说明**：
- 功能测试
- 性能测试
- 兼容性测试

**验收标准**：
- 所有功能正常运行
- 达到性能指标

**预计工时**：8 小时

**依赖任务**：全部

---

### 任务 5.6：用户验收测试

**任务描述**：配合用户进行验收测试

**详细说明**：
- 演示功能
- 收集反馈
- 修复问题

**验收标准**：
- 用户满意
- 达到预期目标

**预计工时**：8 小时

**依赖任务**：5.5

---

## 任务依赖关系图

```
第一阶段: 基础框架
├── 1.1 创建参数类
├── 1.2 材料数据库 ──┐
├── 1.3 扩展生成器 ──┼── 1.4 API ──┬── 1.5 前端 ──┬── 1.6 模板 ──┬── 1.7 验证 ──→ 1.8 测试
│                    │              │              │              │
└────────────────────┴──────────────┴──────────────┴──────────────┘

第二阶段: 分模算法
│
├── 2.1 法向量分析 ──→ 2.2 多分型面 ──→ 2.3 倒扣检测
│
├── 2.4 拔模角 ──────────────────────────────────────────────────────────┐
│                                                                          │
├── 2.5 收缩补偿 ◄──────────────────┐                                    │
│                                     │                                    │
├── 2.6 型腔分离 ──→ 2.7 模具块 ──→ 2.8 平滑处理 ──→ 2.9 优化 ──→ 2.10 测试
│                                                                          │
└────────────────────────────────────┴────────────────────────────────────┘

第三阶段: 质量检测
│
├── 3.1 检测器类 ──→ 3.2 平滑度 ──→ 3.3 连续性 ──→ 3.4 结构 ──→ 3.5 可行性 ──→ 3.6 报告
│
└────────────────────────────────────┬────────────────────────────────────┘

第四阶段: 可视化
│
├── 4.1 分型面 ──→ 4.2 分型线 ──→ 4.3 拖拽 ──→ 4.4 参数调整 ──→ 4.5 剖视
│                                    │                                    │
├── 4.6 测量 ──→ 4.7 视角 ──→ 4.8 导出 ◄─────────────┘
│
└────────────────────────────────────┬────────────────────────────────────┘

第五阶段: 接口和测试
│
├── 5.1 STEP ──→ 5.2 JSON ◄──┐
│                              │
├── 5.3 PDF ◄─────────────────┼── 5.4 IGES ──→ 5.5 集成 ──→ 5.6 验收
│                              │
└──────────────────────────────┘
```

---

## 资源分配

| 角色 | 任务 | 预计工时 |
|------|------|----------|
| 后端开发 | 1.1-1.4, 2.1-2.10, 3.1-3.6, 5.1-5.4 | 180 小时 |
| 前端开发 | 1.5-1.6, 4.1-4.8 | 60 小时 |
| 测试 | 1.8, 2.10, 5.5-5.6 | 32 小时 |
| **总计** | | **272 小时** |

---

## 风险评估

| 风险 | 影响 | 应对措施 |
|------|------|----------|
| 算法复杂度高 | 时间延误 | 预留缓冲时间，分阶段交付 |
| OpenCASCADE 兼容问题 | 功能受限 | 多种实现方案，准备备选 |
| 性能不达标 | 用户体验差 | 持续优化，必要时降级功能 |
| 需求变更 | 计划调整 | 敏捷开发，快速迭代 |

---

**文档结束**