# archive.html · 设备档案

## 用途与角色

S11-1 设备档案维护（文员职责）。**在役序列号清单的唯一权威来源**——ECN 影响面清点只认这里（规格书 3.4 节、第 11 节）。

## 区块

| 区块 | 说明 |
|---|---|
| 完整度警示条 | 缺客户/出厂日期的台数与占比，黄色常驻直至 100% |
| 筛选栏 | 机型/在役状态/客户/编号搜索 |
| 档案表 | 编号/客户/机型/出厂/配置版本/程序版本/累计问题单/累计工时/在役 + 「历史问题单」穿透 |
| 操作 | 批量导入（Excel 模板）/ 导出 |

## 字段与来源

- 累计问题单/累计工时：由 S1/S8 汇总的派生值（设备维度聚合）。
- 程序版本：ECN 实施完成时自动回写（在役逐台整改签字后）。
- 在役/退役：文员维护；退役设备保留全部历史，仅退出影响面候选。

## 行为契约

1. 批量导入：模板校验（编号唯一、出厂日期格式、客户名匹配 S11-2）；失败行下载回执修正重传，成功行即时生效。
2. 「历史问题单（N）」点击 → 问题单列表预筛选该设备。
3. ECN 影响面清点入口（ECN 页调用）：按机型+在役导出清单，导出动作留审计。
4. 档案修改（机型/出厂日期等关键属性）留变更历史；删除禁止（只能退役）。

## 接口草案

- `GET /api/loop/devices?model=&status=&customer=&q=&page=`
- `POST /api/loop/devices/import`（multipart）/ `GET /api/loop/devices/export`
- `PATCH /api/loop/devices/{id}`（关键属性变更留痕）

## 权限

- 维护：文员 ✓ 经理 ✓；技术/质量/跟单员只读；台账只读+导出。

## 边界与空态

- 无设备：引导先做初始导入（M1 迁移验收：在役设备 100% 有客户名/机型/出厂日期）。
- 重复编号导入：整批拒绝并报告冲突行。

## AI 辅助（M2）

- 警示条内「AI 档案补全建议」：从该设备历史工单的客户联系人、装机时间推断缺失的客户名/出厂批次，给置信度，**逐台核对采纳**后落库（落库留审计、标注来源=AI 推断+确认人）。

## 验收要点

- 按「机型 G7 + 在役」筛选出的台数 = ECN-2026-014 在役子表应改数（同源）。
- 档案完整度未达 100% 时警示条不可关闭。