docs: 初始化项目设计文档库

包含: 项目需求文档、数据库设计、前端全局规范、13模块功能清单(管理后台+大屏) Ultraworked with Sisyphus Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
1 week ago · 16643a2d08
commit 16643a2d08
57 changed files with 5392 additions and 0 deletions
--- a/.gitignore
+++ b/.gitignore
@ -0,0 +1,35 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+Thumbs.db
+.DS_Store
+
+# Local config
+.sisyphus/
+.playwright-mcp/
+
+# Screenshots (temp)
+*.png
+!docs/**/*.png
+
+# Logs
+*.log
+npm-debug.log*
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# TypeScript cache
+*.tsbuildinfo
--- a/AGENTS.md
+++ b/AGENTS.md
@ -0,0 +1,116 @@
+# 项目知识库
+
+**生成时间:** 2026-04-25
+**项目:** CNC机床数据采集系统
+
+## 概述
+
+多品牌CNC机床统一化数据采集系统的产品设计文档库。技术栈：Vue3前端 + ASP.NET Web API 2后端 + Windows Service采集服务 + MariaDB数据库。本地IIS部署，局域网场景。
+
+## 项目结构
+
+```
+.
+├── docs/                              # 全部设计文档
+│   ├── 00-需求与设计文档.md             # 核心需求、架构决策、技术选型
+│   ├── 01-数据库设计.md                # 双库设计(业务库+日志库)，17张表DDL
+│   ├── 02-功能清单/                    # 按模块拆分的功能清单
+│   │   ├── 02-文件夹创建规范.md  # ⚠️ 文档结构规范，新增模块必读
+│   │   ├── 02-前端全局规范.md      # 前端全局规范+CRUD必填项+模块进度+工程开发规范
+│   │   ├── 03-界面变更执行规范.md  # ⚠️ AI助手执行界面变更时必读
+│   │   ├── 大屏/                       # 大屏看板模块
+│   │   └── 管理后台/                   # 12个子模块（登录/仪表盘/设备/品牌/采集地址/员工/产量/告警/系统/车间/操作日志/大屏配置）
+│   └── ...
+├── frontend/                          # 前端工程（Vue3+Vite+TypeScript+Element Plus）
+│   ├── mock/                          # Mock数据定义（按模块拆分）
+│   ├── src/                           # 源码（路由/组件/样式/类型）
+│   └── vite.config.ts                 # Vite配置（mock插件+proxy）
+└── 发那科系统采集示例.txt              # FANUC品牌采集JSON样例数据
+```
+
+## 查找指南
+
+| 需求 | 位置 | 备注 |
+|------|------|------|
+| 了解项目背景/架构决策 | `docs/00-需求与设计文档.md` | 核心文档，所有已确认决策在此 |
+| 查看数据库表结构 | `docs/01-数据库设计.md` | 668行，含完整DDL+字段说明 |
+| 前端页面交互设计 | `docs/02-前端全局规范.md` | 全局组件规范+CRUD必填项+模块进度+工程开发规范 |
+| 前端工程开发规范 | `docs/02-前端全局规范.md` → 前端工程开发规范章节 | 技术栈/Mock方案/目录结构/CSS规范 |
+| 新增功能模块文档 | `docs/02-功能清单/02-文件夹创建规范.md` | 目录结构/命名/内容模板规范 |
+| AI助手执行界面变更 | `docs/02-功能清单/03-界面变更执行规范.md` | ⚠️ 必读：最小必读文件+变更清单+联动同步规则 |
+| 品牌采集数据格式 | `发那科系统采集示例.txt` | FANUC品牌JSON结构示例 |
+| 管理后台某模块设计 | `docs/02-功能清单/管理后台/{编号}-{模块名}/` | 每模块含索引+规范+页面文件 |
+| 大屏看板设计 | `docs/02-功能清单/大屏/` | 索引+规范+页面 |
+
+## 文档规范
+
+### 文件命名规则（必须遵循）
+
+- 索引文件：`00-{名称}-索引.md`
+- 规范文件：`01-{名称}-规范.md`
+- 页面文件：`{模块号}-{页面号}-{页面名}.md`（如 `03-01-设备列表页面.md`）
+- 模块编号：两位数 01-99
+
+### 三种文件分工
+
+| 文件类型 | 内容重点 |
+|---------|---------|
+| 索引文件 | 功能逻辑、交互关系、路由跳转、状态机 |
+| 规范文件 | 技术规范（组件、校验、布局、安全） |
+| 页面文件 | 技术实现（界面布局、字段定义、Mock数据） |
+
+### 页面文件20项模板
+
+结构定义(1-6) → 交互行为(7-12,14-15) → 技术实现(13,16-20)
+详见 `docs/02-功能清单/02-文件夹创建规范.md` 第五节
+
+## 核心业务规则
+
+- **采集模式**：HTTP拉取JSON，非直连机床；地址间并行、地址内串行
+- **零件计数**：NC程序名切换时结账上一段，新程序从0开始；同程序名多次出现分段记录
+- **双库分离**：业务库 `cnc_business` + 日志库 `cnc_log`；原始JSON存日志库，解析后存业务库
+- **时间标准**：以服务器时间为准
+- **品牌映射**：管理后台可视化配置，修改不回溯历史数据
+
+## 前端全局规范摘要
+
+- 组件库：Element Plus
+- API响应格式：`{ code: 0, message: "success", data: ... }`
+- 分页默认：page-sizes=[20,50,100]
+- 写操作防重复：loading+disabled+requestLock+axios 500ms去重
+- API超时：30秒
+- 删除确认：`确定删除【{name}】？此操作不可恢复。`
+- Layout：顶部栏(系统名+管理员下拉) + 侧边栏(200px可折叠+10个菜单项) + 内容区
+- 路由守卫：有Token访问/login重定向/dashboard，无Token访问管理后台重定向/login
+
+## 待设计模块
+
+- API接口设计（后置，界面全部确认后启动）
+- 采集服务核心逻辑设计（后置，界面全部确认后启动）
+- 前端管理后台设计（✅ 已完成，见 `02-前端全局规范.md` + `02-功能清单/管理后台/`）
+- 大屏看板设计（✅ 已完成，见 `02-功能清单/大屏/`）
+
+## 强制要求（必须遵守）
+
+- **思考过程使用中文**：所有AI助手的推理、分析、思考过程必须使用中文输出
+- **控制台输出中文**：所有控制台输出、日志、提示信息使用中文，不得出现乱码
+- **所有文档使用中文**：项目内所有文档、注释、界面文案使用中文
+- **PowerShell中文编码修复（每次会话必须执行）**：PowerShell 5.1默认OutputEncoding为GB2312，中文路径/文件名输出会乱码。在执行任何涉及中文路径的PowerShell命令前，必须先设置编码：
+  ```powershell
+  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+  [Console]::InputEncoding = [System.Text.Encoding]::UTF8
+  $OutputEncoding = [System.Text.Encoding]::UTF8
+  ```
+- **文件写入编码规范**：
+  - 禁止使用PowerShell `Out-File -Encoding utf8` 写入文件（会产生UTF-8 with BOM + CRLF）
+  - 使用Node.js `fs.writeFileSync(path, content, 'utf8')` 写入文件（无BOM、LF换行）
+  - 或使用Write/Edit工具直接写入（无BOM、LF换行）
+  - 如必须用PowerShell写入，需用 `[System.IO.File]::WriteAllText($path, $content, [System.Text.UTF8Encoding]::new($false))` 避免BOM
+  - 已有BOM文件修复：`node -e "const fs=require('fs');let b=fs.readFileSync('文件路径');if(b[0]===0xEF&&b[1]===0xBB&&b[2]===0xBF)b=b.slice(3);let t=b.toString('utf8').replace(/\r\n/g,'\n');fs.writeFileSync('文件路径',t,'utf8')"`
+
+## 注意事项
+
+- 部分索引/规范文件内容为空（尚未填写）→ 已全部填写
+- 数据库设计为草案状态(状态：草案)，界面确认后定稿
+- 前端界面设计全部完成(2026-04-26)，13个模块16个页面均已设计
+- 品牌预置：FANUC已预置，其他品牌手动添加
--- a/docs/00-文档进度总览.md
+++ b/docs/00-文档进度总览.md
@ -0,0 +1,62 @@
+# CNC机床数据采集系统 - 文档进度总览
+
+> 最后更新：2026-04-26
+
+---
+
+## 状态说明
+
+| 标记 | 含义 |
+|------|------|
+| ✅ 已确认 | 决策冻结，可作为开发依据 |
+| 📋 草案 | 初始设计完成，待界面确认后定稿 |
+| 🔄 设计中 | 内容已有但尚未确认，可能调整 |
+| ✅ 已设计 | 功能清单已完成，待开发 |
+| ⬜ 待设计 | 目录/文件已创建，内容待填写 |
+| ⬜ 未创建 | 文件尚未创建 |
+
+---
+
+## 核心设计文档
+
+| 文档 | 状态 | 最后更新 | 备注 |
+|------|------|---------|------|
+| [00-需求与设计文档](./00-需求与设计文档.md) | ✅ 已确认 | 2026-04-23 | 核心决策已冻结，待设计模块列表已过时 |
+| [01-数据库设计](./01-数据库设计.md) | 📋 草案 | 2026-04-25 | 界面设计确认后定稿，允许根据界面需求调整 |
+| [02-前端全局规范](./02-前端全局规范.md) | 🔄 设计中 | 2026-04-26 | 全局规范+Layout+路由总表已定，所有管理后台+大屏页面设计完成 |
+
+---
+
+## 前端功能清单（管理后台）
+
+| 模块 | 页面文件 | 索引文件 | 设计状态 | 最后更新 |
+|------|---------|---------|---------|---------|
+| 01-登录 | 01-01-登录页面.md | 00-登录-索引.md | ✅ 已设计 | 2026-04-25 |
+| 02-仪表盘 | 02-01-仪表盘页面.md | 00-仪表盘-索引.md | ✅ 已设计 | 2026-04-25 |
+| 03-设备管理 | 03-01/03-02 | 00-设备管理-索引.md | ✅ 已设计 | 2026-04-25 |
+| 04-品牌模板 | 04-01/04-02 | 00-品牌模板-索引.md | ✅ 已设计 | 2026-04-25 |
+| 05-采集地址 | 05-01/05-02 | 00-采集地址-索引.md | ✅ 已设计 | 2026-04-25 |
+| 06-员工管理 | 06-01/06-02 | 00-员工管理-索引.md | ✅ 已设计 | 2026-04-26 |
+| 07-产量报表 | 07-01-产量报表页面.md | 00-产量报表-索引.md | ✅ 已设计 | 2026-04-26 |
+| 08-告警中心 | 08-01-告警中心页面.md | 00-告警中心-索引.md | ✅ 已设计 | 2026-04-26 |
+| 09-系统设置 | 09-01-系统设置页面.md | 00-系统设置-索引.md | ✅ 已设计 | 2026-04-26 |
+| 10-车间管理 | 10-01-车间管理页面.md | 00-车间管理-索引.md | 🔀 已合并 | 2026-04-25 | 合并至09-系统设置 |
+| 11-操作日志 | 11-01-操作日志页面.md | 00-操作日志-索引.md | ✅ 已设计 | 2026-04-26 |
+| 12-大屏配置 | 12-01-大屏配置页面.md | 00-大屏配置-索引.md | ✅ 已设计 | 2026-04-25 | |
+
+---
+
+## 前端功能清单（大屏）
+
+| 模块 | 页面文件 | 索引文件 | 设计状态 | 最后更新 |
+|------|---------|---------|---------|---------|
+| 大屏看板 | 01-01-大屏看板页面.md | 00-大屏-索引.md | ✅ 已设计 | 2026-04-26 |
+
+---
+
+## 待创建文档
+
+| 文档 | 优先级 | 状态 | 说明 |
+|------|--------|------|------|
+| API接口设计 | P0 | 🔜 后置 | 待界面设计全部确认后启动 |
+| 采集服务核心逻辑设计 | P1 | 🔜 后置 | 待界面设计全部确认后启动 |
--- a/docs/00-需求与设计文档.md
+++ b/docs/00-需求与设计文档.md
@ -0,0 +1,133 @@
+# CNC机床数据采集系统 - 需求与设计文档
+
+> 最后更新：2026-04-23
+> 状态：设计中（数据库设计已确认，API/前端/采集服务待设计）
+
+---
+
+## 一、项目概述
+
+本系统用于对多台不同品牌CNC机床进行统一化、分布式、自动化数据采集，实现设备状态监控、零件产量自动统计、加工过程分析、人员与设备绑定管理，并通过BI大屏实时展示生产数据。
+
+系统本地IIS部署，MariaDB数据库（业务库+日志库双库分离），单角色管理模式。
+
+---
+
+## 二、技术栈
+
+| 层 | 技术 | 说明 |
+|----|------|------|
+| 前端 | Vue3 | 管理后台 + 大屏看板 |
+| 后端 | ASP.NET Web API 2 (.NET Framework 4.5+) | REST API |
+| 采集服务 | Windows Service (.NET Framework 4.5+) | 定时采集+数据处理 |
+| 数据库 | MariaDB 10.6+ | 业务库 + 日志库 |
+| 部署 | Windows Server + IIS | 局域网，同站点 |
+
+---
+
+## 三、系统架构
+
+[见附图：架构图]
+
+核心组件：
+- Windows Service (CncCollector)：定时拉取HTTP数据，字段映射解析，零件数增量计算，日终汇总，心跳上报
+- MariaDB：业务库(cnc_business) + 日志库(cnc_log)
+- IIS Web API 2：/api/admin/** Token认证，/api/screen/** 免认证
+- Vue3前端：管理后台(/) + 大屏(/screen)
+
+---
+
+## 四、已确认的核心需求与决策
+
+### 4.1 采集架构
+
+| 决策 | 结论 |
+|------|------|
+| 采集模式 | 系统定时从一个HTTP地址拉取JSON数据（非直连机床） |
+| 采集地址 | 多个采集地址，每个地址关联品牌+选择要采的机床列表，URL和间隔配在地址级 |
+| 采集间隔 | 配置在采集地址级别，同地址统一间隔 |
+| 采集并发 | 地址间并行，地址内串行 |
+| Ping前置 | Ping通才采集，Ping结果=在线状态 |
+| 采集失败 | 自动重试3次间隔30秒，连续5次失败记告警 |
+| 采集认证 | HTTP采集地址无需认证 |
+| 新设备发现 | 采集到未知device时记录告警，不自动创建 |
+
+### 4.2 数据格式
+
+| 决策 | 结论 |
+|------|------|
+| 顶层结构 | 所有品牌统一：JSON数组，每台设备含device、desc、tags |
+| 字段定位 | 通过tags数组中id匹配定位关键字段 |
+| 字段映射 | 管理后台可视化配置品牌字段映射，实时生效不改代码 |
+| device映射 | 机床表配置device_code，采集时用device值匹配 |
+| 原始数据 | 存原始JSON到日志库，解析后结构化数据存业务库 |
+| 时间标准 | 以服务器时间为准，机床时间仅存为参考字段 |
+| 数值处理 | 自动去除.00000尾缀，转换为数值/字符串 |
+
+### 4.3 零件产量统计
+
+| 决策 | 结论 |
+|------|------|
+| 零件识别 | NC程序名（Tag5）作为零件唯一识别 |
+| 计数方式 | CNC切换加工零件时NC程序名变更+零件数清零 |
+| 产量计算 | 程序切换时结账上一段零件数，新程序从0开始 |
+| A-B-C-A-B | 同程序名多次出现，产量分段记录，日汇总时合并 |
+| 手动清零 | 同程序下part_count下降视为手动清零，结账前值后从0重计 |
+| 设备重启 | 确认不清零零件数 |
+| 跨天处理 | 零点后数据归属第二天，有问题后台手工调 |
+| 日终汇总 | 按自然天汇总，过0点后自动汇总前一天，汇总时间后台可配 |
+| 未开机机床 | 日汇总插0产量记录 |
+| 采集失败机床 | Ping通但采集失败标记数据缺失，前端显示-而非0 |
+
+### 4.4 班次与工人
+
+| 决策 | 结论 |
+|------|------|
+| 班次 | v1不支持班次，按自然天+固定绑定汇总 |
+| 工人-机床 | 固定绑定，一台机床只绑一个工人 |
+| 工人归属 | 工人不归属车间 |
+
+### 4.5 管理与监控
+
+| 决策 | 结论 |
+|------|------|
+| 采集服务通信 | 心跳写DB + 轻量HTTP管理API（启停控制） |
+| 配置热更新 | 轮询DB（每30秒）+ 管理操作后API通知，双保险 |
+| 采集服务自恢复 | 每个采集地址任务独立线程，崩了不影响其他，自动重启间隔递增 |
+| DB断连处理 | 本地文件缓存+自动补写 |
+| 采集服务API认证 | 加服务间API Key（配置文件中写死） |
+| 手工调整产量 | 管理后台修正功能+审计日志 |
+| 模板修改 | 不回溯历史数据，修改时弹提醒 |
+
+### 4.6 前端与认证
+
+| 决策 | 结论 |
+|------|------|
+| API认证 | /api/admin/** Token认证，/api/screen/** 免认证 |
+| 管理后台 | PC端，Vue3 |
+| 大屏 | Chrome无人值守，提供全屏按钮，免认证 |
+| 大屏可配置 | 固定布局+卡片指标可配+筛选可配+图表类型可选 |
+| Vue3部署 | 同IIS站点，无跨域问题 |
+| Excel导出 | EPPlus |
+
+### 4.7 系统运维
+
+| 决策 | 结论 |
+|------|------|
+| 日志轮转 | 按日期切割，保留天数在管理后台配置 |
+| DB备份 | 每日自动全量+binlog增量，保留30天，需检查binlog是否开启 |
+| 分区维护 | 按月创建新分区+删除过期分区 |
+| 品牌预置 | 预置FANUC品牌模板，其他手动添加 |
+| 告警通知 | v1只做管理后台内告警列表+标记已处理，不做推送 |
+| 机床停用 | 软删除(is_enabled)，保留历史数据 |
+
+---
+
+## 五、待设计模块
+
+> 以下模块尚未展开设计，待后续讨论确认：
+
+- 5.1 API接口设计
+- 5.2 采集服务核心逻辑设计
+- 5.3 前端管理后台设计
+- 5.4 大屏看板设计
--- a/docs/01-数据库设计.md
+++ b/docs/01-数据库设计.md
@ -0,0 +1,668 @@
+# CNC机床数据采集系统 - 数据库设计文档
+
+> 最后更新：2026-04-25
+> 状态：草案（界面设计确认后定稿，允许根据界面需求调整表结构）
+
+---
+
+## 一、数据库架构
+
+- **业务库**：cnc_business
+- **日志库**：cnc_log
+- **引擎**：InnoDB，字符集 utf8mb4，排序 utf8mb4_unicode_ci
+- **分区策略**：高写入表按月分区，定期创建新分区+删除过期分区
+
+---
+
+## 二、业务库 cnc_business（17张表）
+
+### 2.1 车间表 cnc_workshop
+
+``sql
+CREATE TABLE cnc_workshop (
+    id          INT AUTO_INCREMENT PRIMARY KEY,
+    name        VARCHAR(100) NOT NULL UNIQUE,
+    sort_order  INT NOT NULL DEFAULT 0,
+    is_enabled  TINYINT(1) NOT NULL DEFAULT 1,
+    created_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='车间表';
+``
+
+无额外索引。3个车间，数据量极小，主键足够。
+
+---
+
+### 2.2 品牌模板表 cnc_brand
+
+``sql
+CREATE TABLE cnc_brand (
+    id              INT AUTO_INCREMENT PRIMARY KEY,
+    brand_name      VARCHAR(50) NOT NULL UNIQUE,
+    device_field    VARCHAR(50) NOT NULL DEFAULT 'device',
+    tags_path       VARCHAR(100) NOT NULL DEFAULT 'tags',
+    is_enabled      TINYINT(1) NOT NULL DEFAULT 1,
+    created_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='CNC品牌模板表';
+``
+
+所有品牌顶层结构统一，device_field和tags_path默认值覆盖绝大多数品牌。品牌数量少，无额外索引。
+
+---
+
+### 2.3 品牌字段映射表 cnc_brand_field_mapping
+
+``sql
+CREATE TABLE cnc_brand_field_mapping (
+    id              INT AUTO_INCREMENT PRIMARY KEY,
+    brand_id        INT NOT NULL,
+    standard_field  VARCHAR(50) NOT NULL,
+    field_name      VARCHAR(50) NOT NULL,
+    match_by        VARCHAR(20) NOT NULL DEFAULT 'id',
+    data_type       VARCHAR(20) NOT NULL DEFAULT 'string',
+    is_required     TINYINT(1) NOT NULL DEFAULT 0,
+    created_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (brand_id) REFERENCES cnc_brand(id) ON DELETE CASCADE,
+    UNIQUE KEY uk_brand_standard (brand_id, standard_field)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='品牌字段映射表';
+``
+
+**标准字段约定**（代码层面，不建表）：
+
+| standard_field | 含义 | data_type |
+|----------------|------|-----------|
+| program_name | NC程序名 | string |
+| part_count | 当前加工零件数 | number |
+| device_status | 设备状态 | number |
+| run_status | 运行状态 | number |
+| operate_mode | 操作模式 | number |
+| spindle_speed_set | 主轴设定速度 | number |
+| feed_speed_set | 进给设定速度 | number |
+| spindle_speed_actual | 主轴实际速度 | number |
+| feed_speed_actual | 进给实际转速 | number |
+| spindle_load | 主轴负载 | number |
+| spindle_override | 主轴倍率 | number |
+| power_on_time | 开机时间 | number |
+| run_time | 运行时间 | number |
+| cutting_time | 切削时间 | number |
+| cycle_time | 循环时间 | number |
+| machining_status | 加工状态 | string |
+
+索引：uk_brand_standard唯一约束同时作为索引，保证同一品牌下标准字段不重复，采集时按brand_id查询所有映射规则。
+
+---
+
+### 2.4 采集地址表 cnc_collect_address
+
+``sql
+CREATE TABLE cnc_collect_address (
+    id                INT AUTO_INCREMENT PRIMARY KEY,
+    name              VARCHAR(100) NOT NULL,
+    url               VARCHAR(500) NOT NULL,
+    brand_id          INT NOT NULL,
+    collect_interval  INT NOT NULL DEFAULT 30,
+    is_enabled        TINYINT(1) NOT NULL DEFAULT 1,
+    last_collect_time DATETIME NULL,
+    last_collect_status VARCHAR(20) NULL,
+    fail_count        INT NOT NULL DEFAULT 0,
+    created_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (brand_id) REFERENCES cnc_brand(id),
+    INDEX idx_brand (brand_id),
+    INDEX idx_enabled (is_enabled)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集地址表';
+``
+
+索引：idx_brand用于采集服务按品牌加载地址列表；idx_enabled用于只查启用的地址。last_collect_time/status/fail_count由采集服务实时更新，大屏和管理后台直接查此表显示采集状态。
+
+---
+
+### 2.5 机床表 cnc_machine
+
+``sql
+CREATE TABLE cnc_machine (
+    id                  INT AUTO_INCREMENT PRIMARY KEY,
+    device_code         VARCHAR(100) NOT NULL,
+    name                VARCHAR(100) NOT NULL,
+    workshop_id         INT NOT NULL,
+    collect_address_id  INT NOT NULL,
+    ip_address          VARCHAR(50) NOT NULL,
+    brand_id            INT NOT NULL,
+    is_enabled          TINYINT(1) NOT NULL DEFAULT 1,
+    is_online           TINYINT(1) NOT NULL DEFAULT 0,
+    last_ping_time      DATETIME NULL,
+    last_collect_time   DATETIME NULL,
+    last_device_status  VARCHAR(20) NULL,
+    last_run_status     VARCHAR(20) NULL,
+    last_program_name   VARCHAR(200) NULL,
+    last_part_count     DECIMAL(15,5) NULL,
+    last_operate_mode   VARCHAR(20) NULL,
+    last_machining_status VARCHAR(20) NULL,
+    created_at          DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at          DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (workshop_id) REFERENCES cnc_workshop(id),
+    FOREIGN KEY (collect_address_id) REFERENCES cnc_collect_address(id),
+    FOREIGN KEY (brand_id) REFERENCES cnc_brand(id),
+    UNIQUE KEY uk_device_code (device_code),
+    INDEX idx_workshop (workshop_id),
+    INDEX idx_collect_address (collect_address_id),
+    INDEX idx_enabled_online (is_enabled, is_online),
+    INDEX idx_enabled_address (is_enabled, collect_address_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='CNC机床表';
+``
+
+索引设计：
+- uk_device_code：采集时用device值匹配机床，唯一约束防重复
+- idx_workshop：按车间筛选机床
+- idx_enabled_online：大屏查在线+可用机床列表，高频查询
+- idx_enabled_address：采集服务按地址查启用的机床列表
+
+实时状态字段：故意冗余到机床表，大屏和首页查询只读此表，不JOIN采集记录表，避免高频查询大表。
+
+---
+
+### 2.6 工人表 cnc_worker
+
+``sql
+CREATE TABLE cnc_worker (
+    id          INT AUTO_INCREMENT PRIMARY KEY,
+    name        VARCHAR(50) NOT NULL,
+    code        VARCHAR(50) NOT NULL UNIQUE,
+    is_enabled  TINYINT(1) NOT NULL DEFAULT 1,
+    created_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='工人表';
+``
+
+工人不归属车间。uk_code覆盖工号查询。
+
+---
+
+### 2.7 工人-机床绑定表 cnc_worker_machine
+
+``sql
+CREATE TABLE cnc_worker_machine (
+    id          INT AUTO_INCREMENT PRIMARY KEY,
+    worker_id   INT NOT NULL,
+    machine_id  INT NOT NULL,
+    created_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (worker_id) REFERENCES cnc_worker(id) ON DELETE CASCADE,
+    FOREIGN KEY (machine_id) REFERENCES cnc_machine(id) ON DELETE CASCADE,
+    UNIQUE KEY uk_machine (machine_id),
+    INDEX idx_worker (worker_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='工人-机床绑定表';
+``
+
+索引：uk_machine保证一对一绑定，同时作为按机床查工人的索引；idx_worker用于按工人查机床列表。
+
+---
+
+### 2.8 采集结构化记录表 cnc_collect_record（按月分区，高频写入）
+
+``sql
+CREATE TABLE cnc_collect_record (
+    id                    BIGINT AUTO_INCREMENT PRIMARY KEY,
+    machine_id            INT NOT NULL,
+    collect_time          DATETIME NOT NULL,
+    device_time           DATETIME NULL,
+    program_name          VARCHAR(200) NULL,
+    part_count            DECIMAL(15,5) NULL,
+    device_status         VARCHAR(20) NULL,
+    run_status            VARCHAR(20) NULL,
+    operate_mode          VARCHAR(20) NULL,
+    spindle_speed_set     DECIMAL(15,5) NULL,
+    feed_speed_set        DECIMAL(15,5) NULL,
+    spindle_speed_actual  DECIMAL(15,5) NULL,
+    feed_speed_actual     DECIMAL(15,5) NULL,
+    spindle_load          DECIMAL(15,5) NULL,
+    spindle_override      DECIMAL(5,2) NULL,
+    power_on_time         DECIMAL(15,2) NULL,
+    run_time              DECIMAL(15,2) NULL,
+    cutting_time          DECIMAL(15,2) NULL,
+    cycle_time            DECIMAL(15,2) NULL,
+    machining_status      VARCHAR(20) NULL,
+    extra_data            JSON NULL,
+    created_at            DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (machine_id) REFERENCES cnc_machine(id),
+    INDEX idx_machine_time (machine_id, collect_time),
+    INDEX idx_collect_time (collect_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
+  COMMENT='采集结构化记录表（按月分区，90天自动清理）'
+  PARTITION BY RANGE (TO_DAYS(collect_time)) (
+    PARTITION p202604 VALUES LESS THAN (TO_DAYS('2026-05-01')),
+    PARTITION p202605 VALUES LESS THAN (TO_DAYS('2026-06-01')),
+    PARTITION p202606 VALUES LESS THAN (TO_DAYS('2026-07-01')),
+    PARTITION p_future VALUES LESS THAN MAXVALUE
+  );
+``
+
+索引设计：
+- idx_machine_time：最核心索引，覆盖查某台机床某时间段采集数据（报表、趋势图、日汇总计算）
+- idx_collect_time：覆盖查某个时间点所有机床数据（全局状态快照）
+
+分区策略：按月分区，删除过期数据只需DROP PARTITION，避免DELETE大量行导致锁表和碎片。
+数据量估算：160台 x 每天约2000条 = 32万/天，90天约2900万行。分区后单分区约300万行。
+
+---
+
+### 2.9 产量分段记录表 cnc_production_segment
+
+``sql
+CREATE TABLE cnc_production_segment (
+    id                BIGINT AUTO_INCREMENT PRIMARY KEY,
+    machine_id        INT NOT NULL,
+    program_name      VARCHAR(200) NOT NULL,
+    production_date   DATE NOT NULL,
+    start_time        DATETIME NOT NULL,
+    end_time          DATETIME NULL,
+    start_part_count  DECIMAL(15,5) NOT NULL,
+    end_part_count    DECIMAL(15,5) NULL,
+    quantity          DECIMAL(15,5) NULL,
+    is_settled        TINYINT(1) NOT NULL DEFAULT 0,
+    close_reason      VARCHAR(30) NULL,
+    created_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (machine_id) REFERENCES cnc_machine(id),
+    INDEX idx_machine_date (machine_id, production_date),
+    INDEX idx_machine_date_program (machine_id, production_date, program_name),
+    INDEX idx_active (machine_id, is_settled, end_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='产量分段记录表';
+``
+
+核心逻辑：每次采集检测到以下情况时结账当前段并开新段：
+1. NC程序名变化 -> close_reason = 'program_change'
+2. 同程序下part_count下降 -> close_reason = 'manual_reset'
+3. 日终汇总时仍在运行 -> close_reason = 'end_of_day'
+4. 采集服务停止时 -> close_reason = 'service_stop'
+
+A-B-C-A-B场景：程序A第二次出现时创建新的段记录，日汇总按(machine_id, production_date, program_name)合并。
+
+索引设计：
+- idx_machine_date：日汇总计算时查某台机床某天的所有段
+- idx_machine_date_program：查某台机床某天某个程序的所有段（合并计算）
+- idx_active：采集服务运行时快速查找当前活跃段（is_settled=0, end_time IS NULL）
+
+---
+
+### 2.10 机床日状态表 cnc_machine_daily_status
+
+``sql
+CREATE TABLE cnc_machine_daily_status (
+    id              INT AUTO_INCREMENT PRIMARY KEY,
+    machine_id      INT NOT NULL,
+    production_date DATE NOT NULL,
+    data_status     VARCHAR(20) NOT NULL DEFAULT 'normal',
+    created_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (machine_id) REFERENCES cnc_machine(id),
+    UNIQUE KEY uk_machine_date (machine_id, production_date),
+    INDEX idx_date_status (production_date, data_status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='机床日状态表';
+``
+
+data_status规则：
+- normal：当天至少成功采集过一次
+- offline：当天从未Ping通，产量=0
+- data_missing：Ping通但采集始终失败，前端显示-而非0
+
+索引：uk_machine_date保证每台机床每天只有一条状态记录；idx_date_status支持按天查特定状态机床。
+
+---
+
+### 2.11 日汇总表 cnc_daily_production（按机床+程序）
+
+``sql
+CREATE TABLE cnc_daily_production (
+    id                INT AUTO_INCREMENT PRIMARY KEY,
+    machine_id        INT NOT NULL,
+    production_date   DATE NOT NULL,
+    program_name      VARCHAR(200) NOT NULL,
+    total_quantity    DECIMAL(15,5) NOT NULL DEFAULT 0,
+    segment_count     INT NOT NULL DEFAULT 1,
+    total_run_time    DECIMAL(15,2) NULL,
+    total_cutting_time DECIMAL(15,2) NULL,
+    total_cycle_time  DECIMAL(15,2) NULL,
+    is_adjusted       TINYINT(1) NOT NULL DEFAULT 0,
+    adjusted_quantity DECIMAL(15,5) NULL,
+    created_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (machine_id) REFERENCES cnc_machine(id),
+    UNIQUE KEY uk_machine_date_program (machine_id, production_date, program_name),
+    INDEX idx_date (production_date),
+    INDEX idx_date_program (production_date, program_name)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='日汇总表(按机床+程序)';
+``
+
+索引设计：
+- uk_machine_date_program：唯一约束+最核心查询索引
+- idx_date：按日期查所有汇总
+- idx_date_program：按日期+程序名查汇总
+
+---
+
+### 2.12 工人日汇总表 cnc_worker_daily_summary
+
+``sql
+CREATE TABLE cnc_worker_daily_summary (
+    id                INT AUTO_INCREMENT PRIMARY KEY,
+    worker_id         INT NOT NULL,
+    production_date   DATE NOT NULL,
+    total_quantity    DECIMAL(15,5) NOT NULL DEFAULT 0,
+    machine_count     INT NOT NULL DEFAULT 0,
+    program_count     INT NOT NULL DEFAULT 0,
+    is_adjusted       TINYINT(1) NOT NULL DEFAULT 0,
+    adjusted_quantity DECIMAL(15,5) NULL,
+    created_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (worker_id) REFERENCES cnc_worker(id) ON DELETE CASCADE,
+    UNIQUE KEY uk_worker_date (worker_id, production_date),
+    INDEX idx_date (production_date),
+    INDEX idx_date_quantity (production_date, total_quantity)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='工人日汇总表';
+``
+
+索引设计：
+- uk_worker_date：唯一约束+核心查询
+- idx_date：按日期查所有工人汇总
+- idx_date_quantity：排行榜核心索引，按日期查产量排名，覆盖大屏排行榜高频查询
+
+---
+
+### 2.13 产量修正审计表 cnc_production_adjustment
+
+``sql
+CREATE TABLE cnc_production_adjustment (
+    id                BIGINT AUTO_INCREMENT PRIMARY KEY,
+    target_table      VARCHAR(30) NOT NULL,
+    target_id         INT NOT NULL,
+    field_name        VARCHAR(50) NOT NULL,
+    old_value         DECIMAL(15,5) NULL,
+    new_value         DECIMAL(15,5) NOT NULL,
+    reason            VARCHAR(500) NOT NULL,
+    operator_ip       VARCHAR(50) NULL,
+    created_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_target (target_table, target_id),
+    INDEX idx_created (created_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='产量修正审计表';
+``
+
+索引：idx_target用于查某条记录的修正历史；idx_created用于按时间查审计日志。
+
+---
+
+### 2.14 告警表 cnc_alert
+
+``sql
+CREATE TABLE cnc_alert (
+    id              BIGINT AUTO_INCREMENT PRIMARY KEY,
+    alert_type      VARCHAR(30) NOT NULL,
+    machine_id      INT NULL,
+    collect_address_id INT NULL,
+    title           VARCHAR(200) NOT NULL,
+    detail          TEXT NULL,
+    is_resolved     TINYINT(1) NOT NULL DEFAULT 0,
+    resolved_at     DATETIME NULL,
+    created_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (machine_id) REFERENCES cnc_machine(id) ON DELETE SET NULL,
+    FOREIGN KEY (collect_address_id) REFERENCES cnc_collect_address(id) ON DELETE SET NULL,
+    INDEX idx_type_resolved (alert_type, is_resolved),
+    INDEX idx_machine_time (machine_id, created_at),
+    INDEX idx_created (created_at),
+    INDEX idx_unresolved (is_resolved, created_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='告警表';
+``
+
+告警类型：collect_fail / device_offline / production_anomaly / unknown_device / service_error
+
+索引设计：
+- idx_type_resolved：按类型查未处理告警
+- idx_machine_time：查某台机床的告警历史
+- idx_unresolved：管理后台最常用查询，查所有未处理告警按时间排序
+
+---
+
+### 2.15 系统配置表 cnc_sys_config
+
+``sql
+CREATE TABLE cnc_sys_config (
+    id          INT AUTO_INCREMENT PRIMARY KEY,
+    config_key  VARCHAR(100) NOT NULL UNIQUE,
+    config_value TEXT NOT NULL,
+    value_type  VARCHAR(20) NOT NULL DEFAULT 'string',
+    description VARCHAR(200) NULL,
+    updated_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='系统配置表';
+``
+
+预置配置项：
+
+| config_key | 默认值 | 说明 |
+|------------|--------|------|
+| ping_interval | 60 | Ping检测间隔(秒) |
+| collect_retry_count | 3 | 采集失败重试次数 |
+| collect_retry_interval | 30 | 采集重试间隔(秒) |
+| collect_fail_alert_threshold | 5 | 连续失败N次触发告警 |
+| heartbeat_interval | 10 | 心跳写入间隔(秒) |
+| daily_summary_time | 01:00 | 日终汇总执行时间 |
+| config_poll_interval | 30 | 采集服务轮询配置间隔(秒) |
+| log_retention_days | 90 | 原始采集日志保留天数 |
+| system_log_retention_days | 30 | 系统日志保留天数 |
+| alert_log_retention_days | 180 | 异常日志保留天数 |
+| heartbeat_retention_days | 7 | 心跳记录保留天数 |
+| bigscreen_refresh_interval | 10 | 大屏刷新间隔(秒) |
+| api_token | (自动生成) | 前端API Token |
+| collector_api_port | 5800 | 采集服务管理API端口 |
+| collector_api_key | (自动生成) | 采集服务间通信API Key |
+| error_retry_base_interval | 60 | 任务错误重试基础间隔(秒) |
+
+---
+
+### 2.16 大屏配置表 cnc_screen_config
+
+``sql
+CREATE TABLE cnc_screen_config (
+    id              INT AUTO_INCREMENT PRIMARY KEY,
+    card_key        VARCHAR(50) NOT NULL UNIQUE,
+    card_type       VARCHAR(30) NOT NULL,
+    title           VARCHAR(100) NOT NULL,
+    metric          VARCHAR(50) NOT NULL,
+    dimension       VARCHAR(30) NULL,
+    sort_order      INT NOT NULL DEFAULT 0,
+    is_enabled      TINYINT(1) NOT NULL DEFAULT 1,
+    chart_config    JSON NULL,
+    created_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='大屏卡片配置表';
+``
+
+card_type类型：stat_number / bar_chart / line_chart / pie_chart / status_grid / rank_list
+
+预置卡片：
+
+| card_key | card_type | title | metric | dimension |
+|----------|-----------|-------|--------|-----------|
+| total_online | stat_number | 在线机床数 | online_count | - |
+| total_production_today | stat_number | 今日总产量 | part_count | - |
+| workshop_production | bar_chart | 各车间产量 | part_count | workshop |
+| worker_rank | rank_list | 工人产量排行 | part_count | worker |
+| machine_rank | rank_list | 机床产量排行 | part_count | machine |
+| machine_status | status_grid | 机床状态总览 | - | - |
+| collector_status | stat_number | 采集服务状态 | - | - |
+| production_trend | line_chart | 产量趋势(7天) | part_count | - |
+
+---
+
+### 2.17 大屏筛选配置表 cnc_screen_filter
+
+``sql
+CREATE TABLE cnc_screen_filter (
+    id              INT AUTO_INCREMENT PRIMARY KEY,
+    screen_key      VARCHAR(50) NOT NULL,
+    filter_type     VARCHAR(30) NOT NULL,
+    filter_value    VARCHAR(100) NOT NULL,
+    is_default      TINYINT(1) NOT NULL DEFAULT 0,
+    sort_order      INT NOT NULL DEFAULT 0,
+    UNIQUE KEY uk_screen_filter (screen_key, filter_type, filter_value)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='大屏筛选配置表';
+``
+
+---
+
+## 三、日志库 cnc_log（3张表）
+
+### 3.1 原始采集JSON表 log_collect_raw（按月分区）
+
+``sql
+CREATE TABLE log_collect_raw (
+    id                BIGINT AUTO_INCREMENT PRIMARY KEY,
+    collect_address_id INT NOT NULL,
+    request_time      DATETIME NOT NULL,
+    response_time     DATETIME NOT NULL,
+    response_duration INT NULL,
+    is_success        TINYINT(1) NOT NULL DEFAULT 1,
+    status_code       INT NULL,
+    raw_json          MEDIUMTEXT NOT NULL,
+    error_message     VARCHAR(500) NULL,
+    created_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_address_time (collect_address_id, request_time),
+    INDEX idx_request_time (request_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
+  COMMENT='原始采集JSON表（按月分区，90天自动清理）'
+  PARTITION BY RANGE (TO_DAYS(request_time)) (
+    PARTITION p202604 VALUES LESS THAN (TO_DAYS('2026-05-01')),
+    PARTITION p202605 VALUES LESS THAN (TO_DAYS('2026-06-01')),
+    PARTITION p202606 VALUES LESS THAN (TO_DAYS('2026-07-01')),
+    PARTITION p_future VALUES LESS THAN MAXVALUE
+  );
+``
+
+数据量估算：每30秒一次采集 x 5-10个地址 x 86400秒/天 = 1.4-2.9万条/天，每条约20KB = 280-580MB/天。90天约25-52GB。
+
+---
+
+### 3.2 系统日志表 log_system（按月分区）
+
+``sql
+CREATE TABLE log_system (
+    id              BIGINT AUTO_INCREMENT PRIMARY KEY,
+    log_level       VARCHAR(10) NOT NULL,
+    source          VARCHAR(50) NOT NULL,
+    message         TEXT NOT NULL,
+    stack_trace     TEXT NULL,
+    extra_data      JSON NULL,
+    created_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_level_time (log_level, created_at),
+    INDEX idx_source_time (source, created_at),
+    INDEX idx_created (created_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
+  COMMENT='系统日志表（按月分区，30天自动清理）'
+  PARTITION BY RANGE (TO_DAYS(created_at)) (
+    PARTITION p202604 VALUES LESS THAN (TO_DAYS('2026-05-01')),
+    PARTITION p202605 VALUES LESS THAN (TO_DAYS('2026-06-01')),
+    PARTITION p202606 VALUES LESS THAN (TO_DAYS('2026-07-01')),
+    PARTITION p_future VALUES LESS THAN MAXVALUE
+  );
+``
+
+---
+
+### 3.3 采集服务心跳表 log_collector_heartbeat
+
+``sql
+CREATE TABLE log_collector_heartbeat (
+    id                BIGINT AUTO_INCREMENT PRIMARY KEY,
+    service_id        VARCHAR(50) NOT NULL DEFAULT 'CncCollector',
+    status            VARCHAR(20) NOT NULL,
+    collect_address_id INT NULL,
+    last_collect_time DATETIME NULL,
+    success_count     INT NOT NULL DEFAULT 0,
+    fail_count        INT NOT NULL DEFAULT 0,
+    uptime_seconds    BIGINT NULL,
+    detail            JSON NULL,
+    created_at        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_service_time (service_id, created_at),
+    INDEX idx_address_time (collect_address_id, created_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='采集服务心跳表（7天自动清理）';
+``
+
+心跳检测逻辑：Web API查WHERE service_id='CncCollector' AND created_at > NOW() - INTERVAL 30 SECOND，有记录=运行中，无记录=已停止。
+
+---
+
+## 四、ER关系总览
+
+`
+cnc_workshop 1-----N cnc_machine
+cnc_brand    1-----N cnc_brand_field_mapping
+cnc_brand    1-----N cnc_collect_address
+cnc_collect_address 1--N cnc_machine
+cnc_machine  1-----1 cnc_worker_machine  (uk_machine)
+cnc_worker   1-----N cnc_worker_machine
+cnc_machine  1-----N cnc_collect_record
+cnc_machine  1-----N cnc_production_segment
+cnc_machine  1-----N cnc_daily_production
+cnc_machine  1-----N cnc_machine_daily_status
+cnc_worker   1-----N cnc_worker_daily_summary
+cnc_daily_production 1--N cnc_production_adjustment
+cnc_worker_daily_summary 1--N cnc_production_adjustment
+cnc_machine  1-----N cnc_alert
+
+--- 日志库 ---
+cnc_collect_address 1--N log_collect_raw (弱关联，跨库)
+log_collector_heartbeat (独立，弱关联collect_address_id)
+log_system (独立)
+`
+
+---
+
+## 五、分区维护策略
+
+| 任务 | 频率 | 操作 |
+|------|------|------|
+| 创建新分区 | 每月1日 | 为cnc_collect_record、log_collect_raw、log_system预创建下下月分区 |
+| 删除过期分区 | 每月1日 | DROP超过保留期的分区 |
+| 清理心跳表 | 每天 | DELETE log_collector_heartbeat超过7天的记录 |
+| 清理告警表 | 每天 | DELETE cnc_alert已处理且超过180天的记录 |
+
+---
+
+## 六、索引设计总览
+
+| 表 | 索引名 | 类型 | 覆盖场景 |
+|----|--------|------|---------|
+| cnc_brand_field_mapping | uk_brand_standard | UNIQUE | 按品牌查映射规则 |
+| cnc_collect_address | idx_brand | INDEX | 按品牌加载地址 |
+| cnc_collect_address | idx_enabled | INDEX | 查启用的地址 |
+| cnc_machine | uk_device_code | UNIQUE | 采集device匹配 |
+| cnc_machine | idx_workshop | INDEX | 按车间筛选 |
+| cnc_machine | idx_enabled_online | INDEX | 大屏在线机床查询 |
+| cnc_machine | idx_enabled_address | INDEX | 采集服务按地址查机床 |
+| cnc_worker_machine | uk_machine | UNIQUE | 一对一绑定+按机床查工人 |
+| cnc_worker_machine | idx_worker | INDEX | 按工人查机床列表 |
+| cnc_collect_record | idx_machine_time | INDEX | 报表/趋势图/汇总计算 |
+| cnc_collect_record | idx_collect_time | INDEX | 全局状态快照 |
+| cnc_production_segment | idx_machine_date | INDEX | 日汇总计算 |
+| cnc_production_segment | idx_machine_date_program | INDEX | 按程序合并计算 |
+| cnc_production_segment | idx_active | INDEX | 查找活跃段 |
+| cnc_machine_daily_status | uk_machine_date | UNIQUE | 每天一条状态 |
+| cnc_machine_daily_status | idx_date_status | INDEX | 按天查状态 |
+| cnc_daily_production | uk_machine_date_program | UNIQUE | 机床+日+程序唯一 |
+| cnc_daily_production | idx_date | INDEX | 按日期查汇总 |
+| cnc_daily_production | idx_date_program | INDEX | 按日期+程序查 |
+| cnc_worker_daily_summary | uk_worker_date | UNIQUE | 工人+日唯一 |
+| cnc_worker_daily_summary | idx_date | INDEX | 按日期查工人汇总 |
+| cnc_worker_daily_summary | idx_date_quantity | INDEX | 排行榜查询 |
+| cnc_production_adjustment | idx_target | INDEX | 修正历史查询 |
+| cnc_production_adjustment | idx_created | INDEX | 审计日志时间查询 |
+| cnc_alert | idx_type_resolved | INDEX | 按类型查未处理 |
+| cnc_alert | idx_machine_time | INDEX | 机床告警历史 |
+| cnc_alert | idx_unresolved | INDEX | 未处理告警列表 |
+| log_collect_raw | idx_address_time | INDEX | 按地址查原始数据 |
+| log_collect_raw | idx_request_time | INDEX | 时间范围清理 |
+| log_system | idx_level_time | INDEX | 按级别查错误日志 |
+| log_system | idx_source_time | INDEX | 按来源查日志 |
+| log_collector_heartbeat | idx_service_time | INDEX | 服务最新状态 |
+| log_collector_heartbeat | idx_address_time | INDEX | 地址心跳历史 |
+
+共计：20张表，34个索引（含唯一索引）
--- a/docs/02-前端全局规范.md
+++ b/docs/02-前端全局规范.md
@ -0,0 +1,468 @@
+# CNC机床数据采集系统 - 前端全局规范
+
+> 最后更新：2026-04-25
+> 状态：设计中
+
+---
+
+## 说明
+
+本文档为**全局规范汇总**，定义所有页面通用的技术规则。各模块的页面设计（布局、字段、交互流程等）见 `docs/02-功能清单/管理后台/` 和 `docs/02-功能清单/大屏/` 对应模块子文件。
+
+---
+
+## 全局规范
+
+### 组件规范
+
+| 组件 | 用途 | 配置参数 |
+|------|------|---------|
+| el-table | 列表展示 | border, stripe, size=default, header-cell-style背景#f5f7fa |
+| el-table-column | 列定义 | show-overflow-tooltip=true 默认开启 |
+| el-pagination | 分页 | page-sizes=[20,50,100], background=true, layout=total,sizes,prev,pager,next,jumper |
+| el-form | 表单 | label-width=120px, label-position=right, size=default |
+| el-dialog | 弹窗 | close-on-click-modal=false, close-on-press-escape=true, destroy-on-close=true |
+| el-select | 下拉 | filterable=true, clearable=true |
+| el-date-picker | 日期 | type=daterange, value-format=YYYY-MM-DD, clearable=true |
+| el-input | 输入 | clearable=true, maxlength按字段定义 |
+| el-button | 按钮 | size=default, 操作类type=primary, 危险类type=danger |
+| el-message | 轻提示 | 成功success, 失败error, 警告warning |
+| el-message-box | 确认框 | type=warning |
+| el-tag | 状态标签 | size=small, 按状态配color |
+| el-tooltip | 提示 | placement=top |
+
+### 防重复请求
+
+- 所有写操作按钮点击后立即loading=true+disabled=true
+- 请求锁requestLock指令，同一按钮1秒内不可重复点击
+- axios拦截器，相同URL+参数的请求500ms内自动去重
+
+### 超时与加载反馈
+
+- API超时30秒(可配置)
+- 列表页v-loading指令
+- 弹窗提交按钮loading+弹窗内遮罩
+- 超时提示el-message error
+
+### 操作确认机制
+
+- 删除：确定删除【{name}】？此操作不可恢复。
+- 停用/启用：确定{操作}？
+- 批量操作：确定对选中的{N}项执行{操作}？
+- 产量修正：确定修正产量？修正后将记录审计日志。
+
+### 脏数据检测
+
+- 编辑弹窗关闭时：若表单有未保存修改，弹出确认
+- 表单组件内维护isDirty状态，对比初始值与当前值
+- 路由切换时：beforeRouteLeave守卫
+
+### 操作结果反馈
+
+| 场景 | 反馈方式 | 持续时间 |
+|------|---------|---------|
+| 创建成功 | el-message success {资源}创建成功 | 3秒 |
+| 修改成功 | el-message success 保存成功 | 3秒 |
+| 删除成功 | el-message success {资源}已删除 | 3秒 |
+| 操作失败 | el-message error {具体错误信息} | 5秒 |
+| 批量操作 | el-message info 已{操作}{N}项 | 3秒 |
+
+### 校验规则
+
+| 字段类型 | 规则 | 错误提示 | 触发时机 |
+|---------|------|---------|---------|
+| 必填 | required | 此项为必填 | blur |
+| IP地址 | pattern正则 | 请输入正确的IP地址 | blur |
+| URL | pattern正则 | 请输入正确的HTTP地址 | blur |
+| 数字 | type:number | 请输入数字 | blur |
+| 正整数 | pattern正则 | 请输入正整数 | blur |
+| 长度限制 | maxlength | 最多{N}个字符 | input |
+| 编码唯一 | async validator API调用 | 此{字段}已存在 | blur |
+
+### Mock数据规格
+
+成功响应: code=0, message=success, data=对象
+分页列表: code=0, data={items:[], total:160, page:1, pageSize:20}
+失败响应: code=40001, message=具体错误, data=null
+
+### 空状态设计
+
+| 场景 | 展示 |
+|------|------|
+| 列表无数据 | el-empty description=暂无数据 image-size=120 |
+| 查询无结果 | el-empty description=未找到匹配的数据，请调整查询条件 |
+| 图表无数据 | 居中显示暂无数据灰色文字 |
+
+### 错误码处理
+
+| 错误码 | 含义 | 前端处理 |
+|--------|------|---------|
+| 0 | 成功 | 正常处理data |
+| 40001 | 参数校验失败 | el-message error显示message |
+| 40002 | 资源不存在 | el-message warning+刷新列表 |
+| 40003 | 资源已存在 | el-message error+聚焦冲突字段 |
+| 40101 | Token无效/过期 | 清除Token跳转登录页 |
+| 50001 | 服务器内部错误 | el-message error服务器错误 |
+| 50002 | 采集服务不可达 | el-message warning采集服务未响应 |
+
+### 管理后台Layout
+
+```
+┌──────────────────────────────────────────────────────────┐
+│ [顶部栏] height=48px                                      │
+│ 左：系统名称「CNC机床数据采集系统」                         │
+│ 右：管理员 ▼ → [修改密码] [退出登录]                       │
+├────────┬─────────────────────────────────────────────────┤
+│ [侧边栏]│ [内容区] padding=20px                           │
+│ width=  │                                                 │
+│ 200px   │                                                 │
+│         │                                                 │
+│ 仪表盘  │                                                 │
+│ 设备管理│                                                 │
+│ 品牌模板│                                                 │
+│ 采集地址│                                                 │
+│ 员工管理│                                                 │
+│ 产量报表│                                                 │
+│ 告警中心│                                                 │
+│ 系统设置│                                                 │
+│ 操作日志│                                                 │
+│ 大屏配置│                                                 │
+├────────┤                                                 │
+│ [折叠]  │                                                 │
+└────────┴─────────────────────────────────────────────────┘
+```
+
+**顶部栏规范：**
+- 高度48px，背景色#409EFF（Element Plus primary），文字白色
+- 左侧：系统名称，font-size=16px，font-weight=bold
+- 右侧：管理员下拉菜单，el-dropdown，trigger=click
+  - [修改密码]：打开修改密码弹窗（见09-系统设置）
+  - [退出登录]：确认"确定退出登录？" → 清除Token → 跳转/login
+
+**侧边栏规范：**
+- 宽度200px，可折叠至64px（仅图标）
+- 折叠按钮：底部，el-icon Fold/Expand
+- 菜单项：el-menu，background=#304156，text=#bfcbd9，active-text=#409EFF
+- 当前路由自动高亮，使用 el-menu 的 default-active 绑定当前路由path
+- 菜单项无子菜单（均为一级），无折叠子菜单
+
+**侧边栏菜单项与路由映射：**
+
+| 菜单名称 | 路由 | 图标(el-icon) |
+|---------|------|-------------|
+| 仪表盘 | /dashboard | Odometer |
+| 设备管理 | /machine | Monitor |
+| 品牌模板 | /brand | PriceTag |
+| 采集地址 | /collect-address | Link |
+| 员工管理 | /worker | User |
+| 产量报表 | /production | DataAnalysis |
+| 告警中心 | /alert | Bell |
+| 系统设置 | /settings | Setting |
+| 操作日志 | /log | Document |
+| 大屏配置 | /screen-config | Monitor |（注意：与设备管理图标不同，用View或FullScreen）
+
+**内容区规范：**
+- padding=20px
+- 最大宽度不限（全宽）
+- 背景#f0f2f5
+- 面包屑在内容区顶部，非顶部栏中
+
+### 路由总表
+
+| 路由 | 组件 | 权限 | 需Token | 重定向/备注 |
+|------|------|------|---------|------------|
+| /login | LoginPage | 无 | 否 | 登录页，独立Layout（无侧边栏） |
+| / | Layout | admin | 是 | 管理后台框架，重定向→/dashboard |
+| /dashboard | DashboardPage | admin | 是 | 嵌套在Layout内 |
+| /machine | MachineListPage | admin | 是 | 嵌套在Layout内 |
+| /machine/:id | MachineDetailPage | admin | 是 | 嵌套在Layout内 |
+| /brand | BrandListPage | admin | 是 | 嵌套在Layout内 |
+| /brand/create | BrandEditPage | admin | 是 | 新增品牌 |
+| /brand/:id/edit | BrandEditPage | admin | 是 | 编辑品牌（复用同一组件） |
+| /collect-address | CollectAddressListPage | admin | 是 | 嵌套在Layout内 |
+| /collect-address/:id | CollectAddressDetailPage | admin | 是 | 嵌套在Layout内 |
+| /worker | WorkerListPage | admin | 是 | 嵌套在Layout内 |
+| /worker/:id | WorkerDetailPage | admin | 是 | 嵌套在Layout内 |
+| /production | ProductionPage | admin | 是 | 嵌套在Layout内 |
+| /alert | AlertPage | admin | 是 | 嵌套在Layout内 |
+| /settings | SettingsPage | admin | 是 | 嵌套在Layout内 |
+| /log | LogPage | admin | 是 | 嵌套在Layout内 |
+| /screen-config | ScreenConfigPage | admin | 是 | 嵌套在Layout内 |
+| /screen | ScreenPage | 无 | 否 | 大屏看板，独立Layout（全屏，无侧边栏） |
+
+### axios封装与路由守卫
+
+**axios实例配置：**
+- baseURL：'/'（同IIS站点，无跨域）
+- timeout：30000（30秒，可通过cnc_sys_config配置）
+- 请求拦截：自动添加 `Authorization: Bearer {token}` header（从localStorage取token）
+- 响应拦截：
+  - code=0 → 正常返回data
+  - code=40101 → 清除localStorage.token → router.push('/login') → 弹出el-message warning"登录已过期"
+  - code=40001/40002/40003/50001/50002 → 按错误码处理表执行
+  - HTTP状态码非200 → el-message error "网络异常"
+
+**路由守卫（router.beforeEach）：**
+- 访问/login → 如果localStorage有token → 重定向/dashboard
+- 访问/api/admin/**路由 → 如果localStorage无token → 重定向/login?redirect=当前路由
+- 访问/screen → 放行（免认证）
+- 其他 → 放行
+
+**Token管理：**
+- 存储：localStorage.setItem('token', value)
+- 读取：localStorage.getItem('token')
+- 清除：localStorage.removeItem('token')
+- 登录成功后跳转：redirect参数存在则跳redirect，否则跳/dashboard
+
+---
+
+## 前端工程开发规范
+
+> 最后更新：2026-04-26
+> 本章节为1:1可交互界面生成的工程实现规范
+
+### 技术栈
+
+| 类别 | 选型 | 版本要求 |
+|------|------|---------|
+| 框架 | Vue3 | >=3.4 |
+| 构建工具 | Vite | >=5.0 |
+| 语言 | TypeScript | >=5.0 |
+| UI组件库 | Element Plus | >=2.5 |
+| 路由 | Vue Router 4 | >=4.3 |
+| HTTP | Axios | >=1.6 |
+| 图表 | ECharts | >=5.5 |
+| Mock | vite-plugin-mock | >=3.0 |
+
+### 项目目录
+
+```
+D:\opencode\haoliang\frontend\
+├── index.html
+├── package.json
+├── tsconfig.json
+├── vite.config.ts                # mock插件 + proxy配置
+├── mock/                         # Mock数据定义（按模块拆分）
+│   ├── login.ts
+│   ├── dashboard.ts
+│   ├── machine.ts
+│   ├── brand.ts
+│   ├── collect-address.ts
+│   ├── worker.ts
+│   ├── production.ts
+│   ├── alert.ts
+│   ├── settings.ts
+│   ├── log.ts
+│   └── screen.ts
+└── src/
+    ├── main.ts
+    ├── App.vue
+    ├── router/
+    │   └── index.ts              # 路由定义（双套：正常路由 + /mock前缀路由）
+    ├── composables/
+    │   └── useMockMode.ts        # Mock模式检测
+    ├── utils/
+    │   └── request.ts            # axios封装（根据mock模式切换baseURL）
+    ├── layouts/
+    │   ├── AdminLayout.vue       # 管理后台Layout（顶部栏+侧边栏+内容区）
+    │   └── ScreenLayout.vue      # 大屏Layout（全屏独立）
+    ├── views/                    # 页面组件（按模块目录）
+    │   ├── login/
+    │   ├── dashboard/
+    │   ├── machine/
+    │   ├── brand/
+    │   ├── collect-address/
+    │   ├── worker/
+    │   ├── production/
+    │   ├── alert/
+    │   ├── settings/
+    │   ├── log/
+    │   ├── screen-config/
+    │   └── screen/
+    ├── styles/
+    │   ├── admin.scss            # 管理后台全局样式
+    │   └── screen.scss           # 大屏深色主题样式
+    └── types/                    # TypeScript类型定义
+```
+
+### Mock方案：URL前缀切换
+
+**核心规则：** 同一组件、同一套交互逻辑，仅axios请求路径不同。
+
+```
+/mock/dashboard  →  axios请求走 /mock-api/**  →  vite-plugin-mock拦截返回Mock JSON
+/dashboard       →  axios请求走 /api/**        →  Vite proxy转发到真实后端
+```
+
+#### 使用体验
+
+| 阶段 | URL | 行为 |
+|------|-----|------|
+| 开发阶段（后端未就绪） | `http://localhost:5173/mock/dashboard` | Mock数据完整展示 |
+| 开发阶段（后端未就绪） | `http://localhost:5173/dashboard` | 界面正常，API请求404 |
+| 后端就绪后 | `http://localhost:5173/dashboard` | 直接对接真实API |
+| 后端就绪后 | `http://localhost:5173/mock/dashboard` | 仍可切回Mock对比 |
+
+#### Mock模式检测
+
+```typescript
+// src/composables/useMockMode.ts
+// 根据 route.path.startsWith('/mock') 判断是否为Mock模式
+// 返回 computed<boolean> isMock
+```
+
+#### axios baseURL切换
+
+```typescript
+// src/utils/request.ts
+// if (isMock) baseURL = '/mock-api'
+// else      baseURL = '/api'
+// 其余拦截逻辑不变（Token/错误码/超时等）
+```
+
+#### 路由定义
+
+```typescript
+// src/router/index.ts
+// 函数生成两套路由：
+// 1. 正常路由：/dashboard, /machine, /login ...
+// 2. Mock前缀路由：/mock/dashboard, /mock/machine, /mock/login ...
+// 两套路由复用同一组件，Mock路由额外注入mock标识
+```
+
+#### Mock数据文件
+
+```
+mock/*.ts 文件内容来源：
+  - 各页面.md中的Mock数据章节
+  - 数据结构严格匹配页面.md中定义的JSON
+  - 一个模块一个文件，按API路径组织
+```
+
+#### Vite配置
+
+```typescript
+// vite.config.ts
+// 1. vite-plugin-mock 配置 mock/**.ts
+// 2. proxy 配置：
+//    /mock-api/** → mock插件拦截（开发环境）
+//    /api/**      → proxy到后端（可配置target，默认http://localhost:5800）
+```
+
+### CSS规范
+
+- 方案：Element Plus默认主题 + 局部scoped样式
+- 管理后台：Element Plus默认蓝色主题(#409EFF)，背景#f0f2f5
+- 大屏看板：独立深色主题(#0f0f1a背景/#1a1a2e卡片)，样式文件 `styles/screen.scss`
+- 不引入Tailwind CSS
+
+### 大屏独立规范
+
+- 独立Layout：`ScreenLayout.vue`（全屏，无侧边栏/面包屑）
+- 独立路由：`/screen` 和 `/mock/screen`
+- 独立主题：深色背景，通过 `screen.scss` 覆盖Element Plus默认样式
+- 免认证：`/api/screen/**` 不需要Token
+- 自动刷新：定时器按卡片配置的刷新策略轮询
+
+### 强制要求
+
+- **思考过程使用中文**：所有AI助手的推理、分析、思考过程必须使用中文输出
+- **控制台输出中文**：所有控制台输出、日志、提示信息使用中文，不得出现乱码
+- **所有文档使用中文**：项目内所有文档、注释、界面文案使用中文
+- **组件文案中文**：所有界面文字（按钮/标签/提示/空状态/确认框）必须使用中文
+- **代码注释中文**：所有代码注释使用中文
+
+---
+
+## CRUD页面必填项
+
+> 页面文件完整模板见 `功能清单文件夹创建规范.md` 第五节（共20项）。以下为本项目CRUD页面的**最小必填项**——20项的子集。未列出的项，若本模块有特殊需求则补充填写，无特殊需求则省略（继承全局规范即可）。
+
+**默认继承全局规范、页面文件无需重复填写的项目：**
+- 防重复请求(8)、超时与加载反馈(9)、操作确认机制(10)、操作结果反馈(12)、校验规则(14)、响应式布局(15)、空状态设计(18)、错误码处理(19)、安全规范(20)
+- 仅当本页面有**不同于全局规范**的特殊逻辑时，才在页面文件中补充对应项
+
+### 列表页必填项
+
+| 序号 | 必填项 | 说明 |
+|------|--------|------|
+| 1 | 基本信息 | 路由、权限、入口、面包屑 |
+| 2 | 界面布局 | ASCII图 |
+| 3 | 查询条件 | 字段/控件/必填/默认值/校验/联动，无筛选则写"无" |
+| 4 | 列表字段 | 字段名/列宽/排序/筛选/固定/超长处理/对齐 |
+| 5 | 操作按钮 | 名称/权限编码/位置/显示条件/点击行为 |
+| 6 | 弹窗规格 | 弹窗宽度/遮罩/ESC/表单字段定义，无弹窗则写"无" |
+| 7 | 状态机 | 状态值/颜色/可用操作，无状态则写"无" |
+| 8 | 交互流程 | 每个操作的主流程+异常处理 |
+| 9 | 空状态 | 列表无数据/查询无结果的展示 |
+
+**弹窗表单字段必填列：**
+
+| 列 | 说明 |
+|----|------|
+| 字段 | 中文名 |
+| 控件 | el-input/el-select等+具体参数 |
+| 必填 | 是/否 |
+| 默认值 | 无则写"-" |
+| 校验 | 必填/格式/唯一性等，无则写"-" |
+| 联动 | 值变化时影响哪些字段，无则写"-" |
+
+### 详情页必填项
+
+| 序号 | 必填项 | 说明 |
+|------|--------|------|
+| 1 | 基本信息 | 路由(含参数)、权限、入口、面包屑 |
+| 2 | 界面布局 | ASCII图 |
+| 3 | 数据区块 | 每个区块的展示字段+控件类型 |
+| 4 | 操作按钮 | 名称/位置/行为 |
+| 5 | 交互流程 | 加载/刷新/跳转 |
+
+### 统计/仪表盘页必填项
+
+| 序号 | 必填项 | 说明 |
+|------|--------|------|
+| 1 | 基本信息 | 路由、权限、入口、面包屑 |
+| 2 | 界面布局 | ASCII图（统计卡片+表格/图表区域） |
+| 3 | 数据区块 | 每个区块的数据来源API+刷新策略 |
+| 4 | 操作按钮 | 名称/位置/行为 |
+| 5 | 状态机 | 状态值/颜色（如有） |
+| 6 | 交互流程 | 加载/自动刷新/跳转 |
+| 7 | 空状态 | 各区块无数据的展示 |
+
+### 登录/特殊页必填项
+
+| 序号 | 必填项 | 说明 |
+|------|--------|------|
+| 1 | 基本信息 | 路由、入口 |
+| 2 | 界面布局 | ASCII图 |
+| 3 | 表单字段 | 字段/控件/校验（如有表单） |
+| 4 | 操作按钮 | 名称/行为 |
+| 5 | 交互流程 | 成功/失败/跳转 |
+| 6 | 安全规范 | Token存储/过期/登出策略 |
+
+---
+
+## 模块设计进度
+
+> 具体页面设计见 `docs/02-功能清单/管理后台/{编号}-{模块名}/` 对应子文件
+
+| 编号 | 模块 | 页面数 | 设计状态 | 备注 |
+|------|------|--------|---------|------|
+| 01 | 登录 | 1 | ✅ 已设计 | 见 `管理后台/01-登录/01-01-登录页面.md` |
+| 02 | 仪表盘 | 1 | ✅ 已设计 | 见 `管理后台/02-仪表盘/02-01-仪表盘页面.md` |
+| 03 | 设备管理 | 2 | ✅ 已设计 | 列表页+详情页，见 `管理后台/03-设备管理/` |
+| 04 | 品牌模板 | 2 | ✅ 已设计 | 列表页+编辑页，见 `管理后台/04-品牌模板/` |
+| 05 | 采集地址 | 2 | ✅ 已设计 | 列表页+详情页(采集历史+原始JSON)，见 `管理后台/05-采集地址/` |
+| 06 | 员工管理 | 2 | ✅ 已设计 | 列表页+详情页，见 `管理后台/06-员工管理/` |
+| 07 | 产量报表 | 1 | ✅ 已设计 | 含修正+导出+数据缺失标记，见 `管理后台/07-产量报表/` |
+| 08 | 告警中心 | 1 | ✅ 已设计 | 含批量标记+统计，见 `管理后台/08-告警中心/` |
+| 09 | 系统设置 | 1 | ✅ 已设计 | 3Tab:配置项+车间管理+修改密码，见 `管理后台/09-系统设置/` |
+| 10 | 车间管理 | - | 🔀 已合并 | 合并至09-系统设置 |
+| 11 | 操作日志 | 1 | ✅ 已设计 | 双Tab:修正审计日志+系统运行日志，见 `管理后台/11-操作日志/` |
+| 12 | 大屏配置 | 1 | ✅ 已设计 | 见 `管理后台/12-大屏配置/12-01-大屏配置页面.md` |
+
+**大屏模块：**
+
+| 编号 | 模块 | 页面数 | 设计状态 | 备注 |
+|------|------|--------|---------|------|
+| 大屏-01 | 大屏看板 | 1 | ✅ 已设计 | 免认证，深色主题，卡片式自动刷新，见 `大屏/01-01-大屏看板页面.md` |
--- a/docs/02-功能清单/00-功能清单索引.md
+++ b/docs/02-功能清单/00-功能清单索引.md
@ -0,0 +1,15 @@
+# 功能清单 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 分类
+
+| 分类 | 类型 | 索引 |
+|------|------|------|
+| 管理后台 | 文件夹 | [00-管理后台-索引.md](./管理后台/00-管理后台-索引.md) |
+| 大屏 | 文件夹 | [00-大屏-索引.md](./大屏/00-大屏-索引.md) |
+
+---
--- a/docs/02-功能清单/01-功能清单规范.md
+++ b/docs/02-功能清单/01-功能清单规范.md
@ -0,0 +1,10 @@
+# 功能清单 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承 `02-前端全局规范.md` 中定义的全局规范。如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/02-文件夹创建规范.md
+++ b/docs/02-功能清单/02-文件夹创建规范.md
@ -0,0 +1,198 @@
+# 功能清单文件夹创建规范
+
+---
+
+### 一、目录结构模板
+
+```
+00-功能清单索引.md
+01-功能清单规范.md
+│
+├── 管理后台\
+│   ├── 00-管理后台-索引.md
+│   ├── 01-管理后台-规范.md
+│   ├── 01-登录\
+│   │   ├── 00-登录-索引.md
+│   │   ├── 01-登录-规范.md
+│   │   └── 01-01-登录页面.md
+│   ├── 02-仪表盘\
+│   │   ├── 00-仪表盘-索引.md
+│   │   ├── 01-仪表盘-规范.md
+│   │   └── 02-01-仪表盘页面.md
+│   └── ...
+│
+└── 大屏\
+    ├── 00-大屏-索引.md
+    ├── 01-大屏-规范.md
+    └── 01-01-大屏看板页面.md
+```
+
+---
+
+### 二、文件命名规则
+
+| 文件类型 | 命名规则 | 示例 |
+|---------|---------|------|
+| 总索引 | `00-功能清单索引.md` | - |
+| 总规范 | `01-功能清单规范.md` | - |
+| 分类索引 | `00-{分类名}-索引.md` | `00-管理后台-索引.md` |
+| 分类规范 | `01-{分类名}-规范.md` | `01-管理后台-规范.md` |
+| 模块索引 | `00-{模块名}-索引.md` | `00-登录-索引.md` |
+| 模块规范 | `01-{模块名}-规范.md` | `01-登录-规范.md` |
+| 页面文件 | `{模块号}-{页面号}-{页面名}.md` | `01-01-登录页面.md` |
+
+**编号规则**：
+- 模块号：01-99（两位数）
+- 页面号：01-99（两位数）
+- 格式：`{模块号}-{页面号}-{页面名}.md`
+
+---
+
+### 三、索引文件内容规则
+
+#### 1. 总索引
+
+```markdown
+# 功能清单 索引
+
+> 版本：v1.0
+> 最后更新：日期
+
+---
+
+## 分类
+
+| 分类 | 类型 | 索引 |
+|------|------|------|
+| 管理后台 | 文件夹 | [00-管理后台-索引.md](./管理后台/00-管理后台-索引.md) |
+| 大屏 | 文件夹 | [00-大屏-索引.md](./大屏/00-大屏-索引.md) |
+
+---
+```
+
+#### 2. 分类索引
+
+```markdown
+# {分类名} 索引
+
+> 版本：v1.0
+> 最后更新：日期
+
+---
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 01 | 登录 | 文件夹 | [01-登录](./01-登录) |
+| 02 | 仪表盘 | 文件夹 | [02-仪表盘](./02-仪表盘) |
+
+---
+```
+
+#### 3. 模块索引
+
+```markdown
+# {模块名} 索引
+
+> 版本：v1.0
+> 最后更新：日期
+
+---
+
+## 模块概述
+[简要说明本模块的功能定位、业务场景]
+
+## 页面清单
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+
+## 页面功能详情
+
+### {页面号} {页面名称}
+**路由**：`/xxx`
+**功能概述**：[简要]
+
+**功能列表**：
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+
+**状态机**：[如有]
+
+**路由跳转**：[本模块内 + 跨模块跳转]
+
+## 子目录/文件
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+
+---
+```
+
+---
+
+### 四、规范文件内容规则
+
+| 层级 | 内容 |
+|------|------|
+| 总规范 | 整体规范，所有模块通用 |
+| 分类规范 | 本分类通用规范 |
+| 模块规范 | 无特殊规范时写"继承上级规范，如有冲突按本目录规范执行" |
+
+---
+
+### 五、页面文件规则（20项模板，按组分类）
+
+页面文件保持20项模板不变，用空行分组提升可读性。
+
+#### 【结构定义】
+
+| 序号 | 内容 | 说明 |
+|------|------|------|
+| 1 | 基本信息 | 路由、权限、入口、面包屑 |
+| 2 | 界面布局 | ASCII图、响应式断点 |
+| 3 | 表单字段 | 字段定义、控件、校验 |
+| 4 | 操作按钮 | 权限、位置、行为 |
+| 5 | 弹窗规格 | 无/弹窗类型 |
+| 6 | 状态机 | 状态值、颜色、流转 |
+
+#### 【交互行为】
+
+| 序号 | 内容 | 说明 |
+|------|------|------|
+| 7 | 交互流程 | 成功/失败处理 |
+| 8 | 防重复请求 | 按钮禁用、AbortController |
+| 9 | 超时与加载反馈 | 超时时间、loading方式 |
+| 10 | 操作确认机制 | 确认文案 |
+| 11 | 脏数据检测 | 快照、重置 |
+| 12 | 操作结果反馈 | 反馈方式、持续时间 |
+| 14 | 校验规则 | 正则、错误提示、触发时机 |
+| 15 | 响应式布局 | 断点布局 |
+
+#### 【技术实现】
+
+| 序号 | 内容 | 说明 |
+|------|------|------|
+| 13 | 组件规范 | 组件选择、配置 |
+| 16 | Mock数据规格 | 完整Request/Response示例 |
+| 17 | 键盘操作 | 快捷键 |
+| 18 | 空状态设计 | 空态展示 |
+| 19 | 错误码处理 | 错误码映射 |
+| 20 | 安全规范 | 加密、存储、防护 |
+
+---
+
+### 六、三种文件分工
+
+| 文件类型 | 重点内容 | 所属 |
+|---------|---------|------|
+| 索引文件 | 功能逻辑、交互关系、路由跳转、状态机 | 模块 |
+| 规范文件 | 技术规范要求（组件、校验、布局、安全） | 模块/分类 |
+| 页面文件 | 技术实现（界面布局、字段、Mock数据） | 页面 |
+
+---
+
+### 七、创建顺序
+
+1. 创建根目录索引+规范
+2. 创建分类目录+分类索引+规范
+3. 创建模块目录+模块索引+规范
+4. 创建页面文件
--- a/docs/02-功能清单/03-界面变更执行规范.md
+++ b/docs/02-功能清单/03-界面变更执行规范.md
@ -0,0 +1,89 @@
+# 界面变更执行规范
+
+> 本规范供AI助手执行界面变更时遵循，确保最小阅读量+最大覆盖度。
+
+---
+
+## 一、动手前必读（最小文件集）
+
+AI助手执行任何界面变更前，只需读以下文件：
+
+| 优先级 | 文件 | 读的目的 |
+|--------|------|---------|
+| 必须 | `docs/02-前端全局规范.md` | 全局规范+Layout+路由总表+CRUD必填项+模块进度+工程开发规范（确认当前状态） |
+| 必须 | `docs/02-功能清单/02-文件夹创建规范.md` | 文件命名规则+创建顺序 |
+| 按需 | 目标模块的 `00-{模块名}-索引.md` | 了解本模块页面清单+路由跳转 |
+| 按需 | 目标模块的页面文件 | 了解要修改的页面的当前设计 |
+| 按需 | `docs/00-文档进度总览.md` | 仅当涉及新增/删除/状态变更时 |
+
+**禁止**：读 `01-数据库设计.md`、`00-需求与设计文档.md` 等大文件，除非变更确实涉及数据库或核心需求。
+
+---
+
+## 二、变更执行清单
+
+### A. 新增页面
+
+1. 确认模块编号和页面编号（读索引文件）
+2. 创建页面文件，命名：`{模块号}-{页面号}-{页面名}.md`
+3. 按 `02-前端全局规范.md` 中对应页面类型的必填项填写
+4. 界面布局使用 box-drawing 样式（┌───┐），首行放面包屑
+5. 页面末尾增加「数据需求」章节
+6. 更新模块索引文件（页面清单+功能详情+子目录表）
+7. 更新 `02-前端全局规范.md` 模块进度表
+8. 更新 `00-文档进度总览.md`
+
+### B. 修改页面
+
+1. 读取目标页面文件 + 模块索引文件
+2. 修改页面内容（保留已有结构，只改变更部分）
+3. 如果修改涉及路由/跳转/状态机 → 同步更新模块索引文件
+4. 如果修改涉及新增数据需求 → 同步更新「数据需求」章节
+5. 不需要更新进度文件（修改不改状态）
+
+### C. 新增模块
+
+1. 读 `02-文件夹创建规范.md` 确认命名规则
+2. 创建模块目录：`{编号}-{模块名}/`
+3. 创建3个文件：`00-{模块名}-索引.md` + `01-{模块名}-规范.md` + `{模块号}-01-{页面名}.md`
+4. 规范文件写"继承上级规范"
+5. 索引文件按模板填写
+6. 页面文件按必填项填写
+7. 更新 `管理后台/00-管理后台-索引.md`（子目录表）
+8. 更新 `02-前端全局规范.md` 模块进度表
+9. 更新 `00-文档进度总览.md`
+
+---
+
+## 三、联动同步规则
+
+**规则1**：改了页面文件的路由或跳转 → 必须同步该模块的索引文件；如果跳转跨模块，还要同步目标模块的索引文件
+
+**规则2**：页面新增了数据字段或接口需求 → 必须同步该页面的「数据需求」章节
+
+**规则3**：新增或删除了页面文件 → 必须同步：模块索引文件 + `02-前端全局规范.md`的模块进度表 + `00-文档进度总览.md`
+
+**规则4**：新增了模块目录 → 必须同步：`管理后台/00-管理后台-索引.md` + `02-前端全局规范.md`的模块进度表 + `00-文档进度总览.md`
+
+**规则5**：修改了`02-前端全局规范.md`中的全局规范 → 必须检查各模块规范文件是否冲突
+
+**记忆口诀**：改页面→查索引；改路由→查双向索引；增删页面/模块→三处同步（索引+进度表+总览）
+
+---
+
+## 四、界面布局规范
+
+- 样式：box-drawing（┌───┐├───┤└───┘│），不用 +---+
+- 首行：面包屑，格式 `[面包屑] 首页 / 模块名 / 子页名`
+- 分区标签：方括号标注，如 `[查询条件区]` `[列表区]` `[操作栏]`
+- 字段对齐：用竖线 `|` 分隔，表头和数据行对齐
+
+---
+
+## 五、禁止事项
+
+- 禁止读大文件获取上下文（除非变更确实涉及）
+- 禁止跳过联动同步（改了页面不更新索引）
+- 禁止修改全局规范而不检查模块兼容性
+- 禁止在页面文件中重复全局规范已有内容
+- 禁止使用旧样式 `+---+` 画界面布局
--- a/docs/02-功能清单/大屏/00-大屏-索引.md
+++ b/docs/02-功能清单/大屏/00-大屏-索引.md
@ -0,0 +1,45 @@
+# 大屏 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+生产数据大屏看板，Chrome无人值守全屏展示，免认证。固定布局+卡片指标可配+筛选可配+图表类型可选。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 01-01 | 大屏看板页面 | /screen | 待设计 |
+
+## 页面功能详情
+
+### 01-01 大屏看板页面
+**路由**：`/screen`
+**功能概述**：生产数据大屏看板，Chrome无人值守全屏展示，免认证。深色主题，卡片式布局，自动刷新
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 加载看板 | 页面进入 | 并行请求所有卡片数据+筛选配置 | GET /api/screen/* |
+| F02 | 筛选切换 | 选择车间/品牌 | 刷新所有卡片数据(附加筛选参数) | 同上 |
+| F03 | 自动刷新 | 定时器触发 | 按卡片刷新策略轮询 | 同上 |
+
+**业务规则**：
+- 免认证访问（/api/screen/**无Token要求）
+- 卡片排列/启停/排序由管理后台大屏配置(cnc_screen_config)决定
+- 筛选选项由管理后台大屏筛选配置(cnc_screen_filter)决定
+- 全局刷新间隔由cnc_sys_config.bigscreen_refresh_interval控制（默认10秒）
+- 1920x1080优化，深色主题，一屏展示
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 01-01 | 大屏看板页面 | 页面文件 | [01-01-大屏看板页面.md](./01-01-大屏看板页面.md) |
+
+---
--- a/docs/02-功能清单/大屏/01-01-大屏看板页面.md
+++ b/docs/02-功能清单/大屏/01-01-大屏看板页面.md
@ -0,0 +1,204 @@
+# 大屏看板页面
+
+> 最后更新：2026-04-26
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /screen |
+| 权限 | 无（免认证） |
+| 入口 | 浏览器直接访问 /screen，管理后台大屏配置页"预览"按钮 |
+| 面包屑 | 无（全屏独立Layout） |
+
+### 2. 界面布局
+
+```
+┌──────────────────────────────────────────────────────────┐
+│ [顶部栏] height=50px  深色背景#1a1a2e                      │
+│ 左：CNC机床数据采集系统                        │
+│ 右：[车间▼A栋] [品牌▼全部]           2026-04-25 17:36:38   │
+├──────────────────────────────────────────────────────────┤
+│ [第一行：统计数字卡片] height=100px                        │
+│ ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐       │
+│ │在线机床│  │今日总产│  │采集服务│  │活跃告警│  │平均产量│       │
+│ │  142  │  │ 8,520│  │ 运行中 │  │   3  │  │  60  │       │
+│ │ /160  │  │      │  │3天16时 │  │      │ │/台   │       │
+│ └──────┘  └──────┘  └──────┘  └──────┘  └──────┘       │
+├──────────────────────────────────────────────────────────┤
+│ [第二行：图表区] height=300px                             │
+│ ┌────────────────────┐  ┌────────────────────┐           │
+│ │  各车间产量(柱状图)  │  │  产量趋势7天(折线图) │           │
+│ │  ████              │  │  ╱╲    ╱╲          │           │
+│ │  ████ ██           │  │ ╱  ╲╱╱  ╲         │           │
+│ │  A栋  B栋 C栋      │  │ 4/19  ...  4/25    │           │
+│ └────────────────────┘  └────────────────────┘           │
+├──────────────────────────────────────────────────────────┤
+│ [第三行：排行+状态] height=auto(填满剩余)                  │
+│ ┌──────────────┐  ┌──────────────┐  ┌──────────────┐   │
+│ │ 机床产量排行   │  │ 工人产量排行   │  │ 机床状态总览   │   │
+│ │ 1.西-1.8  580│  │ 1.张三   1240│  │ ■■■■□□■■■□  │   │
+│ │ 2.西-1.10 420│  │ 2.李四    980│  │ ■■□□■■■■□■  │   │
+│ │ 3.东-2.0  380│  │ 3.王五    870│  │ ■=在线 □=离线 │   │
+│ └──────────────┘  └──────────────┘  └──────────────┘   │
+└──────────────────────────────────────────────────────────┘
+```
+
+**布局说明：**
+- 全屏展示，1920x1080优化，Chrome全屏模式(F11)
+- 深色主题：背景#0f0f1a，卡片背景#1a1a2e，文字白色/浅灰
+- 无侧边栏、无面包屑、无滚动条（一屏展示所有内容）
+- 卡片排列由管理后台"大屏配置"页面控制（排序/启停/类型）
+- 以上布局为默认配置，卡片增减/顺序由cnc_screen_config决定
+
+### 3. 数据区块
+
+| 区块 | card_type | 数据来源API | 刷新策略 |
+|------|-----------|-----------|---------|
+| 在线机床数 | stat_number | /api/screen/summary | 每10秒(可配) |
+| 今日总产量 | stat_number | /api/screen/summary | 每10秒 |
+| 采集服务状态 | stat_number | /api/screen/collector-status | 每10秒 |
+| 活跃告警 | stat_number | /api/screen/summary | 每10秒 |
+| 平均产量 | stat_number | /api/screen/summary | 每10秒 |
+| 各车间产量 | bar_chart | /api/screen/workshop-production | 每60秒 |
+| 产量趋势7天 | line_chart | /api/screen/production-trend | 每300秒 |
+| 机床产量排行 | rank_list | /api/screen/machine-rank | 每60秒 |
+| 工人产量排行 | rank_list | /api/screen/worker-rank | 每60秒 |
+| 机床状态总览 | status_grid | /api/screen/machine-status | 每10秒 |
+
+### 4. 操作按钮
+
+| 名称 | 位置 | 显示条件 | 点击行为 |
+|------|------|---------|---------|
+| 车间筛选 | 顶部栏右侧 | 始终 | 下拉切换，刷新所有卡片数据 |
+| 品牌筛选 | 顶部栏右侧 | 始终 | 下拉切换，刷新所有卡片数据 |
+| 全屏切换 | 顶部栏右侧 | 始终 | F11全屏/退出全屏 |
+
+说明：筛选器为只读展示，可选项由管理后台大屏配置(cnc_screen_filter)定义。默认选中项由is_default字段决定。
+
+### 5. 状态机
+
+采集服务状态：
+- running(运行中): 绿色脉冲圆点 + "运行中" + uptime
+- stopped(已停止): 红色圆点 + "已停止" + 最后心跳时间
+
+机床状态(status_grid)：
+- 在线(is_online=1): 绿色方块■
+- 离线(is_online=0): 灰色方块□
+
+### 6. 交互流程
+
+- 加载：请求筛选配置->设置默认筛选->并行请求所有卡片数据->渲染
+- 自动刷新：定时器按卡片配置的刷新策略轮询（全局默认10秒，可通过cnc_sys_config.bigscreen_refresh_interval配置）
+- 筛选切换：选车间/品牌->所有API请求附加筛选参数->刷新所有卡片
+- 全屏：首次进入自动提示"按F11进入全屏模式"（el-message info，5秒后消失）
+- 无交互操作：鼠标悬停卡片有轻微发光效果，无点击跳转
+
+### 7. 空状态
+
+- 统计数字无数据：显示"--"
+- 图表无数据：居中灰色文字"暂无数据"
+- 排行榜无数据：灰色文字"暂无数据"
+- 状态网格无机床：灰色文字"暂无机床"
+
+### 8. Mock数据
+
+**GET /api/screen/summary 统计摘要：**
+
+```json
+{ "code": 0, "data": { "onlineCount": 142, "totalMachines": 160, "todayProduction": 8520, "activeAlerts": 3, "avgQuantityPerMachine": 60 }}
+```
+
+**GET /api/screen/collector-status 采集服务状态：**
+
+```json
+{ "code": 0, "data": { "status": "running", "uptime": "3天16小时", "successCount": 12800, "failCount": 5, "lastCollectTime": "2026-04-25T17:36:38" }}
+```
+
+**GET /api/screen/workshop-production 各车间产量：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "name": "A栋", "quantity": 3200 },
+  { "name": "B栋", "quantity": 2800 },
+  { "name": "C栋", "quantity": 2520 }
+]}}
+```
+
+**GET /api/screen/production-trend 7天产量趋势：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "date": "04-19", "quantity": 8200 }, { "date": "04-20", "quantity": 7600 },
+  { "date": "04-21", "quantity": 9100 }, { "date": "04-22", "quantity": 8500 },
+  { "date": "04-23", "quantity": 7800 }, { "date": "04-24", "quantity": 9000 },
+  { "date": "04-25", "quantity": 8520 }
+]}}
+```
+
+**GET /api/screen/machine-rank 机床产量排行：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "rank": 1, "machineName": "西-1.8", "quantity": 580 },
+  { "rank": 2, "machineName": "西-1.10", "quantity": 420 },
+  { "rank": 3, "machineName": "东-2.0", "quantity": 380 },
+  { "rank": 4, "machineName": "东-2.5", "quantity": 310 },
+  { "rank": 5, "machineName": "南-3.1", "quantity": 290 }
+]}}
+```
+
+**GET /api/screen/worker-rank 工人产量排行：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "rank": 1, "workerName": "张三", "quantity": 1240 },
+  { "rank": 2, "workerName": "李四", "quantity": 980 },
+  { "rank": 3, "workerName": "王五", "quantity": 870 },
+  { "rank": 4, "workerName": "赵六", "quantity": 650 },
+  { "rank": 5, "workerName": "孙七", "quantity": 520 }
+]}}
+```
+
+**GET /api/screen/machine-status 机床状态网格：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "machineId": 1, "machineName": "西-1.8", "isOnline": 1 },
+  { "machineId": 2, "machineName": "西-1.10", "isOnline": 1 },
+  { "machineId": 3, "machineName": "东-2.0", "isOnline": 0 },
+  { "machineId": 4, "machineName": "东-2.5", "isOnline": 0 },
+  { "machineId": 5, "machineName": "南-3.1", "isOnline": 1 }
+]}}
+```
+
+**GET /api/screen/filters 筛选选项（从cnc_screen_filter读取）：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "filterType": "workshop", "filterValue": "A栋", "isDefault": 1 },
+  { "filterType": "workshop", "filterValue": "B栋", "isDefault": 0 },
+  { "filterType": "brand", "filterValue": "FANUC", "isDefault": 0 }
+]}}
+```
+
+### 9. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 统计摘要 | cnc_machine + cnc_daily_production | 聚合查询 |
+| 采集服务状态 | log_collector_heartbeat | 查最新一条心跳 |
+| 各车间产量 | cnc_daily_production + cnc_machine + cnc_workshop | 按车间聚合 |
+| 产量趋势 | cnc_daily_production | 近7天按日聚合 |
+| 机床排行 | cnc_daily_production + cnc_machine | 按机床聚合TOP N |
+| 工人排行 | cnc_worker_daily_summary | 按工人聚合TOP N |
+| 机床状态 | cnc_machine.is_online | 全量查询 |
+| 筛选配置 | cnc_screen_filter | 筛选可选项+默认值 |
+| 卡片配置 | cnc_screen_config | 哪些卡片启用+排序+图表配置 |
+
+**注意：大屏API（/api/screen/**）免认证，但仅限读取，不暴露管理接口。**
--- a/docs/02-功能清单/大屏/01-大屏-规范.md
+++ b/docs/02-功能清单/大屏/01-大屏-规范.md
@ -0,0 +1,10 @@
+# 大屏 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/00-管理后台-索引.md
+++ b/docs/02-功能清单/管理后台/00-管理后台-索引.md
@ -0,0 +1,25 @@
+# 管理后台 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 01 | 登录 | 文件夹 | [01-登录](./01-登录) |
+| 02 | 仪表盘 | 文件夹 | [02-仪表盘](./02-仪表盘) |
+| 03 | 设备管理 | 文件夹 | [03-设备管理](./03-设备管理) |
+| 04 | 品牌模板 | 文件夹 | [04-品牌模板](./04-品牌模板) |
+| 05 | 采集地址 | 文件夹 | [05-采集地址](./05-采集地址) |
+| 06 | 员工管理 | 文件夹 | [06-员工管理](./06-员工管理) |
+| 07 | 产量报表 | 文件夹 | [07-产量报表](./07-产量报表) |
+| 08 | 告警中心 | 文件夹 | [08-告警中心](./08-告警中心) |
+| 09 | 系统设置 | 文件夹 | [09-系统设置](./09-系统设置) |
+| 10 | 车间管理 | 文件夹 | [10-车间管理](./10-车间管理) |
+| 11 | 操作日志 | 文件夹 | [11-操作日志](./11-操作日志) |
+| 12 | 大屏配置 | 文件夹 | [12-大屏配置](./12-大屏配置) |
+
+---
--- a/docs/02-功能清单/管理后台/01-登录/00-登录-索引.md
+++ b/docs/02-功能清单/管理后台/01-登录/00-登录-索引.md
@ -0,0 +1,43 @@
+# 登录 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+管理后台登录页，单角色admin，Token认证机制。未登录或Token过期自动跳转。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 01-01 | 登录页面 | /login | 用户名+密码登录，Token认证，记住我 |
+
+## 页面功能详情
+
+### 01-01 登录页面
+**路由**：`/login`
+**功能概述**：管理后台唯一入口，用户名密码登录，Token存localStorage，支持"记住我"延长有效期
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 登录 | 点击登录按钮 | 校验->调API->存Token->跳转仪表盘 | POST /api/admin/login |
+| F02 | Token过期跳转 | API返回40101 | 清除Token->跳转登录页(带redirect) | - |
+| F03 | 登录失败 | API返回错误 | 显示错误提示->清空密码框 | - |
+
+**安全规范**：Token有效期默认8小时，记住我7天；统一错误提示防信息泄露；后端IP锁定防暴力破解
+
+**路由跳转**：
+- 登录成功 -> 仪表盘(/dashboard) 或 redirect参数指定的页面
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 01-01 | 登录页面 | 页面文件 | [01-01-登录页面.md](./01-01-登录页面.md) |
+
+---
--- a/docs/02-功能清单/管理后台/01-登录/01-01-登录页面.md
+++ b/docs/02-功能清单/管理后台/01-登录/01-01-登录页面.md
@ -0,0 +1,96 @@
+# 登录页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /login |
+| 入口 | 未登录时自动跳转，或Token过期后跳转 |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│                                                          │
+│              ┌────────────────────────┐                  │
+│              │ CNC机床数据采集系统      │                  │
+│              │                        │                  │
+│              │ 用户名：[____________]  │                  │
+│              │ 密  码：[____________]  │                  │
+│              │                        │                  │
+│              │ [√ 记住我]             │                  │
+│              │                        │                  │
+│              │       [登  录]         │                  │
+│              └────────────────────────┘                  │
+│                                                          │
+└──────────────────────────────────────────────────────────┘
+
+### 3. 表单字段
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 用户名 | el-input maxlength=50 | 是 | - | 必填 | - |
+| 密码 | el-input type=password maxlength=50 show-password | 是 | - | 必填 | - |
+| 记住我 | el-checkbox | 否 | 不勾选 | - | 勾选后Token有效期延长 |
+
+### 4. 操作按钮
+
+| 名称 | 位置 | 显示条件 | 点击行为 |
+|------|------|---------|---------|
+| 登录 | 表单底部 | 始终 | 校验→调登录API→成功存Token跳转仪表盘 |
+
+### 5. 交互流程
+
+- 进入：未登录访问管理后台→axios拦截40101→清除旧Token→router.push(/login)
+- 登录：填写用户名+密码→点击登录→loading+disabled→调登录API→成功→存Token到localStorage→跳转/dashboard
+- 登录失败：用户名或密码错误→el-message error显示错误信息→密码框清空+聚焦
+- Token过期：访问任意管理后台页面→API返回40101→清除Token→跳转/login（带redirect参数，登录后跳回原页面）
+
+### 6. 安全规范
+
+| 项 | 规则 |
+|----|------|
+| Token存储 | localStorage，key=token |
+| Token传递 | Authorization: Bearer {token} |
+| Token有效期 | 默认8小时，勾选"记住我"延长至7天 |
+| Token刷新 | 不做刷新机制，过期直接跳转登录页 |
+| 密码传输 | HTTPS（生产环境），开发环境HTTP |
+| 登录失败提示 | 统一提示"用户名或密码错误"，不区分是哪个错 |
+| 防暴力破解 | 同一IP连续5次失败，锁定15分钟（后端实现） |
+| 单角色 | 仅admin角色，无角色切换，无注册功能 |
+
+### 7. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 用户名/密码验证 | 后端硬编码或配置文件 | 单角色admin，无需用户表 |
+| Token生成与验证 | cnc_sys_config (api_token) | Token值存配置表，但登录流程需后端生成JWT或类似Token |
+| Token有效期 | cnc_sys_config | 记住我模式下延长有效期 |
+
+### 8. Mock数据
+
+**POST /api/admin/login 成功：**
+```json
+{ "code": 0, "message": "success", "data": { "token": "eyJhbGciOiJIUzI1NiJ9.admin.8h", "expiresIn": 28800 }}
+```
+
+**POST /api/admin/login 成功（记住我）：**
+```json
+{ "code": 0, "message": "success", "data": { "token": "eyJhbGciOiJIUzI1NiJ9.admin.7d", "expiresIn": 604800 }}
+```
+
+**POST /api/admin/login 失败：**
+```json
+{ "code": 40001, "message": "用户名或密码错误", "data": null }
+```
+
+**POST /api/admin/login 失败（IP锁定）：**
+```json
+{ "code": 40003, "message": "登录失败次数过多，请15分钟后重试", "data": null }
+```
--- a/docs/02-功能清单/管理后台/01-登录/01-登录-规范.md
+++ b/docs/02-功能清单/管理后台/01-登录/01-登录-规范.md
@ -0,0 +1,10 @@
+# 登录 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/01-管理后台-规范.md
+++ b/docs/02-功能清单/管理后台/01-管理后台-规范.md
@ -0,0 +1,10 @@
+# 管理后台 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/02-仪表盘/00-仪表盘-索引.md
+++ b/docs/02-功能清单/管理后台/02-仪表盘/00-仪表盘-索引.md
@ -0,0 +1,46 @@
+# 仪表盘 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+系统首页，展示今日生产概览（在线机床数、产量、告警）及排行数据，提供采集服务状态监控与控制。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 02-01 | 仪表盘页面 | /dashboard | 统计卡片+采集服务状态+机床/工人产量排行 |
+
+## 页面功能详情
+
+### 02-01 仪表盘页面
+**路由**：`/dashboard`
+**功能概述**：展示在线机床数/今日产量/活跃告警统计卡片、采集服务运行状态（可启停/刷新）、机床产量排行TOP10、工人产量排行TOP10
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 加载仪表盘数据 | 页面挂载 | 4个API并行请求 | 统计卡片/机床排行/工人排行/服务状态 |
+| F02 | 自动刷新 | 定时器触发 | 重新请求所有数据 | 同F01 |
+| F03 | 停止采集 | 点击停止按钮+服务running | 确认->调API | 采集服务控制API |
+| F04 | 启动采集 | 点击启动按钮+服务stopped/error | 确认->调API | 采集服务控制API |
+| F05 | 刷新配置 | 点击刷新按钮+服务running | 确认->调API | 采集服务控制API |
+
+**路由跳转**：
+- 机床名称 -> 设备详情页(/machine/:id)
+- 工人名称 -> 员工详情页(待设计)
+- 查看全部(机床排行) -> 产量报表(待设计)
+- 查看全部(工人排行) -> 产量报表(待设计)
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 02-01 | 仪表盘页面 | 页面文件 | [02-01-仪表盘页面.md](./02-01-仪表盘页面.md) |
+
+---
--- a/docs/02-功能清单/管理后台/02-仪表盘/01-仪表盘-规范.md
+++ b/docs/02-功能清单/管理后台/02-仪表盘/01-仪表盘-规范.md
@ -0,0 +1,10 @@
+# 仪表盘 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/02-仪表盘/02-01-仪表盘页面.md
+++ b/docs/02-功能清单/管理后台/02-仪表盘/02-01-仪表盘页面.md
@ -0,0 +1,135 @@
+# 仪表盘页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /dashboard |
+| 权限 | admin（全局Token） |
+| 入口 | 侧边栏仪表盘，登录后默认页 |
+| 面包屑 | 首页 / 仪表盘 |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 仪表盘                          2026-04-24│
+├──────────────────────────────────────────────────────────┤
+│ [统计卡片区]                                              │
+│ ┌────────────┐  ┌────────────┐  ┌────────────┐          │
+│ │ 在线机床    │  │ 今日产量    │  │ 活跃告警    │          │
+│ │ 142/160    │  │ 2,847      │  │ 3          │          │
+│ └────────────┘  └────────────┘  └────────────┘          │
+│ 采集服务：[状态]  运行3天12小时  上次采集3秒前              │
+│ [停止/启动采集]  [刷新配置]                                 │
+├──────────────────────────────────────────────────────────┤
+│ [机床产量排行区]                        [查看全部]          │
+│ 排名 | 机床名称 | 当前程序 | 产量  | 状态                   │
+│ 1    | 西-1.8   | 1566.NC | 580   | 在线                  │
+├──────────────────────────────────────────────────────────┤
+│ [工人产量排行区]                        [查看全部]          │
+│ 排名 | 工人姓名 | 负责机床数 | 总产量                       │
+│ 1    | 张三     | 3         | 1,240                       │
+└──────────────────────────────────────────────────────────┘
+
+### 3. 数据区块
+
+| 区块 | 数据来源API | 刷新策略 |
+|------|-----------|---------|
+| 统计卡片(在线/产量/告警) | 统计卡片API | 页面挂载时加载，定时N秒刷新 |
+| 采集服务状态 | 服务状态API | 页面挂载时加载，定时N秒刷新 |
+| 机床产量排行 | 机床排行API | 页面挂载时加载，定时N秒刷新 |
+| 工人产量排行 | 工人排行API | 页面挂载时加载，定时N秒刷新 |
+
+> 定时刷新间隔后台可配，默认10秒
+
+### 4. 操作按钮
+
+| 名称 | 位置 | 显示条件 | 点击行为 |
+|------|------|---------|---------|
+| 停止采集 | 服务状态栏 | running | 确认->调API停止 |
+| 启动采集 | 服务状态栏 | stopped/error | 确认->调API启动 |
+| 刷新配置 | 服务状态栏 | running | 确认->调API刷新 |
+| 查看全部 | 机床排行表头 | 始终 | 跳转产量报表 |
+| 查看全部 | 工人排行表头 | 始终 | 跳转产量报表 |
+| 机床名称 | 行内链接 | 始终 | 跳转机床详情 |
+| 工人姓名 | 行内链接 | 始终 | 跳转员工详情 |
+
+### 5. 状态机
+
+采集服务状态：
+- running: #67C23A绿 -> 可停止/刷新
+- stopped: #909399灰 -> 可启动
+- error: #F56C6C红 -> 可启动
+
+机床在线状态：
+- 1(在线): el-tag success
+- 0(离线): el-tag info
+
+### 6. 交互流程
+
+- 加载：页面挂载->4个API并行(统计卡片/机床排行/工人排行/服务状态)->渲染
+- 自动刷新：setInterval每N秒重新请求
+- 点击机床名称：router.push到机床详情
+- 停止采集：确认框->调WebAPI代理->采集服务API->更新状态
+- 异常：采集服务不可达->warning提示+状态显示stopped
+
+### 7. 空状态
+
+- 机床排行无数据：el-empty 今日尚无产量数据
+- 工人排行无数据：el-empty 今日尚无工人产量数据
+
+### 8. Mock数据
+
+**GET /api/admin/dashboard/summary 统计卡片：**
+```json
+{ "code": 0, "data": { "onlineCount": 142, "totalMachines": 160, "todayProduction": 2847, "activeAlerts": 3 }}
+```
+
+**GET /api/admin/collector/status 采集服务状态：**
+```json
+{ "code": 0, "data": { "status": "running", "uptimeSeconds": 316800, "lastCollectTime": "2026-04-25T17:36:38", "successCount": 1280, "failCount": 5 }}
+```
+
+**GET /api/admin/dashboard/machine-rank 机床产量排行TOP10：**
+```json
+{ "code": 0, "data": { "items": [
+  { "rank": 1, "machineId": 1, "machineName": "西-1.8", "program": "1566.NC", "quantity": 580, "status": 1 },
+  { "rank": 2, "machineId": 2, "machineName": "西-1.10", "program": "O123.NC", "quantity": 420, "status": 1 },
+  { "rank": 3, "machineId": 3, "machineName": "东-2.0", "program": "A456.NC", "quantity": 380, "status": 1 },
+  { "rank": 4, "machineId": 4, "machineName": "东-2.5", "program": "B789.NC", "quantity": 310, "status": 0 },
+  { "rank": 5, "machineId": 5, "machineName": "南-3.1", "program": "C012.NC", "quantity": 290, "status": 1 },
+  { "rank": 6, "machineId": 6, "machineName": "南-3.2", "program": "D345.NC", "quantity": 240, "status": 1 },
+  { "rank": 7, "machineId": 7, "machineName": "北-4.0", "program": "E678.NC", "quantity": 210, "status": 1 },
+  { "rank": 8, "machineId": 8, "machineName": "北-4.1", "program": "F901.NC", "quantity": 180, "status": 0 },
+  { "rank": 9, "machineId": 9, "machineName": "西-1.5", "program": "G234.NC", "quantity": 150, "status": 1 },
+  { "rank": 10, "machineId": 10, "machineName": "东-2.8", "program": "H567.NC", "quantity": 87, "status": 1 }
+]}}
+```
+
+**GET /api/admin/dashboard/worker-rank 工人产量排行TOP10：**
+```json
+{ "code": 0, "data": { "items": [
+  { "rank": 1, "workerId": 1, "workerName": "张三", "machineCount": 3, "totalQuantity": 1240 },
+  { "rank": 2, "workerId": 2, "workerName": "李四", "machineCount": 2, "totalQuantity": 980 },
+  { "rank": 3, "workerId": 3, "workerName": "王五", "machineCount": 4, "totalQuantity": 870 },
+  { "rank": 4, "workerId": 4, "workerName": "赵六", "machineCount": 2, "totalQuantity": 650 },
+  { "rank": 5, "workerId": 5, "workerName": "孙七", "machineCount": 3, "totalQuantity": 520 }
+]}}
+
+### 8. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 在线机床数/总机床数 | cnc_machine.is_enabled + is_online | 统计卡片 |
+| 今日总产量 | cnc_daily_production.total_quantity 合计 | 统计卡片 |
+| 活跃告警数 | cnc_alert.is_resolved=0 计数 | 统计卡片 |
+| 采集服务状态+运行时长+上次采集 | log_collector_heartbeat | 服务状态栏 |
+| 机床产量排行TOP10 | cnc_daily_production + cnc_machine | 排行表 |
+| 工人产量排行TOP10 | cnc_worker_daily_summary + cnc_worker | 排行表 |
--- a/docs/02-功能清单/管理后台/03-设备管理/00-设备管理-索引.md
+++ b/docs/02-功能清单/管理后台/03-设备管理/00-设备管理-索引.md
@ -0,0 +1,65 @@
+# 设备管理 索引
+
+> 版本：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) |
+
+---
--- a/docs/02-功能清单/管理后台/03-设备管理/01-设备管理-规范.md
+++ b/docs/02-功能清单/管理后台/03-设备管理/01-设备管理-规范.md
@ -0,0 +1,10 @@
+# 设备管理 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/03-设备管理/03-01-设备列表页面.md
+++ b/docs/02-功能清单/管理后台/03-设备管理/03-01-设备列表页面.md
@ -0,0 +1,159 @@
+# 设备列表页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /machine |
+| 权限 | admin |
+| 入口 | 侧边栏设备管理 |
+| 面包屑 | 首页 / 设备管理 |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 设备管理                                   │
+├──────────────────────────────────────────────────────────┤
+│ [操作栏]  [+ 新增机床] [导入] [导出]                        │
+├──────────────────────────────────────────────────────────┤
+│ [查询条件区]                                              │
+│ 车间[▼全部]  在线状态[▼全部]  品牌[▼全部]  搜索[____]       │
+│                                           [查询] [重置]   │
+├──────────────────────────────────────────────────────────┤
+│ [列表区]                                                  │
+│ [x] | 机床名称 | device_code | 车间 | 品牌 | IP地址 | 在线 | 绑定工人 | 操作  │
+│ [x] | 西-1.8   | fanake_1.8  | A栋 | FANUC| 10.1.1.8| 在线 | 张三  | [编辑][删除] │
+├──────────────────────────────────────────────────────────┤
+│ [分页]  共160条  每页[20▼]  < 1 2 3 ... 8 >              │
+├──────────────────────────────────────────────────────────┤
+│ [批量操作栏]  已选2项  [批量停用]  [批量启用]                │
+└──────────────────────────────────────────────────────────┘
+
+### 3. 查询条件
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 车间 | el-select | 否 | 全部 | - | 无 |
+| 在线状态 | el-select(在线/离线/全部) | 否 | 全部 | - | 无 |
+| 品牌 | el-select | 否 | 全部 | - | 无 |
+| 关键字 | el-input placeholder=机床名称/device_code | 否 | 空 | - | 无 |
+
+### 4. 列表字段
+
+| 字段名 | 列宽 | 排序 | 筛选 | 固定 | 超长处理 | 对齐 |
+|--------|------|------|------|------|---------|------|
+| 选择框 | 40px | - | - | left | - | center |
+| 机床名称 | 120px | y | - | left | tooltip | left |
+| device_code | 140px | y | - | - | tooltip | left |
+| 车间 | 80px | y | 下拉 | - | - | center |
+| 品牌 | 100px | y | 下拉 | - | - | center |
+| IP地址 | 120px | - | - | - | - | left |
+| 在线状态 | 80px | - | - | - | - | center |
+| 绑定工人 | 100px | - | - | - | - | center |
+| 操作 | 120px | - | - | right | - | center |
+
+### 5. 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 新增机床 | machine:create | 页头 | 始终 | 打开新增弹窗 |
+| 导入 | machine:import | 页头 | 始终 | 打开导入弹窗 |
+| 导出 | machine:export | 页头 | 始终 | 调API下载Excel |
+| 编辑 | machine:update | 行操作 | 始终 | 打开编辑弹窗 |
+| 删除 | machine:delete | 行操作 | 始终 | 确认->软删除 |
+| 批量停用 | machine:disable | 底部栏 | 已选含启用项 | 确认->批量 |
+| 批量启用 | machine:enable | 底部栏 | 已选含停用项 | 确认->批量 |
+| 机床名称链接 | - | 行内 | 始终 | 跳转详情页 |
+
+### 6. 弹窗规格
+
+**新增/编辑机床弹窗：**
+- 宽度600px，遮罩有，ESC关闭是(脏数据检测)，标题=新增机床/编辑机床
+
+表单字段：
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 机床名称 | el-input maxlength=100 | 是 | - | 必填 | - |
+| device_code | el-input maxlength=100 | 是 | - | 必填+唯一性(新增时) | - |
+| 所属车间 | el-select | 是 | - | 必填 | - |
+| 采集地址 | el-select | 是 | - | 必填 | 选定后品牌自动填充(只读) |
+| 品牌(只读) | el-input disabled | - | 由采集地址联动 | - | 采集地址变化时自动填充 |
+| IP地址 | el-input | 是 | - | 必填+IP格式 | - |
+| 绑定工人 | el-select | 否 | 空 | - | - |
+
+**导入弹窗：**
+- 宽度500px，标题=导入机床
+
+| 字段 | 控件 | 说明 |
+|------|------|------|
+| 模板下载 | el-button link | 下载Excel模板 |
+| 文件上传 | el-upload | accept=.xlsx, limit=1, auto-upload=false |
+| 确认导入 | el-button primary | 手动触发上传 |
+
+### 7. 状态机
+
+机床is_enabled：
+- 1(启用): el-tag success -> 可编辑/删除/停用
+- 0(停用): el-tag danger -> 可编辑/启用
+
+### 8. 交互流程
+
+- 加载：请求机床列表API(含分页)->渲染表格
+- 查询：点查询->重置page=1->请求列表API
+- 重置：清空所有筛选条件->请求列表API
+- 新增：弹窗->填写->保存->关闭弹窗->刷新列表
+- 编辑：弹窗(回填数据)->修改->保存->关闭->刷新
+- 删除：确认框->调API->成功->刷新列表
+- 批量：勾选->底部栏显示->点操作->确认->批量API->刷新
+- 导出：调API->下载文件
+- 导入：选文件->确认->上传->返回结果(成功N条/失败N条)->刷新列表
+- 机床名称链接：跳转机床详情页
+
+### 9. 空状态
+
+列表无数据：el-empty 暂无机床数据，点击新增机床添加
+
+### 10. Mock数据
+
+**GET /api/admin/machine 机床列表：**
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "name": "西-1.8", "deviceCode": "fanake_1.8", "workshopName": "A栋", "brandName": "FANUC", "ipAddress": "10.1.1.8", "isOnline": 1, "workerName": "张三", "isEnabled": 1 },
+  { "id": 2, "name": "西-1.10", "deviceCode": "fanake_1.10", "workshopName": "A栋", "brandName": "FANUC", "ipAddress": "10.1.1.10", "isOnline": 1, "workerName": "李四", "isEnabled": 1 },
+  { "id": 3, "name": "东-2.0", "deviceCode": "fanake_2.0", "workshopName": "B栋", "brandName": "FANUC", "ipAddress": "10.1.2.0", "isOnline": 0, "workerName": "王五", "isEnabled": 1 },
+  { "id": 4, "name": "东-2.5", "deviceCode": "siemens_2.5", "workshopName": "B栋", "brandName": "SIEMENS", "ipAddress": "10.1.2.5", "isOnline": 0, "workerName": null, "isEnabled": 0 }
+], "total": 160, "page": 1, "pageSize": 20 }}
+```
+
+**POST /api/admin/machine 新增机床成功：**
+```json
+{ "code": 0, "message": "success", "data": { "id": 161, "name": "新机床" }}
+```
+
+**GET /api/admin/machine/export 导出（返回文件流）：**
+二进制Excel文件，Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
+
+**POST /api/admin/machine/import 导入结果：**
+```json
+{ "code": 0, "data": { "successCount": 15, "failCount": 2, "failDetails": ["第3行：device_code重复", "第8行：车间不存在"] }}
+```
+
+### 10. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 机床列表（含分页） | cnc_machine | 主表，需JOIN车间/品牌/工人 |
+| 车间下拉 | cnc_workshop | 查询条件+表单 |
+| 品牌下拉 | cnc_brand | 查询条件 |
+| 采集地址下拉 | cnc_collect_address | 表单联动（选地址→填充品牌） |
+| 工人下拉 | cnc_worker | 表单绑定工人 |
+| 机床唯一性校验 | cnc_machine.device_code | 新增时实时校验 |
+| 设备code唯一性 | cnc_machine.uk_device_code | 新增时校验 |
--- a/docs/02-功能清单/管理后台/03-设备管理/03-02-设备详情页面.md
+++ b/docs/02-功能清单/管理后台/03-设备管理/03-02-设备详情页面.md
@ -0,0 +1,132 @@
+# 设备详情页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /machine/:id |
+| 权限 | admin |
+| 入口 | 设备管理点击机床名称 / 仪表盘点击机床名称 |
+| 面包屑 | 首页 / 设备管理 / {机床名称} |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 设备管理 / 西-1.8                          │
+├──────────────────────────────────────────────────────────┤
+│ [基本信息区]                                              │
+│ < 返回    机床详情：西-1.8                                 │
+│ 机床名称：西-1.8      device_code：fanake_1.8             │
+│ 车间：A栋             品牌：FANUC                          │
+│ 采集地址：FANUC-A栋   IP：10.1.1.8                        │
+│ 绑定工人：张三         在线状态：在线                       │
+├──────────────────────────────────────────────────────────┤
+│ [实时状态区]（自动刷新）                                    │
+│ 当前程序：1566.NC     零件数：580                         │
+│ 运行状态：运行中       操作模式：自动                      │
+│ 主轴转速：300 rpm     进给速度：0                          │
+│ 主轴负载：0%          加工状态：G01                       │
+│ 最后采集：3秒前                                           │
+├──────────────────────────────────────────────────────────┤
+│ [今日产量区]                                              │
+│ 程序名      | 产量  | 运行时间 | 切削时间                  │
+│ 1566.NC    | 580  | 4h20m  | 3h50m                     │
+├──────────────────────────────────────────────────────────┤
+│ [近7天产量趋势（折线图）]                                   │
+│ [============图表区域============]                         │
+├──────────────────────────────────────────────────────────┤
+│ [最近采集记录]                        [查看更多]           │
+│ 时间        | 程序名 | 零件数 | 运行状态                   │
+│ 17:36:35   | 1566  | 580   | 运行中                     │
+│ 17:36:05   | 1566  | 579   | 运行中                     │
+└──────────────────────────────────────────────────────────┘
+
+### 3. 数据区块
+
+| 区块 | 展示字段 | 控件类型 | 刷新策略 |
+|------|---------|---------|---------|
+| 基本信息 | 机床名称、device_code、车间、品牌、采集地址、IP、绑定工人、在线状态 | 文本展示 | 页面加载时请求一次 |
+| 实时状态 | 当前程序、零件数、运行状态、操作模式、主轴转速、进给速度、主轴负载、加工状态、最后采集时间 | 文本展示 | setInterval每10秒刷新 |
+| 今日产量 | 程序名、产量、运行时间、切削时间 | el-table | 页面加载时请求一次 |
+| 近7天趋势 | 日期、产量 | 折线图 | 页面加载时请求一次 |
+| 最近采集记录 | 时间、程序名、零件数、运行状态 | el-table | 页面加载时请求一次 |
+
+### 4. 操作按钮
+
+| 名称 | 位置 | 显示条件 | 点击行为 |
+|------|------|---------|---------|
+| 返回 | 页头左侧 | 始终 | router.back() |
+| 查看更多 | 采集记录表头 | 始终 | 跳转产量报表(预填该机床) |
+
+### 5. 交互流程
+
+- 加载：请求机床详情API+今日产量API+采集记录API+7天趋势API->渲染
+- 自动刷新：setInterval每10秒刷新实时状态部分
+- 返回：router.back()
+
+### 6. 空状态
+
+- 今日产量无数据：el-empty 今日尚无产量数据
+- 采集记录无数据：el-empty 暂无采集记录
+
+### 7. Mock数据
+
+**GET /api/admin/machine/1 机床详情：**
+```json
+{ "code": 0, "data": {
+  "id": 1, "name": "西-1.8", "deviceCode": "fanake_1.8", "workshopName": "A栋", "brandName": "FANUC",
+  "collectAddressName": "FANUC-A栋", "ipAddress": "10.1.1.8", "workerName": "张三", "isOnline": 1, "isEnabled": 1
+}}
+```
+
+**GET /api/admin/machine/1/status 实时状态：**
+```json
+{ "code": 0, "data": {
+  "programName": "1566.NC", "partCount": 580, "runStatus": "运行中", "operateMode": "自动",
+  "spindleSpeedSet": 3000, "feedSpeedSet": 500, "spindleSpeedActual": 2980, "feedSpeedActual": 480,
+  "spindleLoad": 65, "machiningStatus": "G01", "lastCollectTime": "2026-04-25T17:36:38"
+}}
+```
+
+**GET /api/admin/machine/1/production/today 今日产量：**
+```json
+{ "code": 0, "data": { "items": [
+  { "programName": "1566.NC", "quantity": 580, "runTime": "4h20m", "cuttingTime": "3h50m" },
+  { "programName": "O123.NC", "quantity": 120, "runTime": "2h10m", "cuttingTime": "1h45m" }
+]}}
+```
+
+**GET /api/admin/machine/1/production/trend 7天趋势：**
+```json
+{ "code": 0, "data": { "items": [
+  { "date": "2026-04-19", "quantity": 820 }, { "date": "2026-04-20", "quantity": 760 },
+  { "date": "2026-04-21", "quantity": 910 }, { "date": "2026-04-22", "quantity": 850 },
+  { "date": "2026-04-23", "quantity": 780 }, { "date": "2026-04-24", "quantity": 900 },
+  { "date": "2026-04-25", "quantity": 700 }
+]}}
+```
+
+**GET /api/admin/machine/1/collect-records 最近采集记录：**
+```json
+{ "code": 0, "data": { "items": [
+  { "collectTime": "2026-04-25T17:36:35", "programName": "1566.NC", "partCount": 580, "runStatus": "运行中" },
+  { "collectTime": "2026-04-25T17:36:05", "programName": "1566.NC", "partCount": 579, "runStatus": "运行中" },
+  { "collectTime": "2026-04-25T17:35:35", "programName": "1566.NC", "partCount": 578, "runStatus": "运行中" }
+]}}
+
+### 7. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 机床基本信息 | cnc_machine | 主表，含车间/品牌/地址/工人关联 |
+| 实时状态（10秒刷新） | cnc_machine 冗余字段 | last_program_name/last_part_count/last_run_status等 |
+| 今日产量（按程序） | cnc_daily_production | 按machine_id+当天查询 |
+| 近7天趋势 | cnc_daily_production | 按machine_id+近7天聚合 |
+| 最近采集记录 | cnc_collect_record | 按machine_id+时间倒序，取最近N条 |
--- a/docs/02-功能清单/管理后台/04-品牌模板/00-品牌模板-索引.md
+++ b/docs/02-功能清单/管理后台/04-品牌模板/00-品牌模板-索引.md
@ -0,0 +1,64 @@
+# 品牌模板 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+管理CNC品牌模板及其字段映射配置。品牌数量少，列表无分页无筛选。编辑使用独立页面（非弹窗），支持字段映射行内编辑。修改映射不影响历史数据。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 04-01 | 品牌列表页面 | /brand | 品牌列表+新增/编辑/启停/复制 |
+| 04-02 | 品牌编辑页面 | /brand/create 或 /brand/{id}/edit | 品牌基本信息+字段映射配置 |
+
+## 页面功能详情
+
+### 04-01 品牌列表页面
+**路由**：`/brand`
+**功能概述**：品牌模板列表，新增/编辑/启停/复制操作
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 加载品牌列表 | 页面挂载 | 请求列表API | GET /api/admin/brand |
+| F02 | 新增品牌 | 点击新增 | 跳转新增编辑页 | - |
+| F03 | 编辑品牌 | 点击编辑 | 跳转编辑页 | - |
+| F04 | 启停品牌 | 点击启用/禁用 | 确认->切换状态 | PUT /api/admin/brand/{id}/toggle |
+| F05 | 复制品牌 | 点击复制 | 复制模板到新增页 | GET /api/admin/brand/{id} |
+
+**状态机**：品牌is_enabled：1(启用)/0(停用)
+
+**路由跳转**：
+- 新增/编辑 -> 品牌编辑页(/brand/create 或 /brand/{id}/edit)
+
+### 04-02 品牌编辑页面
+**路由**：`/brand/create` 或 `/brand/{id}/edit`
+**功能概述**：编辑品牌基本信息(名称/device字段/tags路径)及字段映射配置(行内表格编辑)
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 加载品牌详情(编辑) | 页面挂载(编辑模式) | 请求品牌详情+映射列表 | GET /api/admin/brand/{id} |
+| F02 | 添加映射行 | 点击添加映射 | 表格新增空行 | - |
+| F03 | 删除映射行 | 点击删除 | 移除该行 | - |
+| F04 | 保存品牌 | 点击保存 | 校验->调API->返回列表 | POST/PUT /api/admin/brand |
+| F05 | 取消编辑 | 点击取消 | 脏数据检测->返回列表 | - |
+
+**路由跳转**：
+- 保存/取消 -> 返回品牌列表页(/brand)
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 04-01 | 品牌列表页面 | 页面文件 | [04-01-品牌列表页面.md](./04-01-品牌列表页面.md) |
+| 04-02 | 品牌编辑页面 | 页面文件 | [04-02-品牌编辑页面.md](./04-02-品牌编辑页面.md) |
+
+---
--- a/docs/02-功能清单/管理后台/04-品牌模板/01-品牌模板-规范.md
+++ b/docs/02-功能清单/管理后台/04-品牌模板/01-品牌模板-规范.md
@ -0,0 +1,38 @@
+# 品牌模板 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
+
+## 品牌标准字段枚举
+
+品牌编辑页"标准字段"下拉的完整可选项，共16个：
+
+| standard_field | 含义 | data_type | 说明 |
+|----------------|------|-----------|------|
+| program_name | NC程序名 | string | 零件唯一识别，Tag5 |
+| part_count | 当前加工零件数 | number | 零件计数，Tag8 |
+| device_status | 设备状态 | number | _io_status |
+| run_status | 运行状态 | number | Tag9 |
+| operate_mode | 操作模式 | number | Tag10 |
+| spindle_speed_set | 主轴设定速度 | number | Tag11 |
+| feed_speed_set | 进给设定速度 | number | Tag12 |
+| spindle_speed_actual | 主轴实际速度 | number | Tag13 |
+| feed_speed_actual | 进给实际转速 | number | Tag14 |
+| spindle_load | 主轴负载 | number | Tag15 |
+| spindle_override | 主轴倍率 | number | Tag16 |
+| power_on_time | 开机时间 | number | Tag17 |
+| run_time | 运行时间 | number | Tag18 |
+| cutting_time | 切削时间 | number | Tag19 |
+| cycle_time | 循环时间 | number | Tag20 |
+| machining_status | 加工状态 | string | Tag21 |
+
+**必填标准字段**：program_name、part_count、device_status（标记isRequired=1）
+**可选标准字段**：其余13个（标记isRequired=0）
+
+---
--- a/docs/02-功能清单/管理后台/04-品牌模板/04-01-品牌列表页面.md
+++ b/docs/02-功能清单/管理后台/04-品牌模板/04-01-品牌列表页面.md
@ -0,0 +1,92 @@
+# 品牌列表页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /brand |
+| 权限 | admin |
+| 入口 | 侧边栏品牌模板 |
+| 面包屑 | 首页 / 品牌模板管理 |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 品牌模板管理                               │
+├──────────────────────────────────────────────────────────┤
+│ [操作栏]  [+ 新增品牌]                                    │
+├──────────────────────────────────────────────────────────┤
+│ [列表区]                                                  │
+│ 品牌名称     | 状态 | 映射字段数 | 操作                    │
+│ FANUC       | 启用 | 16       | [编辑][禁用][复制]        │
+│ SIEMENS     | 启用 | 12       | [编辑][禁用][复制]        │
+│ MITSUBISHI  | 停用 | 8        | [编辑][启用][复制]        │
+└──────────────────────────────────────────────────────────┘
+
+### 3. 查询条件
+
+无（品牌数量少，无需筛选）。
+
+### 4. 列表字段
+
+| 字段名 | 列宽 | 排序 | 超长处理 | 对齐 |
+|--------|------|------|---------|------|
+| 品牌名称 | 150px | y | tooltip | left |
+| 状态 | 80px | - | - | center |
+| 映射字段数 | 100px | - | - | center |
+| 操作 | 180px | - | - | center |
+
+### 5. 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 新增品牌 | brand:create | 页头 | 始终 | 打开新增页 |
+| 编辑 | brand:update | 行操作 | 始终 | 跳转编辑页 |
+| 启用/禁用 | brand:toggle | 行操作 | 始终 | 确认->切换状态 |
+| 复制 | brand:copy | 行操作 | 始终 | 复制模板到新增页 |
+
+### 6. 弹窗规格
+
+无弹窗，使用独立编辑页。
+
+### 7. 状态机
+
+品牌is_enabled：
+- 1(启用): el-tag success -> 可编辑/禁用/复制
+- 0(停用): el-tag danger -> 可编辑/启用/复制
+
+### 8. 交互流程
+
+- 加载：请求品牌列表->渲染表格
+- 新增：跳转新增编辑页(/brand/create)
+- 编辑：跳转编辑页(/brand/:id/edit)
+- 启用/禁用：确认框->调API->刷新列表
+- 复制：复制品牌模板数据到新增页
+
+### 9. 空状态
+
+列表无数据：el-empty 暂无品牌数据，点击新增品牌添加
+
+### 10. Mock数据
+
+**GET /api/admin/brand 品牌列表：**
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "brandName": "FANUC", "deviceField": "device", "tagsPath": "tags", "isEnabled": 1, "fieldCount": 16 },
+  { "id": 2, "brandName": "SIEMENS", "deviceField": "device", "tagsPath": "tags", "isEnabled": 1, "fieldCount": 12 },
+  { "id": 3, "brandName": "MITSUBISHI", "deviceField": "device", "tagsPath": "tags", "isEnabled": 0, "fieldCount": 8 }
+]}}
+
+### 10. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 品牌列表 | cnc_brand | 主表 |
+| 映射字段数 | cnc_brand_field_mapping | 按brand_id计数 |
--- a/docs/02-功能清单/管理后台/04-品牌模板/04-02-品牌编辑页面.md
+++ b/docs/02-功能清单/管理后台/04-品牌模板/04-02-品牌编辑页面.md
@ -0,0 +1,109 @@
+# 品牌编辑页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /brand/create 或 /brand/{id}/edit |
+| 权限 | admin |
+| 入口 | 品牌列表页点击"新增品牌"或"编辑" |
+| 面包屑 | 首页 / 品牌模板管理 / 新增品牌 或 编辑FANUC |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 品牌模板管理 / 编辑FANUC                    │
+├──────────────────────────────────────────────────────────┤
+│ [基本信息区]                                              │
+│ < 返回    编辑品牌模板：FANUC                              │
+│ 品牌名称：[FANUC]                                        │
+│ device字段名：[device]                                    │
+│ tags路径：[tags]                                          │
+├──────────────────────────────────────────────────────────┤
+│ [字段映射配置区]                     [+ 添加映射]          │
+│ 标准字段          | 匹配方式 | 匹配值     | 类型   | 必须 | 操作 │
+│ program_name     | 按id    | Tag5      | string | 是  | [删除] │
+│ part_count       | 按id    | Tag8      | number | 是  | [删除] │
+│ device_status    | 按id    | _io_status| number | 是  | [删除] │
+│ ...                                                      │
+├──────────────────────────────────────────────────────────┤
+│ ⚠ 修改映射配置仅影响后续新采集数据，历史数据不受影响         │
+│                                    [取消]    [保存]        │
+└──────────────────────────────────────────────────────────┘
+
+### 3. 查询条件
+
+无。
+
+### 4. 操作按钮
+
+| 名称 | 位置 | 显示条件 | 点击行为 |
+|------|------|---------|---------|
+| 添加映射 | 映射表头上方 | 始终 | 新增一行空映射 |
+| 删除 | 映射行操作 | 始终 | 移除该行(不弹确认) |
+| 保存 | 页脚 | 始终 | 校验->保存->返回列表 |
+| 取消 | 页脚 | 始终 | 脏数据检测->返回列表 |
+
+### 5. 弹窗规格
+
+添加映射行：使用el-select选标准字段+输入匹配值+选择类型，直接在表格行内编辑，不弹窗。
+
+### 6. 状态机
+
+品牌is_enabled：
+- 1(启用): el-tag success
+- 0(停用): el-tag danger
+
+### 7. 交互流程
+
+- 加载(编辑)：请求品牌详情+映射列表->渲染
+- 加载(新增)：空表单
+- 添加映射：表格新增一行空行(标准字段下拉+匹配值输入+类型选择+必填勾选)
+- 删除映射：直接移除该行
+- 保存：确认弹窗"修改映射配置仅影响后续新采集数据，历史数据不受影响，确定保存？"->调API->成功返回列表
+- 取消：脏数据检测->返回
+
+### 8. 脏数据检测（本模块特殊规则）
+
+品牌名称/device字段/tags路径/映射列表任一变更则isDirty=true。
+
+### 9. Mock数据
+
+**GET /api/admin/brand/1 品牌详情+映射列表：**
+```json
+{ "code": 0, "data": {
+  "id": 1, "brandName": "FANUC", "deviceField": "device", "tagsPath": "tags",
+  "mappings": [
+    { "id": 1, "standardField": "program_name", "fieldName": "Tag5", "matchBy": "id", "dataType": "string", "isRequired": 1 },
+    { "id": 2, "standardField": "part_count", "fieldName": "Tag8", "matchBy": "id", "dataType": "number", "isRequired": 1 },
+    { "id": 3, "standardField": "device_status", "fieldName": "_io_status", "matchBy": "id", "dataType": "number", "isRequired": 1 },
+    { "id": 4, "standardField": "run_status", "fieldName": "Tag9", "matchBy": "id", "dataType": "number", "isRequired": 1 },
+    { "id": 5, "standardField": "operate_mode", "fieldName": "Tag10", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 6, "standardField": "spindle_speed_set", "fieldName": "Tag11", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 7, "standardField": "feed_speed_set", "fieldName": "Tag12", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 8, "standardField": "spindle_speed_actual", "fieldName": "Tag13", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 9, "standardField": "feed_speed_actual", "fieldName": "Tag14", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 10, "standardField": "spindle_load", "fieldName": "Tag15", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 11, "standardField": "spindle_override", "fieldName": "Tag16", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 12, "standardField": "power_on_time", "fieldName": "Tag17", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 13, "standardField": "run_time", "fieldName": "Tag18", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 14, "standardField": "cutting_time", "fieldName": "Tag19", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 15, "standardField": "cycle_time", "fieldName": "Tag20", "matchBy": "id", "dataType": "number", "isRequired": 0 },
+    { "id": 16, "standardField": "machining_status", "fieldName": "Tag21", "matchBy": "id", "dataType": "string", "isRequired": 0 }
+  ]
+}}
+
+### 9. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 品牌基本信息 | cnc_brand | brand_name/device_field/tags_path |
+| 字段映射列表 | cnc_brand_field_mapping | 按brand_id查询，含standard_field/field_name/match_by/data_type/is_required |
+| 标准字段枚举 | 代码层面约定（不建表） | program_name/part_count等16个标准字段 |
--- a/docs/02-功能清单/管理后台/05-采集地址/00-采集地址-索引.md
+++ b/docs/02-功能清单/管理后台/05-采集地址/00-采集地址-索引.md
@ -0,0 +1,53 @@
+# 采集地址 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+管理HTTP采集地址，每个地址关联品牌和机床列表。地址数量少，列表无分页无筛选。新增/编辑通过弹窗完成，弹窗内含品牌联动加载机床的checkbox选择区域。支持查看采集地址详情（关联机床+采集历史+原始JSON）。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 05-01 | 采集地址页面 | /collect-address | 采集地址列表+新增/编辑弹窗+启停 |
+| 05-02 | 采集地址详情页面 | /collect-address/:id | 基本信息+关联机床+采集记录+原始JSON查看 |
+
+## 页面功能详情
+
+### 05-01 采集地址页面
+**路由**：`/collect-address`
+**功能概述**：采集地址列表，显示URL/品牌/间隔/状态/上次采集/连续失败，新增/编辑/启停操作
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 加载地址列表 | 页面挂载 | 请求列表API | GET /api/admin/collect-address |
+| F02 | 新增地址 | 点击新增 | 弹窗->选品牌(加载机床)->勾选机床->保存 | POST /api/admin/collect-address |
+| F03 | 编辑地址 | 点击编辑 | 弹窗(回填+已选机床)->修改->保存 | PUT /api/admin/collect-address/{id} |
+| F04 | 启停地址 | 点击启用/停用 | 确认->切换 | PUT /api/admin/collect-address/{id}/toggle |
+
+**状态机**：采集地址is_enabled：1(启用)/0(停用)
+
+**路由跳转**：
+- 地址名称链接 -> 采集地址详情页(/collect-address/:id)
+
+### 05-02 采集地址详情页面
+**路由**：`/collect-address/:id`
+**功能概述**：查看采集地址基本信息、关联机床列表、最近采集记录（含成功/失败/耗时）、查看原始JSON入口、采集失败趋势图
+
+**路由跳转**：
+- 机床名称 -> 设备详情页(/machine/:id)
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 05-01 | 采集地址页面 | 页面文件 | [05-01-采集地址页面.md](./05-01-采集地址页面.md) |
+| 05-02 | 采集地址详情页面 | 页面文件 | [05-02-采集地址详情页面.md](./05-02-采集地址详情页面.md) |
+
+---
--- a/docs/02-功能清单/管理后台/05-采集地址/01-采集地址-规范.md
+++ b/docs/02-功能清单/管理后台/05-采集地址/01-采集地址-规范.md
@ -0,0 +1,10 @@
+# 采集地址 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/05-采集地址/05-01-采集地址页面.md
+++ b/docs/02-功能清单/管理后台/05-采集地址/05-01-采集地址页面.md
@ -0,0 +1,126 @@
+# 采集地址页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /collect-address |
+| 权限 | admin |
+| 入口 | 侧边栏采集地址 |
+| 面包屑 | 首页 / 采集地址管理 |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 采集地址管理                               │
+├──────────────────────────────────────────────────────────┤
+│ [操作栏]  [+ 新增地址]                                    │
+├──────────────────────────────────────────────────────────┤
+│ [列表区]                                                  │
+│ 名称        | URL               | 品牌 | 间隔 | 状态 | 上次采集 | 连续失败 | 操作       │
+│ FANUC-A栋  | http://10.1.1.1/  | FANUC| 30s | 启用 | 3秒前   | 0       | [编辑][停用]│
+│ FANUC-B栋  | http://10.1.2.1/  | FANUC| 60s | 启用 | 58秒前  | 0       | [编辑][停用]│
+└──────────────────────────────────────────────────────────┘
+
+### 3. 查询条件
+
+无（地址数量少）。
+
+### 4. 列表字段
+
+| 字段名 | 列宽 | 排序 | 超长处理 | 对齐 |
+|--------|------|------|---------|------|
+| 名称 | 120px | y | tooltip | left |
+| URL | 250px | - | tooltip | left |
+| 品牌 | 100px | - | - | center |
+| 采集间隔 | 80px | - | - | center |
+| 状态 | 80px | - | - | center |
+| 上次采集 | 120px | - | - | center |
+| 连续失败 | 80px | - | - | center |
+| 操作 | 120px | - | - | center |
+
+### 5. 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 新增地址 | address:create | 页头 | 始终 | 打开新增弹窗 |
+| 编辑 | address:update | 行操作 | 始终 | 打开编辑弹窗 |
+| 启用/停用 | address:toggle | 行操作 | 始终 | 确认->切换 |
+
+### 6. 弹窗规格
+
+**新增/编辑采集地址弹窗：**
+- 宽度600px，遮罩有，ESC关闭是(脏数据检测)
+
+表单字段：
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 地址名称 | el-input maxlength=100 | 是 | - | 必填 | - |
+| HTTP地址 | el-input maxlength=500 | 是 | - | 必填+URL格式 | - |
+| 关联品牌 | el-select | 是 | - | 必填 | 选定后下方加载该品牌机床 |
+| 采集间隔 | el-input-number min=5 max=300 | 是 | 30 | 必填+正整数 | - |
+| 选择机床 | el-checkbox-group | 否 | 空 | - | 品牌变化时重新加载机床列表 |
+
+机床选择区域说明：
+- 允许不选机床（先创建地址，后续在机床管理中关联）
+- 只显示属于该品牌且未分配到其他地址的机床（编辑时含当前已分配的）
+- 每个checkbox显示：device_code (机床名称) 车间 IP
+
+### 7. 状态机
+
+采集地址is_enabled：
+- 1(启用): el-tag success -> 可编辑/停用
+- 0(停用): el-tag danger -> 可编辑/启用
+
+### 8. 交互流程
+
+- 加载：请求采集地址列表->渲染
+- 新增：弹窗->选品牌(加载机床)->勾选机床->保存->关闭->刷新
+- 编辑：弹窗(回填数据+已选机床)->修改->保存->关闭->刷新
+- 启停：确认->调API->刷新
+
+### 9. 空状态
+
+列表无数据：el-empty 暂无采集地址数据，点击新增地址添加
+
+### 10. Mock数据
+
+**GET /api/admin/collect-address 采集地址列表：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "name": "FANUC-A栋", "url": "http://10.1.1.1/", "brandName": "FANUC", "collectInterval": 30, "isEnabled": 1, "lastCollectTime": "2026-04-25T17:36:38", "failCount": 0, "machineCount": 32 },
+  { "id": 2, "name": "FANUC-B栋", "url": "http://10.1.2.1/", "brandName": "FANUC", "collectInterval": 60, "isEnabled": 1, "lastCollectTime": "2026-04-25T17:35:38", "failCount": 0, "machineCount": 28 }
+]}}
+```
+
+**POST /api/admin/collect-address 新增采集地址成功：**
+
+```json
+{ "code": 0, "message": "success", "data": { "id": 3, "name": "SIEMENS-C栋" }}
+```
+
+**GET /api/admin/collect-address/1/machines 地址下可选机床（弹窗联动）：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "deviceCode": "fanake_1.8", "name": "西-1.8", "workshopName": "A栋", "ipAddress": "10.1.1.8", "isAssigned": false },
+  { "id": 2, "deviceCode": "fanake_1.10", "name": "西-1.10", "workshopName": "A栋", "ipAddress": "10.1.1.10", "isAssigned": true }
+]}}
+
+### 10. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 采集地址列表 | cnc_collect_address | 主表，需JOIN品牌名 |
+| 品牌下拉 | cnc_brand | 弹窗表单 |
+| 可选机床列表 | cnc_machine | 按brand_id筛选+排除已分配其他地址的机床 |
+| 机床-地址关联 | cnc_machine.collect_address_id | 机床归属地址关系 |
--- a/docs/02-功能清单/管理后台/05-采集地址/05-02-采集地址详情页面.md
+++ b/docs/02-功能清单/管理后台/05-采集地址/05-02-采集地址详情页面.md
@ -0,0 +1,129 @@
+# 采集地址详情页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /collect-address/:id |
+| 权限 | admin |
+| 入口 | 采集地址列表点击名称链接 / 仪表盘采集服务状态区点击地址名称 |
+| 面包屑 | 首页 / 采集地址管理 / {地址名称} |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 采集地址管理 / FANUC-A栋                    │
+├──────────────────────────────────────────────────────────┤
+│ [基本信息区]                                              │
+│ < 返回    采集地址详情：FANUC-A栋                           │
+│ 名称：FANUC-A栋         HTTP地址：http://10.1.1.1/          │
+│ 品牌：FANUC             采集间隔：30秒                      │
+│ 状态：启用               上次采集：3秒前                     │
+│ 连续失败：0次            总机床数：32台                      │
+├──────────────────────────────────────────────────────────┤
+│ [关联机床区]                                              │
+│ 机床名称    | device_code  | 车间 | 在线 | 当前程序 | 零件数 │
+│ 西-1.8     | fanake_1.8  | A栋 | 在线 | 1566.NC | 580   │
+│ 西-1.10    | fanake_1.10 | A栋 | 在线 | O123.NC | 120   │
+│ ...                                                      │
+├──────────────────────────────────────────────────────────┤
+│ [最近采集记录]                        [查看原始JSON]        │
+│ 采集时间     | 耗时  | 状态  | 机床数 | 失败数              │
+│ 17:36:38    | 1.2s | 成功 | 32    | 0                   │
+│ 17:36:08    | 1.1s | 成功 | 32    | 0                   │
+│ 17:35:38    | 3.5s | 成功 | 31    | 1                   │
+│ 17:35:08    | -    | 失败 | -     | -                   │
+├──────────────────────────────────────────────────────────┤
+│ [采集失败趋势（近7天折线图）]                                │
+│ [============图表区域============]                         │
+└──────────────────────────────────────────────────────────┘
+
+### 3. 数据区块
+
+| 区块 | 展示字段 | 控件类型 | 刷新策略 |
+|------|---------|---------|---------|
+| 基本信息 | 名称、URL、品牌、间隔、状态、上次采集、连续失败、机床数 | 文本展示 | 页面加载时请求一次 |
+| 关联机床 | 机床名称、device_code、车间、在线、当前程序、零件数 | el-table | 页面加载时请求一次 |
+| 最近采集记录 | 采集时间、耗时、状态、机床数、失败数 | el-table | 页面加载时请求一次 |
+| 采集失败趋势 | 日期、失败次数 | 折线图 | 页面加载时请求一次 |
+
+### 4. 操作按钮
+
+| 名称 | 位置 | 显示条件 | 点击行为 |
+|------|------|---------|---------|
+| 返回 | 页头左侧 | 始终 | router.back() |
+| 机床名称 | 行内链接 | 始终 | 跳转机床详情页(/machine/:id) |
+| 查看原始JSON | 采集记录表头 | 始终 | 弹窗显示选中采集记录的原始JSON |
+
+### 5. 弹窗规格
+
+**原始JSON查看弹窗：**
+- 宽度800px，标题=原始采集JSON
+- 内容：代码高亮显示JSON，只读不可编辑
+- 支持：复制到剪贴板
+
+### 6. 交互流程
+
+- 加载：请求地址详情API+关联机床API+最近采集记录API+失败趋势API->渲染
+- 点击机床名称：router.push到机床详情页
+- 查看原始JSON：点击"查看原始JSON"->弹窗显示最近一次成功采集的原始JSON（或选择某条记录的JSON）
+- 返回：router.back()
+
+### 7. 空状态
+
+- 关联机床无数据：el-empty 该地址暂无关联机床
+- 采集记录无数据：el-empty 暂无采集记录
+
+### 8. Mock数据
+
+**GET /api/admin/collect-address/1 地址详情：**
+
+```json
+{ "code": 0, "data": {
+  "id": 1, "name": "FANUC-A栋", "url": "http://10.1.1.1/", "brandName": "FANUC",
+  "collectInterval": 30, "isEnabled": 1, "lastCollectTime": "2026-04-25T17:36:38",
+  "failCount": 0, "machineCount": 32
+}}
+```
+
+**GET /api/admin/collect-address/1/machines 关联机床：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "machineId": 1, "machineName": "西-1.8", "deviceCode": "fanake_1.8", "workshopName": "A栋", "isOnline": 1, "programName": "1566.NC", "partCount": 580 },
+  { "machineId": 2, "machineName": "西-1.10", "deviceCode": "fanake_1.10", "workshopName": "A栋", "isOnline": 1, "programName": "O123.NC", "partCount": 120 }
+]}}
+```
+
+**GET /api/admin/collect-address/1/collect-records 最近采集记录（日志库）：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "requestTime": "2026-04-25T17:36:38", "duration": 1200, "isSuccess": 1, "machineCount": 32, "failMachineCount": 0 },
+  { "requestTime": "2026-04-25T17:36:08", "duration": 1100, "isSuccess": 1, "machineCount": 32, "failMachineCount": 0 },
+  { "requestTime": "2026-04-25T17:35:38", "duration": 3500, "isSuccess": 1, "machineCount": 31, "failMachineCount": 1 },
+  { "requestTime": "2026-04-25T17:35:08", "duration": null, "isSuccess": 0, "machineCount": null, "failMachineCount": null }
+]}}
+```
+
+**GET /api/admin/collect-address/1/raw-json/123 原始JSON（弹窗）：**
+
+```json
+{ "code": 0, "data": { "rawJson": "[{\"device\":\"fanake_1.8\",\"desc\":\"西-1.8\",\"tags\":[{\"id\":\"_io_status\",\"desc\":\"设备状态\",\"value\":\"1.00000\"},{\"id\":\"Tag5\",\"desc\":\"执行的NC主程序名\",\"value\":\"1566.NC\"},{\"id\":\"Tag8\",\"desc\":\"当前加工零件数\",\"value\":\"580.00000\"}]}]" }}
+
+### 8. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 采集地址基本信息 | cnc_collect_address | 主表 |
+| 关联机床列表 | cnc_machine | 按collect_address_id查询 |
+| 最近采集记录 | log_collect_raw (日志库) | 按collect_address_id+时间倒序，跨库查询 |
+| 原始JSON查看 | log_collect_raw.raw_json | 弹窗展示，MEDIUMTEXT字段 |
+| 采集失败趋势 | log_collect_raw聚合 | 按天统计is_success=0的次数 |
--- a/docs/02-功能清单/管理后台/06-员工管理/00-员工管理-索引.md
+++ b/docs/02-功能清单/管理后台/06-员工管理/00-员工管理-索引.md
@ -0,0 +1,59 @@
+# 员工管理 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+管理工人信息及工人-机床绑定关系（一对一绑定）。支持查看工人详情（绑定机床+历史产量）。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 06-01 | 员工管理页面 | /worker | 工人CRUD列表 |
+| 06-02 | 员工详情页面 | /worker/:id | 基本信息+绑定机床+今日产量+7天趋势 |
+
+## 页面功能详情
+
+### 06-01 员工管理页面
+**路由**：`/worker`
+**功能概述**：工人CRUD列表，支持新增/编辑/删除/批量启停，绑定机床管理
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 查询工人 | 点击查询/切换状态 | 重置page=1，请求列表 | GET /api/admin/worker |
+| F02 | 新增工人 | 点击新增 | 弹窗填写工号+姓名+绑定机床 | POST /api/admin/worker |
+| F03 | 编辑工人 | 点击编辑 | 弹窗回填数据，修改后保存 | PUT /api/admin/worker/:id |
+| F04 | 删除工人 | 点击删除(无绑定机床时) | 确认框->软删除 | DELETE /api/admin/worker/:id |
+| F05 | 批量启停 | 勾选+底部栏操作 | 确认->批量API | PUT /api/admin/worker/batch-status |
+| F06 | 查看详情 | 点击姓名链接 | 跳转详情页 | - |
+
+**路由跳转**：点击姓名→/worker/:id（员工详情页）
+
+### 06-02 员工详情页面
+**路由**：`/worker/:id`
+**功能概述**：工人基本信息+绑定机床+今日产量+7天趋势（只读）
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 加载详情 | 页面进入 | 并行请求4个API | GET /api/admin/worker/:id + machines + production/today + production/trend |
+| F02 | 跳转机床详情 | 点击机床名称 | router.push | - |
+| F03 | 返回 | 点击返回 | router.back() | - |
+
+**路由跳转**：点击机床名称→/machine/:id（设备详情页）
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 06-01 | 员工管理页面 | 页面文件 | [06-01-员工管理页面.md](./06-01-员工管理页面.md) |
+| 06-02 | 员工详情页面 | 页面文件 | [06-02-员工详情页面.md](./06-02-员工详情页面.md) |
+
+---
--- a/docs/02-功能清单/管理后台/06-员工管理/01-员工管理-规范.md
+++ b/docs/02-功能清单/管理后台/06-员工管理/01-员工管理-规范.md
@ -0,0 +1,10 @@
+# 员工管理 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/06-员工管理/06-01-员工管理页面.md
+++ b/docs/02-功能清单/管理后台/06-员工管理/06-01-员工管理页面.md
@ -0,0 +1,146 @@
+# 员工管理页面
+
+> 最后更新：2026-04-26
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /worker |
+| 权限 | admin |
+| 入口 | 侧边栏员工管理 |
+| 面包屑 | 首页 / 员工管理 |
+
+### 2. 界面布局
+
+```
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 员工管理                                   │
+├──────────────────────────────────────────────────────────┤
+│ [操作栏]  [+ 新增工人]                                     │
+├──────────────────────────────────────────────────────────┤
+│ [查询条件区]                                              │
+│ 状态[▼全部]  搜索[__________]                [查询] [重置]  │
+├──────────────────────────────────────────────────────────┤
+│ [列表区]                                                  │
+│ [x] | 工号   | 姓名  | 状态 | 绑定机床数 | 绑定机床       | 操作         │
+│ [x] | W001  | 张三  | 启用 | 2         | 西-1.8,西-2.0  | [编辑][删除] │
+│ [x] | W002  | 李四  | 启用 | 1         | 西-1.10        | [编辑][删除] │
+│ [x] | W003  | 王五  | 停用 | 0         | -              | [编辑][启用] │
+├──────────────────────────────────────────────────────────┤
+│ [分页]  共50条  每页[20▼]  < 1 2 3 >                     │
+├──────────────────────────────────────────────────────────┤
+│ [批量操作栏]  已选2项  [批量停用]  [批量启用]                │
+└──────────────────────────────────────────────────────────┘
+```
+
+### 3. 查询条件
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 状态 | el-select(启用/停用/全部) | 否 | 全部 | - | 无 |
+| 关键字 | el-input placeholder=工号/姓名 | 否 | 空 | - | 无 |
+
+### 4. 列表字段
+
+| 字段名 | 列宽 | 排序 | 筛选 | 固定 | 超长处理 | 对齐 |
+|--------|------|------|------|------|---------|------|
+| 选择框 | 40px | - | - | left | - | center |
+| 工号 | 120px | y | - | - | tooltip | left |
+| 姓名 | 120px | y | - | - | tooltip | left |
+| 状态 | 80px | - | - | - | - | center |
+| 绑定机床数 | 100px | y | - | - | - | center |
+| 绑定机床 | auto | - | - | - | tooltip(逗号分隔) | left |
+| 操作 | 120px | - | - | right | - | center |
+
+### 5. 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 新增工人 | worker:create | 页头 | 始终 | 打开新增弹窗 |
+| 编辑 | worker:update | 行操作 | 始终 | 打开编辑弹窗 |
+| 删除 | worker:delete | 行操作 | 启用状态且无绑定机床 | 确认->软删除 |
+| 批量停用 | worker:disable | 底部栏 | 已选含启用项 | 确认->批量 |
+| 批量启用 | worker:enable | 底部栏 | 已选含停用项 | 确认->批量 |
+| 姓名链接 | - | 行内 | 始终 | 跳转工人详情页(/worker/:id) |
+
+### 6. 弹窗规格
+
+**新增/编辑工人弹窗：**
+- 宽度500px，遮罩有，ESC关闭是(脏数据检测)，标题=新增工人/编辑工人
+
+表单字段：
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 工号 | el-input maxlength=50 | 是 | - | 必填+唯一性(新增时) | - |
+| 姓名 | el-input maxlength=50 | 是 | - | 必填 | - |
+| 绑定机床 | el-select multiple filterable | 否 | 空 | - | 仅显示未绑定其他工人的机床 |
+
+说明：
+- 弹窗中不设"状态"字段，新增默认启用
+- 绑定机床下拉：查询cnc_machine中未绑定其他工人的机床（uk_machine约束确保一对一）
+- 编辑时回填当前已绑定机床+可选未绑定机床
+
+### 7. 状态机
+
+工人is_enabled：
+- 1(启用): el-tag success -> 可编辑/删除(无绑定机床时)/停用
+- 0(停用): el-tag danger -> 可编辑/启用
+
+删除前提：绑定机床数=0（有绑定机床的工人不可删除，需先解绑）
+
+### 8. 交互流程
+
+- 加载：请求工人列表API(含分页)->渲染表格
+- 查询：点查询->重置page=1->请求列表API
+- 重置：清空所有筛选条件->请求列表API
+- 新增：弹窗->填写工号+姓名+选择绑定机床->保存->关闭弹窗->刷新列表
+- 编辑：弹窗(回填数据)->修改->保存->关闭->刷新
+- 删除：确认框"确定删除工人【{姓名}】？此操作不可恢复。 "->调API->成功->刷新列表
+- 批量启停：勾选->底部栏显示->点操作->确认->批量API->刷新
+- 姓名链接：跳转工人详情页
+
+### 9. 空状态
+
+列表无数据：el-empty 暂无工人数据，点击新增工人添加
+
+### 10. Mock数据
+
+**GET /api/admin/worker 工人列表：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "code": "W001", "name": "张三", "isEnabled": 1, "machineCount": 2, "machineNames": "西-1.8,西-2.0" },
+  { "id": 2, "code": "W002", "name": "李四", "isEnabled": 1, "machineCount": 1, "machineNames": "西-1.10" },
+  { "id": 3, "code": "W003", "name": "王五", "isEnabled": 0, "machineCount": 0, "machineNames": "-" }
+], "total": 50, "page": 1, "pageSize": 20 }}
+```
+
+**POST /api/admin/worker 新增工人成功：**
+
+```json
+{ "code": 0, "message": "success", "data": { "id": 4, "name": "赵六" }}
+```
+
+**GET /api/admin/worker/available-machines 可绑定机床下拉：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 5, "name": "东-2.5", "deviceCode": "siemens_2.5", "workshopName": "B栋" },
+  { "id": 8, "name": "北-4.1", "deviceCode": "fanake_4.1", "workshopName": "C栋" }
+]}}
+```
+
+### 11. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 工人列表（含分页） | cnc_worker | 主表，需JOIN绑定机床数+机床名称 |
+| 工号唯一性校验 | cnc_worker.uk_code | 新增时实时校验 |
+| 可绑定机床下拉 | cnc_machine LEFT JOIN cnc_worker_machine | 查未绑定工人(not exists in cnc_worker_machine)的机床 |
--- a/docs/02-功能清单/管理后台/06-员工管理/06-02-员工详情页面.md
+++ b/docs/02-功能清单/管理后台/06-员工管理/06-02-员工详情页面.md
@ -0,0 +1,113 @@
+# 员工详情页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /worker/:id |
+| 权限 | admin |
+| 入口 | 员工管理列表点击工人姓名 / 仪表盘工人排行点击工人姓名 |
+| 面包屑 | 首页 / 员工管理 / {工人姓名} |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 员工管理 / 张三                             │
+├──────────────────────────────────────────────────────────┤
+│ [基本信息区]                                              │
+│ < 返回    工人详情：张三                                    │
+│ 工号：W001              姓名：张三                          │
+│ 状态：启用               绑定机床数：2                      │
+├──────────────────────────────────────────────────────────┤
+│ [绑定机床区]                                              │
+│ 机床名称    | device_code  | 车间 | 品牌 | 在线状态 | 当前程序 │
+│ 西-1.8     | fanake_1.8  | A栋 | FANUC| 在线    | 1566.NC │
+│ 西-2.0     | fanake_2.0  | A栋 | FANUC| 离线    | -       │
+├──────────────────────────────────────────────────────────┤
+│ [今日产量区]                                              │
+│ 机床名称    | 程序名    | 产量  | 运行时间 | 切削时间        │
+│ 西-1.8     | 1566.NC  | 580  | 4h20m  | 3h50m           │
+│ 西-2.0     | -        | -    | -      | -               │
+├──────────────────────────────────────────────────────────┤
+│ [近7天产量趋势（折线图）]                                   │
+│ [============图表区域============]                         │
+└──────────────────────────────────────────────────────────┘
+
+### 3. 数据区块
+
+| 区块 | 展示字段 | 控件类型 | 刷新策略 |
+|------|---------|---------|---------|
+| 基本信息 | 工号、姓名、状态、绑定机床数 | 文本展示 | 页面加载时请求一次 |
+| 绑定机床 | 机床名称、device_code、车间、品牌、在线状态、当前程序 | el-table | 页面加载时请求一次 |
+| 今日产量 | 机床名称、程序名、产量、运行时间、切削时间 | el-table | 页面加载时请求一次 |
+| 近7天趋势 | 日期、产量 | 折线图 | 页面加载时请求一次 |
+
+### 4. 操作按钮
+
+| 名称 | 位置 | 显示条件 | 点击行为 |
+|------|------|---------|---------|
+| 返回 | 页头左侧 | 始终 | router.back() |
+| 机床名称 | 行内链接 | 始终 | 跳转机床详情页(/machine/:id) |
+
+### 5. 交互流程
+
+- 加载：请求工人详情API+绑定机床API+今日产量API+7天趋势API->渲染
+- 点击机床名称：router.push到机床详情页
+- 返回：router.back()
+
+### 6. 空状态
+
+- 绑定机床无数据：el-empty 该工人暂无绑定机床
+- 今日产量无数据：el-empty 今日尚无产量数据
+
+### 8. Mock数据
+
+**GET /api/admin/worker/1 工人详情：**
+
+```json
+{ "code": 0, "data": { "id": 1, "code": "W001", "name": "张三", "isEnabled": 1, "machineCount": 2 }}
+```
+
+**GET /api/admin/worker/1/machines 绑定机床：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "machineId": 1, "machineName": "西-1.8", "deviceCode": "fanake_1.8", "workshopName": "A栋", "brandName": "FANUC", "isOnline": 1, "programName": "1566.NC" },
+  { "machineId": 2, "machineName": "西-2.0", "deviceCode": "fanake_2.0", "workshopName": "A栋", "brandName": "FANUC", "isOnline": 0, "programName": null }
+]}}
+```
+
+**GET /api/admin/worker/1/production/today 今日产量：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "machineName": "西-1.8", "programName": "1566.NC", "quantity": 580, "runTime": "4h20m", "cuttingTime": "3h50m" },
+  { "machineName": "西-2.0", "programName": "-", "quantity": null, "runTime": "-", "cuttingTime": "-" }
+]}}
+```
+
+**GET /api/admin/worker/1/production/trend 7天趋势：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "date": "2026-04-19", "quantity": 980 }, { "date": "2026-04-20", "quantity": 920 },
+  { "date": "2026-04-21", "quantity": 1100 }, { "date": "2026-04-22", "quantity": 1050 },
+  { "date": "2026-04-23", "quantity": 990 }, { "date": "2026-04-24", "quantity": 1080 },
+  { "date": "2026-04-25", "quantity": 580 }
+]}}
+
+### 7. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 工人基本信息 | cnc_worker | 主表 |
+| 绑定机床列表 | cnc_worker_machine + cnc_machine | 按worker_id查关联机床 |
+| 今日产量（按机床+程序） | cnc_daily_production + cnc_machine | 按worker绑定的machine_id查询 |
+| 近7天趋势 | cnc_worker_daily_summary | 按worker_id+近7天查询 |
--- a/docs/02-功能清单/管理后台/07-产量报表/00-产量报表-索引.md
+++ b/docs/02-功能清单/管理后台/07-产量报表/00-产量报表-索引.md
@ -0,0 +1,45 @@
+# 产量报表 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+按日期/车间/机床/工人维度查询产量汇总，支持产量修正及审计，支持导出Excel。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 07-01 | 产量报表页面 | /production | 待设计 |
+
+## 页面功能详情
+
+### 07-01 产量报表页面
+**路由**：`/production`
+**功能概述**：按日期/车间/机床/工人维度查询日产量汇总，支持产量修正（含审计）、导出Excel、数据缺失标记
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 查询产量 | 点击查询/切换条件 | 重置page=1，请求列表+汇总 | GET /api/admin/production/daily + daily-summary |
+| F02 | 重置条件 | 点击重置 | 恢复默认近7天，请求 | 同上 |
+| F03 | 导出Excel | 点击导出 | 按当前查询条件下载 | GET /api/admin/production/export |
+| F04 | 修正产量 | 点击修正产量 | 弹窗输入修正值+原因，确认 | POST /api/admin/production/adjust |
+| F05 | 查看修正记录 | 点击修正记录(已修正行) | 弹窗展示修正历史(只读) | GET /api/admin/production/adjustment-history |
+
+**业务规则**：
+- 日状态data_missing时产量显示"-"而非0（区分真0和缺数据）
+- 修正后is_adjusted=1，修正记录写入cnc_production_adjustment审计表
+- 导出按当前筛选条件（含日期范围+车间+机床+工人）
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 07-01 | 产量报表页面 | 页面文件 | [07-01-产量报表页面.md](./07-01-产量报表页面.md) |
+
+---
--- a/docs/02-功能清单/管理后台/07-产量报表/01-产量报表-规范.md
+++ b/docs/02-功能清单/管理后台/07-产量报表/01-产量报表-规范.md
@ -0,0 +1,10 @@
+# 产量报表 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/07-产量报表/07-01-产量报表页面.md
+++ b/docs/02-功能清单/管理后台/07-产量报表/07-01-产量报表页面.md
@ -0,0 +1,173 @@
+# 产量报表页面
+
+> 最后更新：2026-04-26
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /production |
+| 权限 | admin |
+| 入口 | 侧边栏产量报表 |
+| 面包屑 | 首页 / 产量报表 |
+
+### 2. 界面布局
+
+```
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 产量报表                                   │
+├──────────────────────────────────────────────────────────┤
+│ [查询条件区]                                              │
+│ 日期范围[2026-04-19 ~ 2026-04-25]  车间[▼全部]            │
+│ 机床[▼全部]  工人[▼全部]  程序名[_______]                  │
+│                                    [查询] [重置] [导出]    │
+├──────────────────────────────────────────────────────────┤
+│ [汇总统计区]                                              │
+│ ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐                  │
+│ │总产量 │  │运行机床│  │切削总时│  │平均产量│                  │
+│ │8,520 │  │  142  │  │580h  │  │ 60   │                  │
+│ └──────┘  └──────┘  └──────┘  └──────┘                  │
+├──────────────────────────────────────────────────────────┤
+│ [列表区]                                                  │
+│ 日期      | 机床    | 程序名    | 产量  | 运行时间 | 切削时间 | 日状态 | 修正 | 操作      │
+│ 2026-04-25| 西-1.8 | 1566.NC  | 580  | 4h20m   | 3h50m  | 正常  | -   | [修正产量] │
+│ 2026-04-25| 东-2.5 | A456.NC  | -    | -       | -      | 缺失  | -   | [修正产量] │
+│ 2026-04-25| 北-4.1 | B789.NC  | 310  | 2h10m   | 1h50m  | 正常  | ✓   | [修正记录] │
+├──────────────────────────────────────────────────────────┤
+│ [分页]  共1200条  每页[20▼]  < 1 2 3 ... 60 >           │
+└──────────────────────────────────────────────────────────┘
+```
+
+### 3. 查询条件
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 日期范围 | el-date-picker type=daterange | 是 | 近7天(含今日) | 必填+结束日期≥开始日期 | 无 |
+| 车间 | el-select | 否 | 全部 | - | 联动机床下拉(按车间筛选) |
+| 机床 | el-select filterable | 否 | 全部 | - | 受车间联动 |
+| 工人 | el-select filterable | 否 | 全部 | - | 无 |
+| 程序名 | el-input | 否 | 空 | - | 无 |
+
+### 4. 列表字段
+
+| 字段名 | 列宽 | 排序 | 筛选 | 固定 | 超长处理 | 对齐 |
+|--------|------|------|------|------|---------|------|
+| 日期 | 110px | y | - | left | - | center |
+| 机床名称 | 120px | y | - | - | tooltip | left |
+| 程序名 | 140px | y | - | - | tooltip | left |
+| 产量 | 80px | y | - | - | - | center |
+| 运行时间 | 100px | - | - | - | - | center |
+| 切削时间 | 100px | - | - | - | - | center |
+| 日状态 | 80px | - | 下拉 | - | - | center |
+| 修正标记 | 80px | - | - | - | - | center |
+| 操作 | 120px | - | - | right | - | center |
+
+### 5. 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 查询 | - | 查询区 | 始终 | 重置page=1->请求列表 |
+| 重置 | - | 查询区 | 始终 | 清空条件->请求列表 |
+| 导出 | production:export | 查询区 | 始终 | 按当前查询条件导出Excel |
+| 修正产量 | production:adjust | 行操作 | 始终 | 打开修正弹窗 |
+| 修正记录 | - | 行操作 | is_adjusted=1 | 打开修正历史弹窗(只读) |
+
+### 6. 弹窗规格
+
+**产量修正弹窗：**
+- 宽度500px，遮罩有，ESC关闭是(脏数据检测)，标题=修正产量
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 当前产量 | el-input disabled | - | 原始产量 | - | - |
+| 修正后产量 | el-input-number min=0 | 是 | 原始产量 | 必填+非负整数 | - |
+| 修正原因 | el-input type=textarea maxlength=500 | 是 | - | 必填 | - |
+
+**修正历史弹窗（只读）：**
+- 宽度600px，标题=修正记录
+
+| 展示字段 | 说明 |
+|---------|------|
+| 修正时间 | created_at |
+| 修正前 | old_value |
+| 修正后 | new_value |
+| 修正原因 | reason |
+
+### 7. 状态机
+
+日状态(data_status)：
+- normal(正常): 文本"正常" 灰色 -> 产量正常显示
+- offline(离线): 文本"离线" el-tag danger -> 产量显示0
+- data_missing(数据缺失): 文本"缺失" el-tag warning -> 产量显示"-"(非0)
+
+修正标记：
+- is_adjusted=0: 显示"-"
+- is_adjusted=1: 显示"✓" el-tag primary
+
+### 8. 交互流程
+
+- 加载：默认近7天->请求列表API+汇总统计API->渲染
+- 查询：选条件->查询->重置page=1->请求列表+汇总
+- 重置：清空条件(恢复默认近7天)->请求
+- 导出：调API下载Excel(按当前查询条件导出)
+- 修正产量：弹窗->输入修正后产量+原因->确认"确定修正产量？修正后将记录审计日志。 "->调API->关闭->刷新列表
+- 修正记录：弹窗(只读)->展示修正历史->关闭
+
+### 9. 空状态
+
+列表无数据：el-empty 未找到匹配的产量数据，请调整查询条件
+汇总统计：无数据时各卡片显示"-"
+
+### 10. Mock数据
+
+**GET /api/admin/production/daily-summary 汇总统计：**
+
+```json
+{ "code": 0, "data": { "totalQuantity": 8520, "activeMachineCount": 142, "totalCuttingTime": "580h", "avgQuantityPerMachine": 60 }}
+```
+
+**GET /api/admin/production/daily 产量列表：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "date": "2026-04-25", "machineName": "西-1.8", "programName": "1566.NC", "quantity": 580, "runTime": "4h20m", "cuttingTime": "3h50m", "dataStatus": "normal", "isAdjusted": 0, "adjustedQuantity": null },
+  { "id": 2, "date": "2026-04-25", "machineName": "东-2.5", "programName": "A456.NC", "quantity": null, "runTime": null, "cuttingTime": null, "dataStatus": "data_missing", "isAdjusted": 0, "adjustedQuantity": null },
+  { "id": 3, "date": "2026-04-25", "machineName": "北-4.1", "programName": "B789.NC", "quantity": 310, "runTime": "2h10m", "cuttingTime": "1h50m", "dataStatus": "normal", "isAdjusted": 1, "adjustedQuantity": 320 }
+], "total": 1200, "page": 1, "pageSize": 20 }}
+```
+
+**POST /api/admin/production/adjust 修正产量：**
+
+```json
+{ "code": 0, "message": "success", "data": null }
+```
+
+**GET /api/admin/production/adjustment-history?target_id=3 修正历史：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "createdAt": "2026-04-25 15:30:00", "oldValue": 310, "newValue": 320, "reason": "传感器计数偏差，手工校准" }
+]}}
+```
+
+**GET /api/admin/production/export 导出（返回文件流）：**
+二进制Excel文件，Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
+
+### 11. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 日产量列表(含分页) | cnc_daily_production + cnc_machine | 主表，需JOIN机床名+车间名 |
+| 日状态 | cnc_machine_daily_status | 按machine_id+date关联 |
+| 汇总统计 | cnc_daily_production | 按日期范围聚合SUM/COUNT/AVG |
+| 车间下拉 | cnc_workshop | 查询条件 |
+| 机床下拉 | cnc_machine | 查询条件，受车间联动 |
+| 工人下拉 | cnc_worker | 查询条件 |
+| 产量修正写入 | cnc_daily_production.adjusted_quantity | 更新修正后产量+is_adjusted=1 |
+| 修正审计记录 | cnc_production_adjustment | 写入修正前/后值+原因 |
+| 修正历史查询 | cnc_production_adjustment | 按target_table+target_id查询 |
--- a/docs/02-功能清单/管理后台/08-告警中心/00-告警中心-索引.md
+++ b/docs/02-功能清单/管理后台/08-告警中心/00-告警中心-索引.md
@ -0,0 +1,41 @@
+# 告警中心 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+查看系统告警（采集失败/设备离线/产量异常/未知设备/服务错误），支持标记已处理。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 08-01 | 告警中心页面 | /alert | 待设计 |
+
+## 页面功能详情
+
+### 08-01 告警中心页面
+**路由**：`/alert`
+**功能概述**：查看系统告警（采集失败/设备离线/产量异常/未知设备/服务错误），支持单个/批量标记已处理
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 查询告警 | 点击查询/切换条件 | 重置page=1，请求列表+统计 | GET /api/admin/alert + statistics |
+| F02 | 标记已处理 | 点击行操作 | 确认框->标记 | PUT /api/admin/alert/:id/resolve |
+| F03 | 批量标记 | 勾选+批量操作 | 确认框->批量标记 | PUT /api/admin/alert/batch-resolve |
+| F04 | 查看详情 | 点击查看(已处理行) | 弹窗展示完整告警详情 | - (行数据已含) |
+
+**告警类型**：collect_fail(采集失败) / device_offline(设备离线) / production_anomaly(产量异常) / unknown_device(未知设备) / service_error(服务错误)
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 08-01 | 告警中心页面 | 页面文件 | [08-01-告警中心页面.md](./08-01-告警中心页面.md) |
+
+---
--- a/docs/02-功能清单/管理后台/08-告警中心/01-告警中心-规范.md
+++ b/docs/02-功能清单/管理后台/08-告警中心/01-告警中心-规范.md
@ -0,0 +1,10 @@
+# 告警中心 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/08-告警中心/08-01-告警中心页面.md
+++ b/docs/02-功能清单/管理后台/08-告警中心/08-01-告警中心页面.md
@ -0,0 +1,153 @@
+# 告警中心页面
+
+> 最后更新：2026-04-26
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /alert |
+| 权限 | admin |
+| 入口 | 侧边栏告警中心 |
+| 面包屑 | 首页 / 告警中心 |
+
+### 2. 界面布局
+
+```
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 告警中心                                   │
+├──────────────────────────────────────────────────────────┤
+│ [查询条件区]                                              │
+│ 告警类型[▼全部]  处理状态[▼未处理]  时间范围[__________]    │
+│ 机床[▼全部]  关键字[___________]             [查询] [重置]  │
+├──────────────────────────────────────────────────────────┤
+│ [统计区]                                                  │
+│ ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐       │
+│ │未处理 │  │采集失败│  │设备离线│  │产量异常│  │未知设备│       │
+│ │  15  │  │  5   │  │  6   │  │  2   │  │  2   │       │
+│ └──────┘  └──────┘  └──────┘  └──────┘  └──────┘       │
+├──────────────────────────────────────────────────────────┤
+│ [操作栏]  [批量标记已处理]                                  │
+├──────────────────────────────────────────────────────────┤
+│ [列表区]                                                  │
+│ [x] | 时间              | 类型     | 标题          | 机床   | 详情           | 状态   | 操作         │
+│ [x] | 2026-04-25 17:30 | 采集失败  | 采集请求失败   | 西-1.8 | HTTP超时(30s)  | 未处理 | [标记已处理]  │
+│ [x] | 2026-04-25 17:00 | 设备离线  | 设备离线       | 东-2.5 | 连续3次Ping失败 | 未处理 | [标记已处理]  │
+│ [x] | 2026-04-25 16:00 | 产量异常  | 产量骤降       | 南-3.1 | 产量下降>50%   | 已处理 | [查看]       │
+├──────────────────────────────────────────────────────────┤
+│ [分页]  共320条  每页[20▼]  < 1 2 3 ... 16 >            │
+└──────────────────────────────────────────────────────────┘
+```
+
+### 3. 查询条件
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 告警类型 | el-select(采集失败/设备离线/产量异常/未知设备/服务错误/全部) | 否 | 全部 | - | 无 |
+| 处理状态 | el-select(未处理/已处理/全部) | 否 | 未处理 | - | 无 |
+| 时间范围 | el-date-picker type=daterange | 否 | 空 | - | 无 |
+| 机床 | el-select filterable | 否 | 全部 | - | 无 |
+| 关键字 | el-input placeholder=标题/详情 | 否 | 空 | - | 无 |
+
+### 4. 列表字段
+
+| 字段名 | 列宽 | 排序 | 筛选 | 固定 | 超长处理 | 对齐 |
+|--------|------|------|------|------|---------|------|
+| 选择框 | 40px | - | - | left | - | center |
+| 告警时间 | 170px | y | - | - | - | center |
+| 告警类型 | 100px | - | - | - | - | center |
+| 标题 | 160px | - | - | - | tooltip | left |
+| 机床 | 100px | - | - | - | tooltip | center |
+| 详情 | auto | - | - | - | tooltip | left |
+| 处理状态 | 80px | - | - | - | - | center |
+| 操作 | 120px | - | - | right | - | center |
+
+### 5. 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 批量标记已处理 | alert:resolve | 页头 | 已选含未处理项 | 确认->批量标记 |
+| 标记已处理 | alert:resolve | 行操作 | is_resolved=0 | 确认->标记已处理 |
+| 查看 | - | 行操作 | is_resolved=1 | 弹窗展示详情(只读) |
+
+### 6. 弹窗规格
+
+**告警详情弹窗（只读）：**
+- 宽度600px，标题=告警详情
+
+| 展示字段 | 说明 |
+|---------|------|
+| 告警时间 | created_at |
+| 告警类型 | alert_type |
+| 标题 | title |
+| 机床 | 关联机床名 |
+| 采集地址 | 关联采集地址名 |
+| 详情 | detail（完整文本） |
+| 处理状态 | is_resolved |
+| 处理时间 | resolved_at |
+
+### 7. 状态机
+
+告警类型(alert_type)：
+- collect_fail(采集失败): el-tag warning
+- device_offline(设备离线): el-tag danger
+- production_anomaly(产量异常): el-tag warning
+- unknown_device(未知设备): el-tag info
+- service_error(服务错误): el-tag danger
+
+处理状态(is_resolved)：
+- 0(未处理): el-tag danger -> 可标记已处理
+- 1(已处理): el-tag success -> 只读查看
+
+### 8. 交互流程
+
+- 加载：默认查未处理告警->请求列表API+统计API->渲染
+- 查询：选条件->查询->重置page=1->请求列表+统计
+- 重置：清空条件(恢复默认"未处理")->请求
+- 标记已处理：确认"确定标记为已处理？ "->调API->刷新列表+统计
+- 批量标记：勾选未处理告警->点批量标记->确认"确定对选中的{N}项标记为已处理？ "->调API->刷新
+- 查看详情：弹窗(只读)->关闭
+
+### 9. 空状态
+
+列表无数据：el-empty 暂无告警数据
+统计区：各类型计数为0时显示0
+
+### 10. Mock数据
+
+**GET /api/admin/alert/statistics 告警统计：**
+
+```json
+{ "code": 0, "data": { "unresolved": 15, "collectFail": 5, "deviceOffline": 6, "productionAnomaly": 2, "unknownDevice": 2, "serviceError": 0 }}
+```
+
+**GET /api/admin/alert 告警列表：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "createdAt": "2026-04-25T17:30:00", "alertType": "collect_fail", "title": "采集请求失败", "machineName": "西-1.8", "detail": "HTTP超时(30s)，连续失败3次", "isResolved": 0, "resolvedAt": null },
+  { "id": 2, "createdAt": "2026-04-25T17:00:00", "alertType": "device_offline", "title": "设备离线", "machineName": "东-2.5", "detail": "连续3次Ping失败，IP:10.1.2.5", "isResolved": 0, "resolvedAt": null },
+  { "id": 3, "createdAt": "2026-04-25T16:00:00", "alertType": "production_anomaly", "title": "产量骤降", "machineName": "南-3.1", "detail": "近1小时产量较前1小时下降>50%", "isResolved": 1, "resolvedAt": "2026-04-25T16:30:00" },
+  { "id": 4, "createdAt": "2026-04-25T15:00:00", "alertType": "unknown_device", "title": "未知设备接入", "machineName": null, "detail": "采集地址FANUC-A栋返回未注册设备: fanake_9.9", "isResolved": 0, "resolvedAt": null }
+], "total": 320, "page": 1, "pageSize": 20 }}
+```
+
+**POST /api/admin/alert/resolve 标记已处理：**
+
+```json
+{ "code": 0, "message": "success", "data": null }
+```
+
+### 11. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 告警列表(含分页) | cnc_alert | 主表，需JOIN机床名 |
+| 告警统计(按类型) | cnc_alert | GROUP BY alert_type, is_resolved |
+| 标记已处理 | cnc_alert.is_resolved/resolved_at | 批量更新 |
+| 机床下拉 | cnc_machine | 查询条件 |
--- a/docs/02-功能清单/管理后台/09-系统设置/00-系统设置-索引.md
+++ b/docs/02-功能清单/管理后台/09-系统设置/00-系统设置-索引.md
@ -0,0 +1,47 @@
+# 系统设置 索引
+
+> 版本：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) |
+
+---
--- a/docs/02-功能清单/管理后台/09-系统设置/01-系统设置-规范.md
+++ b/docs/02-功能清单/管理后台/09-系统设置/01-系统设置-规范.md
@ -0,0 +1,10 @@
+# 系统设置 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/09-系统设置/09-01-系统设置页面.md
+++ b/docs/02-功能清单/管理后台/09-系统设置/09-01-系统设置页面.md
@ -0,0 +1,245 @@
+# 系统设置页面
+
+> 最后更新：2026-04-26
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /settings |
+| 权限 | admin |
+| 入口 | 侧边栏系统设置 |
+| 面包屑 | 首页 / 系统设置 |
+
+### 2. 界面布局
+
+```
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 系统设置                                   │
+├──────────────────────────────────────────────────────────┤
+│ [Tab切换]  [系统配置]  [车间管理]  [修改密码]               │
+├──────────────────────────────────────────────────────────┤
+│                                                          │
+│ ====== Tab1: 系统配置 ======                             │
+│                                                          │
+│ [查询条件区]                                              │
+│ 关键字[___________]                          [查询] [重置]  │
+│                                                          │
+│ [列表区]                                                  │
+│ 配置项           | 值              | 类型  | 说明    | 操作 │
+│ ping_interval    | 60              | number| Ping间隔| [编辑] │
+│ collect_retry    | 3               | number| 重试次数| [编辑] │
+│ daily_summary    | 01:00           | string| 汇总时间| [编辑] │
+│ log_retention    | 90              | number| 日志保留| [编辑] │
+│ api_token        | ********        | string| API Token| [编辑][重置] │
+│                                                          │
+│ ====== Tab2: 车间管理 ======                             │
+│                                                          │
+│ [+ 新增车间]                                              │
+│ [列表区]                                                  │
+│ 车间名称  | 排序 | 状态 | 操作                             │
+│ A栋      | 1    | 启用 | [编辑][删除]                      │
+│ B栋      | 2    | 启用 | [编辑][删除]                      │
+│ C栋      | 3    | 停用 | [编辑][启用]                      │
+│                                                          │
+│ ====== Tab3: 修改密码 ======                             │
+│                                                          │
+│ ┌──────────────────────────┐                              │
+│ │ 当前密码  [__________]   │                              │
+│ │ 新密码    [__________]   │                              │
+│ │ 确认密码  [__________]   │                              │
+│ │           [确认修改]      │                              │
+│ └──────────────────────────┘                              │
+└──────────────────────────────────────────────────────────┘
+```
+
+### 3. Tab1-系统配置
+
+#### 查询条件
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 关键字 | el-input placeholder=配置项/说明 | 否 | 空 | - | 无 |
+
+#### 列表字段
+
+| 字段名 | 列宽 | 排序 | 超长处理 | 对齐 |
+|--------|------|------|---------|------|
+| 配置项(config_key) | 200px | - | tooltip | left |
+| 配置值(config_value) | auto | - | tooltip | left |
+| 值类型(value_type) | 80px | - | - | center |
+| 说明(description) | 200px | - | tooltip | left |
+| 操作 | 160px | - | - | center |
+
+#### 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 编辑 | settings:update | 行操作 | 始终 | 打开编辑弹窗 |
+| 重置Token | settings:reset-token | 行操作 | config_key=api_token或collector_api_key | 确认"确定重置{配置项}？重置后需同步更新相关服务配置。 "->调API |
+
+#### 弹窗规格
+
+**编辑配置项弹窗：**
+- 宽度500px，标题=编辑配置项
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 配置项 | el-input disabled | - | config_key | - | - |
+| 配置值 | el-input(根据value_type切换number/string) | 是 | 当前值 | 必填 | value_type=number时控件为el-input-number |
+| 说明 | el-input disabled | - | description | - | - |
+
+说明：敏感字段(api_token/collector_api_key)显示为"********"，编辑弹窗中也默认遮蔽，点击眼睛图标切换可见。
+
+### 4. Tab2-车间管理
+
+#### 列表字段
+
+| 字段名 | 列宽 | 排序 | 超长处理 | 对齐 |
+|--------|------|------|---------|------|
+| 车间名称 | 200px | - | tooltip | left |
+| 排序 | 80px | y | - | center |
+| 状态 | 80px | - | - | center |
+| 操作 | 160px | - | - | center |
+
+#### 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 新增车间 | workshop:create | 页头 | 始终 | 打开新增弹窗 |
+| 编辑 | workshop:update | 行操作 | 始终 | 打开编辑弹窗 |
+| 删除 | workshop:delete | 行操作 | 启用状态且无关联机床 | 确认->删除 |
+| 启用/停用 | workshop:toggle | 行操作 | 始终 | 确认->切换状态 |
+
+#### 弹窗规格
+
+**新增/编辑车间弹窗：**
+- 宽度400px，标题=新增车间/编辑车间
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 车间名称 | el-input maxlength=100 | 是 | - | 必填+唯一性 | - |
+| 排序号 | el-input-number min=0 max=99 | 是 | 末尾 | 必填+正整数 | - |
+
+### 5. Tab3-修改密码
+
+#### 表单字段
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 当前密码 | el-input type=password show-password | 是 | - | 必填 | - |
+| 新密码 | el-input type=password show-password | 是 | - | 必填+长度8-32位 | - |
+| 确认密码 | el-input type=password show-password | 是 | - | 必填+与新密码一致 | 新密码变化时重新校验 |
+
+#### 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 确认修改 | - | 表单底部 | 始终 | 校验通过->调API->成功提示+清空表单 |
+
+### 6. 状态机
+
+车间is_enabled：
+- 1(启用): el-tag success -> 可编辑/停用/删除(无机床关联时)
+- 0(停用): el-tag danger -> 可编辑/启用
+
+删除前提：该车间下无机床（有关联机床的不可删除）
+
+### 7. 交互流程
+
+**Tab1-系统配置：**
+- 加载：请求配置项列表->渲染
+- 查询：关键字搜索->重置page=1->请求列表
+- 编辑：弹窗->修改值->保存->关闭->刷新列表
+- 重置Token：确认->调API重置->显示新值->提示"请同步更新相关服务配置"
+
+**Tab2-车间管理：**
+- 加载：请求车间列表->渲染（数据量极小，无需分页）
+- 新增：弹窗->填写->保存->关闭->刷新
+- 编辑：弹窗(回填)->修改->保存->关闭->刷新
+- 删除：确认"确定删除车间【{名称}】？此操作不可恢复。 "->调API->刷新
+- 启停：确认->调API->刷新
+
+**Tab3-修改密码：**
+- 填写表单->确认修改->校验->调API->成功提示"密码修改成功，请重新登录"->清除Token->跳转/login
+
+### 8. 空状态
+
+系统配置列表无数据：el-empty 暂无配置项
+车间列表无数据：el-empty 暂无车间数据，点击新增车间添加
+
+### 9. Mock数据
+
+**GET /api/admin/sys-config 系统配置列表：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "configKey": "ping_interval", "configValue": "60", "valueType": "number", "description": "Ping检测间隔(秒)" },
+  { "id": 2, "configKey": "collect_retry_count", "configValue": "3", "valueType": "number", "description": "采集失败重试次数" },
+  { "id": 3, "configKey": "collect_retry_interval", "configValue": "30", "valueType": "number", "description": "采集重试间隔(秒)" },
+  { "id": 4, "configKey": "collect_fail_alert_threshold", "configValue": "5", "valueType": "number", "description": "连续失败N次触发告警" },
+  { "id": 5, "configKey": "daily_summary_time", "configValue": "01:00", "valueType": "string", "description": "日终汇总执行时间" },
+  { "id": 6, "configKey": "log_retention_days", "configValue": "90", "valueType": "number", "description": "原始采集日志保留天数" },
+  { "id": 7, "configKey": "bigscreen_refresh_interval", "configValue": "10", "valueType": "number", "description": "大屏刷新间隔(秒)" },
+  { "id": 8, "configKey": "api_token", "configValue": "********", "valueType": "string", "description": "前端API Token" },
+  { "id": 9, "configKey": "collector_api_port", "configValue": "5800", "valueType": "number", "description": "采集服务管理API端口" },
+  { "id": 10, "configKey": "collector_api_key", "configValue": "********", "valueType": "string", "description": "采集服务间通信API Key" }
+]}}
+```
+
+**PUT /api/admin/sys-config/1 编辑配置项：**
+
+```json
+{ "code": 0, "message": "success", "data": null }
+```
+
+**POST /api/admin/sys-config/reset-token 重置Token：**
+
+```json
+{ "code": 0, "data": { "configKey": "api_token", "newValue": "eyJhbGciOiJIUzI1NiJ9.new.random.token" }}
+```
+
+**GET /api/admin/workshop 车间列表：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "name": "A栋", "sortOrder": 1, "isEnabled": 1, "machineCount": 32 },
+  { "id": 2, "name": "B栋", "sortOrder": 2, "isEnabled": 1, "machineCount": 28 },
+  { "id": 3, "name": "C栋", "sortOrder": 3, "isEnabled": 0, "machineCount": 0 }
+]}}
+```
+
+**POST /api/admin/workshop 新增车间：**
+
+```json
+{ "code": 0, "message": "success", "data": { "id": 4, "name": "D栋" }}
+```
+
+**POST /api/admin/change-password 修改密码：**
+
+```json
+{ "code": 0, "message": "success", "data": null }
+```
+
+**POST /api/admin/change-password 修改密码失败（旧密码错误）：**
+
+```json
+{ "code": 40001, "message": "当前密码不正确", "data": null }
+```
+
+### 10. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 系统配置列表 | cnc_sys_config | 主表 |
+| 编辑配置项 | cnc_sys_config.config_value | 按config_key更新 |
+| 重置Token | cnc_sys_config | 生成新随机Token写入 |
+| 车间列表 | cnc_workshop | 主表+关联机床数 |
+| 车间名称唯一性 | cnc_workshop.name UNIQUE | 新增/编辑时校验 |
+| 车间删除约束 | cnc_machine.workshop_id | 有关联机床时禁止删除 |
+| 修改密码 | admin密码校验 | 验证旧密码+写入新密码哈希 |
--- a/docs/02-功能清单/管理后台/10-车间管理/00-车间管理-索引.md
+++ b/docs/02-功能清单/管理后台/10-车间管理/00-车间管理-索引.md
@ -0,0 +1,10 @@
+# 车间管理 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+⚠️ 本模块已合并至 **09-系统设置**，作为系统设置页面的一个Tab页。车间数据量极小（约3条），不单独占一级侧边栏。
+
+---
--- a/docs/02-功能清单/管理后台/10-车间管理/01-车间管理-规范.md
+++ b/docs/02-功能清单/管理后台/10-车间管理/01-车间管理-规范.md
@ -0,0 +1,10 @@
+# 车间管理 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/10-车间管理/10-01-车间管理页面.md
+++ b/docs/02-功能清单/管理后台/10-车间管理/10-01-车间管理页面.md
@ -0,0 +1,4 @@
+<!-- 待设计 -->
+
+> 页面类型：列表页（数据量极小，无分页）
+> 必填项参照：`02-前端全局规范.md` → 列表页必填项
--- a/docs/02-功能清单/管理后台/11-操作日志/00-操作日志-索引.md
+++ b/docs/02-功能清单/管理后台/11-操作日志/00-操作日志-索引.md
@ -0,0 +1,44 @@
+# 操作日志 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+查看产量修正审计日志和系统运行日志，只读不可编辑。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 11-01 | 操作日志页面 | /log | 待设计 |
+
+## 页面功能详情
+
+### 11-01 操作日志页面
+**路由**：`/log`
+**功能概述**：双Tab只读查看——产量修正审计日志（可导出）+系统运行日志（含堆栈详情）
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 查询修正日志 | Tab1查询 | 重置page=1，请求列表 | GET /api/admin/log/adjustment |
+| F02 | 导出修正日志 | Tab1导出 | 下载Excel | GET /api/admin/log/adjustment/export |
+| F03 | 查询系统日志 | Tab2查询 | 重置page=1，请求列表 | GET /api/admin/log/system |
+| F04 | 查看日志详情 | Tab2点击行 | 弹窗展示完整消息+堆栈+附加数据 | - (行数据已含) |
+
+**业务规则**：
+- 全部只读，无编辑/删除操作
+- 产量修正日志来源于cnc_production_adjustment审计表
+- 系统运行日志来源于日志库log_system表，按月分区
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 11-01 | 操作日志页面 | 页面文件 | [11-01-操作日志页面.md](./11-01-操作日志页面.md) |
+
+---
--- a/docs/02-功能清单/管理后台/11-操作日志/01-操作日志-规范.md
+++ b/docs/02-功能清单/管理后台/11-操作日志/01-操作日志-规范.md
@ -0,0 +1,10 @@
+# 操作日志 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/11-操作日志/11-01-操作日志页面.md
+++ b/docs/02-功能清单/管理后台/11-操作日志/11-01-操作日志页面.md
@ -0,0 +1,181 @@
+# 操作日志页面
+
+> 最后更新：2026-04-26
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /log |
+| 权限 | admin |
+| 入口 | 侧边栏操作日志 |
+| 面包屑 | 首页 / 操作日志 |
+
+### 2. 界面布局
+
+```
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 操作日志                                   │
+├──────────────────────────────────────────────────────────┤
+│ [Tab切换]  [产量修正日志]  [系统运行日志]                    │
+├──────────────────────────────────────────────────────────┤
+│                                                          │
+│ ====== Tab1: 产量修正日志 ======                          │
+│                                                          │
+│ [查询条件区]                                              │
+│ 时间范围[__________]  目标[▼全部]  关键字[________]         │
+│                                    [查询] [重置] [导出]    │
+│                                                          │
+│ [列表区]                                                  │
+│ 修正时间          | 目标表          | 目标ID | 修正前 | 修正后 | 原因          | 操作IP     │
+│ 2026-04-25 15:30 | daily_production | 3    | 310   | 320  | 传感器计数偏差 | 192.168.1.5│
+│ 2026-04-24 10:15 | worker_summary   | 12   | 850   | 900  | 漏计补录      | 192.168.1.5│
+│                                                          │
+│ [分页]  共80条  每页[20▼]  < 1 2 3 4 >                  │
+│                                                          │
+│ ====== Tab2: 系统运行日志 ======                          │
+│                                                          │
+│ [查询条件区]                                              │
+│ 日志级别[▼全部]  来源[▼全部]  时间范围[__________]          │
+│ 关键字[___________]                        [查询] [重置]    │
+│                                                          │
+│ [列表区]                                                  │
+│ 时间              | 级别   | 来源         | 消息                │
+│ 2026-04-25 17:36 | INFO  | CncCollector | 采集完成:32台成功    │
+│ 2026-04-25 17:35 | WARN  | CncCollector | 采集失败:1台超时     │
+│ 2026-04-25 17:00 | ERROR | CncCollector | 连接拒绝:10.1.2.5   │
+│                                                          │
+│ [分页]  共5600条  每页[20▼]  < 1 2 3 ... 280 >          │
+└──────────────────────────────────────────────────────────┘
+```
+
+### 3. Tab1-产量修正日志
+
+#### 查询条件
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 时间范围 | el-date-picker type=daterange | 否 | 空 | - | 无 |
+| 目标表 | el-select(daily_production/worker_daily_summary/全部) | 否 | 全部 | - | 无 |
+| 关键字 | el-input placeholder=原因/操作IP | 否 | 空 | - | 无 |
+
+#### 列表字段
+
+| 字段名 | 列宽 | 排序 | 超长处理 | 对齐 |
+|--------|------|------|---------|------|
+| 修正时间 | 170px | y(默认倒序) | - | center |
+| 目标表 | 150px | - | tooltip | left |
+| 目标ID | 80px | - | - | center |
+| 修正前 | 80px | - | - | center |
+| 修正后 | 80px | - | - | center |
+| 修正原因 | auto | - | tooltip | left |
+| 操作IP | 130px | - | - | center |
+
+### 4. Tab2-系统运行日志
+
+#### 查询条件
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 日志级别 | el-select(ERROR/WARN/INFO/DEBUG/全部) | 否 | 全部 | - | 无 |
+| 来源 | el-select(CncCollector/WebApi/Scheduler/全部) | 否 | 全部 | - | 无 |
+| 时间范围 | el-date-picker type=daterange | 否 | 空 | - | 无 |
+| 关键字 | el-input placeholder=消息内容 | 否 | 空 | - | 无 |
+
+#### 列表字段
+
+| 字段名 | 列宽 | 排序 | 超长处理 | 对齐 |
+|--------|------|------|---------|------|
+| 时间 | 170px | y(默认倒序) | - | center |
+| 级别 | 80px | - | - | center |
+| 来源 | 130px | - | tooltip | left |
+| 消息 | auto | - | tooltip+点击展开详情 | left |
+
+### 5. 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 查询 | - | 查询区 | 始终 | 重置page=1->请求列表 |
+| 重置 | - | 查询区 | 始终 | 清空条件->请求列表 |
+| 导出 | log:export | 查询区 | Tab1产量修正日志 | 按当前查询条件导出Excel |
+| 查看详情 | - | 行操作 | Tab2系统运行日志 | 弹窗展示完整消息+堆栈 |
+
+### 6. 弹窗规格
+
+**系统日志详情弹窗（只读）：**
+- 宽度700px，标题=日志详情
+
+| 展示字段 | 说明 |
+|---------|------|
+| 时间 | created_at |
+| 级别 | log_level |
+| 来源 | source |
+| 消息 | message（完整文本，支持换行） |
+| 堆栈信息 | stack_trace（代码格式化展示，无则为空） |
+| 附加数据 | extra_data（JSON格式化展示） |
+
+### 7. 状态机
+
+日志级别(log_level)：
+- ERROR: el-tag danger
+- WARN: el-tag warning
+- INFO: el-tag success
+- DEBUG: el-tag info
+
+### 8. 交互流程
+
+**Tab1-产量修正日志：**
+- 加载：请求修正日志列表->渲染
+- 查询：选条件->查询->重置page=1->请求列表
+- 重置：清空条件->请求
+- 导出：调API下载Excel
+
+**Tab2-系统运行日志：**
+- 加载：请求系统日志列表->渲染
+- 查询：选条件->查询->重置page=1->请求列表
+- 重置：清空条件->请求
+- 查看详情：弹窗(只读)->展示完整消息+堆栈+附加数据->关闭
+
+### 9. 空状态
+
+修正日志无数据：el-empty 暂无产量修正记录
+系统日志无数据：el-empty 暂无系统日志
+查询无结果：el-empty 未找到匹配的日志，请调整查询条件
+
+### 10. Mock数据
+
+**GET /api/admin/log/adjustment 产量修正日志：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "createdAt": "2026-04-25T15:30:00", "targetTable": "daily_production", "targetId": 3, "oldValue": 310, "newValue": 320, "reason": "传感器计数偏差，手工校准", "operatorIp": "192.168.1.5" },
+  { "id": 2, "createdAt": "2026-04-24T10:15:00", "targetTable": "worker_daily_summary", "targetId": 12, "oldValue": 850, "newValue": 900, "reason": "漏计补录，夜班产量未计入", "operatorIp": "192.168.1.5" }
+], "total": 80, "page": 1, "pageSize": 20 }}
+```
+
+**GET /api/admin/log/system 系统运行日志：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "createdAt": "2026-04-25T17:36:38", "logLevel": "INFO", "source": "CncCollector", "message": "采集完成: 32台成功, 0台失败", "stackTrace": null, "extraData": null },
+  { "id": 2, "createdAt": "2026-04-25T17:35:38", "logLevel": "WARN", "source": "CncCollector", "message": "采集失败: 1台超时(fanake_2.5)", "stackTrace": null, "extraData": "{\"machineId\":4,\"addressId\":2,\"error\":\"timeout\"}" },
+  { "id": 3, "createdAt": "2026-04-25T17:00:00", "logLevel": "ERROR", "source": "CncCollector", "message": "连接拒绝: 10.1.2.5", "stackTrace": "System.Net.Http.HttpRequestException: Connection refused\n  at CncCollector.HttpClientWrapper.SendAsync()", "extraData": null },
+  { "id": 4, "createdAt": "2026-04-25T01:00:00", "logLevel": "INFO", "source": "Scheduler", "message": "日终汇总完成: 160台, 耗时12秒", "stackTrace": null, "extraData": null }
+], "total": 5600, "page": 1, "pageSize": 20 }}
+```
+
+**GET /api/admin/log/adjustment/export 导出修正日志（返回文件流）：**
+二进制Excel文件，Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
+
+### 11. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 产量修正日志 | cnc_production_adjustment | 主表(业务库) |
+| 系统运行日志 | log_system | 主表(日志库)，按月分区 |
+| 导出修正日志 | cnc_production_adjustment | 导出Excel |
--- a/docs/02-功能清单/管理后台/12-大屏配置/00-大屏配置-索引.md
+++ b/docs/02-功能清单/管理后台/12-大屏配置/00-大屏配置-索引.md
@ -0,0 +1,49 @@
+# 大屏配置 索引
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+## 模块概述
+
+管理大屏看板的卡片配置和筛选配置。配置大屏显示哪些卡片、卡片类型（统计数字/柱状图/折线图/饼图/状态网格/排行榜）、指标、排序，以及大屏的默认筛选条件。
+
+## 页面清单
+
+| 页面编号 | 页面名称 | 路由 | 功能概述 |
+|---------|---------|------|---------|
+| 12-01 | 大屏配置页面 | /screen-config | 卡片配置列表+编辑+筛选配置 |
+
+## 页面功能详情
+
+### 12-01 大屏配置页面
+**路由**：`/screen-config`
+**功能概述**：管理大屏卡片（增删改排序+启用禁用）和筛选条件配置
+
+**功能列表**：
+
+| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
+|---------|---------|---------|---------|---------|
+| F01 | 加载卡片配置列表 | 页面挂载 | 请求列表API | GET /api/admin/screen-config |
+| F02 | 加载筛选配置列表 | 页面挂载 | 请求筛选列表API | GET /api/admin/screen-filter |
+| F03 | 新增卡片 | 点击新增 | 弹窗填写->保存 | POST /api/admin/screen-config |
+| F04 | 编辑卡片 | 点击编辑 | 弹窗回填->修改->保存 | PUT /api/admin/screen-config/{id} |
+| F05 | 删除卡片 | 点击删除 | 确认->删除 | DELETE /api/admin/screen-config/{id} |
+| F06 | 启停卡片 | 点击启用/禁用 | 确认->切换 | PUT /api/admin/screen-config/{id}/toggle |
+| F07 | 调整卡片排序 | 拖拽或输入排序号 | 保存排序 | PUT /api/admin/screen-config/sort |
+| F08 | 编辑图表配置 | 弹窗内选择图表类型+配置 | 保存 | PUT /api/admin/screen-config/{id} |
+| F09 | 新增筛选条件 | 点击新增筛选 | 弹窗填写->保存 | POST /api/admin/screen-filter |
+| F10 | 删除筛选条件 | 点击删除 | 确认->删除 | DELETE /api/admin/screen-filter/{id} |
+
+**状态机**：卡片is_enabled：1(启用)/0(停用)
+
+**路由跳转**：无（本模块无详情页）
+
+## 子目录/文件
+
+| 编号 | 名称 | 类型 | 索引 |
+|------|------|------|------|
+| 12-01 | 大屏配置页面 | 页面文件 | [12-01-大屏配置页面.md](./12-01-大屏配置页面.md) |
+
+---
--- a/docs/02-功能清单/管理后台/12-大屏配置/01-大屏配置-规范.md
+++ b/docs/02-功能清单/管理后台/12-大屏配置/01-大屏配置-规范.md
@ -0,0 +1,10 @@
+# 大屏配置 规范
+
+> 版本：v1.0
+> 最后更新：2026-04-25
+
+---
+
+继承上级规范，如有冲突按本目录规范执行。
+
+---
--- a/docs/02-功能清单/管理后台/12-大屏配置/12-01-大屏配置页面.md
+++ b/docs/02-功能清单/管理后台/12-大屏配置/12-01-大屏配置页面.md
@ -0,0 +1,165 @@
+# 大屏配置页面
+
+> 最后更新：2026-04-25
+> 状态：已设计
+
+---
+
+### 1. 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 路由 | /screen-config |
+| 权限 | admin |
+| 入口 | 侧边栏大屏配置 |
+| 面包屑 | 首页 / 大屏配置 |
+
+### 2. 界面布局
+
+┌──────────────────────────────────────────────────────────┐
+│ [面包屑] 首页 / 大屏配置                                   │
+├──────────────────────────────────────────────────────────┤
+│ [卡片配置区]                        [+ 新增卡片]          │
+│ 卡片名称    | 类型       | 指标      | 排序 | 状态 | 操作  │
+│ 在线机床数  | stat_number| online   | 1    | 启用 | [编辑][禁用][删除] │
+│ 各车间产量  | bar_chart  | part_count| 3   | 启用 | [编辑][禁用][删除] │
+│ 产量趋势    | line_chart | part_count| 7   | 启用 | [编辑][禁用][删除] │
+│ 机床状态总览| status_grid| -        | 5    | 启用 | [编辑][禁用][删除] │
+│ 工人产量排行| rank_list  | part_count| 4   | 停用 | [编辑][启用][删除] │
+├──────────────────────────────────────────────────────────┤
+│ [筛选配置区]                        [+ 新增筛选]          │
+│ 筛选标识    | 筛选类型   | 筛选值    | 默认 | 排序 | 操作  │
+│ screen_main | workshop   | A栋      | 是   | 1    | [编辑][删除] │
+│ screen_main | workshop   | B栋      | 否   | 2    | [编辑][删除] │
+│ screen_main | brand      | FANUC    | 否   | 3    | [编辑][删除] │
+└──────────────────────────────────────────────────────────┘
+
+### 3. 查询条件
+
+无（配置项数量少）。
+
+### 4. 列表字段
+
+**卡片配置表：**
+
+| 字段名 | 列宽 | 排序 | 超长处理 | 对齐 |
+|--------|------|------|---------|------|
+| 卡片名称 | 150px | - | tooltip | left |
+| 卡片类型 | 120px | - | - | center |
+| 指标 | 120px | - | tooltip | left |
+| 排序 | 80px | y | - | center |
+| 状态 | 80px | - | - | center |
+| 操作 | 200px | - | - | center |
+
+**筛选配置表：**
+
+| 字段名 | 列宽 | 排序 | 超长处理 | 对齐 |
+|--------|------|------|---------|------|
+| 筛选标识 | 120px | - | tooltip | left |
+| 筛选类型 | 120px | - | - | center |
+| 筛选值 | 150px | - | tooltip | left |
+| 默认 | 60px | - | - | center |
+| 排序 | 80px | y | - | center |
+| 操作 | 120px | - | - | center |
+
+### 5. 操作按钮
+
+| 名称 | 权限编码 | 位置 | 显示条件 | 点击行为 |
+|------|---------|------|---------|---------|
+| 新增卡片 | screen-config:create | 卡片区页头 | 始终 | 打开新增卡片弹窗 |
+| 编辑 | screen-config:update | 行操作 | 始终 | 打开编辑弹窗 |
+| 启用/禁用 | screen-config:toggle | 行操作 | 始终 | 确认->切换状态 |
+| 删除 | screen-config:delete | 行操作 | 始终 | 确认->删除 |
+| 新增筛选 | screen-filter:create | 筛选区页头 | 始终 | 打开新增筛选弹窗 |
+
+### 6. 弹窗规格
+
+**新增/编辑卡片弹窗：**
+- 宽度600px，遮罩有，ESC关闭是(脏数据检测)
+
+表单字段：
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 卡片名称 | el-input maxlength=100 | 是 | - | 必填 | - |
+| 卡片标识 | el-input maxlength=50 | 是 | - | 必填+唯一性(新增时) | - |
+| 卡片类型 | el-select(stat_number/bar_chart/line_chart/pie_chart/status_grid/rank_list) | 是 | - | 必填 | 类型变化时图表配置区域联动 |
+| 指标 | el-select(online_count/part_count等) | 是 | - | 必填 | - |
+| 维度 | el-select(workshop/worker/machine等) | 否 | - | - | 选择rank_list或bar_chart时必填 |
+| 排序号 | el-input-number min=1 max=99 | 是 | 末尾 | 必填+正整数 | - |
+| 图表配置 | JSON编辑器(el-input textarea) | 否 | - | JSON格式校验 | 选择图表类型时显示 |
+
+卡片类型说明：
+- stat_number：统计数字卡片（如在线机床数）
+- bar_chart：柱状图（如各车间产量）
+- line_chart：折线图（如产量趋势）
+- pie_chart：饼图
+- status_grid：状态网格（如机床状态总览）
+- rank_list：排行榜（如工人产量排行）
+
+**新增/编辑筛选弹窗：**
+- 宽度500px
+
+| 字段 | 控件 | 必填 | 默认值 | 校验 | 联动 |
+|------|------|------|--------|------|------|
+| 筛选标识 | el-input maxlength=50 | 是 | - | 必填 | - |
+| 筛选类型 | el-select(workshop/brand等) | 是 | - | 必填 | - |
+| 筛选值 | el-input maxlength=100 | 是 | - | 必填 | - |
+| 默认选中 | el-switch | 否 | 否 | - | - |
+| 排序号 | el-input-number min=1 max=99 | 是 | 末尾 | 必填+正整数 | - |
+
+### 7. 状态机
+
+卡片is_enabled：
+- 1(启用): el-tag success -> 可编辑/禁用/删除
+- 0(停用): el-tag danger -> 可编辑/启用/删除
+
+### 8. 交互流程
+
+- 加载：请求卡片配置列表+筛选配置列表->渲染两个区域
+- 新增卡片：弹窗->选卡片类型(联动图表配置)->填写->保存->关闭->刷新
+- 编辑卡片：弹窗(回填)->修改->保存->关闭->刷新
+- 启停卡片：确认->调API->刷新
+- 删除卡片：确认"确定删除卡片【{名称}】？此操作不可恢复。 "->调API->刷新
+- 新增筛选：弹窗->填写->保存->关闭->刷新
+- 修改排序：修改排序号->自动保存或手动保存
+
+### 9. 空状态
+
+卡片列表无数据：el-empty 暂无卡片配置，点击新增卡片添加
+筛选列表无数据：el-empty 暂无筛选配置
+
+### 10. 数据需求
+
+> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
+
+| 数据需求 | 草案对应 | 说明 |
+|---------|---------|------|
+| 卡片配置列表 | cnc_screen_config | 主表，含card_key/card_type/title/metric/dimension/sort_order/is_enabled/chart_config |
+| 筛选配置列表 | cnc_screen_filter | 主表，含screen_key/filter_type/filter_value/is_default/sort_order |
+
+### 11. Mock数据
+
+**GET /api/admin/screen-config 卡片配置列表：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "cardKey": "total_online", "cardType": "stat_number", "title": "在线机床数", "metric": "online_count", "dimension": null, "sortOrder": 1, "isEnabled": 1, "chartConfig": null },
+  { "id": 2, "cardKey": "total_production_today", "cardType": "stat_number", "title": "今日总产量", "metric": "part_count", "dimension": null, "sortOrder": 2, "isEnabled": 1, "chartConfig": null },
+  { "id": 3, "cardKey": "workshop_production", "cardType": "bar_chart", "title": "各车间产量", "metric": "part_count", "dimension": "workshop", "sortOrder": 3, "isEnabled": 1, "chartConfig": "{\"xAxis\":\"workshop\",\"yAxis\":\"part_count\"}" },
+  { "id": 4, "cardKey": "worker_rank", "cardType": "rank_list", "title": "工人产量排行", "metric": "part_count", "dimension": "worker", "sortOrder": 4, "isEnabled": 0, "chartConfig": null },
+  { "id": 5, "cardKey": "machine_status", "cardType": "status_grid", "title": "机床状态总览", "metric": null, "dimension": null, "sortOrder": 5, "isEnabled": 1, "chartConfig": null },
+  { "id": 6, "cardKey": "collector_status", "cardType": "stat_number", "title": "采集服务状态", "metric": null, "dimension": null, "sortOrder": 6, "isEnabled": 1, "chartConfig": null },
+  { "id": 7, "cardKey": "production_trend", "cardType": "line_chart", "title": "产量趋势(7天)", "metric": "part_count", "dimension": null, "sortOrder": 7, "isEnabled": 1, "chartConfig": "{\"xAxis\":\"date\",\"yAxis\":\"part_count\"}" },
+  { "id": 8, "cardKey": "machine_rank", "cardType": "rank_list", "title": "机床产量排行", "metric": "part_count", "dimension": "machine", "sortOrder": 8, "isEnabled": 1, "chartConfig": null }
+]}}
+```
+
+**GET /api/admin/screen-filter 筛选配置列表：**
+
+```json
+{ "code": 0, "data": { "items": [
+  { "id": 1, "screenKey": "screen_main", "filterType": "workshop", "filterValue": "A栋", "isDefault": 1, "sortOrder": 1 },
+  { "id": 2, "screenKey": "screen_main", "filterType": "workshop", "filterValue": "B栋", "isDefault": 0, "sortOrder": 2 },
+  { "id": 3, "screenKey": "screen_main", "filterType": "brand", "filterValue": "FANUC", "isDefault": 0, "sortOrder": 3 }
+]}}
--- a/docs/前端检查规范.md
+++ b/docs/前端检查规范.md
@ -0,0 +1,152 @@
+# 前端检查规范
+
+**版本**: 1.0  
+**更新时间**: 2026-04-27  
+**适用范围**: CNC机床数据采集系统前端（Vue 3 + Vite + Element Plus + ECharts）
+
+---
+
+## 一、核心验收标准
+
+### 1. Mock路由访问
+- **要求**: 通过URL中添加 `/mock` 前缀，可访问所有前端界面
+- **验证方式**: 访问 `http://localhost:5173/mock/login`，登录后可正常浏览所有16个页面
+- **验收条件**: 
+  - `/mock/login` 可正常显示登录页
+  - 登录后跳转至 `/mock/dashboard`
+  - 侧边栏所有菜单项点击后正确跳转到 `/mock/*` 路径下对应页面
+  - 页面刷新后仍保持在 `/mock/*` 路径下
+
+### 2. Mock数据贯穿
+- **要求**: 通过 `/mock/login` 登录后，整个后台所有功能均使用Mock数据
+- **验证方式**: 所有API请求应走 `/mock-api/` 前缀
+- **验收条件**:
+  - 登录验证使用Mock凭据（admin / admin123）
+  - 所有列表页数据来自Mock API
+  - 新增/编辑/删除操作调用Mock API并刷新页面数据
+  - 不出现真实API调用（无 `/api/` 前缀请求）
+
+### 3. 控制台零错误零警告
+- **要求**: 后台所有功能交互正常，浏览器控制台不能有错误（Error）和警告（Warning）
+- **验证方式**: 逐页访问，检查浏览器DevTools Console面板
+- **验收条件**:
+  - `console.error` 数量 = 0
+  - `console.warn` 数量 = 0
+  - 无未捕获的JS异常
+  - 无Vue组件渲染警告
+  - 无网络请求失败（HTTP 4xx/5xx）
+
+### 4. UI元素正常显示
+- **要求**: 所有UI元素可正常显示和交互
+- **验收条件**:
+  - Select下拉框宽度足够显示完整文字
+  - 表格列宽合理，文字不被截断
+  - 弹窗/对话框正常弹出和关闭
+  - 分页组件正常工作
+  - 表单验证提示正常显示
+
+---
+
+## 二、检查范围（16个页面 × 13个模块）
+
+### 管理后台页面（12个模块）
+
+| # | 模块 | 页面文件 | 路由路径 |
+|---|------|---------|---------|
+| 01 | 登录 | LoginPage.vue | /mock/login |
+| 02 | 仪表盘 | DashboardPage.vue | /mock/dashboard |
+| 03 | 设备管理-列表 | MachineListPage.vue | /mock/machine |
+| 03 | 设备管理-详情 | MachineDetailPage.vue | /mock/machine/:id |
+| 04 | 品牌模板-列表 | BrandListPage.vue | /mock/brand |
+| 04 | 品牌模板-编辑 | BrandEditPage.vue | /mock/brand/:id/edit |
+| 05 | 采集地址-列表 | CollectAddressListPage.vue | /mock/collect-address |
+| 05 | 采集地址-详情 | CollectAddressDetailPage.vue | /mock/collect-address/:id |
+| 06 | 员工管理-列表 | WorkerListPage.vue | /mock/worker |
+| 06 | 员工管理-详情 | WorkerDetailPage.vue | /mock/worker/:id |
+| 07 | 产量报表 | ProductionPage.vue | /mock/production |
+| 08 | 告警中心 | AlertPage.vue | /mock/alert |
+| 09 | 系统设置 | SettingsPage.vue | /mock/settings |
+| 10 | 车间管理 | （合并至系统设置Tab） | /mock/settings |
+| 11 | 操作日志 | LogPage.vue | /mock/log |
+| 12 | 大屏配置 | ScreenConfigPage.vue | /mock/screen-config |
+
+### 大屏看板（1个模块）
+
+| # | 模块 | 页面文件 | 路由路径 |
+|---|------|---------|---------|
+| 13 | 大屏看板 | ScreenPage.vue | /mock/screen |
+
+---
+
+## 三、逐页检查清单
+
+每页需检查以下项目：
+
+### 通用检查项（所有页面）
+- [ ] 页面正常加载，无白屏
+- [ ] 控制台无 Error
+- [ ] 控制台无 Warning
+- [ ] Mock API请求路径正确（`/mock-api/` 前缀）
+- [ ] 无网络请求失败
+
+### 列表页额外检查项
+- [ ] 表格数据正常渲染
+- [ ] 分页组件显示和切换正常
+- [ ] 搜索/筛选功能正常
+- [ ] 新增按钮弹出弹窗正常
+- [ ] 编辑按钮弹出弹窗并填充数据
+- [ ] 删除按钮弹出确认框
+- [ ] Select下拉框宽度正常
+
+### 详情页额外检查项
+- [ ] 从列表页点击可正确跳转
+- [ ] 基本信息区域数据展示正常
+- [ ] 返回按钮可正确返回列表页
+- [ ] 面包屑导航正确显示
+
+### 表单/弹窗检查项
+- [ ] 必填字段校验提示正常
+- [ ] 表单提交后数据刷新
+- [ ] 弹窗关闭后表单重置
+- [ ] Loading状态正常显示
+
+---
+
+## 四、构建验证
+
+### Vite Build
+- **命令**: `npx vite build`
+- **验收条件**: 
+  - 构建成功（exit code 0）
+  - 无编译错误
+  - 无TypeScript类型错误
+
+### TypeScript类型
+- **验收条件**: Vue文件中 `any` 类型使用 ≤ 5处（合理遗留）
+
+---
+
+## 五、执行方法
+
+### 自动化检查（Playwright）
+1. 启动dev server: `npx vite`
+2. 使用Playwright逐页访问
+3. 收集每个页面的console.error和console.warn
+4. 验证路由跳转和Mock数据
+
+### 手动检查补充
+1. 逐页点击所有按钮（新增/编辑/删除/导出）
+2. 验证弹窗交互
+3. 检查表格排序和分页
+4. 验证表单校验
+
+---
+
+## 六、问题等级定义
+
+| 等级 | 定义 | 示例 |
+|------|------|------|
+| 🔴 阻断 | 页面无法使用 | 白屏、JS报错导致功能不可用 |
+| 🟡 严重 | 核心功能异常 | 数据不显示、按钮无响应、弹窗打不开 |
+| 🟢 一般 | 非核心问题 | 样式偏移、文案不符、排序不生效 |
+| ⚪ 建议 | 优化建议 | 性能优化、代码风格统一 |
--- a/发那科系统采集示例.txt
+++ b/发那科系统采集示例.txt
@ -0,0 +1,280 @@
+[
+    {
+        "device": "fanake_1.8",
+        "desc": "西-1.8",
+        "tags": [
+            {
+                "id": "_io_status",
+                "desc": "设备状态",
+                "quality": "0",
+                "value": "1.00000",
+                "time": "2026-04-10 17:36:38"
+            },
+            {
+                "id": "Tag2",
+                "desc": "当前轴数",
+                "quality": "0",
+                "value": "4.00000",
+                "time": "2026-04-10 17:36:34"
+            },
+            {
+                "id": "Tag5",
+                "desc": "执行的NC主程序名",
+                "quality": "0",
+                "value": "1566.NC",
+                "time": "2026-04-10 17:36:35"
+            },
+            {
+                "id": "Tag6",
+                "desc": "执行的NC主程序号",
+                "quality": "0",
+                "value": "N0",
+                "time": "2026-04-10 17:36:35"
+            },
+            {
+                "id": "Tag7",
+                "desc": "当前加工程序内容",
+                "quality": "0",
+                "value": "<1566.NC>\nG40G49G80\n( NAME: Administrator )\n( M",
+                "time": "2026-04-10 17:36:35"
+            },
+            {
+                "id": "Tag8",
+                "desc": "当前加工零件数",
+                "quality": "0",
+                "value": "1219.00000",
+                "time": "2026-04-10 17:36:35"
+            },
+            {
+                "id": "Tag9",
+                "desc": "运行状态",
+                "quality": "0",
+                "value": "0.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag11",
+                "desc": "操作模式",
+                "quality": "0",
+                "value": "1.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag14",
+                "desc": "当前主轴倍率",
+                "quality": "0",
+                "value": "100.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag17",
+                "desc": "主轴设定速度",
+                "quality": "0",
+                "value": "300.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag18",
+                "desc": "进给设定速度",
+                "quality": "0",
+                "value": "0.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag19",
+                "desc": "主轴实际速度",
+                "quality": "0",
+                "value": "0.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag20",
+                "desc": "进给实际转速",
+                "quality": "0",
+                "value": "0.00000",
+                "time": "2026-04-10 17:36:37"
+            },
+            {
+                "id": "Tag21",
+                "desc": "主轴负载",
+                "quality": "0",
+                "value": "0.00000",
+                "time": "2026-04-10 17:36:37"
+            },
+            {
+                "id": "Tag22",
+                "desc": "开机时间",
+                "quality": "0",
+                "value": "23558160.00000",
+                "time": "2026-04-10 17:36:37"
+            },
+            {
+                "id": "Tag23",
+                "desc": "运行时间",
+                "quality": "0",
+                "value": "18224.00000",
+                "time": "2026-04-10 17:36:37"
+            },
+            {
+                "id": "Tag24",
+                "desc": "切削时间",
+                "quality": "0",
+                "value": "6848959.00000",
+                "time": "2026-04-10 17:36:37"
+            },
+            {
+                "id": "Tag25",
+                "desc": "循环时间",
+                "quality": "0",
+                "value": "699.00000",
+                "time": "2026-04-10 17:36:38"
+            },
+            {
+                "id": "Tag26",
+                "desc": "加工状态",
+                "quality": "0",
+                "value": "G01",
+                "time": "2026-04-10 17:36:38"
+            }
+        ]
+    },
+    {
+        "device": "fanake_1.9",
+        "desc": "西-1.9",
+        "tags": [
+            {
+                "id": "_io_status",
+                "desc": "设备状态",
+                "quality": "0",
+                "value": "1.00000",
+                "time": "2026-04-10 17:36:38"
+            },
+            {
+                "id": "Tag2",
+                "desc": "当前轴数",
+                "quality": "0",
+                "value": "4.00000",
+                "time": "2026-04-10 17:36:34"
+            },
+            {
+                "id": "Tag5",
+                "desc": "执行的NC主程序名",
+                "quality": "0",
+                "value": "O1",
+                "time": "2026-04-10 17:36:35"
+            },
+            {
+                "id": "Tag6",
+                "desc": "执行的NC主程序号",
+                "quality": "0",
+                "value": "N20",
+                "time": "2026-04-10 17:36:35"
+            },
+            {
+                "id": "Tag7",
+                "desc": "当前加工程序内容",
+                "quality": "0",
+                "value": "G99 G83 Z-43.000 Q3.000 R3.000 F60. \nG80 \nG00 Z",
+                "time": "2026-04-10 17:36:35"
+            },
+            {
+                "id": "Tag8",
+                "desc": "当前加工零件数",
+                "quality": "0",
+                "value": "62.00000",
+                "time": "2026-04-10 17:36:35"
+            },
+            {
+                "id": "Tag9",
+                "desc": "运行状态",
+                "quality": "0",
+                "value": "3.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag11",
+                "desc": "操作模式",
+                "quality": "0",
+                "value": "10.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag14",
+                "desc": "当前主轴倍率",
+                "quality": "0",
+                "value": "100.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag17",
+                "desc": "主轴设定速度",
+                "quality": "0",
+                "value": "450.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag18",
+                "desc": "进给设定速度",
+                "quality": "0",
+                "value": "60.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag19",
+                "desc": "主轴实际速度",
+                "quality": "0",
+                "value": "450.00000",
+                "time": "2026-04-10 17:36:36"
+            },
+            {
+                "id": "Tag20",
+                "desc": "进给实际转速",
+                "quality": "0",
+                "value": "60.00000",
+                "time": "2026-04-10 17:36:37"
+            },
+            {
+                "id": "Tag21",
+                "desc": "主轴负载",
+                "quality": "0",
+                "value": "25.00000",
+                "time": "2026-04-10 17:36:37"
+            },
+            {
+                "id": "Tag22",
+                "desc": "开机时间",
+                "quality": "0",
+                "value": "23784960.00000",
+                "time": "2026-04-10 17:36:37"
+            },
+            {
+                "id": "Tag23",
+                "desc": "运行时间",
+                "quality": "0",
+                "value": "24253.00000",
+                "time": "2026-04-10 17:36:37"
+            },
+            {
+                "id": "Tag24",
+                "desc": "切削时间",
+                "quality": "0",
+                "value": "8009398.00000",
+                "time": "2026-04-10 17:36:38"
+            },
+            {
+                "id": "Tag25",
+                "desc": "循环时间",
+                "quality": "0",
+                "value": "82.00000",
+                "time": "2026-04-10 17:36:38"
+            },
+            {
+                "id": "Tag26",
+                "desc": "加工状态",
+                "quality": "0",
+                "value": "G01",
+                "time": "2026-04-10 17:36:38"
+            }
+        ]
+    }
+]