# 系统设置 索引

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

---

## 模块概述

系统配置项管理+车间管理。使用Tab页切换：系统配置Tab（key-value配置项+编辑+修改密码）和车间管理Tab（车间CRUD，数据量极小）。

## 页面清单

| 页面编号 | 页面名称 | 路由 | 功能概述 |
|---------|---------|------|---------|
| 09-01 | 系统设置页面 | /settings | 配置项管理+修改密码+车间管理（Tab切换） |

## 页面功能详情

### 09-01 系统设置页面
**路由**：`/settings`
**功能概述**：三Tab切换——系统配置(key-value编辑)、车间管理(CRUD)、修改密码

**功能列表**：

| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
|---------|---------|---------|---------|---------|
| F01 | 编辑配置项 | Tab1点击编辑 | 弹窗修改值，保存 | PUT /api/admin/sys-config/:id |
| F02 | 重置Token | Tab1点击重置(api_token/collector_api_key) | 确认框，含警告文案 | POST /api/admin/sys-config/reset-token |
| F03 | 新增车间 | Tab2点击新增 | 弹窗填写名称+排序 | POST /api/admin/workshop |
| F04 | 编辑车间 | Tab2点击编辑 | 弹窗回填，修改后保存 | PUT /api/admin/workshop/:id |
| F05 | 删除车间 | Tab2点击删除(无关联机床) | 确认框->删除 | DELETE /api/admin/workshop/:id |
| F06 | 启停车间 | Tab2点击启停 | 确认框->切换状态 | PUT /api/admin/workshop/:id/toggle |
| F07 | 修改密码 | Tab3填写+确认 | 校验->调API->成功->清Token->跳登录 | POST /api/admin/change-password |

**业务规则**：
- 车间删除前置条件：该车间下无机床（cnc_machine.workshop_id约束）
- 修改密码成功后立即清除Token跳转登录页（重新认证）
- 敏感配置项(api_token/collector_api_key)显示"********"，编辑时眼睛图标切换可见

## 子目录/文件

| 编号 | 名称 | 类型 | 索引 |
|------|------|------|------|
| 09-01 | 系统设置页面 | 页面文件 | [09-01-系统设置页面.md](./09-01-系统设置页面.md) |

---