# ZDXT 执法码管理系统

> 基于 [zdxt-Vue-Plus](https://gitee.com/dromara/zdxt-Vue-Plus) v5.6.0 二次开发的多租户执法码管理平台，前后端分离架构。

---

## 技术栈

| 层级 | 技术 | 版本 |
|------|------|------|
| **后端框架** | Spring Boot | 3.5.12 |
| **服务网关** | Spring Cloud Gateway | 2025.0.0 |
| **ORM** | MyBatis-Plus | 3.5.16 |
| **权限认证** | Sa-Token + JWT | 1.44.0 |
| **缓存** | Redis + Redisson | 3.52.0 |
| **数据库** | MySQL | — |
| **定时任务** | Quartz | — |
| **接口文档** | SpringDoc OpenAPI | 2.8.15 |
| **工具库** | Hutool | 5.8.43 |
| **对象映射** | MapStruct Plus | 1.5.0 |
| **前端管理端** | Vue 3 + Element Plus + Vite | Vue 3.5 / Vite 6.4 |
| **前端移动端** | Vue 3 + Vant 4 + Vite | Vue 3.4 / Vite 6.2 |
| **编译要求** | JDK | ≥ 17 |

---

## 工程结构

```
zdxt-Vue-Plus/
├── zdxt-common/                          # 通用模块（24 个子模块）
│   ├── zdxt-common-bom                   # 依赖清单 BOM
│   ├── zdxt-common-core                  # 核心工具
│   ├── zdxt-common-mybatis               # MyBatis-Plus 封装
│   ├── zdxt-common-redis                 # Redis & Redisson 封装
│   ├── zdxt-common-satoken               # Sa-Token 集成
│   ├── zdxt-common-security              # 安全模块
│   ├── zdxt-common-web                   # Web 通用配置
│   ├── zdxt-common-oss                   # 对象存储
│   ├── zdxt-common-excel                 # Excel 导入导出
│   ├── zdxt-common-doc                   # 接口文档
│   ├── zdxt-common-log                   # 操作日志
│   ├── zdxt-common-tenant                # 多租户
│   ├── zdxt-common-encrypt               # 数据加密
│   ├── zdxt-common-idempotent            # 幂等控制
│   ├── zdxt-common-ratelimiter           # 限流
│   ├── zdxt-common-sensitive             # 数据脱敏
│   ├── zdxt-common-translation           # 翻译模块
│   ├── zdxt-common-mail                  # 邮件
│   ├── zdxt-common-sms                   # 短信
│   ├── zdxt-common-social                # 第三方登录
│   ├── zdxt-common-sse                   # SSE 推送
│   ├── zdxt-common-websocket             # WebSocket
│   ├── zdxt-common-json                  # JSON 处理
│   └── zdxt-common-quartz                # Quartz 定时任务
│
├── zdxt-modules/                         # 业务模块
│   ├── zdxt-system                       # 系统管理（用户/角色/菜单/部门等）
│   ├── zdxt-generator                    # 代码生成器
│   ├── zdxt-demo                         # 演示模块
│   └── zdxt-enforcement-code              # ★ 执法码核心业务模块
│       └── com.zdxt.enforcementcode
│           ├── controller/                # 控制器
│           ├── domain/                    # 实体 & DTO & VO
│           ├── mapper/                    # 数据访问层
│           ├── service/                   # 业务逻辑层
│           ├── util/                      # 工具类（二维码生成、文件处理等）
│           ├── quartz/                    # 定时任务
│           └── runner/                    # 启动执行器
│
├── zdxt-extend/                          # 扩展模块
│   └── zdxt-monitor-admin                # Spring Boot Admin 监控中心
│
├── zdxt-web-server/                       # 服务端入口
│   ├── zdxt-admin-web-server              # 主应用服务（端口 8080）
│   └── zdxt-gateway-web-server            # API 网关（Spring Cloud Gateway）
│
├── zdxt-web-client/                       # 前端工程
│   ├── zdxt-admin-plus-ui                 # 管理后台（Vue3 + Element Plus）
│   └── zdxt-enforcement-code-app          # 移动端 H5（Vue3 + Vant4）
│       ├── enterprise-dev / enterprise-prod   # 企业端（双环境）
│       └── enforcement-dev / enforcement-prod # 执法端（双环境）
│
├── cmd/                                   # 打包脚本
│   ├── all-package.bat                    # 一键全量打包（前后端）
│   ├── ep-package.bat / ep-package.ps1    # 后端打包
│   └── client-package.bat / client-package.ps1  # 前端打包
│
├── script/                                # 脚本 & 配置
│   ├── sql/                               # 数据库脚本
│   │   ├── ry_vue_5.X.sql                 # 基础表结构
│   │   ├── ry_job.sql                     # 定时任务表
│   │   └── zfjd-refactoring-v1/           # 执法码业务迁移脚本
│   ├── docker/                            # Docker 部署配置
│   └── bin/                               # 启停脚本
│
└── dist/                                  # 打包产物输出目录
```

---

## 环境要求

| 依赖 | 最低版本 |
|------|---------|
| JDK | 17 |
| Node.js | 20.15.0 |
| npm | 8.19.0 |
| MySQL | 8.x |
| Redis | 6.x |

---

## 多环境配置

项目支持三套环境，通过 Maven Profile 切换：

| Profile | 用途 | 日志级别 | 默认激活 |
|---------|------|---------|---------|
| `local` | 本地开发 | info | — |
| `dev` | 开发/测试环境 | info | ✅ |
| `prod` | 生产环境 | warn | — |

后端配置文件位于 `zdxt-web-server/zdxt-admin-web-server/src/main/resources/`：
- `application.yml` — 通用配置
- `application-dev.yml` — 开发环境
- `application-prod.yml` — 生产环境
- `application-{env}-{endpoint}-ep.yml` — 多端点差异化配置（sup / ent / enf）

前端移动端支持 4 种构建模式：
- `enterprise-dev` / `enterprise-prod` — 企业端
- `enforcement-dev` / `enforcement-prod` — 执法端

---

## 快速开始

### 1. 后端启动

```bash
# 1) 初始化数据库
#    创建 MySQL 数据库，执行 script/sql/ 下的 SQL 脚本

# 2) 修改配置
#    编辑 application-dev.yml 中的数据库连接、Redis 地址

# 3) 启动主应用
#    IDEA 运行 zdxt-admin-web-server 下的 SpringBoot 启动类
#    默认端口: 8080
```

### 2. 前端启动

```bash
# 管理后台
cd zdxt-web-client/zdxt-admin-plus-ui
npm install
npm run web-vite-supervision-dev

# 移动端 H5（企业端/开发环境为例）
cd zdxt-web-client/zdxt-enforcement-code-app
npm install
npm run app-vite:enterprise-dev
```

### 3. 一键打包

```bash
# 全量打包（前后端）
cmd/all-package.bat dev

# 仅后端打包
cmd/ep-package.bat dev

# 仅前端打包
cmd/client-package.bat dev
```

打包产物输出至 `dist/{时间戳}_{环境}/` 目录，包含：
- `zdxt-sup-web/` — 管理后台前端
- `zdxt-ent-app/` — 企业端 H5
- `zdxt-enf-app/` — 执法端 H5
- `zdxt-admin-web-server.jar` — 后端服务

---

## 核心功能

### 基础平台（继承自 zdxt-Vue-Plus）
- 多租户管理（基于 SaaS 模式）
- 用户 / 角色 / 菜单 / 部门权限管理
- Sa-Token + JWT 认证授权
- 操作日志 / 登录日志
- 数据字典 / 参数配置
- 代码生成器
- 接口文档（SpringDoc OpenAPI）
- 分布式锁（Lock4j + Redisson）
- 文件存储（OSS）
- SSE 实时推送
- XSS 防御 / 接口加密 / 幂等控制 / 限流

### 执法码业务（zdxt-enforcement-code 模块）
- 执法码核心业务管理
- 二维码生成（基于 ZXing）
- 本地文件上传与管理
- 企业端 / 执法端双端 H5 应用
- 定时任务调度（Quartz）

---

## 常见问题

### IDEA 运行测试报 "Command line is too long"

项目依赖多，Windows 下 classpath 超过 8191 字符限制。

**解决方法**：`Run → Edit Configurations → Shorten command line → JAR manifest`

建议修改 JUnit 配置模板（Edit configuration templates → JUnit），一劳永逸。