haoliang-net/docs/02-功能清单/管理后台/03-设备管理/00-设备管理-索引.md

设备管理 索引

版本：v1.0 最后更新：2026-04-25

---

模块概述

管理CNC机床设备，包括设备列表（CRUD+批量操作+导入导出）和设备详情（实时状态+产量+趋势）。

页面清单

页面编号	页面名称	路由	功能概述
03-01	设备列表页面	/machine	机床列表+查询+CRUD+批量+导入导出
03-02	设备详情页面	/machine/:id	基本信息查看+实时状态+今日产量+7天趋势+采集记录

页面功能详情

03-01 设备列表页面

路由：/machine 功能概述：机床设备列表，支持按车间/在线状态/品牌/关键字筛选，新增/编辑/删除/批量启停/导入/导出

功能列表：

功能编号	功能名称	触发条件	交互行为	涉及API
F01	查询机床	点击查询	重置page=1->请求列表API	GET /api/admin/machine
F02	新增机床	点击新增	弹窗填写->保存	POST /api/admin/machine
F03	编辑机床	点击编辑	弹窗回填->修改->保存	PUT /api/admin/machine/{id}
F04	删除机床	点击删除	确认->软删除	DELETE /api/admin/machine/{id}
F05	批量启停	勾选+点击	确认->批量API	PUT /api/admin/machine/batch-toggle
F06	导出Excel	点击导出	调API下载	GET /api/admin/machine/export
F07	导入Excel	点击导入	选文件->上传	POST /api/admin/machine/import

状态机：机床is_enabled：1(启用)/0(停用)

路由跳转：

• 机床名称链接 -> 设备详情页(/machine/:id)

03-02 设备详情页面

路由：/machine/:id 功能概述：展示机床基本信息、实时运行状态(自动刷新)、今日产量、近7天趋势图、最近采集记录

功能列表：

功能编号	功能名称	触发条件	交互行为	涉及API
F01	加载详情	页面挂载	4个API并行	详情/产量/采集记录/趋势
F02	实时状态刷新	定时器每10秒	刷新实时状态区块	GET /api/admin/machine/{id}/status
F03	查看更多采集	点击查看更多	跳转产量报表(预填机床)	-

路由跳转：

• 返回 -> router.back()
• 查看更多 -> 产量报表页(待设计，预填机床筛选)

子目录/文件

编号	名称	类型	索引
03-01	设备列表页面	页面文件	03-01-设备列表页面.md
03-02	设备详情页面	页面文件	03-02-设备详情页面.md

---