# 工具使用规范

## MOM 系统 API

### 后端基础信息
- **Base URL**: `${MOM_API_BASE_URL}`（默认 http://localhost:8080）
- **认证**: JWT Token，通过 Authorization: Bearer 头传递

### 设备管理核心 API

| 功能 | 端点 | 方法 |
|------|------|------|
| 设备列表 | `/mes/dv/machinery/list` | GET |
| 设备详情 | `/mes/dv/machinery/{id}` | GET |
| 创建设备 | `/mes/dv/machinery` | POST |
| 更新设备 | `/mes/dv/machinery` | PUT |
| 点检计划列表 | `/mes/dv/checkplan/list` | GET |
| 点检计划详情 | `/mes/dv/checkplan/{id}` | GET |
| 创建点检计划 | `/mes/dv/checkplan` | POST |
| 维修工单列表 | `/mes/dv/repair/list` | GET |
| 维修工单详情 | `/mes/dv/repair/{id}` | GET |
| 创建维修工单 | `/mes/dv/repair` | POST |
| 更新维修工单 | `/mes/dv/repair` | PUT |

### 关联模块 API

| 功能 | 端点 | 方法 |
|------|------|------|
| 排班计划 | `/mes/cal/plan/list` | GET |
| 班组信息 | `/mes/cal/team/list` | GET |
| 库存查询（备件） | `/mes/wm/materialstock/list` | GET |
| 物料主数据 | `/erp/masterdata/item/list` | GET |
| 工单列表 | `/erp/workOrder/list` | GET |

## 数据库查询

### 常用表

| 表名 | 说明 | 关键字段 |
|------|------|----------|
| `dv_machinery` | 设备台账 | machinery_code, machinery_name, machinery_type, status |
| `dv_check_plan` | 点检计划 | plan_code, machinery_id, check_type, plan_date |
| `dv_repair` | 维修记录 | repair_code, machinery_id, fault_desc, repair_content |
| `cal_team` | 班组 | team_name, team_code |
| `cal_plan` | 排班计划 | plan_date, team_id, shift_id |
| `cal_shift` | 班次 | shift_name, start_time, end_time |

## 工具使用原则

1. 设备故障维修必须创建维修工单，记录完整的故障和修复信息
2. 点检计划到期后自动标记为"待执行"状态
3. 设备状态变更（运行→故障→维修→运行）必须实时更新
4. OEE 计算需要关联生产数据（产量、周期时间、不良数）和设备运行数据
5. 备件出库需要关联维修工单号