# issue-detail.html · 问题单详情

## 用途与角色

单据主操作面。示例视角=售后经理（操作按钮最全）。其他角色按矩阵裁剪按钮与字段可编辑性。

## 区块

| 区块 | 说明 | 数据 |
|---|---|---|
| 页头 | 单号＋紧急度（含原 P0 角标）＋状态＋逾期标＋操作按钮组 | S1 |
| 状态步进条 | 7 状态，done/cur/todo 三态 | 派生 |
| 基本信息 | 受理/定级/归口/时限字段（kv 网格） | S1 手填+自动 |
| 派生字段区（灰底🔒） | 主单状态/卡在哪/落地物类型/重复计数/累计工时成本 | **派生，接口层禁写** |
| 关联落地物 | ECN 卡片（链接+四数+当前阶段+缺口）；应急措施单卡片 | S5/S2 |
| 关联工单 | 工单号＋结果＋工时＋备件＋签字状态 | S8 |
| 时间线 | 全部动作倒序（建单/归口/派工/降级签字/立项/推送） | 审计 |
| 关闭校验预检 | 9.1 五条实时绿灰 | 派生 |

## 行为契约（按按钮）

1. **归口**（仅经理，待归口态）：选出口 6 选 1 → 写出口归属+归口时刻；技术变更类同时提示需 EQCT（4D 引发的例外见 A13）。
2. **派工**（仅经理）：指定责任人 Owner（单人）；写派单时刻、算落地物应启动日（派单日+5 工作日）。
3. **降级**（仅经理）：P0→P1/P2 需已有验证通过的应急措施单；写降级签字人+时刻，留审计（9.1⑤）。
4. **挂起/恢复**（经理；文员登记）：选挂起原因（客户回签/报价/供应商/观察期）；应关闭日暂停顺延（A6）；超上限自动升级（A7）。
5. **催办**：对当前卡点责任人发企微催办，24h 内限 1 次。
6. **关闭主单**（仅经理）：实时预检 9.1 五条，任一灰则按钮禁用并 tooltip 说明缺哪条；全绿弹确认（回填落地物编号不可改）→ 写关闭时刻、触发 90 天复发窗口（A14）。
7. 紧急度**升档**：文员/工程师可直接升；技术/质量/销售走「申请」→ 文员定。
8. 编辑权限：字段级——文员改不了出口归属；非经理看不到降级/关闭按钮；派生区对所有人只读。

## 接口草案

- `GET /api/loop/issues/{sf}`（含落地物、工单、时间线、预检）
- `POST /api/loop/issues/{sf}/assign-outlet` / `/assign-owner` / `/downgrade` / `/suspend` / `/resume` / `/urge` / `/close`
- `POST /api/loop/issues/{sf}/priority`（升/申请）

## 边界与空态

- 无落地物时该区显示空态＋「按出口归属创建：ECN/TIP/4D…」按钮（按出口过滤可选类型）。
- 已关闭单：全页只读＋绿色关闭横幅（关闭人/时刻/凭据编号）＋「复发窗口至 YYYY-MM-DD」。
- 权限外的按钮不渲染（非置灰），防探测。

## 验收要点

- 直调 `PATCH /api/loop/issues/{sf}` 改 `status`/`stuck_at` → 400（铁律一接口层锁）。
- 无落地物编号点关闭 → 明确报错文案；有已签批 4D 时关闭成功且时间线留痕。

## AI 辅助（运营摘要 · M2）

- 右栏「AI 单据摘要」卡：一句话进展＋阻塞点＋风险判断＋前瞻建议（如"到料前可先排在制整改"），只读并标注"不作为流程节点依据"。
- 关联落地物区后续版本加「✦ AI 起草处理方案」入口（M3，质量分析智能体，产出进 4D/TIP 草稿，不落主单字段）。