Praxis Design Explorer

用例图地图

项目版本 0.0.0 · Git 34aad0bffa2f dirty · 更新于 2026-06-25T14:17:55.307Z · 来源 Agent 候选分析

版本策略

业务模块边界

  1. Trail Mate 系统 系统边界

    管理整个应用的用户目标和业务能力

    1. 设备管理 业务模块

      提供设备状态的可见性和用户可控的硬件管理

    2. 聊天通信 业务模块

      管理用户间的消息传递和无线电链路配置

    3. 地图导航 业务模块

      提供基于地图的位置可视化和导航

    4. 团队协作 业务模块

      支持多个用户组成团队并共享实时位置

    5. 诊断工具 业务模块

      提供系统诊断和现场数据采集工具

Trail Mate 系统 / 设备管理

查看设备概览

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_device_management["设备管理"]
      useCase_use_case_view_device_overview(["查看设备概览"])
    end
  end
  actor_actor_user --- useCase_use_case_view_device_overview

场景路径

主成功路径

  1. 1. 用户进入概览页面
  2. 2. 系统读取电池电量、GPS 坐标、无线连接状态等
  3. 3. 系统在界面上展示所有状态
  4. 用户选择查看设备概览
  5. 系统收集电池电量、充电状态、GPS 可用性、无线电状态等
  6. 系统在界面上展示这些状态信息
  7. 用户选择概览页面
  8. 系统请求刷新硬件状态数据
  9. 系统更新页面上的各硬件状态指示器

备选路径

  1. 无

失败路径

  1. 某个硬件模块未就绪时，对应状态显示为未就绪或未知

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「查看设备概览」。

Trail Mate 系统 / 聊天通信

发送文本消息

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  external_external_system_meshtastic_network["&laquo;External System&raquo;<br/>Meshtastic 网络"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_chat_communication["聊天通信"]
      useCase_use_case_send_text_message(["发送文本消息"])
    end
  end
  actor_actor_user --- useCase_use_case_send_text_message
  external_external_system_meshtastic_network --- useCase_use_case_send_text_message

场景路径

主成功路径

  1. 1. 用户输入文本并触发发送
  2. 2. 系统通过 ChatService 将消息打包
  3. 3. 通过 MeshAdapter 发送到网络
  4. 4. 显示发送成功反馈
  5. 用户在聊天页面输入消息并触发发送命令
  6. 系统将消息打包并通过无线电发送
  7. 系统将发出的消息添加到本地历史记录
  8. 用户编写文本消息
  9. 用户触发发送
  10. 系统将消息封装并通过无线电发射

备选路径

  1. 无

失败路径

  1. 无线电通道忙碌或超时，向用户显示发送失败提示
  2. 无线电发送失败，系统显示错误提示

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「发送文本消息」。

Trail Mate 系统 / 地图导航

查看地图并导航

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_map_navigation["地图导航"]
      useCase_use_case_view_map_navigate(["查看地图并导航"])
    end
  end
  actor_actor_user --- useCase_use_case_view_map_navigate

场景路径

主成功路径

  1. 1. 用户打开地图页面
  2. 2. 系统获取当前 GPS 坐标
  3. 3. 系统加载地图瓦片并渲染
  4. 4. 系统显示位置标记和轨迹
  5. 用户选择地图导航功能
  6. 系统获取当前位置坐标
  7. 系统在地图上渲染位置标记和路径
  8. 用户打开地图页面
  9. 系统加载地图瓦片
  10. 系统获取当前 GPS 位置并显示

备选路径

  1. 无

失败路径

  1. GPS 未定位时，显示上次已知位置或提示用户等待定位
  2. GPS 未锁定，地图显示默认位置

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「查看地图并导航」。

Trail Mate 系统 / 团队协作

管理团队共享位置

candidate · low

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  external_external_system_meshtastic_network["&laquo;External System&raquo;<br/>Meshtastic 网络"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_team_collaboration["团队协作"]
      useCase_use_case_manage_team_sharing(["管理团队共享位置"])
    end
  end
  actor_actor_user --- useCase_use_case_manage_team_sharing
  external_external_system_meshtastic_network --- useCase_use_case_manage_team_sharing

场景路径

主成功路径

  1. 1. 用户打开团队页面
  2. 2. 系统获取当前 GPS 位置
  3. 3. 系统通过 TeamService 将位置广播到团队频道
  4. 4. 其他团队成员的位置在地图上显示
  5. 用户选择创建或加入团队
  6. 系统通过 Meshtastic 网络发送/接收团队位置数据
  7. 系统在地图上渲染团队成员位置
  8. 用户创建新团队或加入已有团队
  9. 系统通过 Meshtastic 网络广播团队信息
  10. 位置数据在团队内共享

备选路径

  1. 无

失败路径

  1. 网络不可用时只能查看缓存数据

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「管理团队共享位置」。

Trail Mate 系统 / 设备管理

查看数据详情

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_device_management["设备管理"]
      useCase_use_case_view_data_details(["查看数据详情"])
    end
  end
  actor_actor_user --- useCase_use_case_view_data_details

场景路径

主成功路径

  1. 用户选择查看数据
  2. 系统获取传感器数据（温度、海拔、气压等）
  3. 系统将数据格式化并显示在界面上
  4. 用户选择数据页面
  5. 系统从传感器获取最新数据并显示

备选路径

  1. 无

失败路径

  1. 某些传感器未就绪时，对应字段显示 N/A
  2. 传感器读取失败，页面显示错误状态

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「查看数据详情」。

Trail Mate 系统 / 设备管理

查看硬件状态

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_device_management["设备管理"]
      useCase_use_case_view_hardware_status(["查看硬件状态"])
    end
  end
  actor_actor_user --- useCase_use_case_view_hardware_status

场景路径

主成功路径

  1. 用户选择查看硬件状态
  2. 系统依次检查 GPS、无线电、传感器、SD 卡、电池等
  3. 系统显示每个硬件的状态（就绪/未就绪/错误）及电池电量、温度、充电状态
  4. 用户选择硬件状态页面
  5. 系统逐一查询各个硬件模块的状态并显示

备选路径

  1. 无

失败路径

  1. 某硬件不可用时显示为未就绪，不影响其他硬件检查
  2. 某个硬件模块无响应，显示未就绪

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「查看硬件状态」。

Trail Mate 系统 / 设备管理

查看系统日志

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_device_management["设备管理"]
      useCase_use_case_view_system_logs(["查看系统日志"])
    end
  end
  actor_actor_user --- useCase_use_case_view_system_logs

场景路径

主成功路径

  1. 用户选择查看日志
  2. 系统获取最近的日志记录
  3. 系统将日志内容添加到日志视图
  4. 用户选择日志页面
  5. 系统从日志缓冲区读取并格式化显示

备选路径

  1. 无

失败路径

  1. 无日志时显示空状态提示

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「查看系统日志」。

Trail Mate 系统 / 设备管理

管理设备设置

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_device_management["设备管理"]
      useCase_use_case_manage_device_settings(["管理设备设置"])
    end
  end
  actor_actor_user --- useCase_use_case_manage_device_settings

场景路径

主成功路径

  1. 用户打开设置页面，查看当前各项配置
  2. 用户修改某项设置（如音量、屏幕亮度等）
  3. 系统保存新值并应用
  4. 用户选择设置页面
  5. 用户修改某个设置项
  6. 系统保存新值并通知相关模块

备选路径

  1. 无

失败路径

  1. 无

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「管理设备设置」。

Trail Mate 系统 / 设备管理

同步 GPS 时间

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_device_management["设备管理"]
      useCase_use_case_sync_gps_time(["同步 GPS 时间"])
    end
  end
  actor_actor_user --- useCase_use_case_sync_gps_time

场景路径

主成功路径

  1. 用户选择同步时间或进入自动同步流程
  2. 系统从 GPS 模块读取 UTC 时间
  3. 系统更新 RTC 并调整偏移值
  4. 用户触发时间同步
  5. 系统从 GPS 获取当前 UTC 时间
  6. 系统写入 RTC

备选路径

  1. 无

失败路径

  1. GPS 未就绪或信号差，同步失败并提示用户
  2. GPS 未锁定，同步失败

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「同步 GPS 时间」。

Trail Mate 系统 / 设备管理

控制设备通知

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_device_management["设备管理"]
      useCase_use_case_control_device_notifications(["控制设备通知"])
    end
  end
  actor_actor_user --- useCase_use_case_control_device_notifications

场景路径

主成功路径

  1. 用户调整提示音音量或选择是否开启振动
  2. 系统保存设置并应用到后续通知
  3. 收到新消息时，系统播放相应提示音并/或振动
  4. 用户修改通知音量或振动强度
  5. 系统保存设置并立即应用

备选路径

  1. 无

失败路径

  1. 音频设备未就绪时静默，振动器未就绪时忽略振动

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「控制设备通知」。

Trail Mate 系统 / 设备管理

关闭设备电源

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_device_management["设备管理"]
      useCase_use_case_power_off_device(["关闭设备电源"])
    end
  end
  actor_actor_user --- useCase_use_case_power_off_device

场景路径

主成功路径

  1. 用户触发关机指令
  2. 系统执行关机流程：停止无线电、保存数据、卸载 SD 卡等
  3. 系统关闭电源
  4. 用户触发关机流程
  5. 系统关闭所有外设和无线电
  6. 系统切断电源

备选路径

  1. 无

失败路径

  1. 无

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「关闭设备电源」。

Trail Mate 系统 / 设备管理

管理 SD 卡

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_device_management["设备管理"]
      useCase_use_case_manage_sd_card(["管理 SD 卡"])
    end
  end
  actor_actor_user --- useCase_use_case_manage_sd_card

场景路径

主成功路径

  1. 用户插入 SD 卡或选择安装/检查
  2. 系统尝试初始化 SD 卡，进行就绪检查
  3. 系统更新 SD 卡状态，如果就绪则允许日志、数据等存入 SD 卡
  4. 用户进入 SD 卡管理
  5. 系统检测 SD 卡状态
  6. 用户选择挂载或卸载，系统执行操作

备选路径

  1. 无

失败路径

  1. SD 卡未插入或损坏，提示错误并显示未就绪
  2. SD 卡未插入，操作失败

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「管理 SD 卡」。

Trail Mate 系统 / 聊天通信

接收文本消息

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  external_external_system_meshtastic_network["&laquo;External System&raquo;<br/>Meshtastic 网络"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_chat_communication["聊天通信"]
      useCase_use_case_receive_text_message(["接收文本消息"])
    end
  end
  actor_actor_user --- useCase_use_case_receive_text_message
  external_external_system_meshtastic_network --- useCase_use_case_receive_text_message

场景路径

主成功路径

  1. 无线电模块接收到数据包
  2. 系统读取数据并解析为文本消息
  3. 系统将消息添加到当前聊天窗口，并可能触发通知
  4. 无线电模块接收到消息数据包
  5. 系统解析数据包并转换为文本
  6. 系统将消息推送到 UI 聊天窗口

备选路径

  1. 无

失败路径

  1. 数据包解析失败，丢弃或记录错误日志
  2. 数据包损坏，丢弃

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「接收文本消息」。

Trail Mate 系统 / 聊天通信

配置无线电参数

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  external_external_system_meshtastic_network["&laquo;External System&raquo;<br/>Meshtastic 网络"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_chat_communication["聊天通信"]
      useCase_use_case_configure_radio_parameters(["配置无线电参数"])
    end
  end
  actor_actor_user --- useCase_use_case_configure_radio_parameters
  external_external_system_meshtastic_network --- useCase_use_case_configure_radio_parameters

场景路径

主成功路径

  1. 用户修改无线电频率、调制方式或功率设置
  2. 系统应用新的无线电配置
  3. 系统开始使用新参数发送/接收数据
  4. 用户修改无线电参数
  5. 系统验证参数合法性
  6. 系统将参数写入无线电模块并生效

备选路径

  1. 无

失败路径

  1. 设置无效时，回滚到之前有效配置或提示错误
  2. 参数不合法，系统拒绝并提示

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「配置无线电参数」。

Trail Mate 系统 / 诊断工具

捕获屏幕截图

candidate · medium

UML 底图

flowchart LR
  actor_actor_user["&laquo;Actor&raquo;<br/>用户"]
  subgraph system_system_trail_mate["Trail Mate 系统"]
    subgraph system_business_module_diagnostics_tools["诊断工具"]
      useCase_use_case_capture_screenshot(["捕获屏幕截图"])
    end
  end
  actor_actor_user --- useCase_use_case_capture_screenshot

场景路径

主成功路径

  1. 用户启动截屏工具并指定操作脚本或参数
  2. 工具模拟按键导航到目标界面
  3. 工具触发屏幕捕获并保存为 PNG 文件
  4. 用户启动截屏工具
  5. 工具模拟按键操作以切换界面
  6. 工具捕获当前屏幕内容并保存为文件

备选路径

  1. 无

失败路径

  1. 设备未就绪或模拟按键失败，工具报错退出

变更记录

Git 34aad0bffa2f · main · dirty

恢复或更新候选用例图「捕获屏幕截图」。

地图变更记录

Git 34aad0bffa2f · main · dirty

更新用例图地图，并链接 15 个候选用例图独立文档。