# AI-MES

**Repository Path**: klq007/ai-mes

## Basic Information

- **Project Name**: AI-MES
- **Description**: AI-MES 智能生产车间管理平台知识库，涵盖生产计划、工单派工、工序进度、班组任务、异常停机与缺料预警等业务说明，以及操作规程（SOP）、异常处理手册与常见问题，为 Coze 智能客服和排产助手提供车间场景问答与决策支持。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-05
- **Last Updated**: 2026-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI-MES 智能生产车间管理平台

> 工业应用软件设计 · 题目二「工业生产车间智能管理智能体」  
> Spring Boot 3 + Vue 3 + MySQL + Redis + Coze 智能体

面向离散制造车间的 Web 型 MES，覆盖 **计划下发 → 工单派工 → 工序认领与报工 → 异常闭环 → 完工领料 → 驾驶舱看板**，并接入 **Coze 智能客服** 与 **智能排产工作流**。同时提供产品/BOM、工艺路线、设备台账、点检保养维修、质量检验、库存流水等制造基础能力。

## 目录

- [典型业务闭环](#典型业务闭环)
- [功能模块](#功能模块)
- [角色与权限](#角色与权限)
- [业务状态](#业务状态)
- [AI 能力](#ai-能力)
- [技术栈](#技术栈)
- [快速启动](#快速启动)
- [数据库](#数据库)
- [配置说明](#配置说明)
- [API 与接口文档](#api-与接口文档)
- [消息通知](#消息通知websocket)
- [项目结构](#项目结构)
- [生产部署](#生产部署)

## 典型业务闭环

```
登录 → 驾驶舱总览 → 制定/下发生产计划（可拆多单）
→ 按产品/BOM 自动生成工单 → 主管派工至班组
→ 员工工序看板认领 → 查看 SOP / 工艺参数 / 检验录入 → 报工
→ 异常上报与处理 → 工单完工（按 BOM 扣减库存）
→ AI 客服查询 / AI 排产辅助决策
```

计划下发、派工、缺料、异常、工艺审批等关键节点通过 **WebSocket** 推送系统通知。

## 功能模块

| 模块 | 路由 | 主要能力 |
|------|------|----------|
| 首页驾驶舱 | `/dashboard` | KPI、班组进度、设备状态汇总、最新异常与缺料预警 |
| 生产计划 | `/plans`、`/plans/:id` | 计划 CRUD、绑定产品、下发预览、一计划多工单拆分 |
| 工单管理 | `/work-orders`、`/work-orders/:id` | 新建/编辑/派工/筛选/进度/完工/删除；BOM 理论用量、排产字段 |
| 工序进度 | `/process` | 看板认领/报工、SOP 预览、工艺参数、质检录入、多设备绑定 |
| 产品管理 | `/products` | 产品 CRUD、成品库存、单层 BOM 维护 |
| 工艺管理 | `/process-management`、`/process-management/:id` | 工艺路线/工序/参数/SOP/设备物料绑定、审批发布、版本记录 |
| 设备管理 | `/devices`、`/devices/:id` | 分类树、台账 CRUD、状态变更、运行统计、履历 |
| 设备点检/保养/维修 | 设备详情页 Tab | 点检计划与记录、保养计划与记录、维修报修与完工 |
| 物料管理 | `/materials` | 库存与安全库存、入出库/调整、库存流水 Tab |
| 班组管理 | `/teams` | 班组、产线、成员规模 |
| 异常管理 | `/exceptions` | 设备/缺料/质量/其他异常；处理闭环；质检不合格自动建单 |
| 智能客服 | `/ai-chat` | 多轮对话、历史会话、快捷提问、流式 SSE 回复 |
| AI 悬浮窗 | 全局右下角 | 任意业务页快速唤起助手 |
| 智能排产 | `/ai-scheduling` | 优先级/瓶颈/派工建议，一键写回工单 |
| 用户管理 | `/admin/users` | 账号 CRUD、重置密码、启用/禁用（禁用二次确认） |
| 角色管理 | `/admin/roles` | 17 项细粒度权限分配 |
| Coze 配置 | `/admin/coze` | Token/Bot/工作流配置、连通性与对话健康检查 |
| 个人中心 | `/profile` | 头像、资料、修改密码 |

菜单与 API 按 `sys_role_permission` 权限字符串控制；`admin` 始终拥有全部权限。

### 制造数据能力

| 能力 | 说明 |
|------|------|
| 产品 + BOM | 计划/工单/工艺绑定 `product_id`；完工可按 BOM 扣减物料 |
| 成品库存 | 产品维度库存与 `inv_transaction` 成品流水 |
| 计划拆分 | 下发时按数量拆多工单（默认每 100 件，`PLAN_SPLIT_QTY`） |
| 工艺路线 | 多版本、审批发布、工序参数/SOP、设备与物料绑定 |
| 质量检验 | 检测工序检验项录入；不合格自动创建质量异常 |
| 设备运维 | 点检/保养计划与执行记录、维修单、设备履历 |
| 操作审计 | `sys_operation_log` 记录关键写操作 |

完工领料开关：`BOM_PICK_ON_COMPLETE`（默认 `true`）。

## 角色与权限

内置 **5 种角色**、**17 项权限**：

| 角色 | `role_key` | 典型菜单 |
|------|------------|----------|
| 管理员 | `admin` | 全部 |
| 车间主管 | `supervisor` | 计划、工单、班组、物料、设备、产品、工艺、异常、排产、AI |
| 计划员 | `planner` | 计划、工单、物料、产品、工艺、排产、AI |
| 工程师 | `engineer` | 设备、工单、工序、异常、工艺、工艺审批、产品、AI |
| 操作工 | `worker` | 工序进度、工单反馈、异常上报、AI |

权限项：生产计划、工单管理、工单反馈、工序进度、异常上报、班组、物料、产品管理、设备、工艺管理、工艺审批、排产、AI 客服、用户管理、角色管理、Coze 配置、系统配置。

## 业务状态

**生产计划：** `draft` 草稿 → `released` 已下发 → `done` 已完成

**工单：** `pending` 待分配 → `assigned` 待领取 → `producing` 生产中 → `exception` 异常处理中 → `done` 已完成

**异常：** `open` 待处理 → `processing` 处理中 → `closed` 已关闭

上报异常后关联工单进入 `exception`，进行中工序暂停；恢复生产后回到 `producing`。

## AI 能力

| 能力 | 说明 |
|------|------|
| 智能客服 | 流式接口 `POST /api/coze/chat/stream`；历史会话、停止生成 |
| 会话记忆 | 当前会话最近 5 轮问答注入 Prompt |
| 数据分流 | 操作/SOP/FAQ 走 Coze 知识库；工单/缺料/设备等走后端实时查库 |
| 排产工作流 | Coze Workflow 生成优先级/瓶颈/派工建议，可写回工单 |
| Coze 配置 | 管理后台保存 Token、Bot ID、工作流 ID；支持健康检查 |
| 演示模式 | 未配置 Coze 或额度不足时，可关闭 Coze 使用本地 Mock |

Coze 配置读取优先级：**数据库 `sys_coze_config` > 根目录 `.env`**。Token 勿提交 Git。

## 技术栈

| 层次 | 技术 |
|------|------|
| 前端 | Vue 3、TypeScript、Vite、Element Plus、Pinia、Vue Router、ECharts |
| 后端 | Spring Boot 3.3、MyBatis-Plus、Sa-Token（Redis）、WebSocket |
| 数据 | MySQL 8、Redis 6+ |
| AI | Coze Bot API v3、Workflow API |
| 文档 | Knife4j / OpenAPI 3 |

## 快速启动

### 环境要求

| 组件 | 版本 |
|------|------|
| JDK | 17+ |
| Node.js | 18+ |
| MySQL | 8.0+ |
| Redis | 6+ |
| Maven | 3.9+ |

默认：MySQL `localhost:3306` / 库名 `AI-MES` / `root`；Redis `localhost:6379`。

### 1. 初始化数据库

```bash
mysql -uroot -proot < sql/init.sql
```

### 2. 配置环境变量（可选）

```bash
cp .env.example .env
# 编辑 .env 填写 Coze Token、Bot ID 等
```

未配置 Coze 时系统自动使用演示数据回复。

### 3. 启动后端

```bash
cd backend && mvn spring-boot:run
```

Windows 推荐（自动加载 `.env` 并打包运行）：

```powershell
.\scripts\start-backend-dev.ps1
```

- API：`http://localhost:8080`
- 接口文档：`http://localhost:8080/doc.html`

### 4. 启动前端

```bash
cd frontend && npm install && npm run dev
```

- 访问：`http://localhost:3088`（`/api`、`/ws` 代理到 8080）

根目录快捷命令：`npm run dev:backend`、`npm run dev:frontend`

### 5. 演示账号

密码均为 **`123456`**（登录页可快捷填充）：

| 账号 | 角色 |
|------|------|
| `admin` | 管理员 |
| `supervisor` | 车间主管 |
| `planner` | 计划员 |
| `engineer` | 工程师 |
| `worker` | 操作工 |

### 6. 运行测试（可选）

```bash
cd backend && mvn test
```

## 数据库

后端**不会**自动建表，需执行 `sql/init.sql` 完成初始化。

| 项目 | 说明 |
|------|------|
| 数据库名 | `AI-MES` |
| 表数量 | 33 张（生产、主数据、设备、质量、系统、AI 等） |
| 种子数据 | 演示账号、班组、计划/工单、物料、设备、工艺、点检保养记录等 |
| 权限种子 | 5 角色 × 17 权限项 |

主要表分组：生产（`prod_*`）、主数据（`mdm_*`）、物料库存（`mat_*` / `inv_*`）、设备（`dev_*`）、质量（`qms_*`）、异常（`exc_*`）、系统（`sys_*`）、AI（`ai_chat_log`）。

## 配置说明

复制 `.env.example` → `.env`：

| 变量 | 说明 |
|------|------|
| `DB_*` | 数据库连接 |
| `REDIS_*` | Redis 连接 |
| `SERVER_PORT` | 后端端口，默认 8080 |
| `COZE_API_TOKEN` | Coze 个人访问令牌（PAT） |
| `COZE_BOT_ID` | 智能体 Bot ID |
| `COZE_WORKFLOW_ID` | 排产工作流 ID（可选） |
| `COZE_API_URL` | 默认 `https://api.coze.cn/v3` |
| `BOM_PICK_ON_COMPLETE` | 工单完工按 BOM 扣库存，默认 `true` |
| `PLAN_SPLIT_QTY` | 计划下发拆单阈值，默认 `100` |
| `UPLOAD_DIR` | SOP 等上传目录，默认 `uploads` |

管理员还可在 **系统管理 → Coze 配置** 页面在线保存并测试连通性。

## API 与接口文档

| 前缀 | 说明 |
|------|------|
| `/api/auth` | 登录、验证码、当前用户 |
| `/api/dashboard` | 驾驶舱统计 |
| `/api/plans` | 生产计划 |
| `/api/work-orders` | 工单与工序 |
| `/api/products` | 产品与 BOM |
| `/api/process-routes` | 工艺路线、工序、SOP、审批 |
| `/api/devices` | 设备分类与台账 |
| `/api/device-inspections` | 设备点检 |
| `/api/device-maintenances` | 设备保养 |
| `/api/device-repairs` | 设备维修 |
| `/api/materials` | 物料库存与流水 |
| `/api/quality` | 质量检验 |
| `/api/teams` | 班组 |
| `/api/exceptions` | 异常事件 |
| `/api/notifications` | 系统通知 |
| `/api/coze` | AI 客服与排产 |
| `/api/admin/users` | 用户管理 |
| `/api/admin/roles` | 角色权限 |

完整接口与在线调试：启动后端后访问 `http://localhost:8080/doc.html`。

## 消息通知（WebSocket）

| 项目 | 说明 |
|------|------|
| 端点 | `ws://localhost:8080/ws/notifications?token=<Token>` |
| REST | `GET /api/notifications`、标记已读、删除 |
| 前端 | `stores/notifications.ts` |
| 后端 | `websocket/` 包 |

生产环境 Nginx 转发示例见 `deploy/nginx.conf`。

## 项目结构

```
AI-MES/
├── backend/                 # Spring Boot 后端
│   ├── src/main/java/       # 业务代码（controller / service / entity）
│   └── src/test/            # 单元测试
├── frontend/                # Vue 3 前端（dev: 3088）
├── sql/
│   └── init.sql             # 全量数据库初始化（33 表 + 种子数据）
├── scripts/                 # 启动脚本（读取 .env）
├── deploy/nginx.conf        # Nginx 部署示例
├── .env.example             # 环境变量模板
└── README.md
```

`.env` 含密钥，已在 `.gitignore` 中忽略，勿提交。

## 生产部署

```bash
cd frontend && npm run build
cd backend && mvn clean package -DskipTests
```

产出：

- 前端静态资源：`frontend/dist`
- 后端可执行包：`backend/target/ai-mes-backend-1.0.0.jar`

按 `deploy/nginx.conf` 配置 Nginx 反向代理静态资源、`/api` 与 WebSocket。





=======================项目功能简介=======
下面按当前项目的实际菜单和后台实体关系，说明各模块的用途、上下游关系及一条完整的数据流转示例。

一、整体定位
该项目是一个带 AI 能力的 MES（制造执行系统），核心目标是把生产过程串成一条闭环：

产品与物料建模
↓
定义生产工艺
↓
创建生产计划
↓
生成并安排工单
↓
分配生产班组
↓
执行各道工序
↓
记录设备、物料和异常
↓
完成工单与生产计划
↓
驾驶舱汇总分析

智能排产和智能客服属于辅助能力：

MES 实时数据 → AI 分析 → 生成建议 → 人工确认 → 写回 MES

二、各功能菜单介绍
1. 首页驾驶舱
   首页驾驶舱是整个系统的生产概览页，用于展示当前车间运行状态，例如：

今日生产计划和产量；
工单总数、待生产数、生产中数量；
工单完成率和准时率；
设备运行、空闲、故障情况；
物料预警情况；
未处理生产异常；
班组或产线生产负荷；
最近工单和异常动态。
它通常不负责维护业务数据，而是从其他模块汇总数据。

关系如下：

生产计划 ─┐
工单管理 ─┤
工序进度 ─┤
设备管理 ─┼→ 首页驾驶舱
异常管理 ─┤
物料管理 ─┤
班组管理 ─┘

例如，某台设备被标记为故障后：

设备管理中的状态变为“故障”；
异常管理产生或关联一条设备异常；
首页驾驶舱的“设备故障数”增加；
智能排产将该设备视为不可用或高风险资源。
2. 生产计划
   生产计划属于生产任务的上层管理，用于描述：

要生产什么产品；
计划生产多少；
计划开始和完成日期；
当前计划状态；
已完成数量和生产进度；
计划下面包含哪些工单。
生产计划偏向“目标”，工单偏向“执行”。

关系如下：

产品
↓
生产计划
↓
一个或多个工单
↓
工序执行记录

例如：

生产计划：PLAN-2026-001
产品：精密组件 C
计划数量：1,000 件
计划日期：2026-08-12 至 2026-08-15

该计划可以拆成：

WO-2026-001：生产 400 件
WO-2026-002：生产 300 件
WO-2026-003：生产 300 件

生产计划关注总任务完成情况，工单负责每一批次的实际生产。

3. 工单管理
   工单是该系统的核心执行单据。

每个工单通常包含：

工单编号；
关联生产计划；
产品和生产数量；
优先级；
交付日期；
当前生产状态；
分配班组；
计划开始时间；
预计工时；
AI 排产原因；
工序执行进度。
典型工单状态可以理解为：

pending
待安排
↓
assigned
已分配班组
↓
producing
生产中
↓
done
已完成

异常时可能进入：

producing → exception → producing

当前项目的智能排产会更新工单的：

班组；
状态；
优先级；
计划开始时间；
预计工时；
排产原因。
对应后台逻辑在 backend/src/main/java/com/aimes/service/WorkOrderService.java:475。

需要注意：当前系统主要做到：

工单 → 班组

尚未做到：

工单 → 工序 → 具体员工

因此，工单分到班组后，具体由班组中的哪位人员操作，当前通常需要班组长在线下或业务流程中安排。

4. 工艺管理
   工艺管理用于定义“产品应该怎样生产”，属于生产执行前的基础数据。

通常包括：

产品工艺路线；
工序顺序；
每道工序标准工时；
工序所需物料；
工序所需设备；
工艺参数；
SOP 作业指导书；
工艺版本和变更历史。
项目中已经存在相应数据实体，例如：

MdmRouting                工艺路线
MdmRoutingHistory         工艺版本历史
MdmOperation              工序
MdmOperationMaterial      工序物料要求
MdmOperationDevice        工序设备要求
MdmOperationParam         工艺参数
MdmOperationSop           SOP

关系如下：

产品
↓
工艺路线
↓
工序 1 → 工序 2 → 工序 3
↓       ↓       ↓
物料     设备     参数/SOP

例如，产品“精密组件 C”的工艺路线为：

工序 10：物料准备
工序 20：装配
工序 30：质量检测
工序 40：包装

当工单开始生产时，工序进度模块就按照该产品的工艺路线执行。

5. 工序进度
   工序进度负责记录车间的实际生产执行，是 MES 最核心的现场模块之一。

主要用途包括：

查看班组待生产工单；
开始某个工单或某道工序；
记录完工数量；
记录合格数量和不良数量；
记录实际开始、完成时间；
提交工序生产反馈；
处理生产中异常；
推进工单状态。
关系如下：

工单
↓
解析产品工艺路线
↓
生成或执行工序
↓
记录工序生产数据
↓
更新工单完成进度
↓
更新生产计划完成进度

例如：

WO-2026-003
↓
装配工序开始
↓
生产 100 件，合格 98 件，不良 2 件
↓
进入检测工序
↓
所有工序完成
↓
工单状态改为 done

工序进度还可能影响：

物料库存扣减；
设备状态或设备使用记录；
质量检验记录；
异常事件；
驾驶舱产量统计。
6. 班组管理
   班组管理用于维护生产组织和执行单位，例如：

甲班、乙班、丙班；
班组负责人；
班组成员；
所属产线；
班次和工作时间；
当前负荷；
班组状态。
智能排产当前会把工单分配给班组，后台根据 AI 返回的 teamName 查找班组。

如果 AI 返回：

{
"workOrderCode": "WO-2026-003",
"teamName": "甲班"
}

后台会查询“甲班”，找到后把其 ID 写入工单：

prod_work_order.team_id = 甲班ID

如果返回的班组不存在，例如“装配一组”，但系统实际只有“甲班、乙班、丙班”，该条建议会被跳过，并返回：

未识别班组：装配一组

对应逻辑在 backend/src/main/java/com/aimes/service/WorkOrderService.java:495。

班组与工单、用户的关系可理解为：

班组
├─ 班组成员
└─ 被分配的工单

但当前智能排产只更新工单的班组，没有进一步生成员工级派工记录。

7. 设备管理
   设备管理负责维护生产资源，包括：

设备基础档案；
设备编号和类别；
所属产线；
运行、空闲、停机、故障状态；
当前设备负荷；
点检计划与记录；
保养计划与记录；
维修工单；
设备历史记录。
项目中的设备实体包括：

DevDevice
DevDeviceCategory
DevDeviceHistory
DevInspectionPlan
DevInspectionRecord
DevMaintenancePlan
DevMaintenanceRecord
DevRepairOrder

设备与工艺、排产、异常的关系是：

工艺工序要求某类设备
↓
智能排产检查设备负荷
↓
工序执行使用具体设备
↓
设备发生故障
↓
异常管理记录
↓
维修完成后恢复生产

例如：

“装配”工序要求使用装配工位 A1；
A1 当前负荷达到 100%；
智能排产将其识别为瓶颈；
AI 建议延迟开工、换设备或调整班组；
如果 A1 故障，则工单可能暂停；
异常解除后再恢复生产。
8. 异常管理
   异常管理用于统一记录生产过程中的异常事件，例如：

设备故障；
物料短缺；
产品质量异常；
工艺参数异常；
生产进度延期；
人员或班组异常；
其他现场异常。
异常通常包括：

异常类型；
异常等级；
关联工单；
关联设备；
异常描述；
上报人；
处理负责人；
处理状态；
处理结果；
发生和解除时间。
典型状态为：

待处理 → 处理中 → 已解决 → 已关闭

关系如下：

工单执行
↓
发现设备、质量或物料问题
↓
异常上报
↓
工单进入 exception 或暂停
↓
负责人处理
↓
异常关闭
↓
工单恢复生产

异常数据还会反馈给：

首页驾驶舱；
智能排产；
智能客服；
设备维修；
工单进度。
9. 产品管理
   产品管理维护企业生产的产品主数据，例如：

产品编码；
产品名称；
产品规格；
产品单位；
产品状态；
BOM；
默认或启用的工艺路线。
产品属于生产计划、工单、BOM、工艺路线之间的连接中心：

产品
├─ BOM
├─ 工艺路线
├─ 生产计划
└─ 工单

例如产品“标准组件 B”建立后，需要继续配置：
 
生产该产品需要哪些原材料；
每件产品需要多少用量；
需要经过哪些工序；
每道工序需要什么设备；
每道工序的标准工时是多少。
只有这些基础数据完整，系统才能进行较准确的物料计算和排产分析。

10. 物料管理
    物料管理负责原材料和库存状态，包括：

物料编码和名称；
当前库存；
安全库存；
库存预警；
入库、出库和调整记录；
BOM 物料需求；
工序物料需求；
库存交易流水。
项目中相关实体包括：

MatMaterial
MdmBom
MdmBomItem
InvTransaction

物料关系如下：

产品
↓
BOM
↓
计算工单所需物料
↓
检查当前库存
↓
满足：允许生产
不足：生成预警或异常
↓
生产领料/消耗
↓
生成库存流水

例如：

产品：标准组件 B
计划生产：100 件
每件需要精密螺丝：4 个
总需求：400 个
当前库存：300 个
缺口：100 个

系统可以：

将物料标记为预警；
在智能排产中提示物料不足；
降低该工单排产可行性；
提醒采购或仓库补料。
11. 智能客服
    智能客服是 MES 数据的自然语言查询入口。

用户可以用自然语言询问：

今天有哪些逾期工单？
哪些设备发生故障？
当前有哪些物料库存不足？
某个工单生产到哪道工序？
哪个班组的生产负荷最高？
某条异常是否已经处理？
某产品的工艺路线是什么？
其定位主要是：

用户问题
↓
系统组织 MES 业务上下文
↓
调用 Coze 智能体
↓
生成自然语言回答

智能客服原则上应以查询和解释为主。涉及修改工单、库存、设备状态等操作时，不建议让 AI 直接写库，应跳转到对应业务页面，由有权限的人员确认。

12. 智能排产
    智能排产综合以下数据：

工单交期和优先级；
产品与工艺路线；
物料库存和预警；
设备状态和负荷；
班组状态和负荷；
当前未处理异常；
计划日期；
用户选择的约束条件。
处理流程如下：

选择工单和计划日期
↓
选择物料、设备、班组约束
↓
后端获取 MES 实时数据
↓
调用 Coze 排产工作流
↓
AI 返回优先级、瓶颈、派工建议
↓
后端校验并规范化
↓
前端展示预览
↓
用户点击“应用建议”
↓
更新真实工单

生成建议接口：

POST /api/coze/scheduling

应用建议接口：

POST /api/coze/scheduling/apply

相关入口在 backend/src/main/java/com/aimes/controller/CozeController.java:86 和 backend/src/main/java/com/aimes/controller/CozeController.java:103。

智能排产本身不会在生成结果时立即修改工单。只有用户确认“应用建议”后，才会写入工单。

13. 系统管理
    系统管理主要负责平台配置和安全控制，通常包括：

用户管理；
角色管理；
菜单权限；
操作权限；
Coze 配置；
系统参数；
通知；
操作日志。
权限关系如下：

用户 → 角色 → 权限 → 可访问菜单和接口

例如：

系统管理员可以管理用户、角色和 Coze 配置；
计划员可以管理计划、工单和智能排产；
班组长可以查看本班组工单和工序进度；
普通生产人员可以进行生产反馈；
设备人员可以维护点检、保养和维修数据。
前端菜单根据权限动态显示，菜单定义位于 frontend/src/components/layout/AppSidebar.vue。

三、模块之间的核心关系
可以将系统分为五层。

1. 基础数据层
   产品管理
   物料管理
   工艺管理
   设备管理
   班组管理

这一层回答：

生产什么；
用什么物料；
按什么步骤生产；
使用什么设备；
由哪个生产组织执行。
2. 计划调度层
   生产计划
   工单管理
   智能排产

这一层回答：

需要生产多少；
拆成哪些生产任务；
哪个任务优先；
什么时候生产；
分配给哪个班组。
3. 现场执行层
   工序进度
   设备使用
   物料消耗
   生产反馈

这一层回答：

现在执行到哪里；
实际生产多少；
使用了什么设备；
消耗了多少物料；
合格和不良数量是多少。
4. 风险处理层
   异常管理
   设备维修
   物料预警
   质量检验

这一层处理生产过程中的偏差和风险。

5. 分析辅助层
   首页驾驶舱
   智能客服
   智能排产

这一层用于汇总、分析、解释和辅助决策。

四、完整数据流转示例
假设企业接到一个订单，需要生产 1,000 件“标准组件 B”。

第一步：建立产品基础数据
在“产品管理”中创建：

产品编码：PROD-B
产品名称：标准组件 B
单位：件

为产品配置 BOM：

钢制外壳：1 个/件
精密螺丝：4 个/件
电子模块：1 个/件

生产 1,000 件需要：

钢制外壳：1,000 个
精密螺丝：4,000 个
电子模块：1,000 个

第二步：建立工艺路线
在“工艺管理”中配置：

工序 10：备料
工序 20：装配
工序 30：检测
工序 40：包装

资源要求：

装配 → 装配工位 A1
检测 → 检测台 Q1
包装 → 包装线 P1

同时配置标准工时和 SOP。

第三步：检查资源数据
在“物料管理”中查询库存：

钢制外壳：1,200 个
精密螺丝：3,500 个
电子模块：1,100 个

精密螺丝缺少 500 个，因此产生库存预警。

在“设备管理”中看到：

装配工位 A1：运行中，负荷 90%
检测台 Q1：空闲
包装线 P1：空闲

在“班组管理”中看到：

甲班：负荷 80%
乙班：负荷 40%
丙班：负荷 20%

第四步：创建生产计划
在“生产计划”中创建：

计划编号：PLAN-2026-008
产品：标准组件 B
计划数量：1,000 件
计划开始：2026-08-12
计划完成：2026-08-15

第五步：生成工单
将计划拆成两个工单：

WO-2026-101：500 件
WO-2026-102：500 件

初始状态：

status = pending
team_id = null

第六步：进行智能排产
计划员进入“智能排产”，选择两个工单，并启用：

物料可用性
设备负荷
班组工时

后台收集：

工单：WO-2026-101、WO-2026-102
物料：精密螺丝缺少 500 个
设备：装配工位 A1 负荷 90%
班组：乙班和丙班负荷较低
异常：当前无严重未处理异常

Coze 返回建议：

{
"priorities": [
{
"rank": 1,
"workOrderCode": "WO-2026-101",
"priorityLabel": "高",
"reason": "交期较近，建议优先生产"
}
],
"bottlenecks": [
{
"processName": "装配",
"loadRate": 90,
"suggestion": "装配工位负荷较高，建议错峰生产"
},
{
"processName": "物料准备",
"loadRate": 100,
"suggestion": "精密螺丝库存不足，需要先补料"
}
],
"dispatches": [
{
"workOrderCode": "WO-2026-101",
"teamName": "乙班",
"startTime": "2026-08-12 08:00",
"hours": "8"
}
]
}

第七步：应用排产建议
计划员查看预览，确认后点击“应用建议”。

后台更新工单：

team_id = 乙班ID
status = assigned
priority = 高
scheduled_start_time = 2026-08-12 08:00
estimated_hours = 8
scheduling_reason = AI建议摘要

对应实际写入逻辑在 backend/src/main/java/com/aimes/service/WorkOrderService.java:508。

此时只是将工单分到乙班，尚未指定乙班中的具体员工。

第八步：班组执行工单
乙班进入“工序进度”，看到待执行工单：

WO-2026-101
产品：标准组件 B
数量：500 件
计划开始：2026-08-12 08:00

班组开始“备料”工序。

如果物料不足：

工序无法正常开始或只能部分生产；
物料管理保持库存预警；
操作人员上报“物料短缺”异常；
工单可以进入 exception；
驾驶舱显示未处理异常；
下一次智能排产会读取该异常并重新评估。
第九步：设备发生故障
装配过程中，装配工位 A1 故障：

设备状态改为“故障”；
产生设备维修单；
异常管理新增设备异常；
工单暂停或进入异常状态；
首页驾驶舱设备故障数增加；
智能客服可以回答该工单停产原因；
再次排产时，AI 不应继续将任务安排到 A1。
维修完成后：

维修单完成
→ 设备恢复可用
→ 异常关闭
→ 工单恢复生产

第十步：生产完成
各工序依次完成：

备料完成
→ 装配完成
→ 检测完成
→ 包装完成

系统记录：

计划数量：500
实际完成：500
合格数量：495
不良数量：5

随后：

工单状态 → done
生产计划完成数量增加 500
物料库存减少
设备产生运行记录
驾驶舱更新今日产量和完成率

当两个工单都完成后：

生产计划完成数量 = 1,000
生产计划状态 = 已完成

五、最简关系总结
整个项目可以概括为：

产品管理定义“生产什么”
物料管理定义“需要什么”
工艺管理定义“怎样生产”
设备管理定义“用什么生产”
班组管理定义“由谁组织生产”
生产计划定义“生产目标”
工单管理定义“具体生产任务”
智能排产决定“何时生产、哪个优先、交给哪个班组”
工序进度记录“实际生产过程”
异常管理处理“生产偏差和故障”
驾驶舱展示“整体运行结果”
智能客服负责“自然语言查询与解释”
系统管理负责“人员、权限和 AI 配置”

其中最关键的业务主线是：

产品/BOM/工艺
↓
生产计划
↓
工单
↓
智能排产
↓
班组
↓
工序执行
↓
物料、设备、质量、异常记录
↓
工单完成
↓
计划完成
↓
驾驶舱汇总