# ProBom

**Repository Path**: pekua/pro-bom

## Basic Information

- **Project Name**: ProBom
- **Description**: 用于erpnext中bom创建
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2025-10-28
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ProBOM - 专业BOM管理工具

ProBOM是一个ERPNext自定义应用，专门用于优化和简化BOM（物料清单）创建流程。通过批量上传和智能映射功能，大大提高BOM创建的效率。

## 功能特性

### 🚀 核心功能
- **批量上传材料清单**：支持Excel格式的材料清单批量上传
- **智能物料映射**：自动或手动将材料清单映射到ERPNext物料编码
- **一键BOM生成**：从映射完成的材料清单快速生成标准BOM
- **多级BOM支持**：支持复杂的多级BOM结构创建

### 📊 材料清单格式
支持标准的7列材料清单格式：
- 序号
- 名称  
- 规格
- 材质
- 数量
- 单位
- 备注

### 🎯 智能功能
- **自动验证**：上传文件格式自动验证
- **智能匹配**：基于物料名称的智能匹配建议
- **批量操作**：支持批量物料编码映射
- **模板导出**：提供标准模板文件下载

## 安装指南

### 前提条件
- ERPNext 15.x 或更高版本
- Frappe Framework 15.x 或更高版本
- Python 3.8+
- pandas库：用于Excel文件处理

### 安装步骤

1. 切换到bench目录
```bash
cd /path/to/frappe-bench
```

2. 获取应用
```bash
bench get-app probom /path/to/probom
```

3. 安装应用到站点
```bash
bench --site your-site-name install-app probom
```

4. 迁移数据库
```bash
bench --site your-site-name migrate
```

5. 重新启动服务
```bash
bench restart
```

## 使用指南

### 1. 准备材料清单
- 下载标准模板文件
- 按照模板格式填写材料信息
- 保存为Excel格式(.xlsx)

### 2. 上传材料清单
- 进入"Material List Upload"菜单
- 点击"New"创建新的上传记录
- 填写BOM基本信息
- 上传Excel文件并保存

### 3. 映射物料编码
- 在材料项目列表中，为每个项目选择对应的ERPNext物料编码
- 使用"Auto Map Items"功能自动映射
- 检查并调整映射结果

### 4. 生成BOM
- 确认所有物料都已正确映射
- 点击"Generate BOM"按钮
- 系统会自动创建标准的ERPNext BOM记录

### 5. 查看和管理BOM
- 在"BOM Import"菜单中查看导入记录
- 点击"View BOM"查看生成的BOM
- 在标准的BOM模块中进行后续管理

## 权限设置

### 角色权限
- **System Manager**：完整权限，包括配置和管理
- **Manufacturing User**：创建、编辑、提交BOM导入的权限

### 权限级别
- Material List Upload：读取、创建、编辑、删除
- BOM Import：读取、创建、编辑、提交、取消

## 技术架构

### 核心组件
- **Material List Upload**：主文档，管理材料清单上传
- **Material List Item**：子表，存储材料项目详情
- **BOM Import**：BOM导入文档，用于创建标准BOM
- **BOM Import Item**：BOM项目子表

### 前端功能
- 文件上传和验证
- 物料编码智能搜索
- 批量操作界面
- 实时数据验证

### 后端功能
- Excel文件解析
- 物料编码验证
- BOM自动创建
- 价格计算和更新

## 常见问题

### Q: 支持哪些Excel格式？
A: 支持.xlsx格式，建议使用Excel 2007及以上版本创建的文件。

### Q: 如何处理物料编码不存在的情况？
A: 系统会在映射时提示，需要先创建对应的物料主数据。

### Q: 可以导入多级BOM吗？
A: 当前版本支持单层BOM导入，多级BOM需要分层导入。

### Q: 如何更新已导入的BOM？
A: 建议创建新的BOM版本，或使用标准的BOM修改功能。

## 更新日志

### v1.0.0 (2024-01-01)
- 初始版本发布
- 支持材料清单批量上传
- 实现物料编码映射功能
- 支持BOM自动生成

## 技术支持

如有问题或建议，请联系：
- Email: 397014443@qq.com
- 项目地址: https://gitee.com/pekua/pro-bom

## 许可证

MIT License - 详见LICENSE文件