# 工具使用规范

## MOM 系统 API

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

### 生产管理核心 API

| 功能 | 端点 | 方法 |
|------|------|------|
| 生产计划列表 | `/erp/productionPlan/list` | GET |
| 生产计划详情 | `/erp/productionPlan/{id}` | GET |
| 创建生产计划 | `/erp/productionPlan` | POST |
| 工单列表 | `/erp/workOrder/list` | GET |
| 工单详情 | `/erp/workOrder/{id}` | GET |
| 创建工单 | `/erp/workOrder` | POST |
| 工单BOM | `/erp/workOrder/bom/{workOrderId}` | GET |
| 报工反馈 | `/mes/pro/feedback/list` | GET |
| 工序任务 | `/mes/pro/task/list` | GET |
| 生产零件 | `/erp/parts/list` | GET |
| MBOM清单 | `/erp/mbom/list` | GET |
| 采购计划 | `/erp/purchasePlan/list` | GET |

### 主数据 API

| 功能 | 端点 | 方法 |
|------|------|------|
| 物料主数据 | `/erp/masterdata/item/list` | GET |
| BOM结构 | `/erp/masterdata/bom/list` | GET |
| 车间列表 | `/erp/masterdata/workshop/list` | GET |
| 工位列表 | `/erp/masterdata/workstation/list` | GET |
| 计量单位 | `/erp/masterdata/unit/list` | GET |

### 关联模块 API

| 功能 | 端点 | 方法 |
|------|------|------|
| 设备列表 | `/mes/dv/machinery/list` | GET |
| 排班计划 | `/mes/cal/plan/list` | GET |
| 库存查询 | `/mes/wm/materialstock/list` | GET |
| 领料单 | `/erp/warehouse/issue/list` | GET |

## 数据库查询

仅在 API 无法满足需求时使用直接 SQL 查询：
- 连接信息通过环境变量获取
- 只允许 SELECT 查询，禁止 INSERT/UPDATE/DELETE
- 查询必须带 LIMIT 限制（默认 100 条）
- 大表查询必须走索引字段

### 常用表

| 表名 | 说明 | 关键字段 |
|------|------|----------|
| `erp_mp_production_plan` | 生产计划 | plan_code, status, plan_date |
| `erp_mp_mbom` | 制造BOM | mbom_code, item_id, quantity |
| `pro_workorder` | 工单 | workorder_code, status, quantity |
| `pro_task` | 工序任务 | task_code, workorder_id, process_id |
| `pro_feedback` | 报工记录 | feedback_id, task_id, quantity_qualified |
| `erp_md_item` | 物料主数据 | item_code, item_name, item_type_id |
| `erp_md_bom` | 产品BOM | bom_id, item_id, component_id |

## 工具使用原则

1. 优先通过 API 获取数据，API 不足时才用 SQL
2. 写操作（创建计划、工单）前必须确认用户意图
3. 批量操作前先做小范围验证
4. 所有查询结果缓存在 session 中避免重复请求