Praxis Design Explorer

Sequence Diagram：对象交互：查看设备概览主成功场景

Trail Mate 系统 / 设备管理 · Use Case 查看设备概览 · 项目版本 0.0.0 · Git 34aad0bffa2f dirty · 更新于 2026-06-25T14:17:55.307Z

Trail Mate 系统 / 设备管理 / 查看设备概览

对象交互：查看设备概览主成功场景

candidate · medium

用户触发概览页面后，GTK 界面调用后台服务获取状态数据

交互场景

用户查看设备核心状态指标

参与者 / 生命线

  • - participant User as 用户
  • - participant Shell as GtkUConsoleShell
  • - participant Widgets as GtkUConsoleWidgets
  • - participant Board as TLoRaPagerBoard

消息时序

  • - User->>Shell: 选择概览页面
  • - Shell->>Widgets: 请求刷新状态
  • - Widgets->>Board: 获取电池、信号、GPS 状态
  • - Board-->>Widgets: 返回状态数据
  • - Widgets-->>Shell: 更新 UI 控件
  • - Shell-->>User: 显示概览

同步 / 异步 / 回调

  • - Board-->>Widgets: 返回状态数据
  • - Widgets-->>Shell: 更新 UI 控件
  • - Shell-->>User: 显示概览

返回 / 异常 / 补偿

  • - Board-->>Widgets: 返回状态数据
  • - Widgets-->>Shell: 更新 UI 控件
  • - Shell-->>User: 显示概览

事务 / 幂等 / 重试边界

UI 组件（Widgets）作为应用服务调用 Board 接口获取硬件事实

  • - 无

Sequence UML 读图说明

用户生命线触发 UI，UI 向 Board 请求数据并返回

实现范围锚点

  • - 模块：apps/linux_uconsole_gtk
  • - 模块：boards
  • - 关键文件：apps/linux_uconsole_gtk/src/platform/gtk/gtk_uconsole_widgets.cpp
  • - 关键文件：boards/tlora_pager/src/tlora_pager_board.cpp
  • - 代码锚点：apps/linux_uconsole_gtk/src/platform/gtk/gtk_uconsole_widgets.cpp#L1
  • - 不覆盖代码：其他板的实现

不覆盖场景

  • - 硬件状态轮询
  • - 错误恢复

UML 底图

sequenceDiagram
  participant User as 用户
  participant Shell as GtkUConsoleShell
  participant Widgets as GtkUConsoleWidgets
  participant Board as TLoRaPagerBoard
  User->>Shell: 选择概览页面
  Shell->>Widgets: 请求刷新状态
  Widgets->>Board: 获取电池、信号、GPS 状态
  Board-->>Widgets: 返回状态数据
  Widgets-->>Shell: 更新 UI 控件
  Shell-->>User: 显示概览

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新 Sequence Diagram。