# gas-system-go

**Repository Path**: xmcqq/gas-system-go

## Basic Information

- **Project Name**: gas-system-go
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-21
- **Last Updated**: 2026-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 散装汽油实名认证信息系统（GAS System）

面向加油站散装汽油销售场景的实名登记与安全监管平台，覆盖**场所（加油站）管理、人员实名登记、散装油购买登记、企业信息管理、日常安检与统计分析**全流程，为公安/主管部门提供监管入口。

系统采用前后端分离架构，由三个子项目组成：

| 子项目 | 说明 | 技术栈 |
|---|---|---|
| [`gas-system-server`](./gas-system-server/) | 后端服务（Java 版 1:1 重构） | Go 1.26 + Gin + GORM |
| [`gas-system-web`](./gas-system-web/) | Web 管理端（监管人员 / 管理员） | Vue 2 + Element UI |
| [`gas-system-app`](./gas-system-app/) | 移动端（加油站工作人员 / 购买人员） | uni-app (Vue 2)，支持 App / H5 / 小程序 |

## 系统架构

```
┌─────────────────┐     ┌─────────────────┐
│  gas-system-web │     │  gas-system-app │
│  Vue 2 管理端    │     │  uni-app 移动端  │
└────────┬────────┘     └────────┬────────┘
         │    HTTP / JSON (/gas) │
         └───────────┬───────────┘
                     ▼
         ┌─────────────────────┐
         │   gas-system-server │  Go + Gin + GORM（单二进制）
         │   JWT + Redis 会话  │
         └───┬──────────┬──────┘
             │          │
        ┌────▼───┐  ┌───▼──────────────┐
        │ MySQL  │  │ Redis            │
        │ 业务库  │  │ 会话/验证码/缓存   │
        └────────┘  └──────────────────┘

         gas-system-server ──► gas-system-python 微服务
                               （OCR / 人脸检测 / 人证比对）
```

## 功能模块

- **系统管理**：用户、角色、菜单、部门、岗位、字典、参数、通知公告、操作日志、登录日志、在线用户
- **场所管理**：加油站等售卖场所的注册、审批与管理
- **人员管理**：购买人员 / 工作人员实名登记（支持 OCR 证件识别、人证比对）
- **散装油登记**：散装汽油购买实名登记、记录查询、二维码
- **企业信息**：涉油企业信息管理
- **安全检查**：日常安检记录与整改管理
- **统计报表**：登记 / 安检 / 场所数据统计
- **监控与任务**：定时任务（sys_job 驱动）、服务监控、缓存监控

## 快速开始

### 后端（gas-system-server）

```bash
cd gas-system-server

# 准备配置：复制模板并修改 MySQL / Redis 连接信息
cp config/config.yaml.example config/config.yaml

# 直接构建（需要 Go 1.26 工具链）
go build -o gas-server ./cmd/server

# 或使用构建脚本（支持 Windows / Linux amd64 / Linux arm64）
powershell -ExecutionPolicy Bypass -File scripts/build.ps1

# 启动
./gas-server
```

服务默认监听 `8180` 端口，接口统一带 `/gas` 前缀，返回 `{code, msg, data}` 信封格式。详细说明见 [`gas-system-server/README.md`](./gas-system-server/README.md)。

### Web 管理端（gas-system-web）

```bash
cd gas-system-web
npm install --registry=https://registry.npmmirror.com
npm run dev          # 开发模式
npm run build:prod   # 生产构建
```

### 移动端（gas-system-app）

```bash
cd gas-system-app
npm install
npm run dev:h5            # H5 开发调试
npm run build:app-plus    # App 构建
npm run build:mp-weixin   # 微信小程序构建
```

也可将项目直接拖入 HBuilderX 运行。

## 目录结构

```
gas-system-go/
├── gas-system-server/    # Go 后端
│   ├── cmd/server/       #   入口（main.go + logger）
│   ├── config/           #   外部配置（config.yaml）
│   ├── internal/         #   业务代码（config/common/model/repository/
│   │                     #   auth/middleware/handler/service/pkg/router）
│   ├── scripts/          #   构建脚本（build.ps1）、systemd 单元
│   └── test/             #   测试
├── gas-system-web/       # Vue 2 管理端
│   ├── src/api/          #   接口封装
│   ├── src/views/        #   页面（dashboard/enterprise/inspect/monitor/
│   │                     #   place/public/register/statistics/system/tool）
│   └── src/layout/       #   布局组件
└── gas-system-app/       # uni-app 移动端
    └── src/
        ├── pages/        #   页面（work/login/mine/place/person/register/
        │                 #   inspect/system）
        ├── api/          #   接口封装
        ├── store/        #   Vuex 状态
        └── uni_modules/  #   uni-app 组件库
```

## 依赖服务

| 服务 | 用途 | 说明 |
|---|---|---|
| MySQL | 业务数据存储 | 30+ 张表，与 Java 版数据库完全兼容（零迁移） |
| Redis | 会话 / 验证码 / 缓存 | JWT 会话 `login_tokens:{uuid}` |
| gas-system-python | OCR / 人脸检测 / 人证比对 | 独立 Python 微服务，由后端调用（读超时 120s） |

## 部署

- **后端**：单二进制部署，无外部运行时依赖（CGO 关闭）；支持 systemd 托管（见 `gas-system-server/scripts/gas-server.service`）
- **切换**：Go 后端与 Java 版 API 契约 1:1（`/gas` 前缀、JWT、日期格式、分页结构一致），可在不停前端的情况下无缝切换，随时回滚
- **前端**：`npm run build:prod` 产物由 Nginx 托管，代理 `/gas` 至后端

## 测试

```bash
cd gas-system-server
go test ./...
```

冒烟测试依赖本地 MySQL（3307）与 Redis，配置见 `config/config.test.yaml`（测试专用，勿用于生产）。

## 相关文档

- [后端 README](./gas-system-server/README.md)：API 契约、配置项、构建与部署、Java 版切换步骤
- [Web 管理端 README](./gas-system-web/README.md)：开发与发布
- 移动端：基于 uni-app 开发，支持 App / H5 / 微信小程序等多端