# 加工件报价系统

**Repository Path**: webvip/cnc_quotation

## Basic Information

- **Project Name**: 加工件报价系统
- **Description**: 集成在erpnext中的加工件报价系统。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2026-02-03
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CNC Quotation (加工件报价系统) v2.3.0

CNC Quotation 是一个基于 [Frappe Framework](https://frappeframework.com) 和 ERPNext 的智能报价插件，专为 CNC 机加工行业设计。它支持从 3D 文件分析数据、自动计算材料费、加工费及辅助费用，并生成正式报价单。

## 主要功能

*   **3D 文件集成**: 支持集成 3D 分析工具，自动提取体积、表面积、Bounding Box 尺寸。
*   **智能成本计算**:
    *   **材料费**: 根据材料密度、单价及毛坯重量（含切削余量）自动计算。
    *   **机加工费**: 基于 MRR (材料去除率) 计算粗加工时间，基于表面积计算精加工时间，结合复杂度系数。
    *   **辅助费用**: 自动统计螺纹孔、H7 精度孔、表面处理等额外费用。
*   **灵活输入**: 支持 "3D 分析" 和 "人工输入" (Manual Input) 两种模式，适应无 3D 图纸场景。
*   **报价单生成**: 一键将计算结果生成 ERPNext 标准 Quotation。

## 安装说明

本应用需安装在 Frappe/ERPNext v15+ 环境中。

```bash
bench get-app https://gitee.com/alexjunqi/cnc_quotation
bench --site [your-site-name] install-app cnc_quotation
bench migrate
```

## 使用指南

1.  进入 **CNC Config** 设置基础参数（工时费率、材料价格表、机台参数等）。
2.  创建 **CNC Quote**，添加零件明细。
3.  选择输入方式 (3D Analysis / Manual Input)。
4.  点击 **刷新价格** 实时查看预估成本。
5.  点击 **生成报价单** 转为正式销售报价。

## 版本历史

### v2.0.0
*   [新增] 优化子表交互，"刷新价格" 不再关闭弹窗。
*   [新增] 修复部分计算逻辑和 UI 显示问题。
*   [优化] 适配 ERPNext v15。

### v2.3.0
*   [新增] **批量费率**: 根据订单数量自动切换 1-2件/3-9件/10-49件/50+件 费率。
*   [新增] **材料加工系数**: 在材料价目表中指定材料类型（铝/钢/不锈钢/塑胶），自动匹配加工工时系数。
*   [新增] **严公差费用**: 启用并计算严公差/H7孔费用。
*   [新增] **API 增强**: 扩展 `add_item_to_active_quote` 接口，支持 Excel VBA 全参数传入。
*   [新增] **参考文档**: 提供完整的 `cnc_api_reference.md` 供线下开发参考。
*   [清理] 移除 `mask_per_count` (遮蔽费用) 等无用配置。

### v2.2.0

### v1.0.0
*   初始版本发布。

## License

MIT