# issues.html · 问题单列表

## 用途与角色

S1 主表的全量视图。默认视角=文员（全部可见）；按角色收敛（规格书 2.2「查看全部单」行）。

## 区块

| 区块 | 说明 |
|---|---|
| 筛选栏 | 紧急度/状态/出口/客户/关键词；右侧实时计数（共/逾期/挂起） |
| 列表表格 | 单号（链接）· 客户/设备 · 紧急度 · 出口 · 状态（含"当前卡在哪"副行）· 责任人 · 剩余时限 · 创建 |
| 分页 | 服务端分页，默认 20/页 |

## 字段与来源

- 「状态」及「当前卡在哪」：派生只读（铁律一），行内不可编辑，悬浮提示"由落地物状态计算"。
- 剩余时限：应关闭日（挂起顺延后）− 今天；负值红色 `−2 天`；挂起单显示「挂起」灰标。
- 紧急度显示当前值；曾 P0 的降级单显示 `P1（原P0）` 角标。

## 行为契约

1. 逾期行整行浅红（`row-bad`）且默认排最前；筛选器可切换。
2. 点击单号 → 详情页；「＋新建问题单」仅文员/经理可见（台账管理员无建单权，V0.2 修订 #14）。
3. 列口径：工程师=本人参与；技术/质量=本出口口；销售=本人；跟单员=涉料单。
4. 导出：当前筛选结果 CSV（台账管理员月度导出的主路径）。

## 接口草案

- `GET /api/loop/issues?status=&priority=&outlet=&customer=&q=&page=`
- `GET /api/loop/issues/export`（同参数，CSV）

## 边界与空态

- 无结果：提示并给「清空筛选」按钮。
- 已关闭单默认收起（筛选可选），关闭满 90 天进入复发窗口的标「复查中」。

## 验收要点

- 文员看到全部 128 条、工程师只见本人 12 条（同一数据集验证）。
- 状态列任何角色任何入口都不可编辑（含直调 API，接口层拒绝）。

## AI 辅助

- 「✦ AI 对话受理（推荐）」按钮跳转建单页 AI 受理区（见 `issue-new.md`），是推荐的低门槛建单路径。