# 桌面页面与交互结构

> V1 是单窗口 PyQt5 桌面应用，没有 Web 路由。本文件规定页面职责和导航，V2 选择本地网页壳或桌面壳时必须保持同等用户流程。

## 页面 / 视图

| 视图 | MVP 职责 |
| --- | --- |
| 实时监控 | 选择本地安全配置、开始/停止流、显示视频、骨架、ID、状态、连接质量和 FPS。 |
| 设置面板 | 显示非敏感配置值，保存前校验；不得显示真实 RTSP 密码。 |
| 摔倒弹窗 | 仅首次 `fall.confirmed` 时显示人员 ID、确认时间、截图路径和确认按钮。 |
| 事件提示区 | 显示最近事件和截图保存结果；V1 不做长期历史数据库。 |
| 连接错误提示 | 显示断流或配置错误以及可重试状态；不得使用“正常”掩盖错误。 |

## 实时监控视图

- 绿色：`NORMAL`。
- 黄色：`SUSPECT`。
- 红色：`CONFIRMED`。
- 灰色：无人员、低质量或视频源不可用；必须附带原因文字。
- 每个可见人员显示稳定 `track_id`、骨架和状态，避免将全画面统一标成摔倒。
- 红色事件持续时维持可视状态，但弹窗和声音只出现一次。

## 交互规则

1. 点击“开始”前，校验模型文件、配置文件和 RTSP 环境变量。
2. 点击“停止”后，停止视频源、释放模型线程、停止刷新；不删除已保存事件。
3. 修改事件阈值后，UI 显示的值必须是下一次开始监控真正使用的配置版本。
4. 断流时显示错误与重连状态；恢复连接不自动生成摔倒事件。
5. 截图保存失败时，仍保留红色报警并在提示区记录错误。