COFE+ · 产品需求文档

故障管理用户流程

按当前页面整理 · 故障设备清单、处理建议、远程处置与通知配置

本文记录项目当前可见能力,不增加按故障类型分流、工单派单或真实设备控制等未实现能力。

1. 介绍 / 概述

故障管理用于帮助运营和运维人员定位当前异常设备、查看故障说明与处理建议,并从故障列表发起设备处置。页面同时展示设备所属商户配置的故障通知渠道。

查看故障按员工获准的故障权限和设备范围查看故障设备,并按设备编号或点位名称筛选。
辅助处置查看故障说明和逐步建议,进入远程操作菜单或现场操作指引。
通知设置在商户和人员资料中维护邮箱 / 公众号渠道,故障行展示当前渠道状态。
暂未覆盖没有故障分级、按类型配置通知、工单分派、维修进度、SLA 或故障关闭流程。

主要用户

2. 整体页面流转

用户从故障列表开始,根据权限和设备范围定位异常;可查看建议或发起设备处置。通知配置在商户与人员资料中维护,并以渠道徽章回显到故障行。

通知配置支线:商户选择邮箱 / 公众号渠道 → 人员维护公众号 OpenID 与故障查看权限 → 故障列表显示渠道徽章。当前没有按故障类型、故障码或严重程度分流。

3. 页面与交互

页面截图字段、文案和交互说明
故障设备列表页面

故障设备列表 · 桌面端

故障设备列表
  • 故障管理 / 故障设备清单与远程处置:页面标题和副标题,说明当前页面用于查看故障设备并进入处置入口。
  • 返回设备页:返回设备管理页面,不会更改当前设备状态。
  • 设备编号:识别具体设备,并关联该设备的故障建议和远程操作。
  • 设备地址:显示设备所在点位名称;下方徽章说明商户当前启用的推送渠道,不代表该条故障已经成功发送通知。
  • 故障内容:显示异常部件或现象的简要描述;下方只预览第一条处理建议。
  • 故障发生时间:显示现有设备故障记录时间;缺少记录时间时使用设备状态时间,不应解释为实时告警或首次发生时间。
  • 操作:点击“远程操作”打开当前设备的可用处置入口。

筛选与交互:“设备:全部”表示纳入所有可见故障设备;打开后可按设备编号或点位名称搜索,并逐台选择、全选或清空。“故障设备 N 台”是当前筛选结果中故障设备的数量;筛选变化后列表和数量同步更新。点击故障行摘要或“查看全部 N 步”展开建议;点击“远程操作”只打开菜单。无匹配设备时显示“暂无故障记录”。故障行不显示邮箱地址和接收人姓名。

当前文案:返回设备页 · 设备:全部 · 故障设备 N 台
故障行展开后的完整处理步骤

故障行展开 · 完整处理步骤

故障说明与处理建议
  • 故障描述:说明设备当前识别到的异常部件或现象,帮助用户定位问题。
  • 处理建议预览:显示建议列表的第一步,供用户快速判断后续操作方向。
  • 查看全部 N 步:N 表示该设备当前建议的总步骤数;点击后在故障行下方按顺序展开完整步骤。
  • 如何处理 · 完整步骤:展开区域标题,不是新的操作入口;再次点击故障行摘要可收起。

没有处理建议时,预览和展开区域均显示“暂无处理建议,请联系运维”。当前页面不展示故障码或严重程度。

远程操作菜单

远程操作 · 菜单

远程操作菜单
  • 远程操作 · {设备编号}:标题中的编号用于确认当前操作目标。
  • 机构重启:进入重启对象选择,再进入二次确认。
  • 设备开门:选择后显示该设备的开门指令提示;当前原型不实际控制设备。
  • 设备停售:选择后显示停售指令提示;当前原型不实际修改设备销售状态。
  • 音量调节:选择后显示音量调节指令提示;当前页面没有音量数值输入控件,也不实际调整音量。

点击弹层外的遮罩关闭菜单;菜单选项的操作目标为标题中的设备编号。

机构重启对象选择

机构重启 · 选择对象

选择重启对象
  • 重启系统:选择整台设备的系统重启目标。
  • 重启点单屏(左) / 重启点单屏(右):分别选择左侧或右侧点单屏作为目标。
  • 重启六轴机械臂:选择机械臂作为目标,并显示“注意安全,谨慎使用”提醒。

选项表示本次确认页的目标部件;选择后进入二次确认,尚未执行重启。

机构重启确认页

机构重启 · 二次确认

确认机构重启
  • 确定要{重启对象}?:动态显示前一步选中的目标,用于再次核对。
  • 确认软件重启:确认后原型显示下发提示,并记录操作时间、操作人、操作项和结果;当前不实际调用设备。
  • 无法远程处理?查看机器按钮位置:不执行重启,转到对应目标的现场操作指引。
  • 取消:关闭确认流程,不执行操作,也不记录本次操作。
设备现场操作指引

无法远程处理 · 现场指引

现场操作指引
  • 操作标题:说明当前指引对应的重启对象。
  • 安全提醒:说明现场操作前必须确认的风险条件;六轴机械臂指引要求先确认作业范围内无人、无障碍物。
  • 按钮位置说明:用文字描述目标设备上的实体按钮位置,当前不是实拍图片。
  • 分步操作:按顺序说明现场操作步骤,供运维人员照着执行。
  • 我知道了:确认已阅读并关闭指引,不会触发远程操作。

4. 用户流程与验收标准

UF-001:查看和筛选故障设备

  1. 用户从运营管理侧边栏进入“故障列表”。
  2. 页面按当前账号的故障查看权限和设备范围加载故障设备。
  3. 用户打开“设备:全部”,搜索设备编号或点位名称,并逐台勾选、全选或清空。
  4. 页面即时更新故障设备数量和列表。
  • 列表仅展示故障状态设备,不混入正常或缺料设备。
  • 搜索候选仅包含当前账号可查看的故障设备,并显示“点位名称 · 设备编号”。
  • 默认选中全部可见故障设备;清空后显示“设备:未选择”和“暂无故障记录”。
  • 没有权限或未分配可见设备时,展示对应的权限 / 范围提示。

UF-002:查看故障处理建议

  1. 用户浏览故障描述和第一条处理建议。
  2. 用户点击“查看全部 N 步”或设备行摘要。
  3. 页面在当前设备行下展开完整处理步骤;再次点击收起。
  • 故障行展示设备编号、点位、故障描述、发生时间和“远程操作”。
  • 有建议时显示第一步和“查看全部 N 步”;无建议时显示“暂无处理建议,请联系运维”。

UF-003:使用设备处置入口

  1. 用户点击目标设备的“远程操作”。
  2. 用户选择机构重启、设备开门、设备停售或音量调节。
  3. 选择机构重启时,用户再选重启对象,并选择确认、查看现场指引或取消。
  • 远程操作菜单标题包含当前设备编号。
  • 重启提供整机、左右点单屏和六轴机械臂四种对象。
  • 确认页提供“确认软件重启”“无法远程处理?查看机器按钮位置”和“取消”。
  • 现场指引包含安全提示、按钮位置说明、操作步骤和“我知道了”。
  • 没有权限查看目标设备时,不打开该设备的远程操作流程。

UF-004:维护故障通知渠道

  1. 运营人员在商户资料中选择邮箱推送、公众号推送或两者;都不选表示不接收通知。
  2. 选择邮箱推送时填写合法邮箱;选择公众号推送时需有符合条件的员工接收人。
  3. 员工在人员资料中登记公众号 OpenID。
  4. 故障行按商户配置展示渠道徽章。
  • 邮箱和公众号可同时启用,也可都关闭;无效邮箱或公众号渠道无接收人时阻止保存并提示原因。
  • 员工变更影响最后一名公众号接收人时,系统提示自动取消公众号渠道、暂不保存以补充接收人或取消本次操作。
  • 渠道徽章不展示收件邮箱和接收人姓名。
  • 通知设置不按故障类型、故障码或严重程度分流。

5. 权限与通知规则

权限

故障通知渠道

商户配置故障列表显示当前规则
邮箱推送✉️ 邮箱推送填写的邮箱需符合格式;故障行不展示邮箱地址。
公众号推送📱 公众号推送商户需有启用账号、拥有故障查看权限且登记 OpenID 的员工。
邮箱 + 公众号两个徽章并列显示两个渠道分别校验。
均未启用🔕 未配置推送允许保存,表示该商户不接收故障推送。

员工变更可能使公众号渠道失去所有可达接收人时,系统先提示运营人员选择处理方式。商户页提供“推送配置变更记录”入口;页面自动校对发现无可达接收人时,会取消公众号渠道并留下记录,最多保留最近 20 条。

当前渠道由商户统一配置。同一商户的不同故障显示相同通知渠道;当前没有按故障类型、故障码或严重程度配置不同的通知策略。真实邮件和公众号消息发送尚未接入。

6. 空状态与异常状态

场景页面反馈
当前筛选下没有故障设备暂无故障记录
当前账号没有故障查看权限当前账号暂未开通故障页面权限
已开通权限但没有可见设备你已拥有故障页面权限,但当前未分配可查看的设备,请联系管理员调整页面设备范围
设备没有处理建议暂无处理建议,请联系运维
商户未启用通知渠道🔕 未配置推送
公众号渠道没有合格接收人保存时提示问题并阻止保存;存量异常配置在页面自动校对时取消公众号渠道并留存记录

7. 当前实现边界

8. 关联页面与资料

本文按项目当前页面与现有权限、通知配置行为整理。