# hongshan

**Repository Path**: code1014/hongshan

## Basic Information

- **Project Name**: hongshan
- **Description**: 红山矿程序文件夹
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-28
- **Last Updated**: 2026-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 鸿山传送带防火监测系统 (HongShan Belt Fire Prevention)

本仓库为「**皮带机 / 传送带防火监测**」项目的完整源代码与文档集合。系统通过网关接收现场设备(传感器、控制器、球阀、热成像仪等)上报的数据,解析后持久化并通过 Web 端实时展示;同时支持联动控制(传感器告警 → 球阀动作等)。

---

## 仓库结构

```
.
├── code/                        # 源代码
│   ├── service/                 # 后端服务(Spring Boot 2.7.1 + Netty 4.1)
│   │   ├── pom.xml              #   artifact: belt_fire_prevention (3.0.1)
│   │   ├── readme.md            #   协议解析 / 网关分析配置的约定说明
│   │   ├── GatewayStructure.*   #   网关通信结构图
│   │   └── src/main/java/com/ji_an/service/
│   │       ├── applicationmanager/   启动器、初始化业务
│   │       ├── configuration/       Spring / 网关分析配置
│   │       ├── controller/           Web 接口层(spray / zone_ctrl 等)
│   │       ├── dao/                  MyBatis 数据访问
│   │       ├── logger/               异步数据日志
│   │       ├── models/               产品 / 传感器 / 缓存实体
│   │       └── netty/                Netty 服务端 + 网关 / 协议解析
│   │           ├── business/             业务执行器(Gateway/FO)
│   │           ├── gateway/              网关消息路由
│   │           ├── gateway_default/      默认协议分析、缓存、心跳
│   │           └── gateway_fibre_optical/光纤温度协议解析
│   │
│   └── ui/                      # 前端管理界面(Vue 2 + Ant Design Vue Pro)
│       ├── package.json         #   vue-antd-pro 3.0.2
│       ├── README.md            #   前端模块说明
│       └── src/
│           ├── api/             #   后端接口封装
│           ├── views/           #   业务页面(spray、zone_controller 等)
│           └── ...
│
├── doc/                         # 项目文档与资料
│   ├── 0505区域控制器报文协议文件夹/   0505 控制器报文协议(xlsx + 说明 md)
│   ├── database_backup/               数据库表 SQL 备份(心跳/错误表)
│   ├── 方案空白版_Netty并发及线程安全优化总方案.md
│   ├── 方案C_Netty并发及线程安全优化总方案.md
│   └── 实施记录_Netty优化.md
│
└── .gitignore                   # Java / Maven / Node 通用忽略规则
```

---

## 技术栈

### 后端 (`code/service`)
| 类别 | 选型 |
|---|---|
| 语言 / JDK | Java 8 |
| 框架 | Spring Boot 2.7.1、Spring MVC、Spring JDBC |
| 通信 | Netty 4.1.31.Final(TCP 长连接,自定义二进制协议) |
| 持久化 | MyBatis 1.3.2 + MySQL / PostgreSQL |
| JSON | FastJSON 1.2.68 |
| 日志 | LightLog (global.zk) |

### 前端 (`code/ui`)
| 类别 | 选型 |
|---|---|
| 框架 | Vue 2.6 + vue-cli 4.5 |
| UI 库 | Ant Design Vue 1.7 / Ant Design Pro Layout / ProTable |
| 图表 | AntV / ECharts / Viser |
| 工具 | Axios、Vuex、Vue Router、Vue I18n、Eslint + Stylelint + Commitlint |

---

## 本地启动

### 1. 后端 (`code/service`)

```bash
cd code/service

# 编译
mvn clean package -DskipTests

# 运行(Spring Boot 默认读取 src/main/resources/application.properties)
java -jar target/belt_fire_prevention-3.0.1.jar

# 或在 IDE 中直接运行 com.ji_an.service.ServiceApplication
```

启动后:
- Web 接口监听端口见 `application.properties` 的 `server.port`
- Netty 服务端监听端口见同文件中的 Netty 配置段,负责接收网关 / 现场设备 TCP 上行数据

### 2. 前端 (`code/ui`)

```bash
cd code/ui

# 安装依赖(任选其一)
npm install        # 或 yarn / pnpm install

# 开发模式
npm run serve      # 默认 http://localhost:8000

# 生产构建
npm run build      # 输出到 dist/

# 预览 / 预发布构建
npm run build:preview
```

前端请求后端的 baseURL 通过 `.env.development` / `.env.production` 配置。

---

## 关键概念

| 缩写 | 全称 | 含义 |
|---|---|---|
| `sys` | system | 系统 |
| `usr` | user | 用户 |
| `fo`  | fibre optical | 光纤(温度) |
| `ic`  | infrared camera | 红外热成像仪 |
| `EOV` | Electric Operated Valve | 电动球阀(联动执行器) |

### 网关报文解析约定

详见 [`code/service/readme.md`](code/service/readme.md) —— 包含 `gateway_analysis_config.json` 结构、字节位序、`product_code` 编码对照等。

### 联动控制模型

- **触发源**(烟雾 / CO 传感器):联动开关为「**使能 / 不使能**」—— 控制告警时是否触发联动
- **执行器**(球阀 / 电动阀):联动开关为「**强制 / 取消**」—— 控制联动触发时是否强制动作
- 联动状态数据下发协议见 `doc/0505区域控制器报文协议文件夹/`

---

## 协议编辑器临时文件

仓库根目录可能存在 `tmp_0505.univer`、`tmp_0505_proto.univer` 两份二进制文件,来自报文协议编辑器的缓存,**请勿提交**(`.gitignore` 已新增忽略条目)。

---

## 数据库初始化

`doc/database_backup/` 下提供两类初始化脚本:

- `spray_0505_heart_beat_data.sql` —— 0505 心跳数据表
- `spray_0505_main_sub_error_tables.sql` —— 0505 主子错误表

按需导入到目标 MySQL / PostgreSQL 实例即可。

---

## 版本

- 后端 artifact: `com.ji_an:belt_fire_prevention:3.0.1`
- 前端包名: `vue-antd-pro:3.0.2`

---

## 许可

内部项目,版权归吉安(ji_an)所有,未经许可不得外发。