# issue-new.html · 新建问题单

## 用途与角色

文员受理建单（文员/经理可建；台账管理员不可，V0.2 修订 #14）。当场判紧急度。规格书 2.1 节、S1 字段表。

## 区块

| 区块 | 说明 |
|---|---|
| 一·受理信息 | 报修来源（4 选 1）/ 客户（搜索选择）/ 设备（搜索选择，带出只读档案卡）/ 故障描述（≥20 字计数） |
| 二·定级 | 影响程度（4 选 1，定级依据）/ 紧急度 P（3 选 1）＋「按高不就低」提示 |
| 右栏 | 定级提示表 / 系统自动写入说明 / 同类历史提示（A8） |

## 字段与来源

| 字段 | 来源 | 校验 |
|---|---|---|
| 客户名称 | 手填（关联 S11-2） | 必填，搜索选择 |
| 设备编号 | 手填（关联 S11-1） | 必填；带出机型/出厂/配置/程序版本只读卡 |
| 故障描述 | 手填 | 必填 ≥20 字，前端计数+后端复核 |
| 影响程度 | 手填 | 必填；选项=停机/停线/降效/不影响 |
| 紧急度 P | 手填 | 必填；P0/P1/P2 |
| 单号 / T0 / 应关闭日 / 状态 / 创建人时刻 | **自动** | 提交时生成，不出现在表单 |

## 行为契约

1. 提交 → `POST /api/loop/issues`：生成 `SF-YYYYMM-####`、写 T0、算应关闭日（T0+15 净工作日，技术变更出口 30）、状态=待派单、创建人/时刻。
2. P0 单提交即触发「P0 单创建」立即推送（经理+文员）并进 30 分钟归口倒计时（通知矩阵）。
3. 同类历史卡：按设备编号＋现象关键词查近 90 天命中数；≥1 显示；提交时命中 ≥2 自动打「重复问题」标记（A8）。
4. 暂存草稿：仅存本地（localStorage），不占单号、不触发任何规则。
5. 定级提示表为静态参考；P0 具体判据清单待产品拍板（规格书待确认 #3）。

## 接口草案

- `POST /api/loop/issues`
- `GET /api/loop/customers?q=`、`GET /api/loop/devices?q=&customer=`（搜索下拉）
- `GET /api/loop/devices/{id}/similar-issues`（同类历史）

## 权限

- 建单：文员 ✓ 经理 ✓；其余只读或无。
- 出口归属**不在本页**：归口是经理动作，在详情页完成（本页刻意不给，防越权归口）。

## 边界与空态

- 设备档案缺失（客户/出厂日期为空）：可建单，但右栏黄条提示「档案不完整，影响后续影响面清点」。
- 提交失败（网络/校验）：保留全部已填内容，错误定位到字段。

## 验收要点

- 提交后列表首行出现新单，状态=待派单，T0=提交时刻（秒级一致）。
- <20 字提交被拒且提示明确；P0 提交后经理 1 分钟内收到企微推送。

## AI 辅助（受理助理 · M2）

- 「AI 快速受理」区（页内锚点 `#ai`，列表页按钮直达）：粘贴微信记录或语音转写 → 提取客户/设备/现象/影响程度**预填**表单（AI 预填字段带标记，人确认后清除）；紧急度仅给**建议值**（标"需人确认"）。
- 接口：`POST /api/loop/ai/intake {text|audio_url}` → 返回结构化字段+置信度；命中知识库/同类历史时一并返回（A8 提示增强）。
- 边界：AI 不定级、不提交；提取失败时回退手工表单（本页始终保留完整手填模式）。