pipIrr 智能灌溉系统
项目概述
pipIrr是一套基于Java的智能管道灌溉系统解决方案，用于实现水资源的智能化管理与灌溉控制。系统集成了远程终端控制、GIS地理信息、水资源监测与分析、微信接入等多种功能，为智慧农业和水利工程提供全面的技术支持。
系统架构
系统采用微服务架构，基于Spring Boot 3构建，主要包括以下几个核心部分：
- 前端应用层：提供Web界面、移动应用、微信公众号等多种交互方式
- 业务服务层：处理核心业务逻辑，包括灌溉管理、项目管理、数据统计等
- 中间件层：提供RTU(远程终端单元)通信、第三方系统集成等功能
- 基础设施层：提供数据存储、缓存、消息队列等基础服务
模块说明
父模块 (pipIrr-platform)
作为整个项目的父模块，管理依赖版本和构建配置。
核心子模块
- pipIrr-common: 公共组件，提供工具类、通用配置等
- pipIrr-global: 全局配置和服务
- pipIrr-web: Web应用模块集合
- pipIrr-web-base: 基础数据服务
- pipIrr-web-sso: 单点登录服务
- pipIrr-web-irrigate: 灌溉管理
- pipIrr-web-gis: GIS地理信息服务
- pipIrr-web-project: 项目管理
- pipIrr-web-statistics: 数据统计分析
- pipIrr-web-remote: 远程控制
- pipIrr-web-wechat: 微信集成
- pipIrr-web-app: 移动应用服务
- pipIrr-web-file: 文件管理
- pipIrr-web-operation: 运维管理
- pipIrr-web-sell: 销售管理
- pipIrr-web-temp: 临时模块
- pipIrr-mw: 中间件服务
- pipIrr-mw-rtu: RTU设备通信
- pipIrr-mw-rtu3rd: 第三方RTU集成
- pipIrr-mw-simulate-rtu: RTU模拟器
- pipIrr-mwTest-server: 测试服务器
- pipIrr-mwTest-client: 测试客户端
技术栈
- 基础框架: Spring Boot 3.1.3
- JDK版本: Java 20
- Web服务: Tomcat 10.1.12
- 数据库: MySQL 8.0.33
- ORM框架: MyBatis-Plus 3.5.3.2
- 数据库连接池: Druid 1.2.20
- API文档: SpringDoc OpenAPI 2.2.0
- JSON处理: FastJSON 2.0.40
- 对象映射: MapStruct 1.5.5.Final
- 工具集: Hutool 5.8.22
- 日志框架: Log4j2 2.20.0
ID生成器使用说明
系统使用自定义的IDLongGenerator来生成唯一的Long型ID，确保在分布式环境下的ID唯一性。
IDLongGenerator特性
- 格式:
年月日时分秒 + 3位自增序列 + 2位系统后缀
- 长度: 19位数字（如：20231218104504069**00**）
- 并发性: 支持同一秒内生成1000个不同ID
- 分布式: 通过后缀区分不同子系统，避免ID冲突
使用方式
// 依赖注入
@Autowired
private IDLongGenerator idLongGenerator;
// 生成ID
Long id = idLongGenerator.generate();
应用场景
- 管理卡创建: createManagementCard方法中使用IDLongGenerator生成管理卡ID
- 实体主键: 所有业务实体的主键ID生成
- 订单号: 业务流水号生成
- 日志记录: 操作记录的唯一标识
配置说明
系统启动时会自动设置ID后缀，不同的服务模块使用不同的后缀来避免ID冲突：
<!-- web.xml或Spring配置 -->
<context-param>
<param-name>idSuffix</param-name>
<param-value>01</param-value> <!-- 不同服务使用不同后缀 -->
</context-param>
开发环境搭建
前置条件
- JDK 20
- Maven 3.8+
- MySQL 8.0+
- IDE推荐: IntelliJ IDEA
构建步骤
克隆代码库
bash git clone <repository-url>
导入项目到IDE
使用IDEA导入Maven项目
配置数据库
在相应配置文件中设置数据库连接信息
编译项目
bash mvn clean package
部署说明
开发环境
mvn spring-boot:run -Dspring.profiles.active=dev
生产环境
打包应用
bash mvn clean package -Dspring.profiles.active=prod
运行jar包
bash java -jar <模块名>-<版本号>.jar
项目文档
详细的项目文档位于 pipIrr-platform/文档/ 目录下，包括：
- API接口文档
- 数据库设计
- 部署指南
- 编码规范
版本信息
当前版本: 1.0.0
贡献指南
- Fork 本仓库
- 创建功能分支 (
git checkout -b feature/AmazingFeature)
- 提交变更 (
git commit -m 'Add some AmazingFeature')
- 推送到分支 (
git push origin feature/AmazingFeature)
- 创建Pull Request
