diff --git a/aucma-production/andon.md b/aucma-production/andon.md
new file mode 100644
index 0000000..3aebbdd
--- /dev/null
+++ b/aucma-production/andon.md
@@ -0,0 +1,813 @@
+# Andon 系统文档
+
+> 本文档针对 aucma-mes 项目中的安灯系统（Andon），从**项目文档**与**操作手册**两个维度进行说明，既帮助理解整体业务设计，也指导一线用户具体使用。
+
+---
+
+## 一、项目文档（业务与设计说明）
+
+### 1.1 系统整体概述
+
+安灯系统用于对生产现场的异常、需求等进行**呼叫、响应、处理和追踪**，构建从“发现问题”到“解决问题”的完整闭环。核心目标：
+
+- **快速呼叫**：现场在工位/设备/系统中发起安灯呼叫；
+- **规则驱动**：依据预先配置的安灯规则自动匹配处理要求；
+- **自动派工/通知**：将事件自动派发给责任人或责任角色；
+- **全过程留痕**：记录确认、开始处理、完成、取消等里程碑时间；
+- **可视化看板**：通过安灯看板统一展示当前安灯状态和历史数据。
+
+从实现上，安灯系统围绕以下几个核心领域模型展开：
+
+- **AndonRule（安灯规则配置）**：定义不同呼叫类型在不同产线/工位/班组上的处理策略、时限和通知对象；
+- **AndonEvent（安灯事件）**：每一次安灯呼叫形成的一条事件记录，是业务闭环的中心实体；
+- **AndonEventAssignment（安灯派工记录）**：围绕事件派发给具体人员或角色的待办/任务；
+- **AndonEventLog（安灯事件日志）**：记录与事件相关的所有关键操作，形成审计追踪；
+- **AndonBoardConfig（安灯看板配置）**：配置各类安灯看板的产线/工位范围、展示字段及刷新策略。
+
+上述模型在后端分别由对应的 Service 与 Mapper 实现，在前端对应以下页面：
+
+- `views/production/andonRule/index.vue`：安灯规则配置；
+- `views/production/andonEvent/index.vue`：安灯事件管理；
+- `views/production/andonEventAssignment/index.vue`：安灯派工记录管理；
+- `views/production/andonEventLog/index.vue`：安灯事件日志查询；
+- `views/production/andonBoardConfig/index.vue`：安灯看板配置。
+
+---
+
+### 1.2 模块职责概览
+
+#### 1.2.1 安灯规则配置（AndonRule）
+
+**职责**：
+
+- 定义安灯呼叫类型及其适用范围（产线、工位/工序、班组、触发源类型等）；
+- 设置确认时限（ACK Timeout）和解决时限（Resolve Timeout）；
+- 定义默认优先级（Priority）；
+- 定义通知对象（具体用户列表、角色列表）；
+- 通过字段 `isFlag` 控制规则是否生效。
+
+**典型字段（来自 AndonRule / AndonRuleMapper.xml）：**
+
+- `ruleName`：规则名称；
+- `callTypeCode`：呼叫类型编码；
+- `productLineCode` / `stationCode` / `teamCode`：适用产线、工位、班组；
+- `sourceType`：限定触发源类型（如工位、设备、报警、手动等）；
+- `ackTimeoutMin`：确认时限（分钟）；
+- `resolveTimeoutMin`：解决时限（分钟）；
+- `priorityDefault`：默认优先级；
+- `notifyUsers`：通知用户 ID 列表（逗号分隔）；
+- `notifyRoles`：通知角色 Key 列表（逗号分隔，当前主要作为兜底）；
+- `remark`：扩展配置 JSON（如派工模式、是否取消其他派工、解决时限锚点等）；
+- `isFlag`：是否有效。
+
+#### 1.2.2 安灯事件（AndonEvent）
+
+**职责**：
+
+- 表示一条实际发生的安灯呼叫记录；
+- 保存安灯发生环境（产线/工位/班组/工单/物料/设备等）；
+- 保存业务里程碑信息（确认时间、开始处理时间、完成时间等）；
+- 保存规则计算得到的截止时间和优先级；
+- 通过状态字段反映事件生命周期（待处理、处理中、已解决、已取消等）。
+
+**典型字段（来自 AndonEvent / AndonEventMapper.xml）：**
+
+- 标识与基础信息：
+ - `eventId`：事件主键；
+ - `callCode`：安灯呼叫单号；
+ - `callTypeCode`：呼叫类型编码，对应规则的 `callTypeCode`；
+- 触发源与位置：
+ - `sourceType` / `sourceRefId`：触发源类型及引用 ID（工位编码、设备编码、报警号等）；
+ - `productLineCode` / `stationCode` / `teamCode`：产线、工位、班组；
+ - `orderCode` / `materialCode` / `deviceId` / `deviceCode`：关联工单、物料、设备；
+- 状态与优先级：
+ - `priority`：事件优先级，未设置时从规则 `priorityDefault` 继承；
+ - `eventStatus`：事件状态（PENDING/PROCESSING/RESOLVED/CANCELLED，对应字典 `andon_event_status`）；
+- 时间与里程碑：
+ - `ackBy` / `ackTime`：确认人及确认时间；
+ - `responseStartTime`：开始处理时间；
+ - `responseEndTime`：处理完成/解决时间；
+ - `ackDeadline`：系统计算的确认截止时间；
+ - `resolveDeadline`：系统计算的解决截止时间；
+ - `escalateLevel` / `escalateTime`：升级级别与时间（预留扩展）；
+- 其他：
+ - `description`：呼叫描述；
+ - `resolution`：解决/处理措施；
+ - `cancelReason`：取消原因；
+ - `isFlag` / `remark`：有效标记与备注。
+
+在 Service 层（`AndonEventServiceImpl`）中，对新增/修改事件进行了规则匹配、时限计算以及状态变更的封装。
+
+#### 1.2.3 安灯派工记录（AndonEventAssignment）
+
+**职责**：
+
+- 表示围绕某个安灯事件创建的派工/待办记录；
+- 记录任务被派给了谁（用户/角色/班组）、何时派工、接单与完成时间；
+- 维护派工的状态（已派工、已接单、已完成、已取消、已拒绝等）；
+- 与事件状态联动，构成完整处理闭环。
+
+**典型字段（来自 AndonEventAssignment / Mapper）：**
+
+- `assignmentId`：派工记录主键；
+- `eventId`：所属安灯事件；
+- `assigneeUserId` / `assigneeUserName`：被分配用户信息；
+- `assigneeRoleKey` / `assigneeTeamCode`：被分配角色与班组；
+- `assignedTime`：派工时间；
+- `acceptTime`：接单时间（在 Service 中根据状态自动补充）；
+- `finishTime`：完成时间（在 Service 中根据状态自动补充）；
+- `status`：派工状态（字典 `andon_status`）；
+- `isFlag`：是否有效；
+- `remark`：备注。
+
+在 Service 层（`AndonEventAssignmentServiceImpl`）中，`updateAndonEventAssignment` 会根据派工状态自动：
+
+- 补充自身接单/完成时间；
+- 联动更新事件的开始处理时间、完成时间及状态；
+- 写入对应的事件日志；
+- 在配置允许时，自动取消同一事件下的其他并行派工。
+
+#### 1.2.4 安灯事件日志（AndonEventLog）
+
+**职责**：
+
+- 记录所有与安灯事件相关的关键操作，形成审计轨迹；
+- 为事后追溯、责任划分和优化分析提供依据。
+
+**典型字段：**
+
+- `logId`：日志主键；
+- `eventId`：关联事件；
+- `operation`：操作类型（字典 `andon_operation`，如 CREATE、ASSIGN、ACK、RESOLVE、CANCEL 等）；
+- `content`：操作内容描述；
+- `operatorUserId` / `operatorUserName`：操作人；
+- `operationTime`：操作时间；
+- `remark`：备注。
+
+事件日志通常由后端 Service 自动写入：
+
+- 事件创建/编辑/取消；
+- 自动派工创建；
+- 派工接单/完成/取消/拒绝；
+- 自动取消其他派工等。
+
+#### 1.2.5 安灯看板配置（AndonBoardConfig）
+
+**职责**：
+
+- 为车间现场的安灯看板（大屏）提供配置；
+- 指定看板关联产线/工位、展示字段、刷新周期等。
+
+**典型字段：**
+
+- `boardCode` / `boardName`：看板编码与名称；
+- `productLineCode` / `stationCode`：关联产线与工位/工序；
+- `displayFields`：看板展示字段配置（JSON 或约定字符串）；
+- `refreshIntervalSec`：刷新间隔（秒）；
+- `isFlag`：是否有效；
+- `remark`：备注。
+
+前端看板程序可根据 `boardCode` 读取配置，再按产线/工位范围实时拉取 AndonEvent 数据进行可视化展示。
+
+---
+
+### 1.3 业务流程说明（从呼叫到关闭的闭环）
+
+#### 1.3.1 前置：配置安灯规则
+
+1. 管理人员在“安灯规则配置”页面维护规则：
+ - 定义规则名称与呼叫类型编码；
+ - 选择适用的产线/工位/班组与触发源类型；
+ - 设置确认时限、解决时限与默认优先级；
+ - 选择通知用户（以及可选的通知角色）；
+ - 启用（`isFlag = 1`）。
+2. 后端通过 `AndonRuleMapper.selectAndonRuleList` 根据条件查询有效规则，为后续事件创建与派工提供基础。
+
+#### 1.3.2 创建安灯事件（AndonEvent）
+
+安灯事件可以由前端页面手工新增，也可以由外部系统/设备通过接口推送，后端统一通过 `AndonEventServiceImpl.insertAndonEvent` 处理：
+
+1. 写入事件的 `createTime`；
+2. 调用 `applyRuleAndCompute(e, true)`：
+ - 按 `callTypeCode + isFlag` 从规则表拉取候选规则；
+ - 通过 `pickBestRule` 根据产线/工位/班组/触发源类型的匹配度选择最优规则；
+ - 若命中规则：
+ - 若事件未设置 `priority`，使用规则的 `priorityDefault`；
+ - 根据规则的 `ackTimeoutMin` 计算确认截止时间 `ackDeadline`；
+ - 根据规则的 `resolveTimeoutMin` 及 `remark.resAnchor` 计算解决截止时间 `resolveDeadline`；
+3. 调用 `andonEventMapper.insertAndonEvent` 入库；
+4. 调用 `autoCreateAssignments(e)` 基于规则自动创建派工记录；
+5. 写入一条 `CREATE` 类型的事件日志。
+
+#### 1.3.3 自动派工（AndonEventAssignment）
+
+`autoCreateAssignments` 的主要逻辑：
+
+1. 再次根据事件信息匹配最佳规则；
+2. 从规则的 `remark` 中解析派工模式与兜底策略：
+ - `mode`：`single`（单人）或 `multi`（多人），默认 `single`；
+ - `fallback`：`role` 或 `none`，决定在没有用户或单人模式未创建成功时是否按角色兜底；
+3. 优先依据 `notifyUsers` 创建派工：
+ - 对每个用户 ID 创建 `AndonEventAssignment`，状态初始为 ASSIGNED；
+ - 单人模式下创建第一条后即停止；
+4. 如未成功创建，且 `fallback = role`，则依据 `notifyRoles` 按角色创建派工；
+5. 若成功创建至少一条派工，则写入一条 `ASSIGN` 类型的事件日志。
+
+#### 1.3.4 派工状态与事件状态联动
+
+当派工记录状态被修改（`AndonEventAssignmentServiceImpl.updateAndonEventAssignment`）时：
+
+1. 派工自身里程碑时间维护：
+ - 若状态变更为 ACCEPTED 且 `acceptTime` 为空，则写入当前时间；
+ - 若状态变更为 DONE 且 `finishTime` 为空，则写入当前时间；
+2. 事件联动：
+ - 若派工状态为 ACCEPTED：
+ - 若事件 `responseStartTime` 为空，则写入当前时间；
+ - 事件状态设置为 PROCESSING；
+ - 写入 `ACCEPT` 操作日志；
+ - 若派工状态为 DONE：
+ - 若事件 `responseEndTime` 为空，则写入当前时间；
+ - 事件状态设置为 RESOLVED；
+ - 写入 `RESOLVE` 操作日志；
+ - 根据规则策略 `cancelOthers` 可自动取消同一事件下其他未完成派工（状态置为 CANCELLED，并写 `CANCEL_OTHERS` 日志）；
+ - 若派工状态为 CANCELLED：
+ - 写入 `CANCEL_ASSIGNMENT` 操作日志；
+ - 若派工状态为 REJECTED：
+ - 写入 `REJECT` 操作日志。
+
+#### 1.3.5 事件生命周期操作（确认/开始处理/完成/取消）
+
+在 `AndonEventServiceImpl` 中提供了对事件基础生命周期的操作方法（同时前端也通过专用按钮调用）：
+
+1. `acknowledgeEvent`（确认事件）：
+ - 记录确认人 `ackBy` 与确认时间 `ackTime`；
+ - 将事件状态设置为 PROCESSING；
+ - 写入 `ACK` 日志；
+2. `startProcessEvent`（开始处理）：
+ - 记录 `responseStartTime`；
+ - 事件状态置为 PROCESSING；
+ - 调用 `applyRuleAndCompute` 重新计算解决截止时间（以开始处理时间为锚点）；
+ - 写入“开始处理”编辑日志；
+3. `completeEvent`（完成事件）：
+ - 记录 `responseEndTime` 与 `resolution`；
+ - 事件状态置为 RESOLVED；
+ - 写入 `RESOLVE` 日志；
+4. `cancelEvent`（取消事件）：
+ - 记录 `cancelReason`；
+ - 事件状态置为 CANCELLED；
+ - 级联调用 `cascadeCancelAssignments` 将该事件下所有派工置为 CANCELLED；
+ - 写入 `CANCEL` 日志。
+
+#### 1.3.6 日志与看板
+
+- 日志（AndonEventLog）：由各类 Service 方法在关键节点自动写入；
+- 看板（AndonBoardConfig）：前端根据配置定时拉取 AndonEvent 数据，在大屏展示当前安灯分布和状态。
+
+---
+
+### 1.4 关键扩展配置（remark JSON）
+
+部分高级策略通过 `remark` 字段以 JSON 形式保存，例如：
+
+```json
+{
+ "mode": "single|multi",
+ "fallback": "role|none",
+ "cancelOthers": true,
+ "resAnchor": "start|ack|create"
+}
+```
+
+含义说明：
+
+- `mode`：派工模式
+ - `single`：单人模式，只创建一条派工记录；
+ - `multi`：多人模式，按照用户列表全部创建；
+- `fallback`：兜底策略
+ - `role`：当 `notifyUsers` 为空或未成功创建时，退回按 `notifyRoles` 创建派工；
+ - `none`：不进行角色兜底；
+- `cancelOthers`：是否在某条派工完成后自动取消同一事件下其他并行派工，默认 `true`；
+- `resAnchor`：解决时限起算锚点
+ - `start`：优先从 `responseStartTime` 起算，若为空则退回确认时间，再退回创建时间；
+ - `ack`：从确认时间起算，若为空则退回创建时间；
+ - `create`：直接从创建时间起算。
+
+### 1.5 前后端代码逻辑概览
+
+本节从“前端页面 → 前端 api → 后端 Controller → Service → Mapper/数据库”的角度，梳理各模块的主要调用链，方便开发、联调与排查问题。
+
+#### 1.5.1 安灯事件（AndonEvent）调用链
+
+**前端页面与 api：**
+
+- 页面：`views/production/andonEvent/index.vue`
+- api：`api/production/andonEvent.js`
+ - `listAndonEvent(query)` → `GET /production/andonEvent/list`
+ - `getAndonEvent(eventId)` → `GET /production/andonEvent/{eventId}`
+ - `addAndonEvent(data)` → `POST /production/andonEvent`
+ - `updateAndonEvent(data)` → `PUT /production/andonEvent`
+ - `delAndonEvent(eventId)` → `DELETE /production/andonEvent/{eventId}`
+ - `acknowledgeEvent(eventId)` → `POST /production/andonEvent/acknowledge/{eventId}`
+ - `startProcessEvent(eventId)` → `POST /production/andonEvent/startProcess/{eventId}`
+ - `completeEvent(eventId, resolution)` → `POST /production/andonEvent/complete/{eventId}`，`resolution` 通过查询参数传递；
+ - `cancelEvent(eventId, cancelReason)` → `POST /production/andonEvent/cancel/{eventId}`，`cancelReason` 通过查询参数传递。
+
+**后端 Controller：** `AndonEventController`（`/production/andonEvent`）
+
+- `list(AndonEvent andonEvent)`：查询事件列表，调用 `IAndonEventService.selectAndonEventList`，由 `AndonEventMapper.selectAndonEventList` 查询 `andon_event` 表；
+- `add(AndonEvent andonEvent)`：新增事件，补全 `createBy`/`createTime` 后调用 `insertAndonEvent`；
+- `edit(AndonEvent andonEvent)`：修改事件，补全 `updateBy`/`updateTime` 后调用 `updateAndonEvent`；
+- `acknowledge(Long eventId)`：确认事件，调用 `acknowledgeEvent(eventId, getUsername())`；
+- `startProcess(Long eventId)`：开始处理，调用 `startProcessEvent(eventId, getUsername())`；
+- `complete(Long eventId, String resolution)`：完成事件，调用 `completeEvent(eventId, resolution, getUsername())`；
+- `cancel(Long eventId, String cancelReason)`：取消事件，调用 `cancelEvent(eventId, cancelReason, getUsername())`。
+
+**Service 关键逻辑：** `AndonEventServiceImpl`
+
+- `insertAndonEvent`：执行规则匹配与时限计算（`applyRuleAndCompute`）→ 写入事件（`insertAndonEvent` Mapper）→ 自动创建派工（`autoCreateAssignments`）→ 写入创建日志（`logEvent`）；
+- `updateAndonEvent`：根据最新时间重算截止时间；如状态为取消则调用 `cascadeCancelAssignments` 级联取消派工，并写取消日志；
+- `acknowledgeEvent` / `startProcessEvent` / `completeEvent` / `cancelEvent`：维护确认/开始处理/完成/取消相关字段与状态，调用 `AndonEventMapper.updateAndonEvent` 落库，并通过 `logEvent` 写入相应操作日志。
+
+**调用链时序图示例（新增安灯事件）：**
+
+```mermaid
+sequenceDiagram
+ participant U as 用户
+ participant V as AndonEvent 页面
index.vue
+ participant A as andonEvent.js
+ participant C as AndonEventController
+ participant S as AndonEventServiceImpl
+ participant RM as AndonRuleMapper
+ participant EM as AndonEventMapper
+ participant AM as AndonEventAssignmentMapper
+ participant LM as AndonEventLogMapper
+
+ U->>V: 点击“新增”并提交安灯表单
+ V->>A: addAndonEvent(data)
+ A->>C: POST /production/andonEvent
+ C->>S: insertAndonEvent(andonEvent)
+ S->>RM: selectAndonRuleList(...)
+ RM-->>S: 返回候选规则
+ S->>S: applyRuleAndCompute(匹配规则并计算截止时间)
+ S->>EM: insertAndonEvent(写入 andon_event)
+ S->>AM: insertAndonEventAssignment(根据规则创建派工)
+ S->>LM: insertAndonEventLog(记录创建日志)
+ S-->>C: 返回插入结果
+ C-->>A: AjaxResult
+ A-->>V: 响应成功，刷新事件列表
+```
+
+#### 1.5.2 安灯规则（AndonRule）调用链
+
+**前端页面与 api：**
+
+- 页面：`views/production/andonRule/index.vue`
+- api：`api/production/andonRule.js`
+ - `listAndonRule(query)` → `GET /production/andonRule/list`
+ - `getAndonRule(ruleId)` → `GET /production/andonRule/{ruleId}`
+ - `addAndonRule(data)` → `POST /production/andonRule`
+ - `updateAndonRule(data)` → `PUT /production/andonRule`
+ - `delAndonRule(ruleId)` → `DELETE /production/andonRule/{ruleId}`
+ - `getAndonRuleList(query)` → `GET /production/andonRule/getAndonRuleList`（安灯事件新增时用于加载规则下拉）
+
+**后端 Service 与 Mapper：**
+
+- `IAndonRuleService` / `AndonRuleServiceImpl`：提供规则的增删改查能力；
+- `AndonRuleMapper`（`AndonRuleMapper.xml`）：与 `andon_rule` 表交互；
+- 规则查询 `selectAndonRuleList` 被 `AndonEventServiceImpl.applyRuleAndCompute` 与 `autoCreateAssignments` 调用，用于为事件匹配最佳规则及派工策略。
+
+#### 1.5.3 安灯派工记录（AndonEventAssignment）调用链
+
+**前端页面与 api：**
+
+- 页面：`views/production/andonEventAssignment/index.vue`
+- api：`api/production/andonEventAssignment.js`
+ - `listAndonEventAssignment(query)` → `GET /production/andonEventAssignment/list`
+ - `getAndonEventAssignment(assignmentId)` → `GET /production/andonEventAssignment/{assignmentId}`
+ - `addAndonEventAssignment(data)` → `POST /production/andonEventAssignment`
+ - `updateAndonEventAssignment(data)` → `PUT /production/andonEventAssignment`
+ - `delAndonEventAssignment(assignmentId)` → `DELETE /production/andonEventAssignment/{assignmentId}`
+ - `getAndonEventAssignmentList(query)` → `GET /production/andonEventAssignment/getAndonEventAssignmentList`
+
+**后端 Service 与 Mapper：**
+
+- `IAndonEventAssignmentService` / `AndonEventAssignmentServiceImpl`：
+ - `insertAndonEventAssignment` 在自动派工或手工新增派工时调用，写入 `createTime` 后通过 `AndonEventAssignmentMapper.insertAndonEventAssignment` 持久化；
+ - `updateAndonEventAssignment` 根据派工状态自动补 `acceptTime` / `finishTime`，并通过 `AndonEventMapper` 联动更新事件的状态与时间里程碑，同时调用 `AndonEventLogMapper.insertAndonEventLog` 写日志；
+- `AndonEventAssignmentMapper`：与 `andon_event_assignment` 表交互。
+
+#### 1.5.4 安灯事件日志（AndonEventLog）调用链
+
+**前端页面与 api：**
+
+- 页面：`views/production/andonEventLog/index.vue`
+- api：`api/production/andonEventLog.js`
+ - `listAndonEventLog(query)` → `GET /production/andonEventLog/list`
+ - `getAndonEventLog(logId)` → `GET /production/andonEventLog/{logId}`
+ - `addAndonEventLog(data)` → `POST /production/andonEventLog`
+ - `updateAndonEventLog(data)` → `PUT /production/andonEventLog`
+ - `delAndonEventLog(logId)` → `DELETE /production/andonEventLog/{logId}`
+ - `getAndonEventLogList(query)` → `GET /production/andonEventLog/getAndonEventLogList`
+
+**后端 Service 与 Mapper：**
+
+- `IAndonEventLogService` / `AndonEventLogServiceImpl`：提供日志的增删改查；
+- `AndonEventLogMapper`：与 `andon_event_log` 表交互；
+- 实际业务中，大多由 `AndonEventServiceImpl`、`AndonEventAssignmentServiceImpl` 内部调用 `AndonEventLogMapper.insertAndonEventLog` 自动写入，不建议前端直接新增/修改。
+
+#### 1.5.5 安灯看板配置（AndonBoardConfig）调用链
+
+**前端页面与 api：**
+
+- 页面：`views/production/andonBoardConfig/index.vue`
+- api：`api/production/andonBoardConfig.js`
+ - `listAndonBoardConfig(query)` → `GET /production/andonBoardConfig/list`
+ - `getAndonBoardConfig(boardId)` → `GET /production/andonBoardConfig/{boardId}`
+ - `addAndonBoardConfig(data)` → `POST /production/andonBoardConfig`
+ - `updateAndonBoardConfig(data)` → `PUT /production/andonBoardConfig`
+ - `delAndonBoardConfig(boardId)` → `DELETE /production/andonBoardConfig/{boardId}`
+ - `getAndonBoardConfigList(query)` → `GET /production/andonBoardConfig/getAndonBoardConfigList`
+
+**后端 Service 与 Mapper：**
+
+- `IAndonBoardConfigService` / `AndonBoardConfigServiceImpl`：看板配置的增删改查；
+- `AndonBoardConfigMapper`：与 `andon_board_config` 表交互；
+- 前端看板展示页可基于 `boardCode` 拉取对应配置，再结合 `AndonEvent` 列表做可视化展示。
+
+---
+
+## 二、操作手册（终端用户使用说明）
+
+本章节面向车间一线操作人员、班组长、维修/质量/设备人员及生产管理人员，说明在各个前端页面上的具体操作方式和注意事项，并结合系统后台逻辑帮助理解业务闭环。
+
+### 2.1 用户角色与使用边界（概览）
+
+> 实际角色划分以项目实施时的权限配置为准，本节仅给出典型场景参考。
+
+- **一线操作工**：
+ - 在出现异常时发起安灯呼叫；
+ - 补充或更新呼叫描述信息。
+- **班组长/线长**：
+ - 维护本产线/班组相关的安灯规则；
+ - 跟踪本线的安灯事件进度，必要时协助调整处理优先级；
+ - 在特殊情况下取消不再需要处理的事件。
+- **维修/质量/设备工程师**：
+ - 作为安灯派工的接收者，接单并处理问题；
+ - 在系统中填写解决措施，完成派工与事件；
+- **生产/质量管理人员**：
+ - 通过事件列表、派工列表、日志和看板分析异常分布与响应效率；
+ - 调整规则和组织方式以持续优化。
+
+---
+
+### 2.2 安灯规则配置页面使用说明
+
+对应前端：`views/production/andonRule/index.vue`
+
+#### 2.2.1 页面结构
+
+- **查询区域**：
+ - 可按“规则名称”进行模糊查询；
+ - 其它高级条件（产线/工位/班组等）可按需要扩展使用；
+- **列表区域**：
+ - 展示规则名称、呼叫类型、适用范围、时限、默认优先级、通知对象等；
+ - 支持列显隐配置；
+- **操作按钮**：
+ - 新增：添加新的安灯规则；
+ - 修改：编辑选中规则；
+ - 删除：逻辑层面删除不再需要的规则（建议谨慎使用，优先通过 `isFlag` 失效）。
+
+#### 2.2.2 新增/编辑规则
+
+在弹出的规则表单中：
+
+- 填写“规则名称”“呼叫类型编码”；
+- 选择适用产线、工位/工序、班组（可选）；
+- 设置确认时限与解决时限（分钟）；
+- 设置默认优先级（1–5）；
+- 在“通知用户”中多选需要被通知的人员；
+- 必要时在“备注”中约定高级策略（如取消其它派工、解决时限锚点等）；
+- 提交后，系统在新增时会自动设置默认值（优先级 3、确认 5 分钟、解决 30 分钟、`isFlag=1` 等）。
+
+**建议：** 上线前先由工艺/设备/质量等相关部门共同评审规则配置，确保呼叫类型、适用范围和处理时限合理。
+
+---
+
+### 2.3 安灯事件页面使用说明
+
+对应前端：`views/production/andonEvent/index.vue`
+
+#### 2.3.1 查看与筛选安灯事件
+
+- 在顶部查询区域，可按“安灯呼叫单号”等条件查询；
+- 列表中可看到事件的呼叫类型、触发源类型、产线/工位/班组、工单号、设备、优先级、状态、各类时间节点等；
+- 可通过右上角列配置按钮开启/关闭不关心的列，简化视图。
+
+#### 2.3.2 新增安灯事件（手工发起呼叫）
+
+点击“新增”，在弹窗中：
+
+- 系统会自动给出一条默认的呼叫单号（如 `AD + 时间戳`），可直接使用；
+- 选择“呼叫类型编码”：
+ - 下拉选项来自安灯规则列表（仅取有效规则）；
+ - 推荐按实际业务场景选择对应类型；
+- 选择“触发源类型”与“触发源引用”：
+ - 若是工位安灯：选择触发源类型为工位，并从下拉中选择具体工位；
+ - 若是设备安灯：选择触发源类型为设备，并选择设备台账中的设备；
+ - 报警/手动等类型可直接输入引用 ID；
+- 选择产线、工位/工序、班组（均为下拉框）；
+- 如有需要，可录入工单号、设备编码等辅助信息；
+- 在“呼叫描述”中尽量详细描述问题现象和影响范围；
+- 提交后：
+ - 系统将自动匹配规则并计算确认/解决截止时间与优先级；
+ - 自动生成相关派工记录；
+ - 写入事件创建日志。
+
+#### 2.3.3 事件确认、完成与取消
+
+在事件列表的“操作”列中，根据事件状态会显示不同按钮：
+
+- **确认**（仅待处理状态显示）：
+ - 点击后，系统记录当前用户为确认人，并写入确认时间；
+ - 事件状态变为“处理中”；
+ - 写入确认日志；
+- **完成**（处理中状态显示）：
+ - 点击后，在弹窗或表单中填写解决措施；
+ - 系统记录处理完成时间，将事件状态置为“已解决”；
+ - 写入解决日志；
+- **取消**（待处理/处理中状态显示）：
+ - 输入取消原因后提交；
+ - 事件状态变为“已取消”；
+ - 系统自动将该事件下所有派工记录状态改为“已取消”；
+ - 写入取消日志。
+
+> 注意：安灯事件用于统计分析和追溯，**不建议删除事件**，如需终止处理，请使用“取消”功能。
+
+---
+
+### 2.4 安灯派工记录页面使用说明
+
+对应前端：`views/production/andonEventAssignment/index.vue`
+
+#### 2.4.1 查看派工记录
+
+- 在查询区域可按“派工状态”等条件进行筛选；
+- 列表中展示：被分配用户/角色/班组、派工时间、接单时间、完成时间、派工状态、是否有效等信息；
+- 通过列控制可隐藏技术性较强的字段（如主键 ID 等），方便业务人员使用。
+
+#### 2.4.2 修改派工状态
+
+系统设计上，派工记录通常由后端根据规则自动创建，业务人员主要通过“修改状态”来反映实际执行情况：
+
+- 选择一条或多条记录，点击“修改状态”；
+- 在弹出的表单中：
+ - 选择事件（只读或下拉）；
+ - 选择被分配用户（如有需要可调整）；
+ - 查看接单时间、完成时间（由后端自动维护）；
+ - 修改派工状态为：已派工、已接单、已完成、已取消、已拒绝等；
+ - 提交后，后端将自动补充对应的时间戳，并联动更新事件状态与里程碑时间，同时写入相应日志。
+
+**不建议**在日常使用中删除派工记录，以免影响事件完整性和统计结果。在特殊需要删除时，应遵循项目管理规范执行。
+
+---
+
+### 2.5 安灯事件日志页面使用说明
+
+对应前端：`views/production/andonEventLog/index.vue`
+
+#### 2.5.1 查看日志
+
+- 在查询区域可按“操作类型”筛选（如只看创建、派工、取消等）；
+- 列表中展示：事件 ID、操作类型、操作内容、操作人、操作时间等；
+- 可按时间排序，便于从时间轴维度审查某一事件的完整处理过程。
+
+#### 2.5.2 使用建议
+
+- 日志主要由系统后台自动记录，**通常无需人工新增或修改**；
+- 管理人员可在以下场景使用：
+ - 复盘重大停线/质量事故的处理过程；
+ - 检查某一次安灯是否按规定时限响应和完成；
+ - 分析不同班组/人员对安灯的响应习惯和效率。
+
+---
+
+### 2.6 安灯看板配置页面使用说明
+
+对应前端：`views/production/andonBoardConfig/index.vue`
+
+#### 2.6.1 查看与维护看板配置
+
+- 列表中展示：看板编码、看板名称、产线、工位/工序、展示字段配置、刷新间隔、是否有效等；
+- 可按看板编码或名称搜索特定看板配置。
+
+#### 2.6.2 新增/编辑看板配置
+
+在新增或编辑对话框中：
+
+- 填写“看板编码”“看板名称”；
+- 选择关联的产线和工位/工序；
+- 设置“刷新间隔”（秒）：
+ - 决定大屏从后端拉取数据的频率；
+ - 建议根据现场网络与数据量情况合理设置；
+- 根据需求配置“展示字段配置”（如展示哪些时间、状态、优先级等）；
+- 设置“是否有效”为启用状态；
+- 提交后，大屏应用即可根据新的配置进行展示。
+
+---
+
+### 2.7 典型业务使用场景小结
+
+#### 场景一：上线前配置规则
+
+- 由工艺/设备/质量/IT 等角色共同在“安灯规则配置”页面定义：
+ - 规则名称与呼叫类型；
+ - 适用产线/工位/班组；
+ - 确认与解决时限；
+ - 通知用户列表；
+ - 是否自动取消其他派工等策略。
+
+#### 场景二：现场发起安灯
+
+- 一线操作工或班组长根据现场情况，在“安灯事件”页面点击“新增”；
+- 选择合适的呼叫类型与触发源，填写产线/工位/班组与问题描述；
+- 提交后系统自动匹配规则和派工，不需要人工额外操作。
+
+#### 场景三：责任人接单并处理
+
+- 维修、质量等责任人员在“安灯派工记录”或“安灯事件”页面：
+ - 将派工状态改为“已接单”，开始实际处理；
+ - 在完成后改为“已完成”，并填写解决措施；
+- 系统自动维护相关时间节点并更新事件状态。
+
+#### 场景四：管理层监控与复盘
+
+- 通过“安灯事件”页面查看当前和历史事件分布；
+- 通过“安灯派工记录”分析不同责任人/班组的响应与处理情况；
+- 通过“安灯事件日志”还原重要事件的全过程；
+- 通过“安灯看板配置”与现场大屏，实时监控车间安灯整体健康状况。
+
+---
+
+### 2.8 参考案例：1号产线设备故障安灯全流程
+
+以下以“1号产线设备 A 停机故障”为例，从操作顺序和后台逻辑两个角度，串起完整安灯闭环：
+
+#### 2.8.1 前置配置（由规则到页面）
+
+1. 管理人员在“安灯规则配置”页面新增规则：
+ - `ruleName`：1号产线-设备故障；
+ - `callTypeCode`：DEVICE_FAULT；
+ - `productLineCode`：PL001（1号产线）；
+ - `stationCode`：对应工位；
+ - `ackTimeoutMin`：5 分钟，`resolveTimeoutMin`：30 分钟；
+ - `priorityDefault`：1（最高优先级）；
+ - `notifyUsers`：选择维修工程师账号；
+ - `remark` 中可配置 `{"mode":"single","cancelOthers":true,"resAnchor":"start"}`；
+2. 前端保存规则时调用 `addAndonRule` → `POST /production/andonRule`；
+3. 后端 `AndonRuleServiceImpl.insertAndonRule` 将规则写入 `andon_rule` 表，后续事件创建时会按 `callTypeCode` + 产线/工位/班组匹配到该规则。
+
+#### 2.8.2 现场发起安灯事件
+
+1. 一线操作工在 1 号产线操作台发现设备 A 停机：
+ - 打开“安灯事件”页面，点击“新增”；
+ - 选择“呼叫类型编码：DEVICE_FAULT”；
+ - 触发源类型选“设备”，触发源引用选择设备 A；
+ - 产线选择 PL001，工位选择当前工位，班组选择当前班组；
+ - 在“呼叫描述”中填写“设备 A 突然停机，无法启动”；
+ - 提交表单。
+2. 前端调用 `addAndonEvent` → `POST /production/andonEvent`，将表单数据作为 `AndonEvent` 传入后端；
+3. 后端 `AndonEventController.add`：
+ - 补全 `createBy = 当前登录用户`、`createTime = 当前时间`；
+ - 调用 `AndonEventServiceImpl.insertAndonEvent`；
+4. `insertAndonEvent` 内部：
+ - 调用 `applyRuleAndCompute(andonEvent, true)`：
+ - 根据 `callTypeCode=DEVICE_FAULT`、产线/工位/班组在 `andon_rule` 中筛选出候选规则；
+ - 通过 `pickBestRule` 按匹配度选择前面配置的“1号产线-设备故障”规则；
+ - 计算 `ackDeadline = createTime + 5 分钟`；
+ - 计算 `resolveDeadline = （后续 start 时间 或 createTime）+ 30 分钟`；
+ - 若未手动设置优先级，则赋值为 `priorityDefault=1`；
+ - 通过 `AndonEventMapper.insertAndonEvent` 写入 `andon_event` 表；
+ - 调用 `autoCreateAssignments(andonEvent)`：
+ - 读取规则中的 `notifyUsers`，为维修工程师创建一条派工记录（状态 ASSIGNED，`assignedTime` 为当前时间）；
+ - 通过 `AndonEventAssignmentMapper.insertAndonEventAssignment` 写入 `andon_event_assignment` 表；
+ - 调用 `logEvent` 向 `andon_event_log` 记录一条“事件创建并完成规则计算与派工初始化”的日志。
+
+#### 2.8.3 责任人接单与处理
+
+1. 维修工程师在系统中查看“安灯派工记录”页面：
+ - 筛选派工状态为“已派工”；
+ - 看到自己被分配到的“设备 A 故障”记录；
+2. 维修工程师点击“修改”/“修改状态”，将派工状态改为“已接单”：
+ - 前端调用 `updateAndonEventAssignment` → `PUT /production/andonEventAssignment`；
+ - 后端 `AndonEventAssignmentServiceImpl.updateAndonEventAssignment`：
+ - 补全 `acceptTime = 当前时间`；
+ - 根据 `eventId` 读取对应 `AndonEvent`，若 `responseStartTime` 为空则补为当前时间；
+ - 将事件状态置为 PROCESSING；
+ - 更新 `andon_event` 与 `andon_event_assignment`，并写入一条“派工已接受，事件进入处理中”的日志；
+3. 维修工程师处理完成后，再次修改派工状态为“已完成”：
+ - 前端仍然调用 `updateAndonEventAssignment`；
+ - `updateAndonEventAssignment`：
+ - 补全 `finishTime = 当前时间`；
+ - 若事件 `responseEndTime` 为空则补为当前时间，将事件状态置为 RESOLVED；
+ - 按规则中 `cancelOthers=true`，自动取消同一事件下其他未完成派工（如有）；
+ - 写入“派工已完成，事件标记已解决”以及“策略要求取消该事件的其他并行派工”的日志。
+
+> 也可以由班组长在“安灯事件”页面直接对该事件点击“完成”，前端调用 `completeEvent` 接口，后端 `AndonEventServiceImpl.completeEvent` 会记录 `responseEndTime`、`resolution` 并将事件状态置为 RESOLVED，同样写入解决日志。
+
+#### 2.8.4 管理层查看与复盘
+
+1. 生产管理在“安灯事件”页面按时间、产线、呼叫类型筛选，可看到该次设备故障安灯的：
+ - 呼叫单号、产线/工位、设备、班组；
+ - 优先级、当前状态；
+ - 确认时间、开始处理时间、完成时间；
+ - 确认/解决截止时间是否被超时等；
+2. 在“安灯事件日志”页面按事件 ID 查询，可看到完整的日志链：
+ - 事件创建；
+ - 自动派工；
+ - 派工被接受；
+ - 派工完成及自动取消其他派工（若有）；
+3. 在现场安灯看板上，对应 1 号产线的大屏会按配置展示：
+ - 当前正在处理或已超时的安灯事件；
+ - 该设备故障事件在处理期间会以高优先级标记，以便管理者快速关注。
+
+通过上述案例，可以看到：
+
+- 业务人员仅需按实际情况在前端页面完成“配置规则 → 发起安灯 → 接单处理 → 填写结果”等操作；
+- 系统自动完成规则命中、时限计算、派工生成、状态联动和日志记录；
+- 管理层可以通过事件列表、派工记录、日志和看板对一次安灯从呼叫到解决的全过程进行追踪与复盘。
+
+---
+
+### 2.9 安灯业务流程总览（流程图）
+
+本节通过一张整体流程图，展示安灯从**规则配置 → 现场呼叫 → 系统匹配规则与派工 → 接单处理 → 完成/取消 → 日志与看板**的闭环过程。若使用支持 Mermaid 的 Markdown 查看器（如 VSCode 对应扩展、部分 Git 平台），下方代码块会直接渲染为流程图。
+
+```mermaid
+flowchart LR
+ subgraph PRE[规则与基础配置]
+ RCFG[安灯规则配置
AndonRule] -->|保存规则| RDB[(andon_rule)]
+ BCFG[安灯看板配置
AndonBoardConfig] --> BDB[(andon_board_config)]
+ end
+
+ subgraph CALL[现场呼叫]
+ OP[一线操作工/班组长] -->|点击“新增安灯”或外部系统触发| FEV[前端安灯事件页面
andonEvent/index.vue]
+ FEV -->|addAndonEvent| API[/api/production/andonEvent.js/]
+ API --> CTRL[AndonEventController]
+ end
+
+ CTRL -->|insertAndonEvent| SVC[AndonEventServiceImpl]
+
+ subgraph RULE[规则匹配与时限计算]
+ SVC -->|selectAndonRuleList| RDB
+ RDB --> SVC
+ SVC -->|applyRuleAndCompute
计算确认/解决时限、优先级| SVC
+ end
+
+ subgraph EVENTDB[事件与派工落库]
+ SVC -->|insertAndonEvent| EDB[(andon_event)]
+ SVC -->|autoCreateAssignments| ADB[(andon_event_assignment)]
+ SVC -->|logEvent(CREATE/ASSIGN)| LDB[(andon_event_log)]
+ end
+
+ subgraph EXEC[接单与处理]
+ RSP[维修/质量/设备人员] -->|在派工页面查看并“接单/完成”| FAS[前端派工页面
andonEventAssignment/index.vue]
+ FAS -->|updateAndonEventAssignment| AAPI[/api/production/andonEventAssignment.js/]
+ AAPI --> ASVC[AndonEventAssignmentServiceImpl]
+ ASVC --> ADB
+ ASVC --> EDB
+ ASVC -->|logEvent(ACCEPT/RESOLVE/CANCEL_OTHERS)| LDB
+ end
+
+ subgraph LIFECYCLE[事件生命周期操作]
+ MGR[班组长/管理人员] -->|确认/开始处理/完成/取消| FEV2[安灯事件页面操作按钮]
+ FEV2 -->|acknowledgeEvent/startProcessEvent/completeEvent/cancelEvent| API2[/api/production/andonEvent.js/]
+ API2 --> CTRL2[AndonEventController]
+ CTRL2 --> SVC2[AndonEventServiceImpl]
+ SVC2 --> EDB
+ SVC2 -->|logEvent(ACK/RESOLVE/CANCEL)| LDB
+ end
+
+ subgraph VIEW[查看与复盘]
+ MGR2[管理层/分析人员] --> EVLIST[安灯事件列表页]
+ MGR2 --> ASSLIST[派工记录页]
+ MGR2 --> LOGPAGE[事件日志页]
+ MGR2 --> BOARD[现场安灯看板]
+
+ EVLIST -->|查询/统计| EDB
+ ASSLIST --> ADB
+ LOGPAGE --> LDB
+ BOARD -->|读看板配置| BDB
+ BOARD -->|拉取安灯事件数据| EDB
+ end
+
+ PRE --> CALL
+ EVENTDB --> EXEC
+ EVENTDB --> LIFECYCLE
+ EXEC --> VIEW
+ LIFECYCLE --> VIEW
+```
+
+---
+
+> 本文档仅覆盖当前代码与前端页面实现范围。若后续扩展了安灯统计报表、自动升级策略、移动端推送等能力，可在本文件中增补相应章节。
+