# ecn.html · ECN 变更单

## 用途与角色

最复杂落地物（S5，22 字段）。示例视角=技术（ECN 整改负责人）。规格书 3.2 节 S5、第 5/9 节。

## 区块

| 区块 | 说明 |
|---|---|
| 页头 | ECN 号＋状态＋物料缺口标＋操作（生成请购/导出物料清单） |
| 状态步进条 | 10 段：草稿→影响面锁定→评审→已批准→请购中→到料→实施中→已回标→已论证→已关闭 |
| 影响面四数卡 | 应改新机/在制/在役/旧料处置＋锁定人时刻＋切换点 |
| 物料清单子表 | 件号/名称/用途标记（常规·整改专用）/应需/到货/缺口/状态 |
| 在役逐台子表 | 设备×客户×整改状态×旧件回收，进度条，分页 |
| 关闭七项硬校验 | 实时绿灰清单（2/7 示例） |
| 基本信息 | 摘要/原因/验证判据/版本/观察期/会签 |

## 行为契约

1. **影响面锁定闸门（A9）**：四数未全部锁定时「生成请购单」禁用，tooltip 列出缺失项；锁定动作=整改负责人提交＋四方数据落库，锁定后修改需重新评审（状态回退并留痕）。
2. **物料缺口（A10/A11）**：到货<应需的行标红；缺口>0 每日生成 HUB 任务@跟单员；「整改专用」行被生产挪用→当日报警给经理。
3. **在役清单来源**：从 S11-1 按「机型+在役」一键拉取生成逐台子表；整改完成逐台签字；旧件回收销毁必填记录（9.2⑤）。
4. **状态推进**：到料（全部行缺口=0）→实施中→已回标（新机/在制完成）→已论证（三项：实物符合/功能验证/客户观察期 30 天，量化判据必填）→已关闭（七项全绿）。
5. **关闭即回写**：ECN 关闭自动回写关联 4D（A13），并提示「售后第二签」——ECN 关闭 ≠ 问题单关闭（9.2 第 7 项）。
6. 生成请购：调 S9 配件申请（用途=整改专用），请购号回填物料行。

## 接口草案

- `GET /api/loop/ecn/{id}`（含子表与校验状态）
- `POST /api/loop/ecn/{id}/impact-lock`（四数锁定）
- `POST /api/loop/ecn/{id}/purchase-req`（A9 闸门在此校验）
- `POST /api/loop/ecn/{id}/units/import-in-service`（从 S11-1 拉清单）
- `POST /api/loop/ecn/{id}/units/{unit}/rectify`（逐台签字）
- `POST /api/loop/ecn/{id}/close`（9.2 七项校验）

## 权限

- 提交/处置：技术 ✓（质量会签，跟单员只读到料，经理只读）。
- 影响面锁定：ECN 整改负责人（技术岗）汇总四方数据后执行。

## 边界与空态

- 在役子表 0 行：提示先完善 S11-1 档案（联动 archive 页黄条）。
- 观察期未满时「已论证」不可达，显示剩余天数倒计时。
- 会签未齐：评审段停住，显示待会签人。

## AI 辅助（变更协调 · M3）

- 「✦ AI 预清点」：从 S11-1 设备档案＋BOM 差异＋在制计划生成四数建议稿与在役清单初稿、物料清单初稿；四方核对改定后由整改负责人**人工锁定**——A9 闸门逻辑不变，AI 无锁定权限。
- 接口：`POST /api/loop/ai/ecn/{id}/impact-suggest` → 建议值+依据（档案命中数/BOM 差异行）。

## 验收要点

- 未锁四数点「生成请购」→ 拒绝并列出缺失项（A9）。
- 七项校验有灰项时 `close` 接口 400 并返回逐项原因。
- 在役 30 台改 27 台时无法关闭——系统回答"还差 3 台哪几台"。