# 设备管理 索引

> 版本：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) |

---