You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

8.8 KiB

项目包版本与系统配置信息

项目名称: data-center-business (data-center-business) 最后更新: 2026-06-24


1. 系统环境 (OS / Runtime)

组件 版本 说明
Java 17 .java-version 指定
Maven 3.x (系统默认) 多模块 Maven 项目
Spring Boot 3.5.13 parent POM spring-boot-starter-parent
打包方式 pom / jar 多模块聚合项目

2. 项目模块结构

模块 说明
data-center-business (parent) 父 POM,聚合所有子模块
data-center-business-util 工具模块
data-center-business-common 公共模块
data-center-business-model 数据模型模块
data-center-business-dao 数据访问层模块
data-center-business-service 业务逻辑层模块
data-center-business-controller Web 控制器层模块

3. 核心框架 (Framework)

3.1 Spring 生态

依赖 版本 说明
spring-boot-starter 3.5.13 (managed) Spring Boot 基础启动器
spring-boot-starter-web 3.5.13 (managed) Web 支持(排除默认 Tomcat 和 Logging)
spring-boot-starter-websocket 3.5.13 (managed) WebSocket 支持
spring-boot-starter-integration 3.5.13 (managed) Spring Integration 支持
spring-boot-starter-data-redis 3.5.13 (managed) Redis 数据访问
spring-boot-starter-security 3.5.13 (managed) Spring Security 支持
spring-boot-starter-test 3.5.13 (managed) 测试支持
spring-integration-mqtt 6.5.3 MQTT 集成
spring-security-oauth2-authorization-server 1.5.3 OAuth2 授权服务器

3.2 Tomcat (Web 容器)

依赖 版本 说明
tomcat-embed-core 10.1.54 嵌入式 Tomcat(排除默认后手动引入)

4. 数据库 & ORM (Database / Persistence)

依赖 版本 说明
mysql-connector-j 9.5.0 MySQL JDBC 驱动
mybatis-spring-boot-starter 3.0.4 MyBatis + Spring Boot 整合
mybatis-generator-maven-plugin 1.3.5 MyBatis 代码生成器插件
mybatis-generator-core 1.3.5 MyBatis 代码生成器核心
pagehelper-spring-boot-starter 1.4.7 MyBatis 分页插件
druid 1.1.3 Alibaba Druid 数据库连接池
flyway-core 11.4.1 数据库迁移
flyway-mysql 11.4.1 Flyway MySQL 方言

4.1 数据源配置

配置项
数据库类型 MySQL (Aliyun RDS)
默认数据库 data_center_aeon_admin
连接池 Druid (type) / HikariCP (备用)
驱动类 com.mysql.jdbc.Driver / com.mysql.cj.jdbc.Driver

5. 缓存 (Cache)

依赖 版本 说明
lettuce-core 6.8.1.RELEASE Redis 客户端 (Lettuce)
jedis 5.0.2 Redis 客户端 (Jedis,备用)
commons-pool2 (Spring Boot managed) 连接池

5.1 Redis 配置

配置项
模式 standalone (支持 cluster / sentinel)
默认端口 6379
数据库索引 0
连接池最大连接数 8

6. 消息 & 集成 (Messaging / Integration)

依赖 版本 说明
org.eclipse.paho.client.mqttv3 1.2.5 MQTT 客户端
spring-integration-mqtt 6.5.3 MQTT 集成
okhttp 4.12.0 OkHttp HTTP 客户端

6.1 EMQX 配置

配置项
API Base URL http://49.235.129.192:18083
用途 MQTT Broker 管理

7. 云服务 (Cloud Services - AWS)

依赖 版本 说明
aws-java-sdk-dynamodb 1.12.782 DynamoDB SDK
aws-java-sdk-athena 1.12.782 Athena SDK
software.amazon.awssdk:s3 2.20.113 (BOM) S3 SDK (v2)
AWS SDK BOM 2.20.113 AWS SDK 版本管理

7.1 AWS 服务配置

服务 用途
S3 文件存储 (bucket: tokyo-build-databucket-...)
Athena 数据查询 (database: tokyotatemoenergydb)
DynamoDB NoSQL 数据库
ECR Docker 镜像仓库

8. 序列化 & JSON

依赖 版本 说明
jackson-core 2.21.2 Jackson 核心
jackson-databind 2.21.2 Jackson 数据绑定
jackson-annotations 2.21 Jackson 注解
fastjson 2.0.7.graal Alibaba FastJSON
gson 2.9.0 Google Gson
json-path 2.9.0 JSONPath 解析
json-smart 2.5.2 JSON 解析(json-path 依赖)

9. 日志 (Logging)

依赖 版本 说明
log4j-core 2.25.4 Log4j 核心
log4j-api 2.25.4 Log4j API
logback-classic 1.5.21 Logback 实现
logback-core 1.5.21 Logback 核心

9.1 日志配置

配置项
日志框架 Logback (配置: logback-boot.xml)
日志级别 DEBUG (可配置)
最大历史 30 天
最大文件大小 100MB

10. Excel / 文档处理 (Office / Document)

依赖 版本 说明
easyexcel 4.0.3 Alibaba EasyExcel
poi 5.5.0 Apache POI 核心
poi-ooxml 5.5.0 Apache POI OOXML
poi-ooxml-lite 5.5.0 Apache POI OOXML Lite
xmlbeans 5.2.0 XML Beans (POI 依赖)
pdfbox 2.0.24 Apache PDFBox
fontbox 2.0.24 Apache FontBox
opencsv 5.12.0 CSV 解析

11. Apache Commons 工具库

依赖 版本 说明
commons-lang3 3.20.0 语言增强工具
commons-compress 1.28.0 压缩工具
commons-io 2.18.0 IO 工具
commons-text 1.13.0 文本处理工具
commons-collections 3.2.2 集合工具
commons-pool2 (Spring Boot managed) 对象池

12. HTTP 客户端

依赖 版本 说明
httpclient5 5.5.1 Apache HttpClient 5
httpcore5 5.3.6 Apache HttpCore 5
okhttp 4.12.0 Square OkHttp

13. 安全 & JWT (Security / Authentication)

依赖 版本 说明
spring-boot-starter-security 3.5.13 (managed) Spring Security
spring-security-oauth2-authorization-server 1.5.3 OAuth2 授权服务器
nimbus-jose-jwt 10.6 JWT 处理
bcpkix-jdk18on 1.80 Bouncy Castle 加密库
encoder 1.3.1 OWASP 编码器

14. API 文档

依赖 版本 说明
springdoc-openapi-starter-webmvc-ui 2.8.14 SpringDoc OpenAPI 3

15. 验证 (Validation)

依赖 版本 说明
hibernate-validator 6.1.0.Final Hibernate Validator
hibernate-validator-cdi 6.1.0.Final Hibernate Validator CDI
jakarta.el-api 6.0.1 Jakarta EL API

16. 其他依赖

依赖 版本 说明
guava 33.4.5-jre Google Guava 工具库
kotlin-stdlib 2.2.21 Kotlin 标准库 (OkHttp 依赖)
hutool-captcha 5.8.41 Hutool 验证码
dom4j 2.1.3 XML 解析
mail (javax.mail) 1.5.0-b01 JavaMail
lombok (Spring Boot managed) Lombok
netty-bom 4.2.12.Final Netty BOM 版本管理

17. 构建插件 (Build Plugins)

插件 版本 说明
maven-jar-plugin (default) JAR 打包
maven-dependency-plugin (default) 依赖拷贝 (lib 分离)
maven-resources-plugin (default) 资源处理
maven-assembly-plugin (default) ZIP 打包
maven-surefire-plugin (default) 测试执行
jib-maven-plugin 3.4.5 Docker 镜像构建 (Google Jib)
maven-antrun-plugin 3.0.0 Ant 任务 (AWS ECR 推送)
mybatis-generator-maven-plugin 1.3.5 MyBatis 代码生成

18. 中间件 & 外部服务 (Middleware / External Services)

服务 版本 / 类型 用途
MySQL Aliyun RDS 主数据库
Redis Aliyun Redis (standalone/cluster/sentinel) 缓存
EMQX MQTT Broker IoT 消息
AWS S3 对象存储 文件存储
AWS Athena 查询服务 大数据查询
AWS DynamoDB NoSQL 数据存储
AWS ECR 容器镜像仓库 Docker 镜像
Salesforce CRM 客户管理集成
CloudDog API 外部 API 告警通知 (Slack)
OIDC / Cognito 认证服务 BIM Viewer 认证

19. 网络配置 (Network)

配置项
服务端口 20008
上下文路径 /api
文件上传大小 单个 200MB / 总 500MB
CORS * (可配置)

20. 部署配置 (Deployment)

环境 Profile 说明
开发环境 development 默认激活
测试环境 test -
正式环境 production -
Docker 测试 docker-test Jib 构建 + ECR 推送
Docker 正式 docker-production Jib 构建 + ECR 推送
仅打包 only-package ZIP 打包

Docker 基础镜像

registry.ap-northeast-1.aliyuncs.com/southwave/jdk17-template:latest