产品需求文档：设备管理（按当前页面）

F-001：设备总览

进入设备管理页后，用户先看到设备总数、运行中、故障、停用 4 张统计卡，以及顶部的主筛选栏。这一层承担“先看全局健康度，再决定是否继续筛选”的作用。

• 统计卡按当前可见设备范围实时计算。
• 右上角提供 + 设备入场 入口。
• 空状态下统计与列表会一起收口到权限 / 范围提示。

F-002：搜索与筛选

用户可以通过搜索框、状态筛选和点位分类筛选快速定位目标设备；搜索同时覆盖设备编号、点位名称和点位编码。

• 支持 全部状态 / 运行中 / 故障。
• 虽然列表中会出现 停用 和 未入场 口径，但当前状态下拉不支持对这两类做单独筛选。
• 支持 全部点位 / 展会点位 / 运营点位。
• 条件变化后即时刷新列表，无需手动提交。

F-003：设备列表

设备列表是页面的主工作区。桌面端使用表格承载高密度信息，移动端使用状态卡片保证可读性和可操作性。

• 桌面端列出 设备编号 / 商户 / 点位 / 状态 / 停卖 / 最近心跳 / 操作。
• 移动端卡片展示 商户 / 点位 / 停卖 / 状态 / 最近心跳。
• 列表级动作固定为 查看 与 停卖 / 恢复。

F-004：添加设备（设备入场）

点击 + 设备入场 后进入最新设备入场页，完成新设备入场配置。当前最新版不是旧的简化录入表单，而是按当前登录商户自动限定设备、点位和员工范围，并在入场阶段一并完成支付方式、广告屏和点位照片配置。

• 设备、点位、员工都按当前登录商户范围过滤，不再在页面上单独选择所属客户。
• 基本信息区包含 选择设备、点位名称，并支持 + 新增点位 快速创建并自动选中。
• 页面拆成左右双栏：左侧负责设备、运维、定位和其他设置；右侧负责支付方式、广告屏设置、点位照片与提交动作。
• 提交后会保存入场信息，并同步更新设备商户、点位、入场状态、停卖状态和心跳初始状态。

F-005：设备详情摘要

设备详情弹层是设备管理的核心查看面。最新版本采用“状态首屏 + 操作优先”的信息层级，首屏只保留设备概览、设备状态和运营摘要，让用户先判断这台设备是谁、在哪里、是否正常，再通过右侧入口进入二级信息。

• 详情为 左主内容 + 右侧操作区 布局。
• 左侧首屏只显示 设备概览、设备状态、运营摘要 三张卡片。
• 设备概览 当前展示 设备编号 / 点位 / 设备类别，不再展示 部署类型。
• 运营摘要 汇总当前点位、支付方式、节能模式、网络信号、最近点位变更和记录摘要。
• 右侧分为 设备操作 和 详细信息 两组；详细信息包含 入场详情 / 广告屏信息 / 技术状态 / 记录摘要。
• 从 记录摘要 继续点击 查看状态记录 时会先关闭摘要浮层，避免浮层层级错乱。

F-005-A：技术状态

技术状态用于承载当前设备的实时技术指标、软件版本和关键机构运行状态，帮助运维在不离开当前设备上下文的情况下快速判断机器是否正常，以及问题更偏向硬件还是软件。

• 不再占用设备详情左侧首屏，用户从右侧 详细信息 > 技术状态 打开。
• 技术状态在二级浮层中以独立详情区展示，并默认展开。
• 展开后按双列信息区展示 冰箱温度、制作仓温度、豆仓温度、豆仓湿度、更新时间、上位机软件、点单屏软件、点单屏系统、点单屏内核、广告屏版本、固件版本 等只读字段。
• 底部单独展示 机构状态 标签组，当前口径会展示咖啡机、机械臂、落杯器、制冰机、前道浆、压盖器、出杯口和混水水路等机构状态。
• 当前只支持查看，不支持在技术状态区域内直接修改任何参数。

F-006：入场信息

入场信息承载设备落位和基础配置，是详情里最重要的业务信息块之一。用户从右侧 详细信息 > 入场详情 进入，查看基础字段、补充字段、点位图片和点位变更记录，并通过底部按钮进入编辑。

• 不再默认占用详情左侧首屏，信息在二级浮层中以单一详情区块展示，并默认展开。
• 支持查看点位图片并点击预览。
• 点位变更记录默认以折叠摘要卡片展示，摘要显示时间、操作人、变更项数量、变更字段和主要变化。
• 支持编辑后直接刷新到当前设备详情。

F-007：广告屏信息

广告屏信息按左右物理屏拆开管理，避免素材传错位置。左侧菜单与右侧排队号背景分别展示、分别维护。

• 不再默认占用详情左侧首屏，用户从右侧 详细信息 > 广告屏信息 打开。
• 左侧支持图片和 H.264 视频。
• 右侧仅支持图片。
• 详情中按左右拼接方式预览。

F-008：温度报警设置

温度报警设置通过独立弹层打开，按温区展示参数卡片，并允许逐区修改阈值。

• 当前固定展示 5 个温区。
• 每个温区都可点击 修改。
• 保存后刷新当前弹层内容。

F-009：状态记录

状态记录用于追溯设备最近的异常和运维处理，不承担远程操作总日志的展示职责。

• 可从右侧 设备操作 > 状态记录 直接打开完整状态记录弹层。
• 也可从右侧 详细信息 > 记录摘要 查看异常 / 运维条数，再点击 查看状态记录 进入完整弹层。
• 从记录摘要进入完整弹层时，系统会关闭摘要浮层，保证完整状态记录位于最上层。
• 弹层固定为 异常记录 与 运维记录 双标签。
• 异常记录较少时，预览环境应保持列表展示稳定。
• 运维记录会自动带出运维人员和联系电话。

F-010：编辑状态

用户可以从右侧操作区直接修改设备状态，快速把系统状态同步到线下真实状态。

• 当前支持 正常 / 故障 / 缺料。
• 保存后刷新列表、统计和设备详情。
• 改为故障时会同步生成异常记录。

F-011：远程操作

远程操作通过弹层发起，当前一级菜单固定包含 机构重启、设备开门、设备停售、音量调节 4 个动作。其中只有 机构重启 需要进入二级确认流，其余动作都属于一级直达动作。

• 一级入口以动作清单形式展示。
• 机构重启 进入二级子菜单，再进入确认页。
• 设备开门、设备停售、音量调节 当前点击后直接执行，并形成操作记录。

F-011-A：机构重启

用于对设备系统、左右点单屏和六轴机械臂发起重启，是当前远程操作里唯一需要二次确认的高风险动作。

• 点击 机构重启 后进入二级子菜单。
• 二级动作固定包含 重启系统、重启点单屏（左）、重启点单屏（右）、重启六轴机械臂（注意安全，谨慎使用）。
• 选择具体动作后进入确认页，点击 确认执行 才真正下发指令。

F-011-B：设备开门

用于直接向设备下发开门指令，便于现场补料、巡检或运维处理。

• 当前作为一级直达动作，入口位于远程操作菜单中。
• 点击后直接关闭弹层，并提示 已向设备 {设备编号} 下发指令：设备开门。
• 当前没有单独的二级确认页或参数配置页。

F-011-C：设备停售

用于向设备下发停售指令，作为远程操作的一类设备控制动作。

• 当前作为一级直达动作，无二级参数页。
• 点击后记录远程动作并提示成功。
• 当前页面不会因为这个动作立即改写列表里的 停卖 展示，列表停卖状态仍由设备数据本身决定。

F-011-D：音量调节

用于向设备下发音量调整类指令，是当前远程操作菜单中的直达入口之一。

• 当前作为一级直达动作展示在远程操作菜单中。
• 点击后直接下发指令并关闭弹层。
• 当前页面尚未实现 设备音量 / 点单屏音量 的二级拆分配置。

UF-001：进入设备管理并查看设备总览

描述： 作为运营人员，我希望进入设备管理页后先看到当前可见设备的整体状态，这样我能快速判断当前设备池是否稳定。

1. 用户进入 设备管理 页面。
2. 页面加载当前可见设备数据。
3. 顶部展示统计卡、筛选栏和设备列表。
4. 用户继续搜索、筛选或进入详情。

UF-002：添加设备并提交入场信息

描述： 作为运营人员，我希望从设备管理页进入最新设备入场页，并在当前商户范围内完成设备、点位、员工、支付方式、广告屏和点位照片配置，这样新设备才能按最新流程正式纳入设备管理范围。

1. 用户在设备管理页点击 + 设备入场。
2. 系统跳转到 设备入场 页面。
3. 系统按当前登录商户范围加载可入场设备、可选点位和可选员工。
4. 用户选择设备、点位和运维人员；如无合适点位，可先 + 新增点位 并自动选中。
5. 用户补充 GPS、经纬度、点位地址、节能模式、设备日期、网络信号、维护时段和备注。
6. 用户选择至少一种支付方式，并按需上传广告屏素材和点位照片。
7. 用户点击 提交入场 完成录入并返回设备管理。

• 录入页按当前登录商户范围过滤 设备、点位 和 员工，不再单独提供“所属客户”选择框。
• 快速新增点位时，系统自动绑定当前商户，并支持填写点位名称、编码、分类、状态、负责人、联系电话、详细地址和备注。
• 提交成功后，系统保存入场信息，同时更新设备所属商户、点位和入场状态。

UF-003：通过搜索与筛选快速定位设备

描述： 作为运营或运维人员，我希望通过设备编号、点位和状态快速缩小范围，这样我能尽快找到目标设备。

• 搜索需同时匹配 设备编号、点位名称 和原始点位编码。
• 状态筛选当前仅包含 全部状态、运行中、故障。
• 当前不提供 停用 或 未入场 的单独筛选项；这两种口径只能在列表展示中查看，不能通过状态筛选直接过滤。
• 点位筛选当前仅包含 全部点位、展会点位、运营点位。
• 筛选项变化后即时生效，不需要额外点击应用按钮。

UF-004：在桌面表格和移动卡片中浏览设备

描述： 作为后台使用者，我希望在桌面端和移动端都能快速浏览设备，并直接进行列表级操作。

UF-005：打开设备详情并查看首屏摘要

描述： 作为运维人员，我希望打开设备详情后先看到设备身份、当前状态和运营摘要，再决定是做远程操作、查看记录，还是进入入场 / 广告屏 / 技术详情。

1. 用户点击列表中的 查看 或 查看详情。
2. 系统打开设备详情弹层。
3. 用户先浏览设备概览、设备状态和运营摘要。
4. 用户根据右侧入口查看入场详情、广告屏信息、技术状态或记录摘要。
5. 用户在右侧设备操作区发起后续动作。

• 详情使用独立弹层，桌面端为超宽布局，移动端回退为单列卡片布局。
• 详情整体为 左侧主内容 + 右侧设备操作区 结构。
• 设备概览 至少展示 设备编号、点位、设备类别；当前不再展示 部署类型。
• 设备状态 至少展示 设备状态、停卖状态、最近心跳、入场状态、当前异常摘要。
• 运营摘要 至少展示 当前点位、支付方式、节能模式、网络信号、最近变更、记录摘要。
• 右侧 设备操作 区固定包含 远程操作、温度报警设置、状态记录、编辑状态、物料页面。
• 右侧 详细信息 区固定包含 入场详情、广告屏信息、技术状态、记录摘要。

UF-005-A：展开并查看技术状态

描述： 作为运维人员，我希望在设备详情里展开技术状态，查看温度、湿度、版本和机构状态，这样我可以先判断故障更偏向现场硬件问题还是软件 / 配置问题。

1. 用户打开某台设备的详情弹层。
2. 用户在右侧 详细信息 区点击 技术状态。
3. 系统打开技术状态二级浮层，并默认展开详情内容。
4. 系统展示当前设备的温度、湿度、软件版本和机构状态标签。
5. 用户根据读到的技术信息，决定继续查看记录、修改状态或发起远程操作。

• 技术状态 必须从右侧 详细信息 入口打开，不再默认占用左侧首屏。
• 展开后至少展示 冰箱温度、制作仓温度、豆仓温度、豆仓湿度、更新时间、上位机软件、点单屏软件、点单屏系统、点单屏内核、广告屏版本、固件版本。
• 技术状态底部必须提供 机构状态 标签区，并展示多个机构的当前状态标签。
• 当前技术状态区为只读展示，不提供参数编辑和保存动作。
• 当部分版本字段暂无数据时，页面允许显示为 -，但结构不能消失。

UF-006：查看并编辑入场信息

描述： 作为运营人员，我希望在设备详情里查看并编辑入场信息、补充字段、点位图片和点位变更记录，这样我可以确认设备的线下落位和基础配置。

1. 用户在右侧 详细信息 区点击 入场详情。
2. 系统打开入场详情二级浮层，展示基础信息、补充信息、点位图片和点位变更记录。
3. 用户点击详情底部 编辑入场信息。
4. 用户在编辑弹层中修改字段、上传图片并保存。

• 入场信息以单一折叠区块展示，不再拆成“核心信息 / 全部信息”两个入口。
• 入场信息通过右侧 详细信息 > 入场详情 打开，不再默认占用左侧首屏。
• 基础信息至少展示 入场时间、点位名称、点位地址、支付方式、节能模式。
• 补充信息至少覆盖 运维人员、运维电话、GPS定位、经纬度、网络信号、设备开始日期、设备结束日期、第五代终端、订单并行制作、维护时段、备注。
• 当节能模式为 开启 时，详情和编辑弹层都展示节能开始 / 结束时间。
• 点位图片支持点击预览，并支持左右切换。
• 点位变更记录默认使用折叠摘要卡片展示，摘要至少包含时间、操作人、变更项数量、变更字段和主要变化。
• 展开某条点位变更记录后，必须能看到对应字段的 变更前 和 变更后。
• 编辑入场信息保存后更新当前设备详情，并即时刷新展示。
• 当设备缺少入场信息时，预览环境应提供稳定的空态或示例内容，避免详情完全空白。

UF-007：查看并维护广告屏信息

描述： 作为运营人员，我希望按照设备的左右物理屏分别查看和维护广告屏素材。

1. 用户在右侧 详细信息 区点击 广告屏信息。
2. 页面按左右固定区域展示广告屏预览。
3. 用户在入场信息编辑弹层中上传或替换广告屏素材。
4. 用户保存后返回详情查看左右屏最新状态。

• 广告屏信息通过右侧 详细信息 > 广告屏信息 打开，并以 左侧菜单 和 右侧排队号背景 两组固定区域展示。
• 左侧菜单支持 jpg/png 图片和 mp4(H.264) 视频。
• 右侧排队号背景当前只支持 jpg/png 图片。
• 右侧上传视频时必须阻止保存。
• 详情页广告屏区按左右拼接方式展示，贴近真实设备物理屏。
• 系统兼容历史广告素材数据，旧设备也能正常展示左侧菜单素材。

UF-008：查看并修改温度报警设置

描述： 作为运维人员，我希望在当前设备上下文中查看各温区参数，并逐项修改报警阈值。

UF-009：查看异常记录与运维记录

描述： 作为运维人员，我希望在设备详情里追溯异常和运维处理信息。

1. 用户可以直接点击右侧 设备操作 > 状态记录。
2. 用户也可以点击右侧 详细信息 > 记录摘要，先查看异常记录数和运维记录数。
3. 用户在记录摘要中点击 查看状态记录。
4. 系统关闭记录摘要浮层，打开完整状态记录弹层，默认停留在 异常记录 标签。
5. 用户切换到 运维记录 标签查看补料 / 清洁等记录。

• 记录摘要 通过右侧 详细信息 入口打开，只展示异常数量、运维数量和查看入口。
• 从 记录摘要 点击 查看状态记录 时，旧摘要浮层必须关闭，完整状态记录弹层必须位于最上层。
• 状态记录弹层固定为 异常记录 与 运维记录 双标签结构。
• 异常记录为空或不足 3 条时，预览环境应保证列表展示稳定。
• 运维记录应覆盖清洁、补料等常见类型，并兼容历史记录格式。
• 当前版本状态记录弹层只展示 异常记录 和 运维记录，不会单独展示远程操作日志。

UF-010：编辑设备状态

描述： 作为运维人员，我希望直接在设备详情中更新设备状态。

UF-011：发起远程操作

描述： 作为运维人员，我希望在设备详情中发起远程操作，并在必要时进行二次确认。