# 地空业务支撑平台 —— 生产管理子系统 流程与讨论文档

> 版本：v3.0  
> 更新日期：2026-04-27  
> 状态：会议评审稿

---

## 一、系统模块总览

| 模块 | 路由 | 核心功能 | 当前状态 |
|------|------|----------|----------|
| 首页 Dashboard | `/` | 全局数据概览、待处理任务快捷入口 | ✅ 已实现 |
| 设备列表 | `/devices` | 设备筛选、卡片列表、设备详情 | ✅ 已实现 |
| 设备详情 | `/devices/[sn]` | 基本信息、授权、装配记录、子设备、固件、维修历史 | ✅ 已实现 |
| 设备型号管理 | `/models` | 型号CRUD、Checklist模板、BOM表管理 | ✅ 已实现 |
| 设备登记 | `/registration` | 装机信息、BOM清单、装配Checklist | ✅ 已实现 |
| 物料列表 | `/materials` | 物料实例管理、状态跟踪、校准信息 | ✅ 已实现 |
| 物料管理 | `/materials/manage` | 物料类型定义、版本管理、固件关联 | ✅ 已实现 |
| 物料登记 | `/materials/register` | 单个/批量登记物料、校准文件导入 | ✅ 已实现 |
| 授权管理 | `/licenses` | 按型号管理授权模块配置 | ✅ 已实现 |
| 配置文件管理 | `/config-files` | 按型号绑定配置文件（发射/采集/网络参数） | ✅ 已实现 |
| 固件库 | `/firmware` | 固件版本管理、上传、下载 | ✅ 已实现 |
| 维修工单 | `/repair` | 工单全生命周期（新建→处理→关闭） | ✅ 已实现 |
| 报废回收 | `/scrap` | 报废审批流程、物料回收入库 | ✅ 已实现 |

---

## 二、核心业务流程

### 2.1 设备生产装配流程

```mermaid
flowchart LR
    A[设备型号管理] -->|定义BOM表| B[物料准备]
    B -->|物料登记入库| C[物料列表]
    C -->|选择物料| D[设备登记]
    A -->|Checklist模板| D
    D -->|装配完成| E[设备列表]
    E -->|待激活出厂| F[客户在线激活使用]
```

### 2.2 物料全生命周期

```mermaid
flowchart TD
    A[物料管理\n定义物料类型/版本] --> B[物料登记\n录入SN/版本/校准文件]
    B --> C{物料状态}
    C -->|在库| D[等待装配]
    C -->|已装配| E[绑定设备]
    C -->|故障| F[维修工单]
    C -->|报废| G[报废回收]
    D --> E
    F -->|修复| D
    F -->|无法修复| G
    G -->|可回收物料| D
```

### 2.3 物料分类体系

| 物料分类 | 物料名称示例 | 物料版本示例 | 有固件 | 需校准 |
|----------|-------------|-------------|--------|--------|
| 主协板 | GD30 主协板 | MB-GD-V1.0 | ✅ GD系列 | ❌ |
| 采集板 | GD30 采集板 | RX-GD-V1.0 | ✅ GD系列 | ✅ |
| 发射板 | GD30 发射板 | TX-GD-V1.0 | ✅ GD系列 | ❌ |
| 升压板 | GD30 升压板 | B0-600-V1.0 | ❌ | ❌ |
| 电缆头 | 通用电缆头 SR10/SR20 | SR10 | ❌ | ❌ |
| 电缆 | 通用电缆 | CBL-60M | ❌ | ❌ |
| 机箱 | 通用机箱 | GD30-CASE-B | ❌ | ❌ |
| 电源 | BP150/BP300/BP600 电源 | BP150-V1.0 等 | ❌ | ❌ |

> 固件管理仅限 GD-10/20/30 Supreme 的主协板、采集板、发射板。

### 2.4 设备型号与BOM关系

```mermaid
flowchart TD
    subgraph GD30["GD-30 Supreme"]
        GD30_MCB[主协板 ×1]
        GD30_ACB[采集板 ×2\n版本须一致 · 需校准]
        GD30_TXB[发射板 ×1]
        GD30_BST[升压板 ×1]
        GD30_CBH[通用电缆头 ×7]
        GD30_CBL[通用电缆 ×6]
        GD30_CHS[通用机箱 ×1]
        GD30_BP[BP600 电源 ×1]
    end

    subgraph GD20["GD-20 Supreme"]
        GD20_MCB[主协板 ×1]
        GD20_ACB[采集板 ×1\n需校准]
        GD20_TXB[发射板 ×1]
        GD20_BST[升压板 ×1]
        GD20_CBH[通用电缆头 ×7]
        GD20_CBL[通用电缆 ×6]
        GD20_CHS2[通用机箱 ×1]
        GD20_BP[BP600 电源 ×1]
    end

    subgraph GD10["GD-10 Supreme"]
        GD10_MCB[主协板 ×1]
        GD10_ACB[采集板 ×1\n需校准]
        GD10_TXB[发射板 ×1]
        GD10_BST[升压板 ×1]
        GD10_CBH[通用电缆头 ×7]
        GD10_CBL[通用电缆 ×6]
        GD10_CHS3[通用机箱 ×1]
        GD10_BP[BP600 电源 ×1]
    end
```


### 2.5 维修与报废流程

```mermaid
flowchart TD
    A[设备故障] --> B[新建维修工单]
    B --> C{故障诊断}
    C -->|更换板卡| D[板卡更换\n原板卡SN → 新板卡SN]
    C -->|固件修复| E[固件修复\n推送适配固件]
    C -->|参数重置| F[参数重置\n重新下发配置]
    C -->|无法修复| G[申请报废]

    D --> H{是否需要重新授权}
    E --> H
    F --> H
    H -->|是| I[重新生成授权文件]
    H -->|否| J[工单关闭]
    I --> J

    G --> K[报废审批流程]
    K --> L{审批结果}
    L -->|通过| M[物料检测]
    L -->|驳回| N[重新申请/返回维修]
    M --> O[可回收物料入库]
    O --> P[报废完成\n设备注销]
```

### 2.6 授权文件生成与激活流程

```mermaid
flowchart LR
    A[设备型号管理] -->|绑定| B[授权模块配置]
    A -->|绑定| C[配置文件]
    B --> D[授权文件生成\n授权项 + 配置文件]
    C --> D

    D --> E[APP激活流程]
    E --> E1[1. APP连接主机\n检索授权文件]
    E1 -->|无授权文件| E2[2. 外网连接平台\nSN号匹配下载]
    E2 --> E3[3. 重新连接设备\n传输授权文件激活]
```

---

## 三、数据模型关系

```mermaid
erDiagram
    DEVICE_MODELS ||--o{ BOM_TEMPLATES : "定义BOM"
    DEVICE_MODELS ||--o{ CHECKLIST_TEMPLATES : "定义Checklist"
    DEVICE_MODELS ||--o{ LICENSES : "绑定授权"
    DEVICE_MODELS ||--o{ CONFIG_FILES : "绑定配置"
    DEVICE_MODELS ||--o{ DEVICES : "生产设备"

    BOARD_TYPES ||--o{ BOARD_VERSIONS : "定义版本"
    BOARD_TYPES ||--o{ MATERIALS : "生产物料"
    BOARD_VERSIONS ||--o{ FIRMWARE : "关联固件"

    DEVICES ||--o{ MATERIALS : "装配物料"
    DEVICES ||--o{ REPAIR_ORDERS : "维修工单"
    DEVICES ||--o{ SCRAP_RECORDS : "报废记录"

    REPAIR_ORDERS ||--o| SCRAP_RECORDS : "发起报废"

    DEVICE_MODELS {
        string name "型号名称"
        string code "型号编码"
        string status "在产/停产"
    }
    BOARD_TYPES {
        string name "物料名称"
        string category "物料分类"
        string device_models "适配设备型号"
    }
    MATERIALS {
        string sn "物料SN"
        string name "物料名称"
        string type "物料类型"
        string status "在库/已装配/故障/报废"
    }
    DEVICES {
        string sn "设备SN"
        string model "设备型号"
        string status "装配中/已激活/已出厂"
    }
```

---

## 四、待讨论事项

### 4.1 维修与报废

| 序号 | 议题 | 说明 | 建议 |
|------|------|------|------|
| 8 | 维修工单状态流转 | 当前：待处理 → 处理中 → 已处理 | 是否需要增加"已验收"状态 |
| 9 | 报废审批层级 | 当前：申请 → 主管审批 → 物料检测 → 回收入库 → 完成 | 确认审批权限和层级 |
| 10 | 板卡更换后的授权 | 更换板卡后可选重新生成授权文件 | 确认哪些板卡更换需要强制重新授权 |

### 4.2 系统演进

| 序号 | 议题 | 说明 | 建议 |
|------|------|------|------|
| 11 | 数据报表 | 当前为占位页面 | 确认优先需要哪些报表 |
| 12 | 用户权限 | 当前无权限控制 | 确认角色划分（管理员/装配员/维修员/审批员） |
| 13 | 操作日志 | 当前为占位页面 | 确认需要记录哪些关键操作 |

---

## 五、系统全局流程图

```mermaid
flowchart TD
    HOME["🏠 首页 Dashboard\n设备统计 · 待处理任务"]

    subgraph S0["⚙️ 型号管理（核心枢纽）"]
        MODEL["设备型号管理\n型号CRUD · 在产/停产"]
        MODEL -->|定义| BOM["BOM表管理\n物料名称 · 物料分类 · 物料类型\n兼容版本 · 数量 · 版本约束"]
        MODEL -->|定义| CKL["Checklist模板\nTab切换型号 · 可编辑"]
    end

    subgraph S1["📦 物料管理"]
        MAT_MGR["物料管理\n物料类型定义 · 版本管理"]
        MAT_MGR -->|版本抽屉| VER["版本管理抽屉\n状态切换 · 固件管理"]
        MAT_REG["物料登记\n单个/批量 · 校准文件"]
        MAT_LIST["物料列表\n物料名称 · 物料类型 · 适配型号\n版本 · 描述 · 状态"]
        MAT_REG --> MAT_LIST
    end

    subgraph S2["🖥️ 设备管理"]
        DEV_REG["设备登记\n装机信息 · BOM清单 · Checklist"]
        DEV_LIST["设备列表\n筛选 · 卡片列表"]
        DEV_DETAIL["设备详情\n基本信息 · 授权 · 装配\n子设备 · 固件 · 维修历史"]
        DEV_REG --> DEV_LIST
        DEV_LIST --> DEV_DETAIL
    end

    subgraph S3["🔑 授权与配置"]
        LIC["授权管理\n按型号配置授权模块"]
        CFG["配置文件管理\n发射/采集/网络参数"]
        FW["固件库\n主协板/采集板/发射板固件"]
    end

    subgraph S4["🔧 维修运维"]
        REPAIR["维修工单\n新建 · 处理 · 详情"]
        SCRAP["报废回收\n审批流程 · 物料回收"]
        REPAIR -->|无法修复| SCRAP
        SCRAP -->|回收物料| MAT_LIST
    end

    HOME --> MODEL
    HOME --> DEV_LIST
    HOME --> REPAIR
    HOME --> SCRAP

    MODEL -->|授权| LIC
    MODEL -->|配置| CFG
    MODEL -->|固件| FW
    MODEL -->|BOM定义物料需求| MAT_MGR

    MAT_LIST -->|装配使用| DEV_REG
    BOM -->|装配依据| DEV_REG
    CKL -->|装配检查| DEV_REG

    DEV_DETAIL -->|发起维修| REPAIR
    VER -->|固件管理| FW

    style S0 fill:#F0F2F5,stroke:#8C8C8C,stroke-width:2px
    style S1 fill:#F0F5FF,stroke:#597EF7,stroke-width:2px
    style S2 fill:#eef5f0,stroke:#4a7c59,stroke-width:2px
    style S3 fill:#E6FFFB,stroke:#13C2C2,stroke-width:2px
    style S4 fill:#FFF1F0,stroke:#FF4D4F,stroke-width:2px
    style HOME fill:#4a7c59,color:#FFFFFF,stroke:#4a7c59
```
