|
|
# 设备管理 索引
|
|
|
|
|
|
> 版本：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-01-设备列表页面.md) |
|
|
|
| 03-02 | 设备详情页面 | 页面文件 | [03-02-设备详情页面.md](./03-02-设备详情页面.md) |
|
|
|
|
|
|
--- |