数字化运维系统三端功能操作流程

本文档说明 Web 管理端、App 移动端、后端服务 在近期已实现功能上的协作关系与操作步骤，便于实施、测试与运维人员对照使用。

三端角色说明

一、AI 智能对话与附图多模态诊断

现场人员可通过 AI 助手进行文字问答，并拍照或从相册选择图片，由大模型进行多模态分析。

1.1 Web 管理端（前置配置）

菜单路径： 设备运维 → AI 模型配置

操作步骤：

1. 使用租户管理员账号登录 Web 管理端。
2. 进入「AI 模型配置」页面。
3. 填写并保存：
   • API 地址（OpenAI 兼容接口 Base URL）
   • API Key
   • 模型名称（需支持 Vision/多模态）
   • 系统提示词（运维领域约束）
   • 启用状态
4. 点击「测试连接」确认配置可用后，点击「保存」。

配置按租户隔离，App 登录后通过 GET /api/ai/provider-config 拉取，无需在 App 内填写 Key。

相关权限： dmsys:aiConfig:query、dmsys:aiConfig:edit

数据库： 表 dms_ai_provider_config（增量脚本见 deploy/sql/06_dmsys_ai_config_upgrade.sql）

1.2 App 移动端

入口： 工作台 → AI 诊断，或「我的」→ AI 助手

文字对话：

1. 打开 AI 助手页面。
2. 在底部输入框输入故障现象、报警代码或问题描述。
3. 点击发送，等待 AI 回复（支持多轮对话与历史会话）。

附图多模态诊断：

1. 点击输入框左侧 相机（附图） 图标。
2. 在弹窗中选择：
   • 拍照：授权相机权限后拍摄现场照片；或
   • 相册：从系统相册选择图片。
3. 确认输入区上方出现附图预览（可点击 × 移除）。
4. 输入补充说明（也可仅发送图片），点击 发送。
5. AI 将结合图片与文字进行诊断分析。

离线说明： 未配置租户 AI 或未联网时，自动降级为本地知识库话术（含附图场景的离线回复模板）。

1.3 后端服务

数据流：

Web 保存 AI 配置 → dms_ai_provider_config
       ↓
App 登录后拉取配置 → OpenAiCompatibleClient.chatCompletion(imageBitmap=...)
       ↓
大模型返回文本 → 写入本地会话表 chat_messages

二、设备扫码 / NFC 识别与工单查询

运维人员通过扫码或手动输入编码定位设备，并在设备详情中查看、筛选关联工单。

2.1 Web 管理端（前置配置）

2.1.1 维护设备与标签

菜单路径： 设备运维 → 设备台账

操作步骤：

1. 新增或编辑设备节点（场站 / 系统 / 机组 / 单元等）。
2. 在设备详情抽屉中找到 资产标签 区域。
3. 新增标签：
   • 类型选择 QR（二维码） 或 NFC；
   • 可点击「生成编码」自动分配 tagCode，或手工录入；
   • 保存后与该设备绑定。
4. 将二维码打印贴附到现场设备，或写入 NFC 标签。

相关权限： 设备台账增删改查权限

2.1.2 工单管理（可选）

菜单路径： 设备运维 → 运维工单

管理员可在 Web 端创建、分派、执行、关闭工单，并指定关联设备。App 端按设备 ID / 设备名称关联展示。

2.2 App 移动端

2.2.1 扫码 / 输入编码查设备

入口： 工作台 → 扫码/NFC

操作步骤：

1. 进入扫码页面，授权相机权限。
2. 对准现场二维码扫描；或在下方输入框 手工输入标签编码 后确认。
3. 系统解析标签，跳转至 设备详情 页。

2.2.2 设备详情 — 工单 Tab

入口： 设备详情 → 工单 标签页

默认行为：

• 展示该设备 最近 10 条 工单；
• 按 日期倒序 排列；
• 每条工单显示：标题、日期、状态、工单类型。

筛选与排序：

1. 点击 筛选条件 栏可展开/收起筛选面板（默认收起）。
2. 展开后可设置：
   • 起始日期 / 截止日期（未选显示「不限」）；
   • 工单状态：全部 / 待处理 / 处理中 / 已完成 / 已关闭 / 已延期。
3. 点击 倒序 / 正序 按钮切换日期排序（收起筛选时也可操作）。
4. 有筛选条件时显示「已筛选」标签，可点击 重置筛选 恢复默认。
5. 点击工单项：
   • 进行中工单 → 进入分步填报表单继续处理；
   • 已结案工单 → 进入工单只读详情。

其他 Tab： 设备详情、图纸、资料、创建运维工单等入口同屏提供。

2.3 后端服务

App 本地逻辑：

• 优先按 equipmentId 匹配工单；
• 若无 ID 匹配，则按 deviceName 回退匹配；
• 筛选、排序、默认 10 条限制在 App 端 WorkOrderQueryHelper 完成。

三、用户头像管理

支持管理员在 Web 端为用户预设头像，App 用户登录后自动展示，并可在 App 内自行更换。

3.1 Web 管理端

3.1.1 管理员为用户设置头像

菜单路径： 系统管理 → 用户管理

操作步骤：

1. 找到目标 APP 用户（用户类型为 App 用户）。
2. 编辑用户，上传头像图片并保存。
3. 头像文件存入 OSS/本地存储（avatar 分类），sys_user.avatar 字段保存 OSS ID。

3.1.2 当前登录用户修改自己的头像

入口： 右上角头像 → 个人中心

操作步骤：

1. 点击头像进入裁剪弹窗。
2. 选择图片 → 裁剪 → 确认上传。
3. 调用 POST /system/user/profile/avatar（字段名 avatarfile）。

3.2 App 移动端

入口： 「我的」→ 点击账户卡片 → 账户信息

查看头像：

• 登录成功或进入「我的 / 账户信息」时，自动调用 GET /api/auth/me 拉取最新用户信息（含 avatarUrl）。
• 优先展示服务端返回的头像 URL；离线访客模式使用本机缓存。

更换头像：

1. 进入「账户信息」页面。
2. 点击 头像 或右下角 相机图标。
3. 从相册选择图片（image/*）。
4. 上传成功后 Toast 提示「头像已更新」，各页面头像同步刷新。

离线模式： 头像仅写入本机 files/avatars/{userId}.jpg，不上传服务器。

3.3 后端服务

头像 URL 解析逻辑（App 兼容层）：

• sys_user.avatar 存 OSS 主键；
• 返回给 App 前通过 ISysOssService.listByIds() 解析为可访问路径（如 /profile/files/{tenant}/avatar/xxx.jpg）；
• 静态路径 /profile/files/** 已加入安全白名单，App 可直接加载。

App 端兼容： 若历史数据中 avatarUrl 仍为纯数字 OSS ID，客户端会自动拼接 /resource/oss/download/{id} 作为回退地址。

四、端到端协作总览

flowchart TB
    subgraph Web["Web 管理端"]
        W1[配置 AI 模型]
        W2[维护设备与 QR/NFC 标签]
        W3[管理运维工单]
        W4[设置用户头像]
    end

    subgraph Backend["后端服务"]
        B1[(dms_ai_provider_config)]
        B2[(dms_asset_tag / 设备)]
        B3[(dms_work_order)]
        B4[(sys_user + sys_oss)]
        API[/api/* 兼容层/]
    end

    subgraph App["App 移动端"]
        A1[AI 对话 + 附图]
        A2[扫码/NFC → 设备工单]
        A3[查看/更换头像]
    end

    W1 --> B1 --> A1
    W2 --> B2 --> A2
    W3 --> B3 --> A2
    W4 --> B4 --> A3
    API --> App
    Web --> API

五、部署与验证清单

5.1 数据库

5.2 服务启动顺序

1. 启动 MySQL / Redis 等依赖；
2. 启动 dmsysr-backend（JAR 或 Docker）；
3. 部署 dmsysr-frontend 静态资源（Nginx）；
4. 安装 / 更新 DMsysGApp，确认 BACKEND_BASE_URL 指向正确网关。

5.3 功能验证要点

六、相关源码索引

文档版本：与当前代码库实现保持一致。若菜单编码或 API 路径有变更，请以实际部署环境为准。