haoliang-net/docs/02-功能清单/管理后台/09-系统设置/00-系统设置-索引.md

系统设置 索引

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

---