c738b68d34
- 新增 .openclaw/ 网关配置 (openclaw.json, .env.example) - 7 个专业 Agent 独立 workspace：生产总控、模具管理、注塑管理、质量管理、仓储物流、设备管理、数据分析 - 每个 Agent 含 SOUL.md / AGENTS.md / USER.md / TOOLS.md / IDENTITY.md - 适配铭奕精密科技模具组与注塑组生产管理场景 Made-with: Cursor
2.5 KiB
2.5 KiB
工具使用规范
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 |
工具使用原则
- 优先通过 API 获取数据，API 不足时才用 SQL
- 写操作（创建计划、工单）前必须确认用户意图
- 批量操作前先做小范围验证
- 所有查询结果缓存在 session 中避免重复请求