# report-alert 域设计总纲（报表预警）

LLMS 索引： [llms.txt](/llms.txt)

---

> **源**：PRD「八、页面架构与关键页面设计」页面树 12「报表预警」（单节点）+「七、核心功能逐项需求」各节**埋点**行（齐套检查、齐套率、未齐套原因、插单模拟、交期影响、外协创建/回货/逾期、回款等埋点汇总为报表与预警源）；决策记录 Q19（负荷口径）/ Q41（成本毛利脱敏）。P0 裁决见决策记录：44 问 triage §2/§5。
>
> **设计确认门：本稿产出即停点，用户确认后才进下一步（FSD 于 B5 完成后统一编制，2026-10-21 裁决）。**
>
> 状态：**已确认**（2026-10-21 用户确认 B5；后续修订追加登记于本行下方）
> 修订：2026-10-21 B5 定稿确认（含报表卡+预警生命周期「触发→确认→消除」、设备负荷口径=班次+小时（Q19 与 resources-crews 互链）、毛利卡按角色渲染（Q41）、预警阈值可配置禁预设）。（FSD `00-总则` 修订记录已于 Phase 3 创建时补记本次定稿）
> 修订：2026-10-21 Phase 3 批量铺开——m14 报表预警册已建（`prd/fsd/m14-报表预警.md`，F14.01~F14.02），本表 FSD ID 列由册粒度占位细化为功能 ID。
> 原型：`html/index.html` 导航 + 1 屏，零依赖静态 HTML；预览走文档站（相对链接以站点布局为准）。

## 页面清单

| 屏 | 原型文件 | 对应真实路由 | 交互点 | 覆盖的 FSD ID |
|----|----------|--------------|--------|----------------------------|
| 报表与预警 | [reports-alerts.html](/poms/design/html/report-alert/reports-alerts.html) | `/reports` | 报表卡（经营/生产/回款——数据来自各域埋点，数值均为示例）；**设备负荷口径=班次+小时（Q19，与 resources-crews 呼应句同一口径）**；毛利类报表按角色脱敏（Q41，销售视角不渲染）；预警列表（等级/类型/对象/触发规则/状态）；预警可跳转对应域详情；阈值**可配置、不预设数值**（配置入口归 admin m15） | F14.01（报表卡）、F14.02（预警管理） |

> 归并说明：页面树 12 为单节点，1 屏承载「报表卡区 + 预警列表区」两块内容。复杂报表钻取/自定义报表属 P2（PRD 范围注），本屏以聚合卡 + 预警为主。

## 状态迁移（预警项生命周期，各域埋点触发）

```mermaid
stateDiagram-v2
    [*] --> 已触发: 埋点越限（齐套延迟/交期风险/回款逾期/外协逾期等）
    已触发 --> 已确认: 责任人确认（认领）
    已确认 --> 处理中: 关联业务动作进行（跳转各域）
    处理中 --> 已消除: 业务状态恢复正常（自动关闭）
    已触发 --> 已升级: 超时未确认（升级通知上级——阈值可配置）
    已升级 --> 处理中: 上级认领
    已消除 --> [*]
```

> 预警是埋点的**越限投影**，不承载业务状态——处理动作在各域完成，本域只跟踪「触发→确认→消除」生命周期。升级/消除阈值为可配置参数（假设，不预设数值）。

## 裁决引用（本域设计吸收的 Phase 0 裁决与假设标注）

| 裁决/问题 | 内容 | 落地点 |
|-----------|------|--------|
| **Q19**（已采纳） | 资源负荷口径=设备+班组，**班次+小时** | 负荷报表卡口径注——与 resources-crews「负荷报表同口径（m14）」互相回链 |
| **Q41**（已采纳） | 成本/毛利仅财务与管理层可见 | 毛利/成本报表卡按角色渲染；销售视角显示「无权限」占位；矩阵收口 admin 域 |
| 各域埋点（6.2~6.10） | 齐套率/插单模拟/交期影响/外协回货/回款等为预警源 | 预警列表「来源埋点」列 |
| 预警阈值 | 全部可配置，**禁预设数值** | 阈值列显示「已配置（参数待访谈）」，配置入口归 admin |

**假设标注约定**：未裁决参数一律「假设（Q<n>，待客户确认）」；预警阈值/报表统计口径参数不出现预设数值，页面数字均为示例数据（页面内联 mock）。

## 覆盖性对账

- 对应 FSD 册：**m14 报表与预警**（批量铺开已建：`prd/fsd/m14-报表预警.md`，F14.01~F14.02）——双向关联两侧无空（2026-10-21 批量铺开互挂）。
- 页面树 12「报表预警」单节点全覆盖，1 屏承载（归并说明见页面清单下注）。
- mock 与 B1~B4 连续：预警引用 WO-0321（齐套延迟）、XC-2026-0107（外协回货延迟）、ORD-0103（回款逾期 ¥14,880）、NC-119（质量返工）；负荷卡呼应 planning 甘特与 resources-crews 班次+小时。

---

反链：

- [交互设计](/poms/design/)
- [FSD M14 · 报表预警](/poms/fsd/m14-%E6%8A%A5%E8%A1%A8%E9%A2%84%E8%AD%A6/)