Initial commit

docs/basic/data-management.md

@@ -0,0 +1,397 @@
+# 基础数据管理
+
+## 1. 功能概述
+
+基础数据是 MES 系统运行的核心支撑，涵盖产品、物料、工艺、设备、组织等各类主数据的管理。完善的基础数据是系统正常运转的前提。
+
+**核心数据分类：**
+
+| 数据类别 | 主要内容 | 重要性 |
+|---------|---------|--------|
+| 产品数据 | 产品信息、BOM、工艺路线 | ⭐⭐⭐⭐⭐ |
+| 物料数据 | 物料主数据、单位转换 | ⭐⭐⭐⭐⭐ |
+| 工艺数据 | 工序定义、工艺路线 | ⭐⭐⭐⭐ |
+| 设备数据 | 设备台账、产线信息 | ⭐⭐⭐⭐ |
+| 组织数据 | 工厂、车间、仓库 | ⭐⭐⭐⭐⭐ |
+
+## 2. 产品数据管理
+
+### 2.1 产品主数据
+
+**产品信息定义：**
+
+| 字段 | 说明 | 是否必填 |
+|------|------|---------|
+| 产品编码 | 产品唯一标识 | ✓ |
+| 产品名称 | 产品名称 | ✓ |
+| 产品规格 | 产品规格型号 | ✓ |
+| 产品分类 | 产品类别 | ✓ |
+| 计量单位 | 默认计量单位 | ✓ |
+| 产品版本 | 版本号 | - |
+| 保质期 | 保质天数 | - |
+| 追溯要求 | 是否需要批次追溯 | ✓ |
+
+**产品创建步骤：**
+
+1. 进入【基础数据】→【产品管理】
+2. 点击【新建】
+3. 填写产品基本信息
+4. 保存产品信息
+
+### 2.2 物料清单（BOM）
+
+BOM（Bill of Materials）是产品的物料构成清单，是生产计划、物料核算的基础。
+
+**BOM结构类型：**
+
+| 类型 | 说明 | 适用场景 |
+|------|------|---------|
+| 单层BOM | 仅包含直接下级物料 | 简单产品 |
+| 多层BOM | 包含多层级的物料结构 | 复杂装配产品 |
+| 工艺BOM | 包含工艺路线信息 | 生产制造 |
+| 成本BOM | 包含成本信息 | 成本核算 |
+
+**BOM层级结构示例：**
+
+```
+产品A (1个)
+├── 物料B (2个)
+│   ├── 物料C (3个)
+│   └── 物料D (1个)
+└── 物料E (5个)
+```
+
+**BOM创建步骤：**
+
+1. 进入【基础数据】→【BOM管理】
+2. 选择产品
+3. 添加下级物料
+4. 填写用量和损耗率
+5. 保存BOM
+
+**【提示】** BOM变更需要经过审核流程，确保数据准确性。
+
+### 2.3 工艺路线
+
+工艺路线定义产品从原材料到成品的加工顺序和工艺参数。
+
+**工艺路线要素：**
+
+| 要素 | 说明 |
+|------|------|
+| 工序编号 | 工序唯一标识 |
+| 工序名称 | 工序名称 |
+| 工序顺序 | 工序执行顺序 |
+| 标准工时 | 标准作业时间 |
+| 作业指导 | 作业指导书 |
+| 检验点 | 是否需要质量检验 |
+
+**工艺路线示例：**
+
+| 工序号 | 工序名称 | 作业工时 | 检验点 | 设备要求 |
+|--------|---------|---------|--------|---------|
+| 001 | SMT贴片 | 10min | ✓ | SMT设备 |
+| 002 | 回流焊接 | 5min | ✓ | 回流焊机 |
+| 003 | AOI检测 | 3min | ✓ | AOI设备 |
+| 004 | 组装 | 15min | - | 产线 |
+| 005 | 测试 | 10min | ✓ | 测试设备 |
+| 006 | 包装 | 5min | - | 包装线 |
+
+**工艺路线创建步骤：**
+
+1. 进入【基础数据】→【工艺路线】
+2. 选择产品
+3. 添加工序
+4. 配置工序参数
+5. 保存工艺路线
+
+## 3. 物料数据管理
+
+### 3.1 物料主数据
+
+**物料信息字段：**
+
+| 字段 | 说明 | 是否必填 |
+|------|------|---------|
+| 物料编码 | 物料唯一标识 | ✓ |
+| 物料名称 | 物料名称 | ✓ |
+| 物料分类 | 物料类别 | ✓ |
+| 规格型号 | 物料规格 | ✓ |
+| 计量单位 | 计量单位 | ✓ |
+| 安全库存 | 最低库存量 | - |
+| 最高库存 | 最高库存量 | - |
+| 采购周期 | 采购提前期 | - |
+| 批次管理 | 是否批次管理 | ✓ |
+
+**物料分类示例：**
+
+| 一级分类 | 二级分类 | 示例 |
+|---------|---------|------|
+| 原材料 | 金属材料 | 铜材、铝材 |
+| 原材料 | 塑料材料 | ABS、PC |
+| 半成品 | PCB板 | 单面板、双面板 |
+| 半成品 | 结构件 | 外壳、支架 |
+| 成品 | 电子元件 | 电阻、电容 |
+| 成品 | 模块 | 电源模块、通讯模块 |
+| 包材 | 包装材料 | 纸箱、说明书 |
+| 辅材 | 化学品 | 焊锡、助焊剂 |
+
+### 3.2 单位管理
+
+**单位类型：**
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| 基本单位 | 最小计量单位 | PCS、KG |
+| 采购单位 | 采购计量单位 | 箱、卷 |
+| 库存单位 | 库存计量单位 | PCS、KG |
+| 生产单位 | 生产投料单位 | 盘、卷 |
+
+**单位转换规则：**
+
+| 物料 | 基本单位 | 采购单位 | 转换比例 |
+|------|---------|---------|---------|
+| 电阻 | PCS | 盘 | 5000 PCS/盘 |
+| 焊锡 | KG | 卷 | 1 KG/卷 |
+| PCB板 | PCS | 箱 | 50 PCS/箱 |
+
+### 3.3 仓库管理
+
+**仓库信息：**
+
+| 字段 | 说明 |
+|------|------|
+| 仓库编码 | 仓库唯一标识 |
+| 仓库名称 | 仓库名称 |
+| 仓库类型 | 原材料库/成品库/半成品库 |
+| 地址 | 仓库地址 |
+| 管理员 | 仓库负责人 |
+
+**库位管理：**
+
+| 库位编码 | 说明 | 示例 |
+|---------|------|------|
+| A-01-001 | 区域-货架-层位 | A区01排001位 |
+| 立体库位 | 仓库-区-排-层-位 | 01-01-001-01-01 |
+
+**库位规划原则：**
+
+- 按物料类别分区
+- 常用物料靠近出入口
+- 危险品单独存放
+- 批次管理物料分批存放
+
+## 4. 组织数据管理
+
+### 4.1 组织架构
+
+**组织层级：**
+
+```
+公司
+└── 工厂
+    └── 车间
+        └── 产线
+            └── 工位
+```
+
+**组织数据示例：**
+
+| 层级 | 名称 | 编码 |
+|------|------|------|
+| 公司 | XX电子有限公司 | HQ |
+| 工厂 | 深圳工厂 | SZ01 |
+| 车间 | SMT车间 | SZ01-SMT |
+| 车间 | 组装车间 | SZ01-ASM |
+| 产线 | SMT-A线 | SZ01-SMT-A |
+| 产线 | SMT-B线 | SZ01-SMT-B |
+| 产线 | 组装-A线 | SZ01-ASM-A |
+
+### 4.2 工厂数据
+
+**工厂信息配置：**
+
+| 配置项 | 说明 |
+|--------|------|
+| 工厂编码 | 工厂唯一标识 |
+| 工厂名称 | 工厂名称 |
+| 工厂地址 | 工厂地址 |
+| 联系方式 | 联系电话 |
+| 工作时间 | 上班时间-下班时间 |
+| 时区设置 | 时区配置 |
+
+### 4.3 车间数据
+
+**车间信息配置：**
+
+| 配置项 | 说明 |
+|--------|------|
+| 车间编码 | 车间唯一标识 |
+| 车间名称 | 车间名称 |
+| 所属工厂 | 上级工厂 |
+| 车间类型 | 生产车间/仓储车间 |
+| 负责人 | 车间主管 |
+| 联系方式 | 联系电话 |
+
+### 4.4 产线数据
+
+**产线信息配置：**
+
+| 配置项 | 说明 |
+|--------|------|
+| 产线编码 | 产线唯一标识 |
+| 产线名称 | 产线名称 |
+| 所属车间 | 上级车间 |
+| 产线类型 | 专用线/柔性线 |
+| 产能 | UPH（每小时产能） |
+| 设备列表 | 产线设备 |
+
+**产能配置：**
+
+| 产线 | 日产能 | 月产能 | 利用率 |
+|------|--------|--------|--------|
+| SMT-A线 | 10000 PCS | 220000 PCS | 85% |
+| SMT-B线 | 8000 PCS | 176000 PCS | 80% |
+| 组装-A线 | 5000 PCS | 110000 PCS | 75% |
+
+## 5. 客户与供应商数据
+
+### 5.1 客户数据
+
+**客户信息字段：**
+
+| 字段 | 说明 |
+|------|------|
+| 客户编码 | 客户唯一标识 |
+| 客户名称 | 客户名称 |
+| 客户类型 | 经销商/终端客户 |
+| 联系信息 | 联系人、电话、邮箱 |
+| 地址信息 | 送货地址 |
+| 信用等级 | 客户信用等级 |
+
+### 5.2 供应商数据
+
+**供应商信息字段：**
+
+| 字段 | 说明 |
+|------|------|
+| 供应商编码 | 供应商唯一标识 |
+| 供应商名称 | 供应商名称 |
+| 供应物料 | 供应的物料类别 |
+| 联系信息 | 联系人、电话、邮箱 |
+| 地址信息 | 公司地址/送货地址 |
+| 资质信息 | 营业执照等资质 |
+
+## 6. 数据导入导出
+
+### 6.1 数据导入
+
+**导入流程：**
+
+1. 下载导入模板
+2. 填写数据
+3. 上传文件
+4. 数据校验
+5. 导入确认
+6. 导入完成
+
+**【注意】** 导入前请仔细阅读模板填写说明，确保数据格式正确。
+
+### 6.2 数据导出
+
+**导出方式：**
+
+| 方式 | 说明 |
+|------|------|
+| 页面导出 | 在列表页面选择导出 |
+| 批量导出 | 按条件批量导出 |
+| 接口导出 | 通过API接口导出 |
+
+**导出格式：**
+
+- Excel格式（.xlsx）
+- CSV格式（.csv）
+- PDF格式（报表）
+
+### 6.3 导入模板字段说明
+
+**产品导入模板：**
+
+| 列名 | 说明 | 示例 |
+|------|------|------|
+| 产品编码 | 产品唯一编码 | P001 |
+| 产品名称 | 产品名称 | PCB板 |
+| 规格型号 | 规格型号 | 100*80mm |
+| 产品分类 | 产品分类编码 | 03 |
+| 计量单位 | 计量单位编码 | 01 |
+| 是否追溯 | 是/否 | 是 |
+
+**物料导入模板：**
+
+| 列名 | 说明 | 示例 |
+|------|------|------|
+| 物料编码 | 物料唯一编码 | M001 |
+| 物料名称 | 物料名称 | 电阻 |
+| 规格型号 | 规格型号 | 10KΩ |
+| 物料分类 | 物料分类编码 | 0101 |
+| 计量单位 | 计量单位编码 | 01 |
+| 安全库存 | 安全库存数量 | 1000 |
+| 是否批次 | 是否批次管理 | 是 |
+
+## 7. 数据校验规则
+
+### 7.1 编码规则
+
+**编码规范：**
+
+| 数据类型 | 编码规则 | 示例 |
+|---------|---------|------|
+| 产品编码 | P+数字 | P001 |
+| 物料编码 | M+数字 | M001 |
+| 客户编码 | C+数字 | C001 |
+| 供应商编码 | S+数字 | S001 |
+| 设备编码 | E+数字 | E001 |
+| 工位编码 | W+数字 | W001 |
+
+**【提示】** 建议在实施前制定统一的编码规范，避免后续混乱。
+
+### 7.2 数据校验
+
+**必填校验：**
+
+- 必填字段不能为空
+- 编码不能重复
+- 数量必须大于0
+
+**格式校验：**
+
+| 字段 | 格式要求 | 示例 |
+|------|---------|------|
+| 编码 | 字母+数字组合 | P001 |
+| 日期 | YYYY-MM-DD | 2026-04-10 |
+| 数量 | 正整数或小数 | 100、99.5 |
+| 比例 | 0-100之间 | 85.5% |
+
+## 8. 数据权限管理
+
+### 8.1 数据权限级别
+
+| 权限级别 | 说明 | 适用对象 |
+|---------|------|---------|
+| 公司级 | 可查看所有工厂数据 | 高管 |
+| 工厂级 | 可查看所属工厂数据 | 工厂负责人 |
+| 车间级 | 可查看所属车间数据 | 车间主管 |
+| 产线级 | 可查看所属产线数据 | 产线主管 |
+| 个人级 | 只能查看自己的数据 | 普通员工 |
+
+### 8.2 数据权限配置
+
+**配置要点：**
+
+1. 根据用户角色分配数据权限级别
+2. 特殊用户可配置例外权限
+3. 定期审核权限配置
+
+---
+
+**基础数据管理篇完**