enterprise-saa-s-dashboard-design/docs/产品原型文档.md

# 地空业务支撑平台 —— 生产管理子系统 产品原型文档

> 版本：v2.0  
> 更新日期：2026-04-20  
> 技术栈：Next.js 16 + React 19 + TailwindCSS + Lucide Icons  
> 主色调：`#4a7c59`（绿色系）

---

## 一、系统概述

本系统为"地空业务支撑平台"的生产管理子系统，面向地球物理仪器（高密度电法仪等）的全生命周期管理，涵盖：

- 设备型号管理（核心枢纽）
- 板卡型号管理
- 设备登记与装配
- 授权文件管理
- 配置文件管理
- 固件库管理
- 采集板校准
- 维修工单
- 报废回收

### 1.1 全局布局

| 区域 | 说明 |
|------|------|
| 左侧边栏（200px） | Logo + 分组导航菜单，固定不滚动 |
| 顶部 Header（56px） | 系统标题 + 数据统计/运营报告入口 + 用户菜单（用户管理/角色权限/操作日志/系统设置/退出） |
| 主内容区 | 背景色 `#F0F2F5`，内容区可滚动 |

### 1.2 导航菜单结构

| 分组 | 菜单项 | 路由 | 图标 |
|------|--------|------|------|
| — | 首页 | `/` | — |
| 设备 | 设备列表 | `/devices` | Monitor |
| 设备 | 设备型号管理 | `/models` | Settings2 |
| 板卡 | 板卡列表 | `/board-cards` | Gauge |
| 板卡 | 板卡版本管理 | `/boards` | Cpu |
| 维修 | 维修工单 | `/repair` | Wrench |
| 维修 | 报废回收 | `/scrap` | Recycle |

---

## 二、页面详细说明

---

### 2.1 首页 Dashboard

**路由**：`/`

#### 功能描述
系统首页，展示全局数据概览和待处理任务快捷入口。

#### 统计卡片（8个，可点击跳转）

| 指标 | 示例值 | 趋势 | 跳转 |
|------|--------|------|------|
| 设备总数 | 5,234 | +5.2% | `/devices` |
| 装配中 | 4,856 | +2.8% | `/devices` |
| 已激活 | 4,912 | +1.5% | `/devices` |
| 有新版本 | 156 | — | `/firmware` |
| 维修中 | 23 | -12.3% | `/repair` |
| 报废 | 56 | — | `/scrap` |
| 授权即将到期 | 45 | — | `/licenses` |
| 可升级 | 8 | — | `/firmware` |

#### 设备状态分布（横向条形图）

| 状态 | 颜色 |
|------|------|
| 已装配 | `#52C41A` |
| 已出厂 | `#FF4D4F` |
| 已激活 | `#FAAD14` |
| 报废 | `#8C8C8C` |

#### 待处理任务（2列布局，每组显示2条+查看全部链接）

| 任务组 | 跳转 |
|--------|------|
| 校准即将到期 | `/board-cards` |
| 维修工单 | `/repair` |
| 固件升级通知 | `/firmware` |
| 授权即将到期 | `/licenses` |

---

### 2.2 设备型号管理

**路由**：`/models`

#### 功能描述
管理设备型号（GD-30/GD-20/GD-10 Supreme），是平台核心枢纽，每个型号关联授权项、配置文件。

#### 页面区块

**1. 信息提示横幅**
- 绿色背景提示：型号管理是平台核心枢纽

**2. 型号列表（表格）**

| 列名 | 说明 |
|------|------|
| 型号名称 | 如 GD-30 Supreme |
| 编码 | 如 GD30 |
| 描述 | 如 高端高密度电法仪 |
| 状态 | 在产（绿色标签）/ 停产（黄色标签） |
| 创建日期 | 日期 |
| 操作 | 编辑 / 授权项（跳转`/licenses?model=型号名`）/ 配置（跳转`/config-files?model=型号名`）/ 固件（跳转`/firmware?model=型号代码`）/ BOM表（跳转`/models/bom?model=型号代码`） |

- 操作列为平铺按钮，不使用下拉菜单
- 右上角按钮：「新增设备型号」

**3. 装配 Checklist 模板**
- Tab 切换不同型号（GD30 / GD20 / GD10）
- 表格列：序号（可拖拽排序）、项目名称（点击可编辑）
- GD30 示例有 22 项检查项（主板SN扫码绑定、采集板SN录入、GPS/北斗检测、电池安装、IP66防护等）
- 右上角按钮：「新增模版」

#### 抽屉：新增设备型号（480px宽）

| 字段 | 类型 | 必填 |
|------|------|------|
| 型号名称 | 文本输入 | 是 |
| 型号编码 | 文本输入 | 是 |
| 状态 | 单选（在产/停产） | — |

#### 抽屉：新增 Checklist 模版（480px宽）

| 字段 | 类型 | 必填 |
|------|------|------|
| 设备型号 | 下拉选择 | 是 |
| 检查项列表 | 动态列表（可增删） | — |

---

### 2.3 板卡型号管理

**路由**：`/boards`

#### 功能描述
管理板卡型号信息，包括主协板、采集板、发射板、升压板。

#### 页面区块

**1. Tab 筛选**：全部 / 主协板 / 采集板 / 发射板 / 升压板

**2. 板卡列表（表格）**

| 列名 | 说明 |
|------|------|
| 类型 | 主协板/采集板/发射板/升压板 |
| 型号 | 如 MB-V2.3、RX-V2.2 |
| 最新固件版本 | 如 v2.3.5 |
| 操作 | 详情 / 固件（跳转`/firmware`） |

- 右上角按钮：「导出」「新增板卡」

#### 抽屉：板卡详情（560px宽）

包含以下信息区块：
- 基本信息：板卡类型、型号、当前固件、生产日期
- 固件升级记录：时间线（日期、版本变更、升级方式、操作人）
- 校准历史：日期、结果、到期日、校准人
- 服役记录：关联设备SN（可点击跳转）、服役时间段、状态（在役/已拆卸）
- 维修记录：关联工单号（可点击跳转）、日期、操作、操作人

---

### 2.4 设备列表

**路由**：`/devices`

#### 功能描述
展示所有设备，支持筛选和搜索。

#### 筛选条件

| 筛选项 | 类型 |
|--------|------|
| 设备型号 | 下拉（全部/GD30/GT20/GM10） |
| 设备状态 | 下拉（全部/已激活/已出厂/装配中） |
| 生产日期 | 日期选择器 |
| 产品型号 | 下拉 |
| 搜索 | 按钮 |

#### 设备卡片列表（非表格，卡片式）

每张卡片展示：
| 字段 | 说明 |
|------|------|
| 设备SN号 | 如 GD30-20240308-001 |
| 型号 | 如 GD30 高密度电法仪 |
| 状态 | 已激活（绿）/ 已出厂（橙）/ 装配中（绿底） |
| 主机版本 | 如 v2.3.5 |
| 生产日期 | 如 2024-03-08 14:30 |

卡片底部操作：
- 详情（跳转 `/devices/:sn`）
- 下线（仅已激活设备显示，红色）

- 右上角按钮：「导出」「登记设备」（跳转`/registration`）
- 分页：显示 X-Y / 共 N 台

---

### 2.5 设备详情

**路由**：`/devices/:id`

#### 功能描述
展示单台设备的完整信息，包含基本信息、授权、装配记录、子设备、固件、维修历史。

#### 页面区块

**1. 页面头部**
- 返回按钮 + 设备SN号 + 状态标签

**2. 基本信息卡片**

| 字段 | 示例 |
|------|------|
| 设备型号 | GD30 高密度电法仪 |
| 主机SN号 | GD30-2025-000001 |
| 设备状态 | 已激活 |
| 生产日期 | 2025-01-15 |
| 出厂日期 | 2025-02-01 |
| 激活日期 | 2025-02-10 |
| 装配人员 | 张工程师 |
| 测试人员 | 李工程师 |
| 客户名称 | 北京地质研究院 |

**3. 授权信息卡片**

| 字段 | 示例 |
|------|------|
| 到期日期 | 2026-02-10 |

- 授权功能模块标签列表：一维自电/电阻率/激电测试模块, 二维自电/电阻率/激电测试模块, 三维自电/电阻率/激电测试模块, 水上, 跨孔, 电流法
- 右上角「修改授权项」按钮，打开编辑抽屉可修改到期时间和勾选/取消授权模块
- 未配置时显示「配置授权项」按钮

**4. 装配记录卡片**

| 字段 | 示例 |
|------|------|
| 装配工单 | ASM-2025-000001 |
| 装配人员 | 张工程师 |
| 装配日期 | 2025-01-15 |
| 测试人员 | 李工程师 |
| 测试结果 | 通过 |
| Checklist完成 | 22/22 项 |

- Checklist 摘要（2列网格，勾选图标 + 项目名称）

**5. 子设备列表（表格）**

| 列名 | 说明 |
|------|------|
| 板卡类型 | 主板/采集板/发射板/测控板/升压板 |
| SN号 | 绿色可点击 |
| 硬件版本 | 如 A1 |
| 固件版本 | 如 v2.3.5 |
| 校准状态 | 已校准/无需校准 |
| 状态 | 正常 |

**6. 固件信息卡片**

| 字段 | 示例 |
|------|------|
| 当前固件版本 | v2.3.5 |
| 最后更新时间 | 2024-03-01 10:30 |
| 更新方式 | 远程OTA |
| 配置文件版本 | v1.2.0 |
| 配置同步时间 | 2024-03-01 10:35 |

- 配置文件 Tab 右上角「更换配置」按钮，打开抽屉可选择其他版本的配置文件替换
- 未配置时显示「选择配置文件」按钮

**7. 维修历史（时间线）**
- 每条记录：日期、类型（固件升级/主板更换/常规保养）、操作人、描述
- 右上角「查看全部」链接跳转 `/repair`

---


### 2.6 设备登记

**路由**：`/registration`

#### 功能描述
登记新设备信息，包含装机信息填写、BOM清单管理、装配Checklist执行。

#### 页面区块

**1. 装机信息卡片（表单）**

| 字段 | 类型 | 必填 | 示例 |
|------|------|------|------|
| 设备型号 | 下拉选择（GD-30/GD-20/GD-10 Supreme） | 是 | GD-30 Supreme |
| 主机SN号 | 文本输入 + 扫码按钮 | 是 | GD30-20240308-001 |
| 主板SN号 | 文本输入 + 扫码按钮 | 是 | MB20240308001 |
| 生产批次 | 下拉选择 + 手动输入 | 是 | BATCH-2025-Q1-001 |
| 装机测试状态 | 下拉（测试通过/测试不通过） | — | 测试通过 |
| 生产日期 | 日期选择器 | — | 2024-03-08 |
| 登记人 | 文本输入 | — | 张工 |

> 主机SN号和主板SN号支持扫码录入（扫码图标按钮），同时保留手动输入。

**2. 型号匹配提示横幅**
- 成功（绿色）：显示匹配到的授权文件、配置文件、固件版本
- 警告（黄色）：未匹配到型号关联信息，提示先在型号管理中配置

**3. 装机清单 BOM（表格）**

| 列名 | 说明 |
|------|------|
| 物料编码 | 如 MB-2024-001 |
| 物料名称 | 主协板/采集板/发射板/升压板/外壳机箱 |
| SN号 | 板卡SN号（带扫码图标，支持扫码录入） |
| 型号 | 如 MB-V2.3 |
| 版本 | 板卡版本号 |
| 校准状态 | 已校准/无需校准 |
| 数量 | 数字 |
| 操作 | 编辑 / 删除 |

- 采集板版本一致性检查：当有多块采集板时（如GD-30有2块），自动检测版本是否一致，不一致时显示红色警告，一致时显示绿色确认
- 右上角按钮：「导入」（打开Excel导入弹窗）

**4. 装配 Checklist（列表）**
- 进度显示：完成 X/Y
- 每项包含：勾选框、序号圆圈、项目名称、版本校验提示（红色警告）、拍照上传按钮
- 已完成项：绿色背景 + 已上传照片数量
- 未完成项：灰色背景 + 拍照上传按钮

**5. 底部操作栏（sticky）**
- 取消 / 更新 / 提交

#### 弹窗：导入BOM清单

| 区域 | 说明 |
|------|------|
| 第一步 | 下载导入模板（BOM导入模板.xlsx） |
| 第二步 | 上传Excel文件（支持 .xlsx/.xls/.csv，拖拽或点击上传） |
| 提示 | 黄色提示：确保格式与模板一致，物料编码和SN号为必填 |

#### 弹窗：上传照片

| 区域 | 说明 |
|------|------|
| 上传方式 | 两个入口：「直接拍照上传」（平板端直接拍照）和「手机扫码上传」（生成二维码，手机扫码拍照上传） |
| 照片网格 | 已上传照片缩略图（可删除）+ 添加更多按钮 |
| 装配记录信息 | 文本域，输入装配记录 |
| 操作 | 取消 / 确认上传（显示照片数量） |

---

### 2.7 授权管理

**路由**：`/licenses`（也支持 `?model=型号名` 参数筛选）

#### 功能描述
管理设备授权模块配置。每个设备型号对应一套授权模块，所有该型号设备共享同一套授权项。授权文件由授权项 + 配置文件共同生成。

#### 页面区块

**1. 信息提示横幅（青色）**
- 说明每个设备型号对应一套授权模块配置

**2. 筛选条件**

| 筛选项 | 类型 |
|--------|------|
| 设备型号 | 下拉（全部/GD-10/GD-20/GD-30） |

**3. 授权列表（表格，每型号一条记录）**

| 列名 | 说明 |
|------|------|
| 设备型号 | 如 GD-30 |
| 授权模块 | 标签形式展示已授权模块 |
| 更新日期 | 日期 |
| 操作 | 编辑 |

- 右上角按钮：「导出」「选择授权项」
- 从型号管理页跳转时自动按型号筛选，显示返回按钮

#### 授权模块定义（6个模块）

| 模块名称 | 说明 | GD-10 | GD-20 | GD-30 |
|----------|------|-------|-------|-------|
| 一维自电/电阻率/激电测试模块 | 包含一维自然电位法、电阻率测深、激发极化测深 | ✓ | ✓ | ✓ |
| 二维自电/电阻率/激电测试模块 | 包含二维自然电位法、电阻率成像、激发极化成像 | ✓ | ✓ | ✓ |
| 三维自电/电阻率/激电测试模块 | 包含三维自然电位法、电阻率成像、激发极化成像 | ✗ | ✓ | ✓ |
| 水上 | 水上电法探测 | ✗ | ✗ | ✓ |
| 跨孔 | 跨孔电阻率成像 | ✗ | ✗ | ✓ |
| 电流法 | 电流场法 | ✗ | ✗ | ✓ |

> 注：一维/二维/三维各为一个整体模块，不再拆分自电、电阻率、激电。

#### 抽屉：选择授权项（640px宽）

| 字段 | 类型 | 说明 |
|------|------|------|
| 设备型号 | 下拉选择 | 必填，切换型号自动预选对应授权项 |
| 授权有效期 | 下拉（永久/1年/2年/自定义） | — |
| 到期日期 | 日期选择器 | 仅"自定义"时显示 |

- 授权项按分类（一维/二维/三维/水上/跨孔/电流法）分组展示
- 底部提示：授权文件由选定的授权项与对应型号的配置文件共同生成
- 操作：全选 / 清空 / 取消 / 保存

---

### 2.8 配置文件管理

**路由**：`/config-files`（也支持 `?model=型号名` 参数筛选）

#### 功能描述
管理设备型号配置文件，包含发射参数、采集参数、网络参数等。

#### 页面区块

**1. 信息提示横幅（绿色）**
- 说明配置文件按设备型号绑定适配

**2. 筛选条件**

| 筛选项 | 类型 |
|--------|------|
| 适配型号 | 下拉 |
| 配置版本 | 下拉 |
| 关键字 | 文本输入 |
| 查询 | 按钮 |

**3. 配置文件列表（表格）**

| 列名 | 说明 |
|------|------|
| 配置文件 | 如 CFG-GD30-v1.2.0（绿色） |
| 适配型号 | 如 GD-30 Supreme |
| 版本 | 如 v1.2.0 |
| 创建时间 | 日期时间 |
| 状态 | 生效（绿）/ 已停用（灰） |
| 操作 | 详情 / 编辑 / 下载 / 删除 |

- 右上角按钮：「新建配置」
- 分页

#### 抽屉：新建配置文件（520px宽）

分为以下区块：

**基本信息**
| 字段 | 类型 | 必填 |
|------|------|------|
| 适配型号 | 下拉选择 (GD-10 Supreme/GD-20 Supreme/GD-30 Supreme) | 是 |
| 配置版本 | 文本输入 | 是 |

**发射参数**
| 字段 | 类型 |
|------|------|
| 最大发射电压 | 下拉（500V/800V/1000V/1200V/1500V） |
| 最大发射电流 | 下拉（2A/5A/8A/10A/15A） |
| 占空比 | 下拉 （50%）、（50%、100%）|
| 脉宽宽度 | 下拉（0.25s/0.5s/1s/2s/4s/8s/16s/32s/64s） /(0.25s/0.5s/1s/2s/4s/8s)|
| 迭代次数 | 下拉(1~256) |

**采集参数**
| 字段 | 类型 |
|------|------|
| 支持通道数 | 数字输入(1/6/12) |
| 采样率 | 下拉(50Hz/60Hz)/(50Hz/60Hz/100Hz/1000Hz) |
| 电压测量量程 | 下拉(±2.5V)/（±2.5V/±80V） /（±80V/±600V） |
| 全波形采集 | 下拉（支持/不支持） |

**网络参数**
| 字段 | 类型 |
|------|------|
| WiFi SSID 前缀 | 文本输入 |

---

### 2.9 参数配置（配置详情）

**路由**：`/config-files/:configId`

#### 功能描述
配置设备型号的详细参数，支持新建和编辑两种模式。

#### 页面区块

**1. 型号信息卡片**
- 新建模式：适配型号（下拉）、配置文件版本（输入）、状态（待生成）
- 编辑模式：适配型号（只读）、版本（只读）、最后更新时间

**2. 发射参数卡片**

| 字段 | 类型 |
|------|------|
| 最大发射电压 | 下拉（500V~1500V） |
| 最大发射电流 | 下拉（2A~10A） |
| 发射脉宽 | 多选标签（0.25s~64s，共9项） |
| 发射波形 | 多选标签（0+0-、+0-0、+-） |
| 支持全波形测量 | 复选框 |
| 占空比支持 | 复选框（50%/100%） |

**3. 采集参数卡片**

| 字段 | 类型 |
|------|------|
| 电压测量范围 | 多选标签（±2.5V/±80V/±600V） |
| 采样率 | 多选标签（50Hz/60Hz/100Hz/1000Hz） |
| 支持通道数 | 数字输入 |
| 迭代次数范围 | 范围输入（最小~最大） |

**4. 保护参数卡片**

| 字段 | 类型 |
|------|------|
| 过压保护 | 复选框 + 阈值输入（V） |
| 过流保护 | 复选框 + 阈值输入（A） |
| 短路保护 | 复选框 |
| 高温保护 | 复选框 + 阈值输入（°C） |

**5. 网络参数卡片**

| 字段 | 类型 |
|------|------|
| WiFi SSID | 文本输入 |

**6. 底部操作栏（sticky）**
- 新建模式：取消 / 预览配置 / 确认生成配置文件
- 编辑模式：取消 / 重置默认 / 预览配置 / 下发配置

---

### 2.10 固件库

**路由**：`/firmware`（支持 `?board=板卡版本` 和 `?model=型号代码` 参数）

#### 功能描述
管理固件版本，支持上传、查看详情、下载。支持板卡固件和设备型号固件两种模式。

#### 模式说明

**1. 通用模式**（直接访问 `/firmware`）
- Tab 筛选：全部 / 主协板 / 采集板 / 发射板 / 升压板 / 主机固件 / 计算单元固件

**2. 板卡固件模式**（从板卡版本管理跳转，`?board=MB-V1.8`）
- 仅显示该板卡版本的固件，带返回按钮

**3. 设备型号固件模式**（从型号管理跳转，`?model=GD30`）
- 两个 Tab：主机固件 / 计算单元固件（带数量角标）
- 带返回按钮，标题显示型号代码

#### 页面区块

**固件版本列表（卡片式）**

每个版本卡片展示：
| 字段 | 说明 |
|------|------|
| 版本号 | 如 v2.3.0 |
| 发布日期 | 日期 |
| 状态 | 已发布 / 草稿 |
| 文件大小 | 如 12.5MB |
| 下载次数 | 如 1,234次 |

展开详情后额外显示：
| 字段 | 说明 |
|------|------|
| MD5 / SHA256 | 校验值 |
| 升级类型 | 可选 / 强制 |
| 数字签名 | 已签名 |
| 发布说明 | 列表形式 |

操作按钮：下载 / 编辑 / 撤回发布 / 查看详情

- 右上角按钮：「上传固件」

#### 弹窗：上传固件（Element Plus Dialog，550px宽）

| 字段 | 类型 | 必填 |
|------|------|------|
| 固件版本 | 文本输入 | 是 |
| 硬件版本范围 | 文本输入 | 是 |
| 升级类型 | 下拉（可选/强制） | 是 |
| 固件类型 | 下拉（主协板/采集板/发射板/主机固件/计算单元固件） | 是 |
| 数字签名 | 复选框 | — |
| 固件包 | ZIP文件上传（拖拽） | 是 |
| 发布说明 | 多行文本（每行一条） | — |

---

### 2.11 板卡列表

**路由**：`/board-cards`

#### 功能描述
管理所有板卡实例，跟踪板卡状态与校准信息。采集板支持查看校准文件。

#### 页面区块

**1. 统计卡片（5个）**
- 板卡总数、在库、已装配、故障、待校准

**2. 筛选条件**

| 筛选项 | 类型 |
|--------|------|
| 板卡类型 | 下拉（全部/主协板/采集板/发射板/升压板） |
| 板卡状态 | 下拉（全部/在库/已装配/故障/报废） |
| 校准状态 | 下拉（全部/合格/不合格/待校准） |
| SN / 设备SN | 文本搜索 |

**3. 板卡列表（表格）**

| 列名 | 说明 |
|------|------|
| 板卡SN | 唯一标识 |
| 类型 | 主协板/采集板/发射板/升压板 |
| 版本 | 板卡版本号 |
| 固件 | 固件版本 |
| 状态 | 在库/已装配/故障/报废 |
| 所属设备 | 关联设备SN |
| 校准状态 | 合格/不合格/待校准（仅采集板） |
| 操作 | 详情 / 校准文件（仅采集板） |

- 右上角按钮：「导出」「登记板卡」（跳转`/board-cards/register`）
- 分页

#### 抽屉：板卡详情（520px宽）
- 基本信息：SN、类型、版本、固件、生产日期、状态
- 装配信息：所属设备
- 校准信息（仅采集板）：校准状态、校准日期

#### 抽屉：校准文件（640px宽，仅采集板）
- 文件信息卡片：文件名、文件大小、MD5、上传时间、下载按钮
- 校准数据表格：通道、参考值、测量值、偏差(%)、结果
- 偏差超过1%标红

---

### 2.12 板卡登记

**路由**：`/board-cards/register`

#### 功能描述
登记新板卡信息，支持单个或批量登记。采集板支持导入校准文件。

#### 页面区块

**1. 登记模式切换**：单个登记 / 批量登记

**2. 板卡信息表单（每条）**

| 字段 | 类型 | 必填 |
|------|------|------|
| 板卡类型 | 下拉（主协板/采集板/发射板/升压板） | 是 |
| 板卡版本 | 下拉（按类型联动） | 是 |
| 固件版本 | 自动填充（只读） | — |
| 板卡SN号 | 文本输入 | 是 |
| 生产日期 | 日期选择器 | 是 |
| 备注 | 文本输入 | — |

**3. 采集板校准文件导入（仅采集板显示）**
- 虚线框点击上传区域，支持 .csv / .xlsx / .dat 格式
- 已选文件显示文件名和大小，可移除

**4. 登记预览表格**
- 列：序号、类型、版本、固件、SN号、生产日期、校准文件、状态

**5. 底部操作栏**
- 显示待登记数量和校准文件附件数
- 取消 / 确认登记

---

### 2.13 校准管理

**路由**：`/calibration`（已迁移至板卡列表的校准文件功能）

#### 功能描述
管理采集板校准数据。仅针对采集板，其他板卡无需校准。

#### 页面区块

**1. 信息提示横幅（紫色）**
- 说明校准仅针对采集板

**2. 筛选条件**

| 筛选项 | 类型 |
|--------|------|
| 采集板SN号 | 文本输入 |
| 校准状态 | 下拉（全部/合格/不合格/待校准） |
| 校准人员 | 下拉 |
| 查询 | 按钮 |

**3. 校准记录列表（表格）**

| 列名 | 说明 |
|------|------|
| 采集板SN号 | 如 RX20240308001 |
| 校准日期 | 日期 |
| 到期日期 | 日期 |
| 校准人员 | 如 王工程师 |
| 状态 | 合格（绿）/ 不合格（红）/ 待校准（黄） |
| 操作 | 详情 / 校准文件 |

- 右上角按钮：「导入」
- 分页

---


### 2.12 维修工单

**路由**：`/repair`

#### 功能描述
管理维修工单的全生命周期，包括新建、处理、查看详情。

#### 页面区块

**1. 筛选条件**

| 筛选项 | 类型 |
|--------|------|
| 状态 | 下拉（全部/处理中/已处理/待处理） |
| 优先级 | 下拉（全部/高/中/低） |
| 维修人员 | 下拉 |
| 创建日期 | 日期范围（开始~结束） |
| SN | 文本输入 |
| 搜索/重置 | 按钮 |

**2. 维修工单列表（卡片式）**

每条工单展示：
| 字段 | 说明 |
|------|------|
| 工单号 | 如 WO-2024-0001 |
| 设备SN | 如 GD30-xxxx |
| 故障类型 | 板卡故障/固件异常/通信异常 |
| 状态 | 处理中（绿底）/ 已处理（绿标签）/ 待处理（灰标签），带emoji图标 |
| 优先级 | 高（红）/ 中（橙）/ 低（蓝） |

操作按钮：详情 / 处理（处理中和待处理时显示）

- 右上角按钮：「新建工单」「维修统计」（跳转`/repair/stats`）
- 分页

#### 抽屉：新建维修工单（520px宽）

分为三个区块：

**设备信息**
| 字段 | 类型 |
|------|------|
| 设备SN | 下拉选择 + 查找设备按钮 |
| 设备信息展示 | 只读（型号、固件、硬件版本、客户） |

**故障信息**
| 字段 | 类型 |
|------|------|
| 故障类型 | 单选（板卡故障/固件异常/通信故障/其他问题） |
| 故障描述 | 多行文本 |
| 故障现象 | 多行文本 |

**工单信息**
| 字段 | 类型 |
|------|------|
| 优先级 | 单选（低/中/高，带颜色） |
| 维修人员 | 下拉选择 |
| 预计修复时间 | 日期选择器 |
| 备注 | 多行文本 |

底部：取消 / 创建工单

#### 抽屉：处理工单（520px宽）

分为以下区块：

**处理操作**
- 单选：更换板卡 / 固件修复 / 参数重置 / 其他处理

**板卡更换（条件显示，选择"更换板卡"时）**
| 字段 | 类型 |
|------|------|
| 原板卡SN | 文本输入 |
| 新板卡SN | 文本输入 |

**授权处理**
| 字段 | 类型 |
|------|------|
| 重新生成授权文件 | 复选框（默认勾选） |
| 推送适配固件 | 复选框 |

**处理备注**
- 多行文本

**报废处理（红色警告区域）**
- 警告文字：报废操作不可逆
- 报废原因：下拉选择（主板损坏无法修复/多个核心部件损坏/维修成本超过设备价值/设备老化严重）
- 申请报废按钮（跳转`/scrap`）

底部：取消 / 提交处理

#### 抽屉：工单详情（540px宽）

包含以下信息区块：
- 工单信息：工单号、状态、优先级、创建时间、维修人员、预计修复
- 设备信息：设备SN、型号、固件、硬件版本、客户
- 故障信息：故障类型、描述、现象
- 处理记录：时间线列表 + 添加记录按钮
- 板卡更换记录：原板卡/新板卡信息、更换时间、更换人员
- 授权处理：复选框（重新生成授权文件/推送适配固件）+ 处理授权按钮

底部：取消 / 关闭工单

---

### 2.13 维修工单详情（独立页面）

**路由**：`/repair/:orderId`

#### 功能描述
维修工单的独立详情页面，与抽屉详情内容一致但以独立页面形式展示。

#### 页面区块（白色卡片堆叠）

1. 工单信息卡片
2. 设备信息卡片
3. 故障信息卡片
4. 处理记录卡片（时间线 + 添加记录按钮）
5. 板卡更换记录卡片
6. 授权处理卡片（复选框 + 处理授权按钮）

**底部操作栏（sticky）**
- 取消 / 关闭工单 / 申请报废（红色，跳转`/scrap`）

---

### 2.14 维修统计

**路由**：`/repair/stats`

#### 功能描述
展示维修数据统计和趋势分析。

#### 页面区块

**1. 时间范围筛选**
- 下拉选择 + Tab 切换（本月/上月/本季度/本年度/自定义）

**2. 统计概览（4列卡片）**

| 指标 | 颜色 |
|------|------|
| 总工单数 | 黑色 |
| 处理中 | 绿色 `#4a7c59` |
| 已完成 | 绿色 `#52C41A` |
| 待处理 | 红色 `#FF4D4F` |

**3. 图表区域（2列）**

| 图表 | 说明 |
|------|------|
| 故障类型分布 | 横向进度条（板卡故障65.5%、固件异常22.3%、通信故障6.3%、其他5.9%） |
| 维修趋势 | 占位图表（1月-6月趋势） |

- 右上角按钮：「导出报告」

---

### 2.15 报废管理

**路由**：`/scrap`

#### 功能描述
管理报废设备审批与物料回收，包含完整的审批流程。

#### 页面区块

**1. 报废审批流程（步骤条）**

| 步骤 | 描述 |
|------|------|
| 1. 申请报废 | 维修工单发起 |
| 2. 主管审批 | 审核报废原因 |
| 3. 物料检测 | 检测可回收物料 |
| 4. 回收入库 | 物料回收登记 |
| 5. 报废完成 | 设备注销 |

**2. 统计概览（4列卡片）**

| 指标 | 颜色 |
|------|------|
| 报废总数 | 黑色 |
| 待审批 | 黄色 |
| 已审批待回收 | 绿色 |
| 已回收 | 绿色 |

**3. 筛选条件**

| 筛选项 | 类型 |
|--------|------|
| 设备SN号 | 文本输入 |
| 状态 | 下拉（全部/待审批/审批中/已审批/已驳回/回收中/已回收） |
| 报废日期 | 日期选择器 |
| 查询 | 按钮 |

**4. 报废设备列表（表格）**

| 列名 | 说明 |
|------|------|
| 设备SN | 如 GD30-2023-001234 |
| 型号 | 如 GD-30 Supreme |
| 报废原因 | 如 主板损坏无法修复 |
| 申请人 | 如 李工 |
| 状态 | 待审批（黄）/审批中（绿底）/已审批（绿）/已驳回（红）/回收中/已回收 |
| 来源工单 | 可点击跳转到维修工单详情 |
| 操作 | 详情 / 审批（待审批时）/ 回收入库（已审批时）/ 重新申请（已驳回时） |

- 右上角按钮：「导出」

#### 抽屉：报废详情（520px宽）

包含以下信息区块：
- 设备信息：SN、型号、报废日期、报废原因、残值评估（元）
- 审批信息：申请人、审批人、来源工单
- 可回收物料：标签列表（如 采集板 AC20240308002、测控板 CT20240308003）
- 审批记录：时间线（提交申请 → 审批通过/驳回 → 物料回收完成）

底部：关闭 / 去审批（待审批时）/ 回收入库（已审批时）

#### 抽屉：报废审批（480px宽）

- 红色警告横幅：报废操作不可逆
- 报废设备摘要：SN、型号、报废原因、残值评估、申请人
- 可回收物料列表
- 审批意见：多行文本

底部：取消 / 驳回（红色）/ 审批通过

#### 抽屉：物料回收入库（480px宽）

- 报废设备摘要
- 物料检测与回收：勾选列表（每项可勾选标记"已检测"，绿色高亮）
- 回收备注：多行文本

底部：取消 / 确认回收入库（绿色，跳转`/registration`）

---

## 三、占位页面

以下页面目前为占位状态，显示"此页面正在开发中..."：

| 页面 | 路由 | 入口 |
|------|------|------|
| 数据报表 | `/reports` | Header 图标 |
| 操作日志 | `/logs` | Header 用户菜单 |
| 系统设置 | `/settings` | Header 用户菜单 |
| 用户管理 | `/users` | Header 用户菜单 |
| 角色权限 | `/roles` | Header 用户菜单 |

---

## 四、通用交互规范

### 4.1 状态标签颜色规范

| 状态类型 | 背景色 | 文字色 | 边框色 |
|----------|--------|--------|--------|
| 成功/已激活/已发布/合格/已审批/已回收 | `#F6FFED` | `#52C41A` | `#B7EB8F` |
| 进行中/在产/处理中 | `#eef5f0` | `#4a7c59` | `#a3c4ad` |
| 警告/草稿/待审批/待校准 | `#FFFBE6` | `#FAAD14` | `#FFE58F` |
| 错误/已驳回/高优先级 | `#FFF1F0` | `#FF4D4F` | `#FFCCC7` |
| 已出厂/中优先级 | `#FFF7E6` | `#FA8C16` | `#FFD591` |
| 低优先级 | `#F0F5FF` | `#597EF7` | `#ADC6FF` |
| 停用/灰色 | `#FAFAFA` | `rgba(0,0,0,0.45)` | `#D9D9D9` |

### 4.2 交互模式

| 模式 | 宽度 | 使用场景 |
|------|------|----------|
| 抽屉（Drawer） | 480px~640px | 新建/编辑/详情（从右侧滑入，背景遮罩） |
| 弹窗（Dialog） | 520px~560px | 导入文件/上传照片 |
| 独立页面 | 全宽 | 设备详情/参数配置/维修工单详情/维修统计 |

### 4.3 表格/列表规范

- 表头背景：`#FAFAFA`
- 行分隔线：`#F0F0F0`
- 分页组件：左侧显示"显示 X-Y / 共 N 条"，右侧页码按钮
- 操作按钮：绿色文字链接 `#4a7c59`，危险操作红色 `#FF4D4F`

### 4.4 表单规范

- 必填标记：红色星号 `*`
- 输入框边框：`#D9D9D9`
- 主按钮：`#4a7c59` 绿色背景白色文字
- 次按钮：`#D9D9D9` 边框灰色文字
- 危险按钮：`#FF4D4F` 边框红色文字
- 禁用状态：`#D9D9D9` 背景

---

## 五、页面路由总览

| 路由 | 页面 | 交互方式 | 说明 |
|------|------|----------|------|
| `/` | 首页 Dashboard | 卡片点击跳转 | 全局数据概览 |
| `/models` | 设备型号管理 | 抽屉（新增型号/Checklist模板） | 核心枢纽 |
| `/models/bom?model=` | 型号BOM表 | 表格 + 抽屉（添加物料） | 按型号管理物料清单 |
| `/boards` | 板卡版本管理 | Tab筛选 + 抽屉（详情） | 板卡型号版本管理 |
| `/board-cards` | 板卡列表 | 筛选 + 表格 + 抽屉（详情/校准文件） | 板卡实例管理 |
| `/board-cards/register` | 板卡登记 | 表单 + 校准文件导入 | 单个/批量登记 |
| `/devices` | 设备列表 | 筛选 + 卡片列表 | 设备总览 |
| `/devices/:sn` | 设备详情 | 独立页面（Tab切换） | 含可编辑授权项和配置文件 |
| `/registration` | 设备登记 | 弹窗（导入/拍照/扫码） | 含生产批次、扫码录入 |
| `/licenses` | 授权管理 | 抽屉（选择授权项） | 每型号一套授权模块 |
| `/firmware` | 固件库 | 弹窗（上传固件） | 支持板卡/设备型号固件 |
| `/config-files` | 配置文件管理 | 抽屉（新建配置） | 按型号绑定 |
| `/config-files/:configId` | 参数配置 | 独立页面 | 详细参数配置 |
| `/repair` | 维修工单 | 抽屉（新建/处理/详情） | 维修全生命周期 |
| `/repair/stats` | 维修统计 | 独立页面 | 数据统计 |
| `/repair/:orderId` | 工单详情 | 独立页面 | 维修工单详情 |
| `/scrap` | 报废管理 | 抽屉（详情/审批/回收） | 报废审批流程 |

---

## 六、跨模块数据流关系

```
设备型号管理 ──→ 授权管理（每型号一套授权模块）
设备型号管理 ──→ 配置管理（按设备型号绑定配置文件）
设备型号管理 ──→ 固件库（按型号关联主机固件/计算单元固件）
设备型号管理 ──→ BOM表（按型号定义物料清单和板卡版本）
设备型号管理 ──→ 设备登记（Checklist模板按型号配置）
板卡版本管理 ──→ 固件库（按板卡型号关联固件）

设备登记 ──→ 设备列表（登记完成后出现在列表中）
设备列表 ──→ 设备详情（点击查看，支持修改授权项和配置文件）

板卡列表 ──→ 校准文件（采集板查看校准数据）
板卡登记 ──→ 板卡列表（登记完成后出现在列表中）

设备详情 ──→ 维修工单（查看维修历史）

维修工单 ──→ 报废管理（申请报废）
报废管理 ──→ 维修工单（关联来源工单）
报废管理 ──→ 设备登记（回收入库后物料重新登记）

授权项 + 配置文件 ──→ 授权文件（系统自动生成）
```