设备管理 PRD

1. 介绍 / 概述

设备管理是后台运营人员用于查看设备运行状态、进入设备详情、执行远程操作、维护入场信息和完成设备入场的统一入口。

devices.html：设备列表、状态筛选、设备详情弹层、远程操作、入场信息编辑。
device-entry.html：设备入场表单、快速新增点位、广告屏素材和点位照片上传。

当前 PRD 只按现有页面描述：设备入场页仍保留“定位设置 / 获取当前位置”交互；未写入“GIS 完全由点位主数据带出”的目标态。

2. 目标

进入设备管理后先看到设备总量、运行中、故障、停用概览。
支持按设备编号、点位、运行状态和点位类型快速定位设备。
设备详情使用概览、运行、记录、入场、广告屏五个 Tab 分组。
重启作为高频操作放在详情顶部，主按钮直接进入重启系统确认流程。
设备入场支持设备、点位、人员、定位、支付方式、广告屏和点位照片一次性提交。

3. 用户流程 / 用户故事

UF-001：进入设备管理并查看设备列表

用户进入设备管理后，页面展示设备总数、运行中、故障、停用四张统计卡，并在列表中查看设备编号、点位、状态、停卖、最近心跳和操作。

操作列提供 `查看` 和 `停卖 / 恢复`。
移动端提供设备卡片和右下角 `+` 浮动入口进入设备录入。

UF-002：搜索和筛选设备

用户可输入设备编号或点位名称搜索，并按状态、点位类型筛选设备。

当前状态筛选支持：全部状态、运行中、故障。
当前点位筛选支持：全部点位、展会点位、运营点位。
筛选后统计卡和分页数量按当前可见数据更新。

UF-003：查看设备详情概览 Tab

用户点击 `查看` 打开设备详情，顶部展示设备编号、状态、入场状态、点位、重启、远程操作和更多菜单，默认进入概览 Tab。

UF-004：查看运行 Tab 和技术状态

运行 Tab 展示温湿度指标、软件 / 固件版本、运营参数、机构状态和温度报警设置。

UF-005：执行设备重启

用户点击顶部 `重启` 主按钮后进入 `重启系统` 确认页；点击右侧箭头可选择点单屏左、点单屏右、六轴机械臂。

点击 `确认软件重启` 前不写入运维记录。
确认后写入对应设备的远程 / 运维操作记录。

UF-006：使用远程操作和更多菜单

`远程操作` 负责机构重启、设备开门、设备停售、音量调节等指令；`更多` 菜单负责温度报警设置、编辑状态、物料页面。

音量调节支持设备音量和点单屏音量二级菜单。
更多菜单不再展示与记录 Tab 重复的状态记录入口。

UF-007：查看记录 Tab

记录 Tab 统一展示异常记录和运维记录，避免概览、状态和运营摘要重复统计。

UF-008：查看和编辑入场信息

入场 Tab 展示基础信息、补充信息、点位图片和点位变更记录；底部 `编辑入场信息` 可修改点位、人员、配置、广告屏和图片。

编辑点位时使用点位下拉选择，不通过纯文本输入变更点位。
点位发生变化后沉淀点位变更记录。

UF-009：查看广告屏 Tab

广告屏 Tab 区分左侧菜单和右侧排队号背景，分别展示素材和更新时间。

UF-010：完成设备入场

用户在设备入场页选择设备、点位、运维人员，配置定位、支付方式、广告屏和点位照片后提交入场。

UF-011：快速新增点位

设备入场过程中可打开快速新增点位弹窗，填写点位名称、编码、分类、状态、地址、经纬度等信息，保存后自动选中。

4. 功能需求

FR-1：提供设备列表、设备详情、设备入场三类核心能力。

FR-2：展示设备总数、运行中、故障、停用四类统计。

FR-3：支持按设备编号或点位名称搜索。

FR-4：当前支持全部状态、运行中、故障筛选。

FR-5：当前支持全部点位、展会点位、运营点位筛选。

FR-6：设备详情必须采用五 Tab 结构。

FR-7：详情顶部必须保留重启、远程操作、更多。

FR-8：重启主按钮默认进入重启系统确认流程。

FR-9：部件重启支持点单屏左、点单屏右、六轴机械臂。

FR-10：确认执行前不得写运维记录。

FR-11：运行 Tab 集中展示技术状态和温度报警设置。

FR-12：记录 Tab 集中展示异常记录与运维记录。

FR-13：入场 Tab 展示入场信息、点位图片和点位变更记录。

FR-14：广告屏 Tab 区分左侧菜单和右侧排队号背景。

FR-15：设备入场页支持设备、点位、人员、定位、支付、广告屏和照片提交。

FR-16：快速新增点位支持自动编码、获取当前位置、保存并选中。

5. 关键规则矩阵

规则类别	触发场景	核心规则	预期结果
设备范围	进入设备管理	按当前账号可见设备范围展示设备	无权限或无分配设备时展示空状态，不展示其他商户设备
统计口径	列表筛选变化	统计卡按当前可见设备集合计算	设备总数、运行中、故障、停用随筛选结果更新
搜索规则	输入设备编号或点位	同时匹配设备编号和点位名称	命中设备保留在列表中
状态筛选	选择状态筛选	当前页面支持全部状态、运行中、故障	列表只展示符合状态条件的设备
详情 Tab	打开设备详情	默认进入概览 Tab，允许切换五个 Tab	切换时只替换内容区，不关闭详情弹层
重启确认	点击重启主按钮	默认进入重启系统确认页，不直接执行	用户需二次点击确认软件重启
运维记录	远程操作确认	只有确认执行后才记录运维操作	取消或仅查看说明不生成记录
记录集中展示	查看设备详情	异常记录和运维记录集中在记录 Tab	概览、状态、运营摘要不重复统计记录数
入场提交	点击提交入场	必须选择设备、点位和至少一个运维人员	缺失时阻止提交并提示
支付方式	提交入场	至少选择一种支付方式	未选择时阻止提交并提示
点位新增	保存快速新增点位	点位编码必须唯一，保存后自动选中	点位进入下拉列表并作为当前选中点位
点位变更	编辑入场信息并更换点位	记录变更前后点位、坐标、操作人和时间	入场 Tab 可追溯点位变更记录
广告屏素材	上传广告屏素材	左侧菜单与右侧排队号背景分开维护	不允许左右屏素材混淆展示

6. 测试用例矩阵

用例ID	优先级	功能点	操作步骤	预期结果
TC-DM-001	P0	设备列表加载	打开设备管理页	展示统计卡、筛选区、设备列表和分页
TC-DM-002	P0	搜索设备	分别输入设备编号、点位关键字	都能筛选出匹配设备
TC-DM-003	P0	状态筛选	切换全部状态、运行中、故障	列表和统计数据同步变化
TC-DM-004	P1	点位类型筛选	切换展会点位、运营点位	仅展示对应点位类型设备
TC-DM-005	P0	详情概览 Tab	点击查看设备详情	默认展示概览 Tab，顶部显示设备编号、状态、入场状态和点位
TC-DM-006	P0	详情五 Tab 切换	依次点击概览、运行、记录、入场、广告屏	每个 Tab 内容正常展示，弹层不关闭
TC-DM-007	P0	重启主按钮	点击顶部重启主按钮	进入重启系统确认页，不直接执行
TC-DM-008	P0	确认软件重启	点击确认软件重启	提示指令已下发，并新增一条运维记录
TC-DM-009	P1	部件重启菜单	选择点单屏左、点单屏右、六轴机械臂	分别进入对应部件确认流程
TC-DM-010	P1	远程操作菜单	点击远程操作并选择音量调节	出现设备音量、点单屏音量二级入口
TC-DM-011	P1	更多菜单	点击更多	展示温度报警设置、编辑状态、物料页面，不展示重复状态记录入口
TC-DM-012	P0	记录 Tab	打开记录 Tab	异常记录和运维记录分区展示，并显示数量
TC-DM-013	P0	入场 Tab	打开入场 Tab	展示基础信息、补充信息、点位图片、点位变更记录
TC-DM-014	P0	编辑入场点位	更换点位并保存	详情刷新，并新增点位变更记录
TC-DM-015	P1	点位图片预览	点击点位图片	打开放大预览，支持上一张 / 下一张
TC-DM-016	P0	广告屏 Tab	打开广告屏 Tab	左侧菜单和右侧排队号背景分区展示
TC-DM-017	P0	设备入场提交校验	不选择设备或点位直接提交	阻止提交并提示必填项
TC-DM-018	P0	完成设备入场	填写必填信息并提交	设备变为已入场，详情可查看入场资料
TC-DM-019	P1	定位设置	点击获取当前位置	经纬度被填充；地址为空时补充地址
TC-DM-020	P0	快速新增点位	新增点位并保存	新点位进入点位下拉并自动选中
TC-DM-021	P1	点位编码唯一性	使用重复编码保存点位	阻止保存并提示编码已存在
TC-DM-022	P1	广告屏上传限制	上传左右屏素材	素材预览正常，左右屏不混淆
TC-DM-023	P1	移动端列表	移动端宽度打开设备管理	无横向滚动，设备卡片和录入入口可用
TC-DM-024	P1	移动端详情	移动端切换 Tab 和执行重启确认	弹层内容可阅读，操作按钮可点击

7. 测试数据要求

至少准备 18 台设备，覆盖运行中、故障、停用、已入场、未入场等状态。
至少准备 2 个点位类型：展会点位、运营点位。
至少准备 1 台有完整入场资料的设备，包含点位、运维人员、支付方式、节能配置、定位信息、点位照片。
至少准备 1 台有广告屏素材的设备，覆盖左侧菜单和右侧排队号背景。
至少准备 1 台有异常记录和运维记录的设备，用于验证记录 Tab。
至少准备 1 台未入场设备，用于验证设备入场流程。
测试账号需要覆盖：可查看全部设备的运营账号、仅可查看部分设备的受限账号。

8. 非目标 / 暂不覆盖

不描述未在当前页面落地的 `停用 / 未入场` 独立状态筛选。
不描述把设备入场 GIS 完全改为点位主数据带出的目标态；当前页面仍保留定位设置。
不描述真实后端接口、权限后端校验和生产数据同步策略。
不描述设备重启的真实硬件通信协议，只描述前端交互和记录规则。

9. 数据与状态

设备主数据：包含设备编号、设备类别、所属商户、当前点位、运行状态、停卖状态、最近心跳、入场状态。
入场资料：包含入场时间、点位、点位地址、运维人员、联系方式、定位信息、节能配置、支付方式、维护时段、备注。
点位资料：包含点位名称、点位编码、点位分类、点位状态、负责人、联系电话、详细地址、经纬度。
技术状态：包含温湿度、软件版本、固件版本、机构状态、温度报警设置。
运维记录：包含操作类型、操作对象、操作时间、操作结果和操作说明。
异常记录：包含异常类型、发生时间、异常状态和异常描述。
点位变更记录：包含变更前点位、变更后点位、坐标信息、操作人和操作时间。
广告屏素材：包含左侧菜单素材、右侧排队号背景素材、素材类型、更新时间。

10. 回归验收建议

运行设备详情 Tabs 相关测试，确认概览、运行、记录、入场、广告屏均可渲染。
运行重启 split button 相关测试，确认主按钮、部件菜单和确认写记录逻辑不回退。
运行设备入场相关测试，确认提交入场、快速新增点位、广告屏、点位照片和定位设置稳定。
手工打开 `devices.html`，完成列表筛选、查看详情、切换 Tabs、重启确认、远程操作、更多菜单。
手工打开 `device-entry.html`，完成设备入场和快速新增点位流程。
手工使用移动端宽度验证设备列表、详情弹层、Tab 切换、重启确认和设备入场页面无横向滚动。

设备管理产品需求文档