# ControlCenter

**Repository Path**: gitmy/control-center

## Basic Information

- **Project Name**: ControlCenter
- **Description**: 基于c#语言开发的工控机软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-02
- **Last Updated**: 2026-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ControlCenter
# 项目名称
<!-- 智能无人驿站控制系统 -->

---

# 版本信息

![Version](https://img.shields.io/badge/Version-1.0.0-blue)
![.NET](https://img.shields.io/badge/.NET-8.0-green)
![Build](https://img.shields.io/badge/Build-Passing-success)
![License](https://img.shields.io/badge/License-MIT-yellow)

<details>
<summary> 详细清单</summary>

| 组件/环境 | 最低版本 | 当前版本 | 备注 |
| --------- | -------- | -------- | ---- |
| .NET SDK  | *8.0.403  | 8.0.403  | 长期支持 (LTS) |
| VS        | *2022 17.11.5 | 2022 17.11.5   | 开发IDE |
| OS        | *Win10 22H2 | Win10 22H2| 部署环境 |
| PaddleOcr | 5.x | 5.x| 图像识别 |

</details>

---

# 运行时配置文件

## 机器配置
程序启动时会在**可执行文件同级目录**读取 `machine.ini`，  
若缺失则无法启动程序。  
请按需创建并修改以下键值：

<details>
<summary> 示例 machine.ini（点击展开）</summary>

```json
{
    "SmallTrayWidth":170,
    "MiddleTrayWidth":340,
    "BigTrayWidth":500,
    "ClosestContainerNumber":5,
    "SmallTrayFixedLayers":[0],
    "MiddleTrayFixedLayers":[1],
    "TraysReserveLayer":0,
    "TempLocation":"0120000405",
    "ExitLocation":"010120",
    "CacheNumber":3,
    "ContainersInfo":[
        {
            "TrayType":1,
            "Sticks":[468,2318],
            "TraysType":null,
            "Heights":[190,190,190,190,190,190,190]
        },
        {
            "TrayType":1,
            "Sticks":[468,2318],
            "TraysType":null,
            "Heights":[190,190,190,190,190,190,190]
        },
        {
            "TrayType":1,
            "Sticks":[805,2295],
            "TraysType":null,
            "Heights":[150,150,150,150,150,150,150,150,150]
        },
        {
            "TrayType":1,
            "Sticks":[825,2315],
            "TraysType":null,
            "Heights":[75,75,150,150,150,150,150,150,150,150]
        },
        {
            "TrayType":2,
            "Sticks":[300,2100],
            "TraysType":null,
            "Heights":[320,320,320,320,320,320]
        }
    ],
    "GetCourierTimeoutSeconds":1,
    "GetEmptyTrayTimeoutSeconds":600,
    "GetTempTimeoutSeconds":6000,
    "PickupCourierTimeoutSeconds":600,
    "PutEmptyTrayTimeoutSeconds":600,
    "PutScheduledTimeoutSeconds":600,
    "ReturnTrayTimeoutSeconds":6000,
    "SendCourierTimeoutSeconds":6000,
    "StoreCourierTimeoutSeconds":600,
    "ForkLiftWaitSeconds":0,
    "ForkLiftStaySeconds":0,
    "CacheHeights": {
        "Small": {
            "100": "800",
            "150": "801",
            "190": "802"
        },
        "Middle": {
            "300": "803"
        },
        "Big": {
            "500": "804"
        }
    }
}
```

字段说明：

| 字段 | 类型 | 描述 |
| ---- | ---- | ---- |
| `SmallTrayWidth` | ushort | 小托盘宽度（单位:mm） |
| `MiddleTrayWidth` | ushort | 中托盘宽度（单位:mm） |
| `BigTrayWidth` | ushort | 大托盘宽度（单位:mm） |
| `ClosestContainerNumber` | ushort | 升降机旁靠近出口的货架号 |
| `SmallTrayFixedLayers` | ushort[] | 小托盘固定位置托盘层号 |
| `MiddleTrayFixedLayers` | ushort[] | 中托盘固定位置托盘层号 |
| `TraysReserveLayer` | ushort | 已抛弃，可忽略 |
| `TempLocation` | string | 出料口暂存托盘坐标，已抛弃，可忽略 |
| `ExitLocation` | string | 出料口坐标，用于计算距离和时间 |
| `CacheNumber` | ushort | 叉车缓存位个数 |
| `ContainersInfo` | ContainerDO[] | 货架参数配置 |
| `TrayType` | int | 托盘类型，设置该货架默认可放置托盘类型 |
| `Sticks` | int[] | 立柱坐标，每个立柱只录入尾部坐标 |
| `TraysType` | int[] | 仅大货架生效且TrayType=3时必须包含此项，用于定制大货架每层的托盘类型 |
| `Heights` | int[] | 每一个层可放置的快递高度 |
| `GetCourierTimeoutSeconds` | ushort | （可选）接快递任务超时时间，默认120，单位:秒 |
| `GetEmptyTrayTimeoutSeconds` | ushort | （可选）取空托盘任务超时时间，默认60，单位:秒 |
| `GetTempTimeoutSeconds` | ushort | （可选）取暂存位托盘任务超时时间，默认60，单位:秒 |
| `PickupCourierTimeoutSeconds` | ushort | （可选）取快递取托盘任务超时时间，默认60，单位:秒 |
| `PutEmptyTrayTimeoutSeconds` | ushort | （可选）放空托盘至固定位置任务超时时间，默认60，单位:秒 |
| `PutScheduledTimeoutSeconds` | ushort | （可选）存预约快递任务超时时间，默认60，单位:秒 |
| `ReturnTrayTimeoutSeconds` | ushort | （可选）返还空托盘任务超时时间，默认60，单位:秒 |
| `SendCourierTimeoutSeconds` | ushort | （可选）出库任务超时时间，默认60，单位:秒 |
| `StoreCourierTimeoutSeconds` | ushort | （可选）存快递任务超时时间，默认60，单位:秒 |
| `ForkLiftWaitSeconds` | ushort | （可选）叉车等待旋转台推至升降机时间，默认3，单位:秒 |
| `ForkLiftWaitSeconds` | ushort | （可选）叉车等待升降机完成是否能存件判断，默认30，单位:秒 |
| `CacheHeights` | CacheHeights | 预约口高度信息的Plc寄存器地址 |
| `Small` | Dictionary<int,string> | 小快递 |
| `Middle` | Dictionary<int,string> | 中快递 |
| `Big` | Dictionary<int,string> | 大快递 |
</details>

## 软件配置
程序启动时会在**可执行文件同级目录**读取 `config.json`，
若缺失程序会自动创建，
请按需创建并修改以下键值：
<details>
<summary> 示例 config.json（点击展开）</summary>

```json
{
  "TcpDevice": {
    "Ip": "192.168.4.1",
    "Port": 3001
  },
  "ModbusTcpDevice": {
    "Ip": "127.0.0.1",
    "Port": 502
  },
  "BatchNumber": "75",
  "PickupCode": "0027",
  "DeliveryUserId": "63",
  "Pending": "{}",
  "Scheduled": "{}",
  "Pickup": "{}"
}
```

字段说明：

| 字段 | 类型 | 描述 |
| ---- | ---- | ---- |
| `TcpDevice` | TcpConfig | Tcp通信配置 |
| `ModbusTcpDevice` | ModbusTcpConfig | ModbusTcp通信配置 |
| `Ip` | string | IP地址 |
| `Port` | ushort | 端口号 |
| `BatchNumber` | long | 批次号，用于存件 |
| `PickupCode` | int | 取件码，用于存件 |
| `DeliveryUserId` | string | 快递用户id |
| `Pending` | Dictionary<string, List<PendingDeliverDO>> | 待寄件正在处理的数据，用于数据恢复 |
| `Scheduled` | Dictionary<string, ScheduleDO> | 预约存件正在处理的数据，用于数据恢复 |
| `Pickup` | Dictionary<string, PUItem> | 取件正在处理的数据，用于数据恢复 |
</details>

# OCR 模型说明（PaddleOCR v5）

本项目使用 **PaddleOCR v5 模型（检测 det + 识别 rec）** 进行图像文字识别。  
由于 PaddleOCR 模型体积较大（超过 100MB），Gitee 对 Release 单文件大小有限制，因此本仓库采用 **分卷压缩** 的方式提供模型及相关配置文件。

---

## 模型下载方式一：从 Release 下载（推荐）

请前往本仓库的 **Release 页面** 下载 OCR 模型压缩包：

 **Release 下载地址：**  
https://gitee.com/xv-xin/control-center/releases/tag/v1.0.0

Release 中包含若干分卷压缩文件：
Resource.zip
Resource.z01


### 📁 放置目录

将 `paddleocr` 文件夹整体移动到：

- 开发模式： `bin/Debug/net8.0-windows/`
- 发布模式： `bin/Release/net8.0-windows/`

最终路径示例：

<pre><code>
```
net8.0-windows/
├─ paddleocr/
│  ├─ det/
│  └─ rec/
└─ config.json
└─ machine.ini
```
</code></pre>

## 📦 模型下载方式二：自行从 PaddleOCR 官方下载（可选）

如果你不希望使用 Release 附带的压缩包，也可以 **自行下载 PaddleOCR v5 模型**。

官方文档：

👉 https://www.paddleocr.ai/main/version3.x/pipeline_usage/OCR.html#5

---

# 目录总览

---

## 核心层（Core）
<!-- Core 层职责概述：通用枚举、公共模型、全局异常、版本管理等 -->

### Enums（通用枚举）
<!-- 本目录作用：所有业务枚举定义，保持统一入口 -->
- **AccessTaskTypeEnum.cs** <!-- 作用：叉车任务枚举类 -->
- **ExpressTypeEnum.cs** <!-- 作用：快递公司枚举类 -->
- **PlcCommandEnum.cs** <!-- 作用：PLC命令枚举类 -->
- **QrCodeFunEnum.cs** <!-- 作用：二维码类型枚举类 -->
- **WsMsgTypeEnum.cs** <!-- 作用：Websocket消息类型枚举类 -->

### FrameWork（公共框架）
<!-- 本目录作用：异常、错误码、全局拦截、系统上下文等 -->
- **Error/**
  - **BaseErrorCode.cs** <!-- 作用：基础错误类 -->
  - **IErrorCode.cs** <!-- 作用：错误码基类 -->
- **Exceptions/**
  - **AbstractException.cs** <!-- 作用：异常抽象类 -->
  - **LocalException.cs** <!-- 作用：本地异常 -->
  - **ServerException.cs** <!-- 作用：服务端异常 -->
- **GlobalExceptionHandler.cs** <!-- 作用：全局异常处理器 -->
- **SystemContext.cs** <!-- 作用：系统上下文 -->
- **VersionManger.cs** <!-- 作用：空间版本管理器 -->

### Models（业务模型）
<!-- 本目录作用：所有业务实体定义 -->
#### AccessCourier（存取任务实体）
<!-- 作用：描述快递柜存取相关任务 -->
- **AccessTask.cs** <!-- 作用：叉车任务基类，所有任务执行前需保证叉车臂无托盘 -->
- **GerCourierTask.cs** <!-- 作用：接快递任务，命令叉车前往升降机接快递 -->
- **GetEmptyTrayTask.cs** <!-- 作用：取空托盘任务，还托盘到固定区前执行 -->
- **GetTempTask.cs** <!-- 作用：取暂存位托盘任务，取出出料口暂存位的空托盘 -->
- **PickBigTask.cs** <!-- 作用：取大快递并直接出库 -->
- **PickupCourierTask.cs** <!-- 作用：从货架取快递 -->
- **PutEmptyTrayTask.cs** <!-- 作用：还托盘至固定区 -->
- **PutScheduledTask.cs** <!-- 作用：放预约件至预约口任务 -->
- **ReturnCourierTask.cs** <!-- 作用：退还快递任务 -->
- **ReturnScheduleCourierTask.cs** <!-- 作用：预约失败后重新将快递放回货架 -->
- **ReturnTrayTask.cs** <!-- 作用：出库后返还空托盘任务 -->
- **SendCourierTask.cs** <!-- 作用：出库任务 -->
- **StoreBigTask.cs** <!-- 作用：存大快递 -->
- **StoreCourierTask.cs** <!-- 作用：存小于大快递的其他快递 -->

#### QrCode（二维码）
<!-- 作用：定义各类二维码payload -->
- **IQrCodePayload.cs** <!-- 作用：二维码基类 -->
- **PUItem.cs** <!-- 作用：取件码子项 -->
- **PickUpQrCode.cs** <!-- 作用：取件二维码 -->
- **StoreCourierQrCode.cs** <!-- 作用：寄件存快递二维码 -->

#### Upload（上传记录任务）
<!-- 作用：数据上传相关任务实体 -->
- **CourierOutboundUploadTask.cs** <!-- 作用：快递出库记录上传 -->
- **PendingEndUploadTask.cs** <!-- 作用：待寄件入库记录上传 -->
- **ReplenishRecordUploadTask.cs** <!-- 作用：快递入库记录上传 -->
- **ScheduledPickupUpdateUploadTask.cs** <!-- 作用：取预约件出库记录上传 -->
- **UploadTask.cs** <!-- 作用：上传任务抽象类 -->
- **UploadTaskFactory.cs** <!-- 作用：上传任务工厂类 -->

- **PendingDeliveryDO.cs** <!-- 作用：待寄件数据对象 -->
- **PrintImageDO.cs** <!-- 作用：图片打印数据对象 -->
- **RecordDO.cs** <!-- 作用：快递记录数据对象 -->
- **StationDO.cs** <!-- 作用：站点信息数据对香港 -->
- **TransMessage.cs** <!-- 作用：发布订阅者模式数据实体 -->

---

## 数据层（Data）
<!-- 作用：仓储实现、本地实体、数据工厂 -->

### Repositories
- **RecordRepository.cs** <!-- 作用：快递记录数据库 -->
- **SpaceRepository.cs** <!-- 作用：空间信息数据库 -->

- **LogDO.cs** <!-- 作用：日志记录数据对象 -->
- **MachineDO.cs** <!-- 作用：机器信息数据对象 -->
- **ScheduledDO.cs** <!-- 作用：预约信息数据对象 -->
- **SpaceDO.cs** <!-- 作用：空间信息数据对象 -->
- **SpaceFactory.cs** <!-- 作用：空间工厂，用于创建空间对象 -->

---

## 设备层（Devices）
<!-- 作用：硬件设备抽象与驱动 -->
- **DeliPrinter.cs** <!-- 作用：得力打印机 -->
- **ForkLift.cs** <!-- 作用：叉车 -->
- **ModbusTcpPlc.cs** <!-- 作用：ModbusTcp通信包装类 -->
- **Phone.cs** <!-- 作用：手机包装类 -->
- **Scanner.cs** <!-- 作用：扫码器 -->
- **TcpPlc.cs** <!-- 作用：Tcp通信包装类 -->

---

## 传输对象（DTOs）
<!-- 作用：前后端/服务间数据交换格式 -->
- **BaseDTO.cs** <!-- 作用：传输对象类基类 -->
- **CreateNormalDTO.cs** <!-- 作用：创建入库记录 -->
- **GridAddressDTO.cs** <!-- 作用：快递地址 -->
- **PLCServiceSnapshotDTO.cs** <!-- 作用：Plc服务快照 -->
- **PendingInboundDTO.cs** <!-- 作用：待寄件入库记录 -->
- **ReadResultDTO.cs** <!-- 作用：Tcp通信响应结果 -->
- **RecordServiceSnapshotDTO.cs** <!-- 作用：快递记录服务快照 -->
- **ReplenishDTO.cs** <!-- 作用：记录上传 -->
- **ResponseDTO.cs** <!-- 作用：Http响应结果 -->
- **UpdateNormalDTO.cs** <!-- 作用：更新快递记录（出库、拦截） -->
- **UpdateStatusDTO.cs** <!-- 作用：更新预约状态 -->

---

## 服务层（Services）
<!-- 作用：核心业务逻辑、消息分发、硬件调度 -->

### Dispatcher（消息/命令分发）
- **handler/**
  - **PlcHandler** <!-- 作用：策略模式命令处理器 -->
  - **QrCodeHandler** <!-- 作用：策略模式二维码处理器 -->
- **MessageDispatcher.cs** <!-- 作用：发布订阅者模式消息分发器 -->
- **QrCodeDispatcher.cs** <!-- 作用：二维码分发器 -->

- **BaseService.cs** <!-- 作用：服务类基类 -->
- **BroadcastService.cs** <!-- 作用：广播服务，播报语音消息 -->
- **MainFormService.cs** <!-- 作用：主窗体服务类，处理主窗体后台任务 -->
- **PLCService.cs** <!-- 作用：PLC服务，负责与PLC通信 -->
- **PhonsService.cs** <!-- 作用：手机服务，负责控制手机 -->
- **PrintService.cs** <!-- 作用：打印机服务，负责处理打印任务 -->
- **RecordService.cs** <!-- 作用：快递记录服务，用于上传快递记录 -->
- **ScannerService.cs** <!-- 作用：扫码服务，用于识别解析二维码 -->
- **StationService.cs** <!-- 作用：站点服务，用于配置站点信息 -->
- **StorageService.cs** <!-- 作用：仓储服务，用于空间信息管理、叉车任务分配 -->
- **WebsocketService.cs** <!-- 作用：Wbesocket通信服务，用于接收开关门、预约等消息 -->

---

## 工具层（Utils）
<!-- 作用：常量、扩展、HTTP、ID生成、图片、系统工具 -->

### Constant（常量定义）
- **LogDesConstant.cs** <!-- 作用：日志描述常量类 -->
- **SystemConstant.cs** <!-- 作用：系统级常量类 -->
- **TopicConstant.cs** <!-- 作用：发布订阅者模式主题常量类 -->
- **WSCodeConstant.cs** <!-- 作用：Websocket返回值常量类 -->

- **ExtensionsUtil.cs** <!-- 作用：扩展工具类，如自定义序列化对象 -->
- **HttpUtil.cs** <!-- 作用：Http工具类，用于处理Http响应 -->
- **IdGenerator.cs** <!-- 作用：Id生成器，生成全局唯一Id，支持分布式 -->
- **ImageUtil.cs** <!-- 作用：图像工具类，包括图像识别、条形码生成等 -->
- **SystemUtil.cs** <!-- 作用：系统工具类，包括保存文件、英文键盘设置等 -->

---

## 视图层（Views）
<!-- 作用：WinForm 用户控件与主界面 -->

### UserControls
- **MainForm/**
  - **HistoryRecord.cs** <!-- 作用：快递记录页 -->
  - **StorageManagement.cs** <!-- 作用：仓储可视化页（包括叉车调试功能和仓储空间状态变化功能） -->
  - **SystemLog.cs** <!-- 作用：系统日志页 -->
  - **TestPage.cs** <!-- 作用：功能测试页 -->
- **SM/**
  - **ContainerPanel.cs** <!-- 作用：货架容器 -->
  - **InsertSpace.cs** <!-- 作用：插入空间弹出框 -->
  - **SpacePanel.cs** <!-- 作用：空间容器 -->
  - **SpaceSetting.cs** <!-- 作用：空间设置弹出框 -->

- **MainForm.cs** <!-- 作用：主窗体 -->
- **SettingsComponent.cs** <!-- 作用：设置弹出框 -->