From fe27d9988794717008b9c1457d71d2c8d4798e15 Mon Sep 17 00:00:00 2001
From: hypersense <18659922013@163.com>
Date: Mon, 24 Mar 2025 14:08:00 +0000
Subject: [PATCH 1/5] Initial commit
---
.gitignore | 29 +-
hypersense-access/pom.xml | 24 ++
.../hypersense/HyperSenseApplication.java | 17 +
.../auth/enums/CaptchaTypeEnum.java | 27 ++
.../hypersense/auth/model/CaptchaInfo.java | 24 ++
.../hypersense/auth/service/AuthService.java | 63 ++++
.../src/main/resources/application-dev.yml | 245 +++++++++++++
.../src/main/resources/application-prod.yml | 221 ++++++++++++
.../src/main/resources/application.yml | 11 +
.../src/main/resources/banner.txt | 16 +
.../src/main/resources/logback-spring.xml | 64 ++++
.../hypersense-common-bom/pom.xml | 70 ++++
.../hypersense-common-core/pom.xml | 64 ++++
.../core/annotation/DataPermission.java | 27 ++
.../common/core/annotation/Debounce.java | 24 ++
.../common/core/annotation/Log.java | 49 +++
.../common/core/annotation/ValidField.java | 35 ++
.../common/core/aspect/DebounceAspect.java | 99 +++++
.../core/constant/JwtClaimConstants.java | 29 ++
.../common/core/constant/RedisConstants.java | 60 ++++
.../core/constant/SecurityConstants.java | 24 ++
.../common/core/constant/SystemConstants.java | 30 ++
.../common/core/domain/model/KValue.java | 22 ++
.../common/core/domain/model/Option.java | 53 +++
.../core/domain/model/base/BaseEntity.java | 49 +++
.../core/domain/model/base/BasePageQuery.java | 27 ++
.../common/core/domain/model/base/BaseVo.java | 21 ++
.../core/domain/result/ExcelResult.java | 44 +++
.../common/core/domain/result/PageResult.java | 46 +++
.../common/core/domain/result/Result.java | 76 ++++
.../core/domain/result/base/IResultCode.java | 14 +
.../common/core/enums/DataScopeEnum.java | 31 ++
.../hypersense/common/core/enums/EnvEnum.java | 27 ++
.../common/core/enums/LogModuleEnum.java | 33 ++
.../common/core/enums/RequestMethodEnum.java | 58 +++
.../common/core/enums/ResultCode.java | 290 +++++++++++++++
.../common/core/enums/StatusEnum.java | 28 ++
.../common/core/enums/base/IBaseEnum.java | 85 +++++
.../core/exception/BusinessException.java | 46 +++
.../handler/GlobalExceptionHandler.java | 267 ++++++++++++++
.../common/core/utils/DateUtils.java | 59 +++
.../common/core/utils/ExcelUtils.java | 19 +
.../hypersense/common/core/utils/IPUtils.java | 138 +++++++
.../common/core/utils/ResponseUtils.java | 80 +++++
.../common/core/validator/FieldValidator.java | 34 ++
.../hypersense-common-desensitize/pom.xml | 18 +
.../hypersense-common-ratelimiter/pom.xml | 13 +
.../hypersense-common-security/pom.xml | 13 +
.../security/config/SecurityConfig.java | 149 ++++++++
.../sms/SmsAuthenticationProvider.java | 79 ++++
.../hypersense-common-tenant/pom.xml | 13 +
.../hypersense-common-translation/pom.xml | 13 +
.../hypersense-common-web/pom.xml | 14 +
.../hypersense-common-websocket/pom.xml | 14 +
hypersense-common/pom.xml | 26 ++
hypersense-modules/hypersense-system/pom.xml | 18 +
.../hypersense/system/enums/DictCodeEnum.java | 27 ++
.../hypersense/system/enums/MenuTypeEnum.java | 33 ++
.../system/enums/NoticePublishStatusEnum.java | 30 ++
.../system/enums/NoticeTargetEnum.java | 29 ++
.../system/event/UserConnectionEvent.java | 37 ++
.../system/listener/UserImportListener.java | 13 +
.../system/mapper/ConfigMapper.java | 16 +
.../hypersense/system/mapper/DeptMapper.java | 25 ++
.../system/mapper/DictDataMapper.java | 24 ++
.../hypersense/system/mapper/DictMapper.java | 36 ++
.../hypersense/system/mapper/LogMapper.java | 54 +++
.../hypersense/system/mapper/MenuMapper.java | 26 ++
.../system/mapper/NoticeMapper.java | 37 ++
.../hypersense/system/mapper/RoleMapper.java | 26 ++
.../system/mapper/RoleMenuMapper.java | 41 +++
.../hypersense/system/mapper/UserMapper.java | 84 +++++
.../system/mapper/UserNoticeMapper.java | 28 ++
.../system/mapper/UserRoleMapper.java | 22 ++
.../hypersense/system/model/bo/NoticeBO.java | 76 ++++
.../system/model/bo/RolePermsBO.java | 26 ++
.../hypersense/system/model/bo/UserBO.java | 71 ++++
.../system/model/bo/VisitCount.java | 23 ++
.../system/model/bo/VisitStatsBO.java | 28 ++
.../system/model/dto/NoticeDTO.java | 29 ++
.../system/model/dto/UserAuthInfo.java | 59 +++
.../system/model/dto/UserExportDTO.java | 43 +++
.../system/model/dto/UserImportDTO.java | 37 ++
.../system/model/entity/Config.java | 57 +++
.../hypersense/system/model/entity/Dept.java | 64 ++++
.../hypersense/system/model/entity/Dict.java | 45 +++
.../system/model/entity/DictData.java | 53 +++
.../hypersense/system/model/entity/Log.java | 106 ++++++
.../hypersense/system/model/entity/Menu.java | 112 ++++++
.../system/model/entity/Notice.java | 88 +++++
.../system/model/entity/Project.java | 60 ++++
.../hypersense/system/model/entity/Role.java | 58 +++
.../system/model/entity/RoleMenu.java | 32 ++
.../hypersense/system/model/entity/User.java | 83 +++++
.../system/model/entity/UserNotice.java | 53 +++
.../system/model/entity/UserRole.java | 32 ++
.../system/model/form/ConfigForm.java | 41 +++
.../system/model/form/DeptForm.java | 40 +++
.../system/model/form/DictDataForm.java | 38 ++
.../system/model/form/DictForm.java | 33 ++
.../system/model/form/EmailUpdateForm.java | 25 ++
.../system/model/form/MenuForm.java | 67 ++++
.../system/model/form/MobileUpdateForm.java | 25 ++
.../system/model/form/NoticeForm.java | 55 +++
.../system/model/form/PasswordUpdateForm.java | 22 ++
.../system/model/form/RoleForm.java | 39 ++
.../system/model/form/UserForm.java | 62 ++++
.../system/model/form/UserProfileForm.java | 38 ++
.../system/model/query/ArchivesQuery.java | 26 ++
.../system/model/query/ConfigPageQuery.java | 21 ++
.../system/model/query/DeptQuery.java | 22 ++
.../system/model/query/DictDataPageQuery.java | 24 ++
.../system/model/query/DictPageQuery.java | 25 ++
.../system/model/query/LogPageQuery.java | 27 ++
.../system/model/query/MenuQuery.java | 22 ++
.../system/model/query/NoticePageQuery.java | 36 ++
.../system/model/query/RolePageQuery.java | 32 ++
.../system/model/query/UserPageQuery.java | 47 +++
.../hypersense/system/model/vo/ConfigVO.java | 35 ++
.../hypersense/system/model/vo/DeptVO.java | 49 +++
.../system/model/vo/DictDataPageVO.java | 40 +++
.../system/model/vo/DictPageVO.java | 30 ++
.../hypersense/system/model/vo/DictVO.java | 45 +++
.../hypersense/system/model/vo/LogPageVO.java | 59 +++
.../hypersense/system/model/vo/MenuVO.java | 60 ++++
.../system/model/vo/NoticeDetailVO.java | 43 +++
.../system/model/vo/NoticePageVO.java | 61 ++++
.../system/model/vo/RolePageVO.java | 39 ++
.../hypersense/system/model/vo/RouteVO.java | 64 ++++
.../system/model/vo/UserInfoVO.java | 36 ++
.../system/model/vo/UserNoticePageVO.java | 42 +++
.../system/model/vo/UserPageVO.java | 54 +++
.../system/model/vo/UserProfileVO.java | 50 +++
.../system/model/vo/VisitStatsVO.java | 39 ++
.../system/model/vo/VisitTrendVO.java | 29 ++
.../system/service/ConfigService.java | 68 ++++
.../system/service/DeptService.java | 65 ++++
.../system/service/DictDataService.java | 68 ++++
.../system/service/DictService.java | 68 ++++
.../hypersense/system/service/LogService.java | 41 +++
.../system/service/MenuService.java | 75 ++++
hypersense-modules/pom.xml | 15 +
.../hypersense-shared-bom/pom.xml | 40 +++
.../hypersense-shared-codegen/pom.xml | 13 +
.../hypersense-shared-oss/pom.xml | 13 +
.../hypersense-shared-redis/pom.xml | 13 +
.../hypersense-shared-wechat/pom.xml | 13 +
hypersense-shared/pom.xml | 22 ++
pom.xml | 339 ++++++++++++++++++
149 files changed, 7376 insertions(+), 11 deletions(-)
create mode 100644 hypersense-access/pom.xml
create mode 100644 hypersense-access/src/main/java/tech/hypersense/HyperSenseApplication.java
create mode 100644 hypersense-access/src/main/java/tech/hypersense/auth/enums/CaptchaTypeEnum.java
create mode 100644 hypersense-access/src/main/java/tech/hypersense/auth/model/CaptchaInfo.java
create mode 100644 hypersense-access/src/main/java/tech/hypersense/auth/service/AuthService.java
create mode 100644 hypersense-access/src/main/resources/application-dev.yml
create mode 100644 hypersense-access/src/main/resources/application-prod.yml
create mode 100644 hypersense-access/src/main/resources/application.yml
create mode 100644 hypersense-access/src/main/resources/banner.txt
create mode 100644 hypersense-access/src/main/resources/logback-spring.xml
create mode 100644 hypersense-common/hypersense-common-bom/pom.xml
create mode 100644 hypersense-common/hypersense-common-core/pom.xml
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/DataPermission.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/Debounce.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/Log.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/ValidField.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/aspect/DebounceAspect.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/JwtClaimConstants.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/RedisConstants.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/SecurityConstants.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/SystemConstants.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/KValue.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/Option.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BaseEntity.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BasePageQuery.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BaseVo.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/ExcelResult.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/PageResult.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/Result.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/base/IResultCode.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/DataScopeEnum.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/EnvEnum.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/LogModuleEnum.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/RequestMethodEnum.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/ResultCode.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/StatusEnum.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/base/IBaseEnum.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/exception/BusinessException.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/exception/handler/GlobalExceptionHandler.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/DateUtils.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/ExcelUtils.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/IPUtils.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/ResponseUtils.java
create mode 100644 hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/validator/FieldValidator.java
create mode 100644 hypersense-common/hypersense-common-desensitize/pom.xml
create mode 100644 hypersense-common/hypersense-common-ratelimiter/pom.xml
create mode 100644 hypersense-common/hypersense-common-security/pom.xml
create mode 100644 hypersense-common/hypersense-common-security/src/main/java/tech/hypersense/common/security/config/SecurityConfig.java
create mode 100644 hypersense-common/hypersense-common-security/src/main/java/tech/hypersense/common/security/extension/sms/SmsAuthenticationProvider.java
create mode 100644 hypersense-common/hypersense-common-tenant/pom.xml
create mode 100644 hypersense-common/hypersense-common-translation/pom.xml
create mode 100644 hypersense-common/hypersense-common-web/pom.xml
create mode 100644 hypersense-common/hypersense-common-websocket/pom.xml
create mode 100644 hypersense-common/pom.xml
create mode 100644 hypersense-modules/hypersense-system/pom.xml
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/DictCodeEnum.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/MenuTypeEnum.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/NoticePublishStatusEnum.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/NoticeTargetEnum.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/event/UserConnectionEvent.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/listener/UserImportListener.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/ConfigMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DeptMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DictDataMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DictMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/LogMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/MenuMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/NoticeMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/RoleMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/RoleMenuMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/UserMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/UserNoticeMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/UserRoleMapper.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/bo/NoticeBO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/bo/RolePermsBO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/bo/UserBO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/bo/VisitCount.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/bo/VisitStatsBO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/dto/NoticeDTO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/dto/UserAuthInfo.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/dto/UserExportDTO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/dto/UserImportDTO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/Config.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/Dept.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/Dict.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/DictData.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/Log.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/Menu.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/Notice.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/Project.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/Role.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/RoleMenu.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/User.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/UserNotice.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/entity/UserRole.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/ConfigForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/DeptForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/DictDataForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/DictForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/EmailUpdateForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/MenuForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/MobileUpdateForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/NoticeForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/PasswordUpdateForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/RoleForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/UserForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/form/UserProfileForm.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/ArchivesQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/ConfigPageQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/DeptQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/DictDataPageQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/DictPageQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/LogPageQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/MenuQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/NoticePageQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/RolePageQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/query/UserPageQuery.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/ConfigVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/DeptVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/DictDataPageVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/DictPageVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/DictVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/LogPageVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/MenuVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/NoticeDetailVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/NoticePageVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/RolePageVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/RouteVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/UserInfoVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/UserNoticePageVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/UserPageVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/UserProfileVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/VisitStatsVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/model/vo/VisitTrendVO.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/service/ConfigService.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/service/DeptService.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/service/DictDataService.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/service/DictService.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/service/LogService.java
create mode 100644 hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/service/MenuService.java
create mode 100644 hypersense-modules/pom.xml
create mode 100644 hypersense-shared/hypersense-shared-bom/pom.xml
create mode 100644 hypersense-shared/hypersense-shared-codegen/pom.xml
create mode 100644 hypersense-shared/hypersense-shared-oss/pom.xml
create mode 100644 hypersense-shared/hypersense-shared-redis/pom.xml
create mode 100644 hypersense-shared/hypersense-shared-wechat/pom.xml
create mode 100644 hypersense-shared/pom.xml
create mode 100644 pom.xml
diff --git a/.gitignore b/.gitignore
index 0e13eeb..125a2c3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,11 +1,18 @@
-target/
-pom.xml.tag
-pom.xml.releaseBackup
-pom.xml.versionsBackup
-pom.xml.next
-release.properties
-dependency-reduced-pom.xml
-buildNumber.properties
-.mvn/timing.properties
-# https://github.com/takari/maven-wrapper#usage-without-binary-jar
-.mvn/wrapper/maven-wrapper.jar
+# Created by .ignore support plugin (hsz.mobi)
+### Example sysUserDetails template template
+### Example sysUserDetails template
+
+# IntelliJ project files
+.idea
+*.iml
+out
+gen
+target
+*.log
+logs
+.history
+
+
+docker/*/data/
+docker/minio/config
+docker/xxljob/logs
\ No newline at end of file
diff --git a/hypersense-access/pom.xml b/hypersense-access/pom.xml
new file mode 100644
index 0000000..da22e56
--- /dev/null
+++ b/hypersense-access/pom.xml
@@ -0,0 +1,24 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-template
+ ${revision}
+
+ hypersense-access
+
+ 应用服务入口
+
+
+
+
+
+ com.mysql
+ mysql-connector-j
+
+
+
+
+
+
diff --git a/hypersense-access/src/main/java/tech/hypersense/HyperSenseApplication.java b/hypersense-access/src/main/java/tech/hypersense/HyperSenseApplication.java
new file mode 100644
index 0000000..b6808e9
--- /dev/null
+++ b/hypersense-access/src/main/java/tech/hypersense/HyperSenseApplication.java
@@ -0,0 +1,17 @@
+package tech.hypersense;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.context.metrics.buffering.BufferingApplicationStartup;
+
+
+@SpringBootApplication
+public class HyperSenseApplication {
+
+ public static void main(String[] args) {
+ SpringApplication application = new SpringApplication(HyperSenseApplication.class);
+ application.setApplicationStartup(new BufferingApplicationStartup(2048));
+ application.run(args);
+ System.out.println("✌(>‿◠)✌ HyperSense start complete ✌≧◔◡◔≦✌");
+ }
+}
diff --git a/hypersense-access/src/main/java/tech/hypersense/auth/enums/CaptchaTypeEnum.java b/hypersense-access/src/main/java/tech/hypersense/auth/enums/CaptchaTypeEnum.java
new file mode 100644
index 0000000..da30e86
--- /dev/null
+++ b/hypersense-access/src/main/java/tech/hypersense/auth/enums/CaptchaTypeEnum.java
@@ -0,0 +1,27 @@
+package tech.hypersense.auth.enums;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 验证码类型枚举
+ * @Version: 1.0
+ */
+public enum CaptchaTypeEnum {
+
+ /**
+ * 圆圈干扰验证码
+ */
+ CIRCLE,
+ /**
+ * GIF验证码
+ */
+ GIF,
+ /**
+ * 干扰线验证码
+ */
+ LINE,
+ /**
+ * 扭曲干扰验证码
+ */
+ SHEAR
+}
diff --git a/hypersense-access/src/main/java/tech/hypersense/auth/model/CaptchaInfo.java b/hypersense-access/src/main/java/tech/hypersense/auth/model/CaptchaInfo.java
new file mode 100644
index 0000000..ad664af
--- /dev/null
+++ b/hypersense-access/src/main/java/tech/hypersense/auth/model/CaptchaInfo.java
@@ -0,0 +1,24 @@
+package tech.hypersense.auth.model;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+import lombok.Data;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 验证码信息
+ * @Version: 1.0
+ */
+@Schema(description = "验证码信息")
+@Data
+@Builder
+public class CaptchaInfo {
+
+ @Schema(description = "验证码缓存 Key")
+ private String captchaKey;
+
+ @Schema(description = "验证码图片Base64字符串")
+ private String captchaBase64;
+
+}
\ No newline at end of file
diff --git a/hypersense-access/src/main/java/tech/hypersense/auth/service/AuthService.java b/hypersense-access/src/main/java/tech/hypersense/auth/service/AuthService.java
new file mode 100644
index 0000000..49367ad
--- /dev/null
+++ b/hypersense-access/src/main/java/tech/hypersense/auth/service/AuthService.java
@@ -0,0 +1,63 @@
+//package tech.hypersense.auth.service;
+//
+///**
+// * @Author: HyperSense
+// * @CreateTime: 2025-03-25
+// * @Description: 认证服务接口
+// * @Version: 1.0
+// */
+//public interface AuthService {
+//
+// /**
+// * 登录
+// *
+// * @param username 用户名
+// * @param password 密码
+// * @return 登录结果
+// */
+// AuthenticationToken login(String username, String password);
+//
+// /**
+// * 登出
+// */
+// void logout();
+//
+// /**
+// * 获取验证码
+// *
+// * @return 验证码
+// */
+// CaptchaInfo getCaptcha();
+//
+// /**
+// * 刷新令牌
+// *
+// * @param refreshToken 刷新令牌
+// * @return 登录结果
+// */
+// AuthenticationToken refreshToken(String refreshToken);
+//
+// /**
+// * 微信小程序登录
+// *
+// * @param code 微信登录code
+// * @return 登录结果
+// */
+// AuthenticationToken loginByWechat(String code);
+//
+// /**
+// * 发送短信验证码
+// *
+// * @param mobile 手机号
+// */
+// void sendSmsLoginCode(String mobile);
+//
+// /**
+// * 短信验证码登录
+// *
+// * @param mobile 手机号
+// * @param code 验证码
+// * @return 登录结果
+// */
+// AuthenticationToken loginBySms(String mobile, String code);
+//}
diff --git a/hypersense-access/src/main/resources/application-dev.yml b/hypersense-access/src/main/resources/application-dev.yml
new file mode 100644
index 0000000..c44b774
--- /dev/null
+++ b/hypersense-access/src/main/resources/application-dev.yml
@@ -0,0 +1,245 @@
+server:
+ port: 8989
+
+spring:
+ datasource:
+ type: com.alibaba.druid.pool.DruidDataSource
+ driver-class-name: com.mysql.cj.jdbc.Driver
+ url: jdbc:mysql://localhost:3306/hypersense_blog?zeroDateTimeBehavior=convertToNull&useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&autoReconnect=true&allowMultiQueries=true
+ username: hypersense
+ password: hypersense
+ data:
+ redis:
+ database: 0
+ host: localhost
+ port: 6379
+ # 如果Redis 服务未设置密码，需要将password删掉或注释，而不是设置为空字符串
+# password: 123456
+ timeout: 10s
+ lettuce:
+ pool:
+ # 连接池最大连接数 默认8 ，负数表示没有限制
+ max-active: 8
+ # 连接池最大阻塞等待时间（使用负值表示没有限制） 默认-1
+ max-wait: -1
+ # 连接池中的最大空闲连接 默认8
+ max-idle: 8
+ # 连接池中的最小空闲连接 默认0
+ min-idle: 0
+ main:
+ # SpringAI
+ banner-mode: off
+ ai:
+ openai:
+ base-url: https://api.siliconflow.cn/
+ api-key: sk-syrjaznwkfypnbxhvyakplapeycsuqvbenoqhggslbnlbhec
+ chat:
+ options:
+ model: Qwen/Qwen2.5-14B-Instruct
+# anthropic:
+# api-key: #这里换成你的api-key
+ mcp:
+ server:
+ enabled: true
+ name: archives-management-server
+ version: 1.0.0
+ type: SYNC
+ sse-message-endpoint: /mcp/message
+ cache:
+ enabled: false
+ # 缓存类型 redis、none(不使用缓存)
+ type: redis
+ # 缓存时间(单位：ms)
+ redis:
+ time-to-live: 3600000
+ # 缓存null值，防止缓存穿透
+ cache-null-values: true
+ caffeine:
+ spec: initialCapacity=50,maximumSize=1000,expireAfterWrite=600s
+ # 邮件配置
+ mail:
+ host: smtp.hypersense.tech
+ port: 587
+ username: your-email@example.com
+ password: 123456
+ properties:
+ mail:
+ smtp:
+ auth: true
+ starttls:
+ enable: true
+ # 邮件发送者
+ from: hypersense@yeah.net
+
+mybatis-plus:
+ mapper-locations: classpath*:/mapper/**/*.xml
+ global-config:
+ db-config:
+ # 主键ID类型
+ id-type: none
+ # 逻辑删除对应的全局属性名（注意：须是对象属性名，不能是表字段名，如 isDeleted 而非 is_deleted，否则逻辑删除失效）
+ logic-delete-field: isDeleted
+ # 逻辑删除-删除值
+ logic-delete-value: 1
+ # 逻辑删除-未删除值
+ logic-not-delete-value: 0
+ configuration:
+ # 驼峰下划线转换
+ map-underscore-to-camel-case: true
+ # 这个配置会将执行的sql打印出来，在开发或测试的时候可以用
+ log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
+
+# 安全配置
+security:
+ session:
+ type: jwt # 会话方式 [jwt|redis-token]
+ access-token-time-to-live: 3600 # 访问令牌 有效期(单位：秒)，默认 1 小时，-1 表示永不过期
+ refresh-token-time-to-live: 604800 # 刷新令牌有效期(单位：秒)，默认 7 天，-1 表示永不过期
+ jwt:
+ secret-key: SecretKey012345678901234567890123456789012345678901234567890123456789 # JWT密钥(HS256算法至少32字符)
+ redis-token:
+ allow-multi-login: false # 是否允许多设备登录
+ # 安全白名单路径（完全绕过安全过滤器）
+ ignore-urls:
+ - /api/v1/auth/login/** # 登录接口(账号密码登录、手机验证码登录和微信登录)
+ - /api/v1/auth/captcha # 验证码获取接口
+ - /api/v1/auth/refresh-token # 刷新令牌接口
+ - /ws/** # WebSocket接口
+ - /api/v1/blog/** # 博客查询展示页
+ - /api/chatbot
+ # 非安全端点路径（允许匿名访问的API）
+ unsecured-urls:
+ - ${springdoc.swagger-ui.path}
+ - /doc.html
+ - /swagger-ui/**
+ - /v3/api-docs/**
+ - /webjars/**
+ - /api/v1/blog/** # 博客查询展示页
+ - /api/chatbot
+
+# 文件存储配置
+oss:
+ # OSS 类型 (目前支持aliyun、minio、local)
+ type: minio
+ # MinIO 对象存储服务
+ minio:
+ # MinIO 服务地址
+ endpoint: http://150.158.18.177:9000
+ # 访问凭据
+ access-key: BWyx1QgREOYrIAw6SC3K
+ # 凭据密钥
+ secret-key: WeYdHxzDS4DksBBAjJXVcq8ns9eaTYyxsxWIJt15
+ # 存储桶名称
+ bucket-name: archives
+ # (可选) 自定义域名：配置后，文件 URL 会使用该域名格式
+ custom-domain:
+ # 阿里云OSS对象存储服务
+ aliyun:
+ # 服务Endpoint
+ endpoint: oss-cn-hangzhou.aliyuncs.com
+ # 访问凭据`
+ access-key-id: your-access-key-id
+ # 凭据密钥
+ access-key-secret: your-access-key-secret
+ # 存储桶名称
+ bucket-name: default
+ # 本地存储
+ local:
+ # 文件存储路径 请注意下，mac用户请使用 /Users/your-username/your-path/，否则会有权限问题，windows用户请使用 D:/your-path/
+ storage-path: /Users/theo/home/
+# 短信配置
+sms:
+ # 阿里云短信
+ aliyun:
+ accessKeyId: LTAI5tSMgfxxxxxxdiBJLyR
+ accessKeySecret: SoOWRqpjtS7xxxxxxZ2PZiMTJOVC
+ domain: dysmsapi.aliyuncs.com
+ regionId: cn-shanghai
+ signName: 氦闪技术
+ templates:
+ # 注册短信验证码模板
+ register: SMS_22xxx771
+ # 登录短信验证码模板
+ login: SMS_22xxx772
+ # 修改手机号短信验证码模板
+ change-mobile: SMS_22xxx773
+
+# springdoc配置： https://springdoc.org/properties.html
+springdoc:
+ swagger-ui:
+ path: /swagger-ui.html
+ operations-sorter: alpha
+ tags-sorter: alpha
+ api-docs:
+ path: /v3/api-docs
+ group-configs:
+ - group: '系统管理'
+ paths-to-match: "/**"
+ packages-to-scan:
+ - com.hypersense.boot.system.controller
+ - com.hypersense.boot.shared.auth.controller
+ - com.hypersense.boot.shared.file.controller
+ - com.hypersense.boot.shared.codegen.controller
+ default-flat-param-object: true
+
+# knife4j 接口文档配置
+knife4j:
+ # 是否开启 Knife4j 增强功能
+ enable: true # 设置为 true 表示开启增强功能
+ # 生产环境配置
+ production: false # 设置为 true 表示在生产环境中不显示文档，为 false 表示显示文档（通常在开发环境中使用）
+ setting:
+ language: zh_cn
+
+# xxl-job 定时任务配置
+xxl:
+ job:
+ # 定时任务开关
+ enabled: false
+ admin:
+ # 调度中心地址,多个逗号分隔
+ addresses: http://150.158.18.177:8080/xxl-job-admin
+ accessToken: default_token
+ # 执行器配置
+ executor:
+ appname: xxl-job-executor-${spring.application.name} # 执行器AppName
+ address: # 执行器注册地址，默认为空，多网卡时可手动设置
+ ip: # 执行器IP，默认为空，多网卡时可手动设置
+ port: 9999 # 执行器通讯端口
+ logpath: /data/applogs/xxl-job/jobhandler # 任务运行日志文件存储磁盘路径
+ logretentiondays: 30 # 日志保存天数，值大于3时生效
+
+# 验证码配置
+captcha:
+ # 验证码类型 circle-圆圈干扰验证码|gif-Gif验证码|line-干扰线验证码|shear-扭曲干扰验证码
+ type: circle
+ # 验证码宽度
+ width: 120
+ # 验证码高度
+ height: 40
+ # 验证码干扰元素个数
+ interfere-count: 2
+ # 文本透明度(0.0-1.0)
+ text-alpha: 0.8
+ # 验证码字符配置
+ code:
+ # 验证码字符类型 math-算术|random-随机字符
+ type: math
+ # 验证码字符长度，type=算术时，表示运算位数(1:个位数运算 2:十位数运算)；type=随机字符时，表示字符个数
+ length: 1
+ # 验证码字体
+ font:
+ # 字体名称 Dialog|DialogInput|Monospaced|Serif|SansSerif
+ name: SansSerif
+ # 字体样式 0-普通|1-粗体|2-斜体
+ weight: 1
+ # 字体大小
+ size: 24
+ # 验证码有效期(秒)
+ expire-seconds: 120
+
+# 微信小程配置
+wx:
+ miniapp:
+ app-id: xxxxxx
+ app-secret: xxxxxx
diff --git a/hypersense-access/src/main/resources/application-prod.yml b/hypersense-access/src/main/resources/application-prod.yml
new file mode 100644
index 0000000..b2ce9cd
--- /dev/null
+++ b/hypersense-access/src/main/resources/application-prod.yml
@@ -0,0 +1,221 @@
+server:
+ port: 8989
+
+spring:
+ datasource:
+ type: com.alibaba.druid.pool.DruidDataSource
+ driver-class-name: com.mysql.cj.jdbc.Driver
+ url: jdbc:mysql://150.158.18.177:3306/hypersense_blog?zeroDateTimeBehavior=convertToNull&useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&autoReconnect=true&allowMultiQueries=true
+ username: root
+ password: 123456
+ data:
+ redis:
+ database: 11
+ host: 150.158.18.177
+ port: 6379
+ password: 123456
+ timeout: 10s
+ lettuce:
+ pool:
+ # 连接池最大连接数 默认8 ，负数表示没有限制
+ max-active: 8
+ # 连接池最大阻塞等待时间（使用负值表示没有限制） 默认-1
+ max-wait: -1
+ # 连接池中的最大空闲连接 默认8
+ max-idle: 8
+ # 连接池中的最小空闲连接 默认0
+ min-idle: 0
+ cache:
+ enabled: false
+ # 缓存类型 redis、none(不使用缓存)
+ type: redis
+ # 缓存时间(单位：ms)
+ redis:
+ time-to-live: 3600000
+ # 缓存null值，防止缓存穿透
+ cache-null-values: true
+ caffeine:
+ spec: initialCapacity=50,maximumSize=1000,expireAfterWrite=600s
+ # 邮件配置
+ mail:
+ host: smtp.youlai.tech
+ port: 587
+ username: your-email@example.com
+ password: 123456
+ properties:
+ mail:
+ smtp:
+ auth: true
+ starttls:
+ enable: true
+ # 邮件发送者
+ from: youlaitech@163.com
+mybatis-plus:
+ mapper-locations: classpath*:/mapper/**/*.xml
+ global-config:
+ db-config:
+ # 主键ID类型
+ id-type: none
+ # 逻辑删除对应的全局属性名（注意：须是对象属性名，不能是表字段名，如 isDeleted 而非 is_deleted，否则逻辑删除失效）
+ logic-delete-field: isDeleted
+ # 逻辑删除-删除值
+ logic-delete-value: 1
+ # 逻辑删除-未删除值
+ logic-not-delete-value: 0
+ configuration:
+ # 驼峰下划线转换
+ map-underscore-to-camel-case: true
+ # 这个配置会将执行的sql打印出来，在开发或测试的时候可以用
+ log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
+
+# 安全配置
+security:
+ session:
+ type: jwt # 会话方式 [jwt|redis-token]
+ access-token-time-to-live: 3600 # 访问令牌 有效期(单位：秒)，默认 1 小时，-1 表示永不过期
+ refresh-token-time-to-live: 604800 # 刷新令牌有效期(单位：秒)，默认 7 天，-1 表示永不过期
+ jwt:
+ secret-key: SecretKey012345678901234567890123456789012345678901234567890123456789 # JWT密钥(HS256算法至少32字符)
+ redis-token:
+ allow-multi-login: true # 是否允许多设备登录
+ # 安全白名单路径（完全绕过安全过滤器）
+ ignore-urls:
+ - /api/v1/auth/login/** # 登录接口(账号密码登录、手机验证码登录和微信登录)
+ - /api/v1/auth/captcha # 验证码获取接口
+ - /api/v1/auth/refresh-token # 刷新令牌接口
+ - /ws/** # WebSocket接口
+ - /api/v1/blog/** # 博客查询展示页
+ # 非安全端点路径（允许匿名访问的API）
+ unsecured-urls:
+ - ${springdoc.swagger-ui.path}
+ - /doc.html
+ - /swagger-ui/**
+ - /v3/api-docs/**
+ - /webjars/**
+ - /api/v1/blog/** # 博客查询展示页
+
+# 文件存储配置
+oss:
+ # OSS 类型 (目前支持aliyun、minio)
+ type: minio
+ # MinIO 对象存储服务
+ minio:
+ # 服务Endpoint
+ endpoint: http://150.158.18.177:9000
+ # 访问凭据
+ access-key: 69Vj5mYhO6W85n2hqwCc
+ # 凭据密钥
+ secret-key: 9bBEo5vKtaxFyfEVL7LbwamhKCwG9KNKhkGuQDL0
+ # 存储桶名称
+ bucket-name: hypersenseblog
+ # (可选)自定义域名，如果配置了域名，生成的文件URL是域名格式，未配置则URL则是IP格式 (eg: https://oss.youlai.tech)
+ custom-domain:
+ # 阿里云OSS对象存储服务
+ aliyun:
+ # 服务Endpoint
+ endpoint: oss-cn-hangzhou.aliyuncs.com
+ # 访问凭据
+ access-key-id: your-access-key-id
+ # 凭据密钥
+ access-key-secret: your-access-key-secret
+ # 存储桶名称
+ bucket-name: default
+ # 本地存储
+ local:
+ # 文件存储路径 请注意下，mac用户请使用 /Users/your-username/your-path/，否则会有权限问题，windows用户请使用 D:/your-path/
+ storage-path: /Users/theo/home/
+# 短信配置
+sms:
+ # 阿里云短信
+ aliyun:
+ accessKeyId: LTAI5tSMgfxxxxxxdiBJLyR
+ accessKeySecret: SoOWRqpjtS7xxxxxxZ2PZiMTJOVC
+ domain: dysmsapi.aliyuncs.com
+ regionId: cn-shanghai
+ signName: 有来技术
+ templates:
+ # 注册短信验证码模板
+ register: SMS_22xxx771
+ # 登录短信验证码模板
+ login: SMS_22xxx772
+ # 修改手机号短信验证码模板
+ change-mobile: SMS_22xxx773
+
+# springdoc配置： https://springdoc.org/properties.html
+springdoc:
+ swagger-ui:
+ path: /swagger-ui.html
+ operationsSorter: alpha
+ tags-sorter: alpha
+ api-docs:
+ path: /v3/api-docs
+ group-configs:
+ - group: '系统管理'
+ paths-to-match: "/**"
+ packages-to-scan:
+ - com.youlai.boot.system.controller
+ - com.youlai.boot.shared.auth.controller
+ - com.youlai.boot.shared.file.controller
+ - com.youlai.boot.shared.codegen.controller
+ default-flat-param-object: true
+
+# knife4j 接口文档配置
+knife4j:
+ # 是否开启 Knife4j 增强功能
+ enable: true # 设置为 true 表示开启增强功能
+ # 生产环境配置
+ production: false # 设置为 true 表示在生产环境中不显示文档，为 false 表示显示文档（通常在开发环境中使用）
+ setting:
+ language: zh_cn
+
+# xxl-job 定时任务配置
+xxl:
+ job:
+ # 定时任务开关
+ enabled: false
+ admin:
+ # 多个地址使用,分割
+ addresses: http://150.158.18.177:8686/xxl-job-admin
+ accessToken: default_token
+ executor:
+ appname: xxl-job-executor-${spring.application.name}
+ address:
+ ip:
+ port: 9999
+ logpath: /data/applogs/xxl-job/jobhandler
+ logretentiondays: 30
+
+# 验证码配置
+captcha:
+ # 验证码类型 circle-圆圈干扰验证码|gif-Gif验证码|line-干扰线验证码|shear-扭曲干扰验证码
+ type: circle
+ # 验证码宽度
+ width: 120
+ # 验证码高度
+ height: 40
+ # 验证码干扰元素个数
+ interfere-count: 2
+ # 文本透明度(0.0-1.0)
+ text-alpha: 0.8
+ # 验证码字符配置
+ code:
+ # 验证码字符类型 math-算术|random-随机字符
+ type: math
+ # 验证码字符长度，type=算术时，表示运算位数(1:个位数运算 2:十位数运算)；type=随机字符时，表示字符个数
+ length: 1
+ # 验证码字体
+ font:
+ # 字体名称 Dialog|DialogInput|Monospaced|Serif|SansSerif
+ name: SansSerif
+ # 字体样式 0-普通|1-粗体|2-斜体
+ weight: 1
+ # 字体大小
+ size: 24
+ # 验证码有效期(秒)
+ expire-seconds: 120
+
+# 微信小程配置
+wx:
+ miniapp:
+ app-id: xxxxxx
+ app-secret: xxxxxx
\ No newline at end of file
diff --git a/hypersense-access/src/main/resources/application.yml b/hypersense-access/src/main/resources/application.yml
new file mode 100644
index 0000000..16e4c23
--- /dev/null
+++ b/hypersense-access/src/main/resources/application.yml
@@ -0,0 +1,11 @@
+spring:
+ application:
+ name: hypernse-boot
+ profiles:
+ active: dev
+ # config:
+ # import: classpath:codegen.yml
+
+# 在 banner.txt 中显示项目版本，使用 @project.version@ 从 pom.xml 获取
+project:
+ version: @project.version@
diff --git a/hypersense-access/src/main/resources/banner.txt b/hypersense-access/src/main/resources/banner.txt
new file mode 100644
index 0000000..f3c6f0a
--- /dev/null
+++ b/hypersense-access/src/main/resources/banner.txt
@@ -0,0 +1,16 @@
+${AnsiColor.BRIGHT_BLUE}
+ ██ ██ ████████
+░██ ░██ ██ ██ ██████ ██░░░░░░
+░██ ░██ ░░██ ██ ░██░░░██ █████ ██████░██ █████ ███████ ██████ █████
+░██████████ ░░███ ░██ ░██ ██░░░██░░██░░█░█████████ ██░░░██░░██░░░██ ██░░░░ ██░░░██
+░██░░░░░░██ ░██ ░██████ ░███████ ░██ ░ ░░░░░░░░██░███████ ░██ ░██░░█████ ░███████
+░██ ░██ ██ ░██░░░ ░██░░░░ ░██ ░██░██░░░░ ░██ ░██ ░░░░░██░██░░░░
+░██ ░██ ██ ░██ ░░██████░███ ████████ ░░██████ ███ ░██ ██████ ░░██████
+░░ ░░ ░░ ░░ ░░░░░░ ░░░ ░░░░░░░░ ░░░░░░ ░░░ ░░ ░░░░░░ ░░░░░░
+
+${AnsiColor.BRIGHT_BLUE}
+HyperSense Boot Version: ${project.version}
+Spring Boot Version: ${spring-boot.version}${spring-boot.formatted-version}
+氦闪官网: https://www.hypersense.tech/
+版权所属: 氦闪技术分享
+${AnsiColor.CYAN}
\ No newline at end of file
diff --git a/hypersense-access/src/main/resources/logback-spring.xml b/hypersense-access/src/main/resources/logback-spring.xml
new file mode 100644
index 0000000..a424b78
--- /dev/null
+++ b/hypersense-access/src/main/resources/logback-spring.xml
@@ -0,0 +1,64 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DEBUG
+
+
+ ${CONSOLE_LOG_PATTERN}
+ UTF-8
+
+
+
+
+
+
+ ${LOG_HOME}/log.log
+
+
+ %d{yyyy-MM-dd HH:mm:ss.SSS} -%5level ---[%15.15thread] %-40.40logger{39} : %msg%n%n
+ UTF-8
+
+
+
+
+ ${LOG_HOME}/%d{yyyy-MM-dd}.%i.log
+
+ 10MB
+
+ 30
+
+ 1GB
+
+
+
+ INFO
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/hypersense-common/hypersense-common-bom/pom.xml b/hypersense-common/hypersense-common-bom/pom.xml
new file mode 100644
index 0000000..9d60a11
--- /dev/null
+++ b/hypersense-common/hypersense-common-bom/pom.xml
@@ -0,0 +1,70 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-common
+ ${revision}
+
+ hypersense-common-bom
+
+
+ hypersense-common-bom common模块依赖项
+
+
+
+ 1.0.0
+
+
+
+
+
+ tech.hypersense
+ hypersense-common-core
+ ${revision}
+
+
+
+ tech.hypersense
+ hypersense-common-web
+ ${revision}
+
+
+
+ tech.hypersense
+ hypersense-common-security
+ ${revision}
+
+
+
+ tech.hypersense
+ hypersense-common-websocket
+ ${revision}
+
+
+
+ tech.hypersense
+ hypersense-common-desensitize
+ ${revision}
+
+
+
+ tech.hypersense
+ hypersense-common-ratelimiter
+ ${revision}
+
+
+
+ tech.hypersense
+ hypersense-common-tenant
+ ${revision}
+
+
+
+ tech.hypersense
+ hypersense-common-translation
+ ${revision}
+
+
+
+
diff --git a/hypersense-common/hypersense-common-core/pom.xml b/hypersense-common/hypersense-common-core/pom.xml
new file mode 100644
index 0000000..6b6a3b5
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/pom.xml
@@ -0,0 +1,64 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-common
+ ${revision}
+
+ hypersense-common-core
+
+ hypersense-common-core 核心模块
+
+
+
+
+
+ org.springframework
+ spring-context-support
+
+
+
+
+ org.springframework
+ spring-web
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-validation
+
+
+
+
+ org.apache.commons
+ commons-lang3
+
+
+
+
+ jakarta.servlet
+ jakarta.servlet-api
+
+
+
+ org.projectlombok
+ lombok
+
+
+
+
+ org.springframework.boot
+ spring-boot-configuration-processor
+
+
+
+ org.springframework.boot
+ spring-boot-properties-migrator
+ runtime
+
+
+
+
+
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/DataPermission.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/DataPermission.java
new file mode 100644
index 0000000..751c0e1
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/DataPermission.java
@@ -0,0 +1,27 @@
+package tech.hypersense.common.core.annotation;
+
+import java.lang.annotation.*;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 数据权限注解
+ * @Version: 1.0
+ */
+@Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.TYPE, ElementType.METHOD})
+public @interface DataPermission {
+
+ /**
+ * 数据权限 {@link com.baomidou.mybatisplus.extension.plugins.inner.DataPermissionInterceptor}
+ */
+ String deptAlias() default "";
+
+ String deptIdColumnName() default "dept_id";
+
+ String userAlias() default "";
+
+ String userIdColumnName() default "create_by";
+
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/Debounce.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/Debounce.java
new file mode 100644
index 0000000..8f9485f
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/Debounce.java
@@ -0,0 +1,24 @@
+package tech.hypersense.common.core.annotation;
+
+import java.lang.annotation.*;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 防止老年手抖导致重复提交注解 该注解用于方法上，防止在指定时间内的重复提交。 默认时间为5秒。
+ * @Version: 1.0
+ */
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+@Inherited
+public @interface Debounce {
+
+ /**
+ * 锁过期时间（秒）
+ *
+ * 默认5秒内不允许重复提交
+ */
+ int expire() default 5;
+
+}
\ No newline at end of file
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/Log.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/Log.java
new file mode 100644
index 0000000..245a050
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/Log.java
@@ -0,0 +1,49 @@
+package tech.hypersense.common.core.annotation;
+
+import tech.hypersense.common.core.enums.LogModuleEnum;
+
+import java.lang.annotation.*;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 日志注解
+ * @Version: 1.0
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+@Documented
+public @interface Log {
+
+ /**
+ * 日志描述
+ *
+ * @return 日志描述
+ */
+ String value() default "";
+
+ /**
+ * 日志模块
+ *
+ * @return 日志模块
+ */
+
+ LogModuleEnum module();
+
+ /**
+ * 是否记录请求参数
+ *
+ * @return 是否记录请求参数
+ */
+ boolean params() default true;
+
+ /**
+ * 是否记录响应结果
+ *
+ * 响应结果默认不记录，避免日志过大
+ * @return 是否记录响应结果
+ */
+ boolean result() default false;
+
+
+}
\ No newline at end of file
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/ValidField.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/ValidField.java
new file mode 100644
index 0000000..848bb10
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/annotation/ValidField.java
@@ -0,0 +1,35 @@
+package tech.hypersense.common.core.annotation;
+
+import jakarta.validation.Constraint;
+import jakarta.validation.Payload;
+import tech.hypersense.common.core.validator.FieldValidator;
+
+import java.lang.annotation.*;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 用于验证字段值是否合法的注解
+ * @Version: 1.0
+ */
+@Documented
+@Constraint(validatedBy = FieldValidator.class)
+@Target({ElementType.FIELD, ElementType.PARAMETER})
+@Retention(RetentionPolicy.RUNTIME)
+public @interface ValidField {
+
+ /**
+ * 验证失败时的错误信息。
+ */
+ String message() default "非法字段";
+
+ Class[] groups() default {};
+
+ Class[] payload() default {};
+
+ /**
+ * 允许的合法值列表。
+ */
+ String[] allowedValues();
+
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/aspect/DebounceAspect.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/aspect/DebounceAspect.java
new file mode 100644
index 0000000..5fb224f
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/aspect/DebounceAspect.java
@@ -0,0 +1,99 @@
+package tech.hypersense.common.core.aspect;
+
+import cn.hutool.core.util.StrUtil;
+import cn.hutool.crypto.digest.DigestUtil;
+import jakarta.servlet.http.HttpServletRequest;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.aspectj.lang.ProceedingJoinPoint;
+import org.aspectj.lang.annotation.Around;
+import org.aspectj.lang.annotation.Aspect;
+import org.aspectj.lang.annotation.Pointcut;
+import org.redisson.api.RLock;
+import org.redisson.api.RedissonClient;
+import org.springframework.http.HttpHeaders;
+import org.springframework.stereotype.Component;
+import org.springframework.web.context.request.RequestContextHolder;
+import org.springframework.web.context.request.ServletRequestAttributes;
+import tech.hypersense.common.core.annotation.Debounce;
+import tech.hypersense.common.core.constant.RedisConstants;
+import tech.hypersense.common.core.constant.SecurityConstants;
+import tech.hypersense.common.core.enums.ResultCode;
+import tech.hypersense.common.core.exception.BusinessException;
+import tech.hypersense.common.core.utils.IPUtils;
+
+import java.util.concurrent.TimeUnit;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 防抖切面
+ * @Version: 1.0
+ */
+@Aspect
+@Component
+@RequiredArgsConstructor
+@Slf4j
+public class DebounceAspect {
+
+ private final RedissonClient redissonClient;
+
+ /**
+ * 防重复提交切点
+ */
+ @Pointcut("@annotation(debounce)")
+ public void repeatSubmitPointCut(Debounce debounce) {
+ }
+
+ /**
+ * 环绕通知：处理防重复提交逻辑
+ */
+ @Around(value = "repeatSubmitPointCut(debounce)", argNames = "pjp,debounce")
+ public Object handleRepeatSubmit(ProceedingJoinPoint pjp, Debounce debounce) throws Throwable {
+ String lockKey = buildLockKey();
+
+ int expire = debounce.expire();
+ RLock lock = redissonClient.getLock(lockKey);
+
+ boolean locked = lock.tryLock(0, expire, TimeUnit.SECONDS);
+ if (!locked) {
+ throw new BusinessException(ResultCode.USER_DUPLICATE_REQUEST);
+ }
+ return pjp.proceed();
+ }
+
+ /**
+ * 生成防重复提交锁的 key
+ * @return 锁的 key
+ */
+ private String buildLockKey() {
+ HttpServletRequest request = ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getRequest();
+ // 用户唯一标识
+ String userIdentifier = getUserIdentifier(request);
+ // 请求唯一标识 = 请求方法 + 请求路径 + 请求参数(严谨的做法)
+ String requestIdentifier = StrUtil.join(":", request.getMethod(), request.getRequestURI());
+ return StrUtil.format(RedisConstants.Lock.RESUBMIT, userIdentifier, requestIdentifier);
+ }
+
+ /**
+ * 获取用户唯一标识
+ * 1. 从请求头中获取 Token，使用 SHA-256 加密 Token 作为用户唯一标识
+ * 2. 如果 Token 为空，使用 IP 作为用户唯一标识
+ *
+ * @param request 请求对象
+ * @return 用户唯一标识
+ */
+ private String getUserIdentifier(HttpServletRequest request) {
+ // 用户身份唯一标识
+ String userIdentifier;
+ // 从请求头中获取 Token
+ String tokenHeader = request.getHeader(HttpHeaders.AUTHORIZATION);
+ if (StrUtil.isNotBlank(tokenHeader) && tokenHeader.startsWith(SecurityConstants.BEARER_TOKEN_PREFIX)) {
+ String rawToken = tokenHeader.substring(SecurityConstants.BEARER_TOKEN_PREFIX.length()); // 去掉 Bearer 后的 Token
+ userIdentifier = DigestUtil.sha256Hex(rawToken); // 使用 SHA-256 加密 Token 作为用户唯一标识
+ } else {
+ userIdentifier = IPUtils.getIpAddr(request); // 使用 IP 作为用户唯一标识
+ }
+ return userIdentifier;
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/JwtClaimConstants.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/JwtClaimConstants.java
new file mode 100644
index 0000000..a43a00e
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/JwtClaimConstants.java
@@ -0,0 +1,29 @@
+package tech.hypersense.common.core.constant;
+/**
+*@Author: HyperSense
+*@CreateTime: 2025-03-25
+*@Description: JWT Claims声明常量
JWT Claims 属于 Payload 的一部分，包含了一些实体（通常指的用户）的状态和额外的元数据。
+*@Version: 1.0
+*/
+public interface JwtClaimConstants {
+
+ /**
+ * 用户ID
+ */
+ String USER_ID = "userId";
+
+ /**
+ * 部门ID
+ */
+ String DEPT_ID = "deptId";
+
+ /**
+ * 数据权限
+ */
+ String DATA_SCOPE = "dataScope";
+
+ /**
+ * 权限(角色Code)集合
+ */
+ String AUTHORITIES = "authorities";
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/RedisConstants.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/RedisConstants.java
new file mode 100644
index 0000000..453cba3
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/RedisConstants.java
@@ -0,0 +1,60 @@
+package tech.hypersense.common.core.constant;
+/**
+*@Author: HyperSense
+*@CreateTime: 2025-03-25
+*@Description: Redis 常量
+*@Version: 1.0
+*/
+public interface RedisConstants {
+
+
+ /**
+ * 限流相关键
+ */
+ interface RateLimiter {
+ String IP = "rate_limiter:ip:{}"; // IP限流（示例：rate_limiter:ip:192.168.1.1）
+ }
+
+ /**
+ * 分布式锁相关键
+ */
+ interface Lock {
+ String RESUBMIT = "lock:resubmit:{}:{}"; // 防重复提交（示例：lock:resubmit:userIdentifier:requestIdentifier）
+ }
+
+ /**
+ * 认证模块
+ */
+ interface Auth {
+ // 存储访问令牌对应的用户信息（accessToken -> OnlineUser）
+ String ACCESS_TOKEN_USER = "auth:token:access:{}";
+ // 存储刷新令牌对应的用户信息（refreshToken -> OnlineUser）
+ String REFRESH_TOKEN_USER = "auth:token:refresh:{}";
+ // 用户与访问令牌的映射（userId -> accessToken）
+ String USER_ACCESS_TOKEN = "auth:user:access:{}";
+ // 用户与刷新令牌的映射（userId -> refreshToken
+ String USER_REFRESH_TOKEN = "auth:user:refresh:{}";
+ // 黑名单 Token（用于退出登录或注销）
+ String BLACKLIST_TOKEN = "auth:token:blacklist:{}";
+ }
+
+ /**
+ * 验证码模块
+ */
+ interface Captcha {
+ String IMAGE_CODE = "captcha:image:{}"; // 图形验证码
+ String SMS_LOGIN_CODE = "captcha:sms_login:{}"; // 登录短信验证码
+ String SMS_REGISTER_CODE = "captcha:sms_register:{}";// 注册短信验证码
+ String MOBILE_CODE = "captcha:mobile:{}"; // 绑定、更换手机验证码
+ String EMAIL_CODE = "captcha:email:{}"; // 邮箱验证码
+ }
+
+ /**
+ * 系统模块
+ */
+ interface System {
+ String CONFIG = "system:config"; // 系统配置
+ String ROLE_PERMS = "system:role:perms"; // 系统角色和权限映射
+ }
+
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/SecurityConstants.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/SecurityConstants.java
new file mode 100644
index 0000000..57e2d46
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/SecurityConstants.java
@@ -0,0 +1,24 @@
+package tech.hypersense.common.core.constant;
+/**
+*@Author: HyperSense
+*@CreateTime: 2025-03-25
+*@Description: 安全模块常量
+*@Version: 1.0
+*/
+public interface SecurityConstants {
+
+ /**
+ * 登录路径
+ */
+ String LOGIN_PATH = "/api/v1/auth/login";
+
+ /**
+ * JWT Token 前缀
+ */
+ String BEARER_TOKEN_PREFIX = "Bearer ";
+
+ /**
+ * 角色前缀，用于区分 authorities 角色和权限， ROLE_* 角色 、没有前缀的是权限
+ */
+ String ROLE_PREFIX = "ROLE_";
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/SystemConstants.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/SystemConstants.java
new file mode 100644
index 0000000..f287e9a
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/constant/SystemConstants.java
@@ -0,0 +1,30 @@
+package tech.hypersense.common.core.constant;
+/**
+*@Author: HyperSense
+*@CreateTime: 2025-03-25
+*@Description: 系统常量
+*@Version: 1.0
+*/
+public interface SystemConstants {
+
+ /**
+ * 根节点ID
+ */
+ Long ROOT_NODE_ID = 0L;
+
+ /**
+ * 系统默认密码
+ */
+ String DEFAULT_PASSWORD = "123456";
+
+ /**
+ * 超级管理员角色编码
+ */
+ String ROOT_ROLE_CODE = "ROOT";
+
+
+ /**
+ * 系统配置 IP的QPS限流的KEY
+ */
+ String SYSTEM_CONFIG_IP_QPS_LIMIT_KEY = "IP_QPS_THRESHOLD_LIMIT";
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/KValue.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/KValue.java
new file mode 100644
index 0000000..1784198
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/KValue.java
@@ -0,0 +1,22 @@
+package tech.hypersense.common.core.domain.model;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 键值对
+ * @Version: 1.0
+ */
+public class KValue {
+ public KValue(String key, String value) {
+ this.key = key;
+ this.value = value;
+ }
+
+ @Schema(description = "选项的值")
+ private String key;
+
+ @Schema(description = "选项的标签")
+ private String value;
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/Option.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/Option.java
new file mode 100644
index 0000000..97b577c
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/Option.java
@@ -0,0 +1,53 @@
+package tech.hypersense.common.core.domain.model;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 下拉选项对象
+ * @Version: 1.0
+ */
+@Schema(description ="下拉选项对象")
+@Data
+@NoArgsConstructor
+public class Option {
+
+ public Option(T value, String label) {
+ this.value = value;
+ this.label = label;
+ }
+
+ public Option(T value, String label, List> children) {
+ this.value = value;
+ this.label = label;
+ this.children= children;
+ }
+
+ public Option(T value, String label, String tag) {
+ this.value = value;
+ this.label = label;
+ this.tag= tag;
+ }
+
+
+ @Schema(description="选项的值")
+ private T value;
+
+ @Schema(description="选项的标签")
+ private String label;
+
+ @Schema(description = "标签类型")
+ @JsonInclude(value = JsonInclude.Include.NON_EMPTY)
+ private String tag;
+
+ @Schema(description="子选项列表")
+ @JsonInclude(value = JsonInclude.Include.NON_EMPTY)
+ private List> children;
+
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BaseEntity.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BaseEntity.java
new file mode 100644
index 0000000..32cbc10
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BaseEntity.java
@@ -0,0 +1,49 @@
+package tech.hypersense.common.core.domain.model.base;
+
+import com.baomidou.mybatisplus.annotation.FieldFill;
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.fasterxml.jackson.annotation.JsonFormat;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.time.LocalDateTime;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 实体类的基类，包含了实体类的公共属性，如创建时间、更新时间、逻辑删除标识等
+ * @Version: 1.0
+ */
+@Data
+public class BaseEntity implements Serializable {
+
+ @Serial
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * 主键ID
+ */
+ @TableId(type = IdType.AUTO)
+ private Long id;
+
+ /**
+ * 创建时间
+ */
+ @TableField(fill = FieldFill.INSERT)
+ @JsonInclude(value = JsonInclude.Include.NON_NULL)
+ @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+ private LocalDateTime createTime;
+
+ /**
+ * 更新时间
+ */
+ @TableField(fill = FieldFill.INSERT_UPDATE)
+ @JsonInclude(value = JsonInclude.Include.NON_NULL)
+ @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+ private LocalDateTime updateTime;
+
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BasePageQuery.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BasePageQuery.java
new file mode 100644
index 0000000..17c7721
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BasePageQuery.java
@@ -0,0 +1,27 @@
+package tech.hypersense.common.core.domain.model.base;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 基础分页类
+ * @Version: 1.0
+ */
+@Data
+@Schema
+public class BasePageQuery implements Serializable {
+
+ @Serial
+ private static final long serialVersionUID = 1L;
+
+ @Schema(description = "页码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ private int pageNum = 1;
+
+ @Schema(description = "每页记录数", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+ private int pageSize = 10;
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BaseVo.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BaseVo.java
new file mode 100644
index 0000000..a3493d8
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/model/base/BaseVo.java
@@ -0,0 +1,21 @@
+package tech.hypersense.common.core.domain.model.base;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 视图层基本类
+ * @Version: 1.0
+ */
+@Data
+@Schema
+public class BaseVo implements Serializable {
+
+ @Serial
+ private static final long serialVersionUID = 1L;
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/ExcelResult.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/ExcelResult.java
new file mode 100644
index 0000000..fae5186
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/ExcelResult.java
@@ -0,0 +1,44 @@
+package tech.hypersense.common.core.domain.result;
+
+import lombok.Data;
+import tech.hypersense.common.core.enums.ResultCode;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: Excel导出响应结构体
+ * @Version: 1.0
+ */
+@Data
+public class ExcelResult {
+
+ /**
+ * 响应码，来确定是否导入成功
+ */
+ private String code;
+
+ /**
+ * 有效条数
+ */
+ private Integer validCount;
+
+ /**
+ * 无效条数
+ */
+ private Integer invalidCount;
+
+ /**
+ * 错误提示信息
+ */
+ private List messageList;
+
+ public ExcelResult() {
+ this.code = ResultCode.SUCCESS.getCode();
+ this.validCount = 0;
+ this.invalidCount = 0;
+ this.messageList = new ArrayList<>();
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/PageResult.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/PageResult.java
new file mode 100644
index 0000000..9142026
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/PageResult.java
@@ -0,0 +1,46 @@
+package tech.hypersense.common.core.domain.result;
+
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import lombok.Data;
+import tech.hypersense.common.core.enums.ResultCode;
+
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 分页响应结构体
+ * @Version: 1.0
+ */
+@Data
+public class PageResult implements Serializable {
+
+ private String code;
+
+ private Data data;
+
+ private String msg;
+
+ public static PageResult success(IPage page) {
+ PageResult result = new PageResult<>();
+ result.setCode(ResultCode.SUCCESS.getCode());
+
+ Data data = new Data<>();
+ data.setList(page.getRecords());
+ data.setTotal(page.getTotal());
+
+ result.setData(data);
+ result.setMsg(ResultCode.SUCCESS.getMsg());
+ return result;
+ }
+
+ @lombok.Data
+ public static class Data {
+
+ private List list;
+
+ private long total;
+
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/Result.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/Result.java
new file mode 100644
index 0000000..250f49a
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/Result.java
@@ -0,0 +1,76 @@
+package tech.hypersense.common.core.domain.result;
+
+import cn.hutool.core.util.StrUtil;
+import lombok.Data;
+import tech.hypersense.common.core.domain.result.base.IResultCode;
+import tech.hypersense.common.core.enums.ResultCode;
+
+import java.io.Serializable;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 响应结构体
+ * @Version: 1.0
+ */
+@Data
+public class Result implements Serializable {
+
+ private String code;
+
+ private T data;
+
+ private String msg;
+
+ public static Result success() {
+ return success(null);
+ }
+
+ public static Result success(T data) {
+ Result result = new Result<>();
+ result.setCode(ResultCode.SUCCESS.getCode());
+ result.setMsg(ResultCode.SUCCESS.getMsg());
+ result.setData(data);
+ return result;
+ }
+
+ public static Result failed() {
+ return result(ResultCode.SYSTEM_ERROR.getCode(), ResultCode.SYSTEM_ERROR.getMsg(), null);
+ }
+
+ public static Result failed(String msg) {
+ return result(ResultCode.SYSTEM_ERROR.getCode(), msg, null);
+ }
+
+ public static Result judge(boolean status) {
+ if (status) {
+ return success();
+ } else {
+ return failed();
+ }
+ }
+
+ public static Result failed(IResultCode resultCode) {
+ return result(resultCode.getCode(), resultCode.getMsg(), null);
+ }
+
+ public static Result failed(IResultCode resultCode, String msg) {
+ return result(resultCode.getCode(), StrUtil.isNotBlank(msg) ? msg : resultCode.getMsg(), null);
+ }
+
+ private static Result result(IResultCode resultCode, T data) {
+ return result(resultCode.getCode(), resultCode.getMsg(), data);
+ }
+
+ private static Result result(String code, String msg, T data) {
+ Result result = new Result<>();
+ result.setCode(code);
+ result.setData(data);
+ result.setMsg(msg);
+ return result;
+ }
+
+ public static boolean isSuccess(Result result) {
+ return result != null && ResultCode.SUCCESS.getCode().equals(result.getCode());
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/base/IResultCode.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/base/IResultCode.java
new file mode 100644
index 0000000..04adc1a
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/domain/result/base/IResultCode.java
@@ -0,0 +1,14 @@
+package tech.hypersense.common.core.domain.result.base;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 响应码接口
+ * @Version: 1.0
+ */
+public interface IResultCode {
+
+ String getCode();
+
+ String getMsg();
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/DataScopeEnum.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/DataScopeEnum.java
new file mode 100644
index 0000000..aee4503
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/DataScopeEnum.java
@@ -0,0 +1,31 @@
+package tech.hypersense.common.core.enums;
+
+import lombok.Getter;
+import tech.hypersense.common.core.enums.base.IBaseEnum;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 数据权限枚举
+ * @Version: 1.0
+ */
+@Getter
+public enum DataScopeEnum implements IBaseEnum {
+
+ /**
+ * value 越小，数据权限范围越大
+ */
+ ALL(0, "所有数据"),
+ DEPT_AND_SUB(1, "部门及子部门数据"),
+ DEPT(2, "本部门数据"),
+ SELF(3, "本人数据");
+
+ private final Integer value;
+
+ private final String label;
+
+ DataScopeEnum(Integer value, String label) {
+ this.value = value;
+ this.label = label;
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/EnvEnum.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/EnvEnum.java
new file mode 100644
index 0000000..8738abe
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/EnvEnum.java
@@ -0,0 +1,27 @@
+package tech.hypersense.common.core.enums;
+
+import lombok.Getter;
+import org.apache.poi.ss.formula.functions.T;
+import tech.hypersense.common.core.enums.base.IBaseEnum;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 环境枚举
+ * @Version: 1.0
+ */
+@Getter
+public enum EnvEnum implements IBaseEnum {
+
+ DEV("dev", "开发环境"),
+ PROD("prod", "生产环境");
+
+ private final String value;
+
+ private final String label;
+
+ EnvEnum(String value, String label) {
+ this.value = value;
+ this.label = label;
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/LogModuleEnum.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/LogModuleEnum.java
new file mode 100644
index 0000000..8202c19
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/LogModuleEnum.java
@@ -0,0 +1,33 @@
+package tech.hypersense.common.core.enums;
+
+import com.fasterxml.jackson.annotation.JsonValue;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 日志模块枚举
+ * @Version: 1.0
+ */
+@Schema(enumAsRef = true)
+@Getter
+public enum LogModuleEnum {
+
+ EXCEPTION("异常"),
+ LOGIN("登录"),
+ USER("用户"),
+ DEPT("部门"),
+ ROLE("角色"),
+ MENU("菜单"),
+ DICT("字典"),
+ SETTING("系统配置"),
+ OTHER("其他");
+
+ @JsonValue
+ private final String moduleName;
+
+ LogModuleEnum(String moduleName) {
+ this.moduleName = moduleName;
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/RequestMethodEnum.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/RequestMethodEnum.java
new file mode 100644
index 0000000..e739132
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/RequestMethodEnum.java
@@ -0,0 +1,58 @@
+package tech.hypersense.common.core.enums;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description:
+ * @Version: 1.0
+ */
+@Getter
+@AllArgsConstructor
+public enum RequestMethodEnum {
+ /**
+ * 搜寻 @AnonymousGetMapping
+ */
+ GET("GET"),
+
+ /**
+ * 搜寻 @AnonymousPostMapping
+ */
+ POST("POST"),
+
+ /**
+ * 搜寻 @AnonymousPutMapping
+ */
+ PUT("PUT"),
+
+ /**
+ * 搜寻 @AnonymousPatchMapping
+ */
+ PATCH("PATCH"),
+
+ /**
+ * 搜寻 @AnonymousDeleteMapping
+ */
+ DELETE("DELETE"),
+
+ /**
+ * 否则就是所有 Request 接口都放行
+ */
+ ALL("All");
+
+ /**
+ * Request 类型
+ */
+ private final String type;
+
+ public static RequestMethodEnum find(String type) {
+ for (RequestMethodEnum value : RequestMethodEnum.values()) {
+ if (value.getType().equals(type)) {
+ return value;
+ }
+ }
+ return ALL;
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/ResultCode.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/ResultCode.java
new file mode 100644
index 0000000..13f8815
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/ResultCode.java
@@ -0,0 +1,290 @@
+package tech.hypersense.common.core.enums;
+
+import lombok.AllArgsConstructor;
+import lombok.NoArgsConstructor;
+import tech.hypersense.common.core.domain.result.base.IResultCode;
+
+import java.io.Serializable;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 响应码枚举：参考阿里巴巴开发手册响应码规范
+ * @Version: 1.0
+ */
+@AllArgsConstructor
+@NoArgsConstructor
+public enum ResultCode implements IResultCode, Serializable {
+
+ SUCCESS("00000", "一切ok"),
+
+ /** 一级宏观错误码 */
+ USER_ERROR("A0001", "用户端错误"),
+
+ /** 二级宏观错误码 */
+ USER_REGISTRATION_ERROR("A0100", "用户注册错误"),
+ USER_NOT_AGREE_PRIVACY_AGREEMENT("A0101", "用户未同意隐私协议"),
+ REGISTRATION_COUNTRY_OR_REGION_RESTRICTED("A0102", "注册国家或地区受限"),
+
+ USERNAME_VERIFICATION_FAILED("A0110", "用户名校验失败"),
+ USERNAME_ALREADY_EXISTS("A0111", "用户名已存在"),
+ USERNAME_CONTAINS_SENSITIVE_WORDS("A0112", "用户名包含敏感词"),
+ USERNAME_CONTAINS_SPECIAL_CHARACTERS("A0113", "用户名包含特殊字符"),
+
+ PASSWORD_VERIFICATION_FAILED("A0120", "密码校验失败"),
+ PASSWORD_LENGTH_NOT_ENOUGH("A0121", "密码长度不够"),
+ PASSWORD_STRENGTH_NOT_ENOUGH("A0122", "密码强度不够"),
+
+ VERIFICATION_CODE_INPUT_ERROR("A0130", "校验码输入错误"),
+ SMS_VERIFICATION_CODE_INPUT_ERROR("A0131", "短信校验码输入错误"),
+ EMAIL_VERIFICATION_CODE_INPUT_ERROR("A0132", "邮件校验码输入错误"),
+ VOICE_VERIFICATION_CODE_INPUT_ERROR("A0133", "语音校验码输入错误"),
+
+ USER_CERTIFICATE_EXCEPTION("A0140", "用户证件异常"),
+ USER_CERTIFICATE_TYPE_NOT_SELECTED("A0141", "用户证件类型未选择"),
+ MAINLAND_ID_NUMBER_VERIFICATION_ILLEGAL("A0142", "大陆身份证编号校验非法"),
+
+ USER_BASIC_INFORMATION_VERIFICATION_FAILED("A0150", "用户基本信息校验失败"),
+ PHONE_FORMAT_VERIFICATION_FAILED("A0151", "手机格式校验失败"),
+ ADDRESS_FORMAT_VERIFICATION_FAILED("A0152", "地址格式校验失败"),
+ EMAIL_FORMAT_VERIFICATION_FAILED("A0153", "邮箱格式校验失败"),
+
+ /** 二级宏观错误码 */
+ USER_LOGIN_EXCEPTION("A0200", "用户登录异常"),
+ USER_ACCOUNT_FROZEN("A0201", "用户账户被冻结"),
+ USER_ACCOUNT_ABOLISHED("A0202", "用户账户已作废"),
+
+ USER_PASSWORD_ERROR("A0210", "用户名或密码错误"),
+ USER_INPUT_PASSWORD_ERROR_LIMIT_EXCEEDED("A0211", "用户输入密码错误次数超限"),
+
+ USER_IDENTITY_VERIFICATION_FAILED("A0220", "用户身份校验失败"),
+ USER_FINGERPRINT_RECOGNITION_FAILED("A0221", "用户指纹识别失败"),
+ USER_FACE_RECOGNITION_FAILED("A0222", "用户面容识别失败"),
+ USER_NOT_AUTHORIZED_THIRD_PARTY_LOGIN("A0223", "用户未获得第三方登录授权"),
+
+ ACCESS_TOKEN_INVALID("A0230", "访问令牌无效或已过期"),
+ REFRESH_TOKEN_INVALID("A0231", "刷新令牌无效或已过期"),
+
+ // 验证码错误
+ USER_VERIFICATION_CODE_ERROR("A0240", "验证码错误"),
+ USER_VERIFICATION_CODE_ATTEMPT_LIMIT_EXCEEDED("A0241", "用户验证码尝试次数超限"),
+ USER_VERIFICATION_CODE_EXPIRED("A0242", "用户验证码过期"),
+
+ /** 二级宏观错误码 */
+ ACCESS_PERMISSION_EXCEPTION("A0300", "访问权限异常"),
+ ACCESS_UNAUTHORIZED("A0301", "访问未授权"),
+ AUTHORIZATION_IN_PROGRESS("A0302", "正在授权中"),
+ USER_AUTHORIZATION_APPLICATION_REJECTED("A0303", "用户授权申请被拒绝"),
+
+ ACCESS_OBJECT_PRIVACY_SETTINGS_BLOCKED("A0310", "因访问对象隐私设置被拦截"),
+ AUTHORIZATION_EXPIRED("A0311", "授权已过期"),
+ NO_PERMISSION_TO_USE_API("A0312", "无权限使用 API"),
+
+ USER_ACCESS_BLOCKED("A0320", "用户访问被拦截"),
+ BLACKLISTED_USER("A0321", "黑名单用户"),
+ ACCOUNT_FROZEN("A0322", "账号被冻结"),
+ ILLEGAL_IP_ADDRESS("A0323", "非法 IP 地址"),
+ GATEWAY_ACCESS_RESTRICTED("A0324", "网关访问受限"),
+ REGION_BLACKLIST("A0325", "地域黑名单"),
+
+ SERVICE_ARREARS("A0330", "服务已欠费"),
+
+ USER_SIGNATURE_EXCEPTION("A0340", "用户签名异常"),
+ RSA_SIGNATURE_ERROR("A0341", "RSA 签名错误"),
+
+ /** 二级宏观错误码 */
+ USER_REQUEST_PARAMETER_ERROR("A0400", "用户请求参数错误"),
+ CONTAINS_ILLEGAL_MALICIOUS_REDIRECT_LINK("A0401", "包含非法恶意跳转链接"),
+ INVALID_USER_INPUT("A0402", "无效的用户输入"),
+
+ REQUEST_REQUIRED_PARAMETER_IS_EMPTY("A0410", "请求必填参数为空"),
+
+ REQUEST_PARAMETER_VALUE_EXCEEDS_ALLOWED_RANGE("A0420", "请求参数值超出允许的范围"),
+ PARAMETER_FORMAT_MISMATCH("A0421", "参数格式不匹配"),
+
+ USER_INPUT_CONTENT_ILLEGAL("A0430", "用户输入内容非法"),
+ CONTAINS_PROHIBITED_SENSITIVE_WORDS("A0431", "包含违禁敏感词"),
+
+ USER_OPERATION_EXCEPTION("A0440", "用户操作异常"),
+
+ /** 二级宏观错误码 */
+ USER_REQUEST_SERVICE_EXCEPTION("A0500", "用户请求服务异常"),
+ REQUEST_LIMIT_EXCEEDED("A0501", "请求次数超出限制"),
+ REQUEST_CONCURRENCY_LIMIT_EXCEEDED("A0502", "请求并发数超出限制"),
+ USER_OPERATION_PLEASE_WAIT("A0503", "用户操作请等待"),
+ WEBSOCKET_CONNECTION_EXCEPTION("A0504", "WebSocket 连接异常"),
+ WEBSOCKET_CONNECTION_DISCONNECTED("A0505", "WebSocket 连接断开"),
+ USER_DUPLICATE_REQUEST("A0506", "请求过于频繁，请稍后再试。"),
+
+ /** 二级宏观错误码 */
+ USER_RESOURCE_EXCEPTION("A0600", "用户资源异常"),
+ ACCOUNT_BALANCE_INSUFFICIENT("A0601", "账户余额不足"),
+ USER_DISK_SPACE_INSUFFICIENT("A0602", "用户磁盘空间不足"),
+ USER_MEMORY_SPACE_INSUFFICIENT("A0603", "用户内存空间不足"),
+ USER_OSS_CAPACITY_INSUFFICIENT("A0604", "用户 OSS 容量不足"),
+ USER_QUOTA_EXHAUSTED("A0605", "用户配额已用光"),
+ USER_RESOURCE_NOT_FOUND("A0606", "用户资源不存在"),
+
+ /** 二级宏观错误码 */
+ UPLOAD_FILE_EXCEPTION("A0700", "上传文件异常"),
+ UPLOAD_FILE_TYPE_MISMATCH("A0701", "上传文件类型不匹配"),
+ UPLOAD_FILE_TOO_LARGE("A0702", "上传文件太大"),
+ UPLOAD_IMAGE_TOO_LARGE("A0703", "上传图片太大"),
+ UPLOAD_VIDEO_TOO_LARGE("A0704", "上传视频太大"),
+ UPLOAD_COMPRESSED_FILE_TOO_LARGE("A0705", "上传压缩文件太大"),
+
+ DELETE_FILE_EXCEPTION("A0710", "删除文件异常"),
+
+ /** 二级宏观错误码 */
+ USER_CURRENT_VERSION_EXCEPTION("A0800", "用户当前版本异常"),
+ USER_INSTALLED_VERSION_NOT_MATCH_SYSTEM("A0801", "用户安装版本与系统不匹配"),
+ USER_INSTALLED_VERSION_TOO_LOW("A0802", "用户安装版本过低"),
+ USER_INSTALLED_VERSION_TOO_HIGH("A0803", "用户安装版本过高"),
+ USER_INSTALLED_VERSION_EXPIRED("A0804", "用户安装版本已过期"),
+ USER_API_REQUEST_VERSION_NOT_MATCH("A0805", "用户 API 请求版本不匹配"),
+ USER_API_REQUEST_VERSION_TOO_HIGH("A0806", "用户 API 请求版本过高"),
+ USER_API_REQUEST_VERSION_TOO_LOW("A0807", "用户 API 请求版本过低"),
+
+ /** 二级宏观错误码 */
+ USER_PRIVACY_NOT_AUTHORIZED("A0900", "用户隐私未授权"),
+ USER_PRIVACY_NOT_SIGNED("A0901", "用户隐私未签署"),
+ USER_CAMERA_NOT_AUTHORIZED("A0903", "用户相机未授权"),
+ USER_PHOTO_LIBRARY_NOT_AUTHORIZED("A0904", "用户图片库未授权"),
+ USER_FILE_NOT_AUTHORIZED("A0905", "用户文件未授权"),
+ USER_LOCATION_INFORMATION_NOT_AUTHORIZED("A0906", "用户位置信息未授权"),
+ USER_CONTACTS_NOT_AUTHORIZED("A0907", "用户通讯录未授权"),
+
+ /** 二级宏观错误码 */
+ USER_DEVICE_EXCEPTION("A1000", "用户设备异常"),
+ USER_CAMERA_EXCEPTION("A1001", "用户相机异常"),
+ USER_MICROPHONE_EXCEPTION("A1002", "用户麦克风异常"),
+ USER_EARPIECE_EXCEPTION("A1003", "用户听筒异常"),
+ USER_SPEAKER_EXCEPTION("A1004", "用户扬声器异常"),
+ USER_GPS_POSITIONING_EXCEPTION("A1005", "用户 GPS 定位异常"),
+
+ /** 一级宏观错误码 */
+ SYSTEM_ERROR("B0001", "系统执行出错"),
+
+ /** 二级宏观错误码 */
+ SYSTEM_EXECUTION_TIMEOUT("B0100", "系统执行超时"),
+
+ /** 二级宏观错误码 */
+ SYSTEM_DISASTER_RECOVERY_FUNCTION_TRIGGERED("B0200", "系统容灾功能被触发"),
+
+ SYSTEM_RATE_LIMITING("B0210", "系统限流"),
+
+ SYSTEM_FUNCTION_DEGRADATION("B0220", "系统功能降级"),
+
+ /** 二级宏观错误码 */
+ SYSTEM_RESOURCE_EXCEPTION("B0300", "系统资源异常"),
+ SYSTEM_RESOURCE_EXHAUSTED("B0310", "系统资源耗尽"),
+ SYSTEM_DISK_SPACE_EXHAUSTED("B0311", "系统磁盘空间耗尽"),
+ SYSTEM_MEMORY_EXHAUSTED("B0312", "系统内存耗尽"),
+ FILE_HANDLE_EXHAUSTED("B0313", "文件句柄耗尽"),
+ SYSTEM_CONNECTION_POOL_EXHAUSTED("B0314", "系统连接池耗尽"),
+ SYSTEM_THREAD_POOL_EXHAUSTED("B0315", "系统线程池耗尽"),
+
+ SYSTEM_RESOURCE_ACCESS_EXCEPTION("B0320", "系统资源访问异常"),
+ SYSTEM_READ_DISK_FILE_FAILED("B0321", "系统读取磁盘文件失败"),
+
+
+ /** 一级宏观错误码 */
+ THIRD_PARTY_SERVICE_ERROR("C0001", "调用第三方服务出错"),
+
+ /** 二级宏观错误码 */
+ MIDDLEWARE_SERVICE_ERROR("C0100", "中间件服务出错"),
+
+ RPC_SERVICE_ERROR("C0110", "RPC 服务出错"),
+ RPC_SERVICE_NOT_FOUND("C0111", "RPC 服务未找到"),
+ RPC_SERVICE_NOT_REGISTERED("C0112", "RPC 服务未注册"),
+ INTERFACE_NOT_EXIST("C0113", "接口不存在"),
+
+ MESSAGE_SERVICE_ERROR("C0120", "消息服务出错"),
+ MESSAGE_DELIVERY_ERROR("C0121", "消息投递出错"),
+ MESSAGE_CONSUMPTION_ERROR("C0122", "消息消费出错"),
+ MESSAGE_SUBSCRIPTION_ERROR("C0123", "消息订阅出错"),
+ MESSAGE_GROUP_NOT_FOUND("C0124", "消息分组未查到"),
+
+ CACHE_SERVICE_ERROR("C0130", "缓存服务出错"),
+ KEY_LENGTH_EXCEEDS_LIMIT("C0131", "key 长度超过限制"),
+ VALUE_LENGTH_EXCEEDS_LIMIT("C0132", "value 长度超过限制"),
+ STORAGE_CAPACITY_FULL("C0133", "存储容量已满"),
+ UNSUPPORTED_DATA_FORMAT("C0134", "不支持的数据格式"),
+
+ CONFIGURATION_SERVICE_ERROR("C0140", "配置服务出错"),
+
+ NETWORK_RESOURCE_SERVICE_ERROR("C0150", "网络资源服务出错"),
+ VPN_SERVICE_ERROR("C0151", "VPN 服务出错"),
+ CDN_SERVICE_ERROR("C0152", "CDN 服务出错"),
+ DOMAIN_NAME_RESOLUTION_SERVICE_ERROR("C0153", "域名解析服务出错"),
+ GATEWAY_SERVICE_ERROR("C0154", "网关服务出错"),
+
+ /** 二级宏观错误码 */
+ THIRD_PARTY_SYSTEM_EXECUTION_TIMEOUT("C0200", "第三方系统执行超时"),
+
+ RPC_EXECUTION_TIMEOUT("C0210", "RPC 执行超时"),
+
+ MESSAGE_DELIVERY_TIMEOUT("C0220", "消息投递超时"),
+
+ CACHE_SERVICE_TIMEOUT("C0230", "缓存服务超时"),
+
+ CONFIGURATION_SERVICE_TIMEOUT("C0240", "配置服务超时"),
+
+ DATABASE_SERVICE_TIMEOUT("C0250", "数据库服务超时"),
+
+ /** 二级宏观错误码 */
+ DATABASE_SERVICE_ERROR("C0300", "数据库服务出错"),
+
+ TABLE_NOT_EXIST("C0311", "表不存在"),
+ COLUMN_NOT_EXIST("C0312", "列不存在"),
+
+ MULTIPLE_SAME_NAME_COLUMNS_IN_MULTI_TABLE_ASSOCIATION("C0321", "多表关联中存在多个相同名称的列"),
+
+ DATABASE_DEADLOCK("C0331", "数据库死锁"),
+
+ PRIMARY_KEY_CONFLICT("C0341", "主键冲突"),
+
+ /** 二级宏观错误码 */
+ THIRD_PARTY_DISASTER_RECOVERY_SYSTEM_TRIGGERED("C0400", "第三方容灾系统被触发"),
+ THIRD_PARTY_SYSTEM_RATE_LIMITING("C0401", "第三方系统限流"),
+ THIRD_PARTY_FUNCTION_DEGRADATION("C0402", "第三方功能降级"),
+
+ /** 二级宏观错误码 */
+ NOTIFICATION_SERVICE_ERROR("C0500", "通知服务出错"),
+ SMS_REMINDER_SERVICE_FAILED("C0501", "短信提醒服务失败"),
+ VOICE_REMINDER_SERVICE_FAILED("C0502", "语音提醒服务失败"),
+ EMAIL_REMINDER_SERVICE_FAILED("C0503", "邮件提醒服务失败");
+
+
+ @Override
+ public String getCode() {
+ return code;
+ }
+
+ @Override
+ public String getMsg() {
+ return msg;
+ }
+
+ private String code;
+
+ private String msg;
+
+ @Override
+ public String toString() {
+ return "{" +
+ "\"code\":\"" + code + '\"' +
+ ", \"msg\":\"" + msg + '\"' +
+ '}';
+ }
+
+
+ public static ResultCode getValue(String code) {
+ for (ResultCode value : values()) {
+ if (value.getCode().equals(code)) {
+ return value;
+ }
+ }
+ return SYSTEM_ERROR; // 默认系统执行错误
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/StatusEnum.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/StatusEnum.java
new file mode 100644
index 0000000..0c6394a
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/StatusEnum.java
@@ -0,0 +1,28 @@
+package tech.hypersense.common.core.enums;
+
+import lombok.Getter;
+import tech.hypersense.common.core.enums.base.IBaseEnum;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 状态枚举
+ * @Version: 1.0
+ */
+@Getter
+public enum StatusEnum implements IBaseEnum {
+
+ ENABLE(1, "启用"),
+ DISABLE (0, "禁用");
+
+ private final Integer value;
+
+
+ private final String label;
+
+ StatusEnum(Integer value, String label) {
+ this.value = value;
+ this.label = label;
+ }
+
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/base/IBaseEnum.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/base/IBaseEnum.java
new file mode 100644
index 0000000..b647205
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/enums/base/IBaseEnum.java
@@ -0,0 +1,85 @@
+package tech.hypersense.common.core.enums.base;
+
+import cn.hutool.core.util.ObjectUtil;
+
+import java.util.EnumSet;
+import java.util.Objects;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 枚举通用接口
+ * @Version: 1.0
+ */
+public interface IBaseEnum{
+
+ T getValue();
+
+ String getLabel();
+
+ /**
+ * 根据值获取枚举
+ *
+ * @param value
+ * @param clazz
+ * @param 枚举
+ * @return
+ */
+ static & IBaseEnum> E getEnumByValue(Object value, Class clazz) {
+ Objects.requireNonNull(value);
+ EnumSet allEnums = EnumSet.allOf(clazz); // 获取类型下的所有枚举
+ E matchEnum = allEnums.stream()
+ .filter(e -> ObjectUtil.equal(e.getValue(), value))
+ .findFirst()
+ .orElse(null);
+ return matchEnum;
+ }
+
+ /**
+ * 根据文本标签获取值
+ *
+ * @param value
+ * @param clazz
+ * @param
+ * @return
+ */
+ static & IBaseEnum> String getLabelByValue(Object value, Class clazz) {
+ Objects.requireNonNull(value);
+ EnumSet allEnums = EnumSet.allOf(clazz); // 获取类型下的所有枚举
+ E matchEnum = allEnums.stream()
+ .filter(e -> ObjectUtil.equal(e.getValue(), value))
+ .findFirst()
+ .orElse(null);
+
+ String label = null;
+ if (matchEnum != null) {
+ label = matchEnum.getLabel();
+ }
+ return label;
+ }
+
+
+ /**
+ * 根据文本标签获取值
+ *
+ * @param label
+ * @param clazz
+ * @param
+ * @return
+ */
+ static & IBaseEnum> Object getValueByLabel(String label, Class clazz) {
+ Objects.requireNonNull(label);
+ EnumSet allEnums = EnumSet.allOf(clazz); // 获取类型下的所有枚举
+ String finalLabel = label;
+ E matchEnum = allEnums.stream()
+ .filter(e -> ObjectUtil.equal(e.getLabel(), finalLabel))
+ .findFirst()
+ .orElse(null);
+
+ Object value = null;
+ if (matchEnum != null) {
+ value = matchEnum.getValue();
+ }
+ return value;
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/exception/BusinessException.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/exception/BusinessException.java
new file mode 100644
index 0000000..511c268
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/exception/BusinessException.java
@@ -0,0 +1,46 @@
+package tech.hypersense.common.core.exception;
+
+import lombok.Getter;
+import org.slf4j.helpers.MessageFormatter;
+import tech.hypersense.common.core.domain.result.base.IResultCode;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 自定义业务异常
+ * @Version: 1.0
+ */
+@Getter
+public class BusinessException extends RuntimeException {
+
+ public IResultCode resultCode;
+
+ public BusinessException(IResultCode errorCode) {
+ super(errorCode.getMsg());
+ this.resultCode = errorCode;
+ }
+
+
+ public BusinessException(IResultCode errorCode,String message) {
+ super(message);
+ this.resultCode = errorCode;
+ }
+
+
+ public BusinessException(String message, Throwable cause) {
+ super(message, cause);
+ }
+
+ public BusinessException(Throwable cause) {
+ super(cause);
+ }
+
+ public BusinessException(String message, Object... args) {
+ super(formatMessage(message, args));
+ }
+
+ private static String formatMessage(String message, Object... args) {
+ return MessageFormatter.arrayFormat(message, args).getMessage();
+ }
+
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/exception/handler/GlobalExceptionHandler.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/exception/handler/GlobalExceptionHandler.java
new file mode 100644
index 0000000..4fdf631
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/exception/handler/GlobalExceptionHandler.java
@@ -0,0 +1,267 @@
+package tech.hypersense.common.core.exception.handler;
+
+import cn.hutool.core.util.StrUtil;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import jakarta.servlet.ServletException;
+import jakarta.validation.ConstraintViolation;
+import jakarta.validation.ConstraintViolationException;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.TypeMismatchException;
+import org.springframework.context.support.DefaultMessageSourceResolvable;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.converter.HttpMessageNotReadableException;
+import org.springframework.jdbc.BadSqlGrammarException;
+import org.springframework.security.access.AccessDeniedException;
+import org.springframework.security.core.AuthenticationException;
+import org.springframework.validation.BindException;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+import org.springframework.web.bind.MissingServletRequestParameterException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.ResponseStatus;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
+import org.springframework.web.servlet.NoHandlerFoundException;
+import tech.hypersense.common.core.domain.result.Result;
+import tech.hypersense.common.core.enums.ResultCode;
+import tech.hypersense.common.core.exception.BusinessException;
+
+import java.sql.SQLSyntaxErrorException;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description:
+ * @Version: 1.0
+ */
+@RestControllerAdvice
+@Slf4j
+public class GlobalExceptionHandler {
+
+
+ /**
+ * 处理绑定异常
+ *
+ * 当请求参数绑定到对象时发生错误，会抛出 BindException 异常。
+ */
+ @ExceptionHandler(BindException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result processException(BindException e) {
+ log.error("BindException:{}", e.getMessage());
+ String msg = e.getAllErrors().stream().map(DefaultMessageSourceResolvable::getDefaultMessage).collect(Collectors.joining("；"));
+ return Result.failed(ResultCode.USER_REQUEST_PARAMETER_ERROR, msg);
+ }
+
+ /**
+ * 处理 @RequestParam 参数校验异常
+ *
+ * 当请求参数在校验过程中发生违反约束条件的异常时（如 @RequestParam 验证不通过），
+ * 会捕获到 ConstraintViolationException 异常。
+ */
+ @ExceptionHandler(ConstraintViolationException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result processException(ConstraintViolationException e) {
+ log.error("ConstraintViolationException:{}", e.getMessage());
+ String msg = e.getConstraintViolations().stream().map(ConstraintViolation::getMessage).collect(Collectors.joining("；"));
+ return Result.failed(ResultCode.INVALID_USER_INPUT, msg);
+ }
+
+ /**
+ * 处理方法参数校验异常
+ *
+ * 当使用 @Valid 或 @Validated 注解对方法参数进行验证时，如果验证失败，
+ * 会抛出 MethodArgumentNotValidException 异常。
+ */
+ @ExceptionHandler(MethodArgumentNotValidException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result processException(MethodArgumentNotValidException e) {
+ log.error("MethodArgumentNotValidException:{}", e.getMessage());
+ String msg = e.getBindingResult().getAllErrors().stream().map(DefaultMessageSourceResolvable::getDefaultMessage).collect(Collectors.joining("；"));
+ return Result.failed(ResultCode.INVALID_USER_INPUT, msg);
+ }
+
+ /**
+ * 处理接口不存在的异常
+ *
+ * 当客户端请求一个不存在的路径时，会抛出 NoHandlerFoundException 异常。
+ */
+ @ExceptionHandler(NoHandlerFoundException.class)
+ @ResponseStatus(HttpStatus.NOT_FOUND)
+ public Result processException(NoHandlerFoundException e) {
+ log.error(e.getMessage(), e);
+ return Result.failed(ResultCode.INTERFACE_NOT_EXIST);
+ }
+
+ /**
+ * 处理缺少请求参数的异常
+ *
+ * 当请求缺少必需的参数时，会抛出 MissingServletRequestParameterException 异常。
+ */
+ @ExceptionHandler(MissingServletRequestParameterException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result processException(MissingServletRequestParameterException e) {
+ log.error(e.getMessage(), e);
+ return Result.failed(ResultCode.REQUEST_REQUIRED_PARAMETER_IS_EMPTY);
+ }
+
+ /**
+ * 处理方法参数类型不匹配的异常
+ *
+ * 当请求参数类型不匹配时，会抛出 MethodArgumentTypeMismatchException 异常。
+ */
+ @ExceptionHandler(MethodArgumentTypeMismatchException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result processException(MethodArgumentTypeMismatchException e) {
+ log.error(e.getMessage(), e);
+ return Result.failed(ResultCode.PARAMETER_FORMAT_MISMATCH, "类型错误");
+ }
+
+ /**
+ * 处理 Servlet 异常
+ *
+ * 当 Servlet 处理请求时发生异常时，会抛出 ServletException 异常。
+ */
+ @ExceptionHandler(ServletException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result processException(ServletException e) {
+ log.error(e.getMessage(), e);
+ return Result.failed(e.getMessage());
+ }
+
+ /**
+ * 处理非法参数异常
+ *
+ * 当方法接收到非法参数时，会抛出 IllegalArgumentException 异常。
+ */
+ @ExceptionHandler(IllegalArgumentException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result handleIllegalArgumentException(IllegalArgumentException e) {
+ log.error("非法参数异常，异常原因：{}", e.getMessage(), e);
+ return Result.failed(e.getMessage());
+ }
+
+ /**
+ * 处理 JSON 处理异常
+ *
+ * 当处理 JSON 数据时发生错误，会抛出 JsonProcessingException 异常。
+ */
+ @ExceptionHandler(JsonProcessingException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result handleJsonProcessingException(JsonProcessingException e) {
+ log.error("Json转换异常，异常原因：{}", e.getMessage(), e);
+ return Result.failed(e.getMessage());
+ }
+
+ /**
+ * 处理请求体不可读的异常
+ *
+ * 当请求体不可读时，会抛出 HttpMessageNotReadableException 异常。
+ */
+ @ExceptionHandler(HttpMessageNotReadableException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result processException(HttpMessageNotReadableException e) {
+ log.error(e.getMessage(), e);
+ String errorMessage = "请求体不可为空";
+ Throwable cause = e.getCause();
+ if (cause != null) {
+ errorMessage = convertMessage(cause);
+ }
+ return Result.failed(errorMessage);
+ }
+
+ /**
+ * 处理类型不匹配异常
+ *
+ * 当方法参数类型不匹配时，会抛出 TypeMismatchException 异常。
+ */
+ @ExceptionHandler(TypeMismatchException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result processException(TypeMismatchException e) {
+ log.error(e.getMessage(), e);
+ return Result.failed(e.getMessage());
+ }
+
+ /**
+ * 处理 SQL 语法错误异常
+ *
+ * 当 SQL 语法错误时，会抛出 BadSqlGrammarException 异常。
+ */
+ @ExceptionHandler(BadSqlGrammarException.class)
+ @ResponseStatus(HttpStatus.FORBIDDEN)
+ public Result handleBadSqlGrammarException(BadSqlGrammarException e) {
+ log.error(e.getMessage(), e);
+ String errorMsg = e.getMessage();
+ if (StrUtil.isNotBlank(errorMsg) && errorMsg.contains("denied to user")) {
+ return Result.failed(ResultCode.ACCESS_UNAUTHORIZED);
+ } else {
+ return Result.failed(e.getMessage());
+ }
+ }
+
+ /**
+ * 处理 SQL 语法错误异常
+ *
+ * 当 SQL 语法错误时，会抛出 SQLSyntaxErrorException 异常。
+ */
+ @ExceptionHandler(SQLSyntaxErrorException.class)
+ @ResponseStatus(HttpStatus.FORBIDDEN)
+ public Result processSQLSyntaxErrorException(SQLSyntaxErrorException e) {
+ log.error(e.getMessage(), e);
+ return Result.failed(e.getMessage());
+ }
+
+ /**
+ * 处理业务异常
+ *
+ * 当业务逻辑发生错误时，会抛出 BusinessException 异常。
+ */
+ @ExceptionHandler(BusinessException.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result handleBizException(BusinessException e) {
+ log.error("biz exception", e);
+ if (e.getResultCode() != null) {
+ return Result.failed(e.getResultCode(), e.getMessage());
+ }
+ return Result.failed(e.getMessage());
+ }
+
+ /**
+ * 处理所有未捕获的异常
+ *
+ * 当发生未捕获的异常时，会抛出 Exception 异常。
+ */
+ @ExceptionHandler(Exception.class)
+ @ResponseStatus(HttpStatus.BAD_REQUEST)
+ public Result handleException(Exception e) throws Exception {
+ // 将 Spring Security 异常继续抛出，以便交给自定义处理器处理
+ if (e instanceof AccessDeniedException
+ || e instanceof AuthenticationException) {
+ throw e;
+ }
+ log.error("unknown exception", e);
+ return Result.failed(e.getLocalizedMessage());
+ }
+
+ /**
+ * 传参类型错误时，用于消息转换
+ *
+ * @param throwable 异常
+ * @return 错误信息
+ */
+ private String convertMessage(Throwable throwable) {
+ String error = throwable.toString();
+ String regulation = "\\[\"(.*?)\"]+";
+ Pattern pattern = Pattern.compile(regulation);
+ Matcher matcher = pattern.matcher(error);
+ String group = "";
+ if (matcher.find()) {
+ String matchString = matcher.group();
+ matchString = matchString.replace("[", "").replace("]", "");
+ matchString = "%s字段类型错误".formatted(matchString.replaceAll("\"", ""));
+ group += matchString;
+ }
+ return group;
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/DateUtils.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/DateUtils.java
new file mode 100644
index 0000000..8cd1a00
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/DateUtils.java
@@ -0,0 +1,59 @@
+package tech.hypersense.common.core.utils;
+
+import cn.hutool.core.date.DateTime;
+import cn.hutool.core.date.DateUtil;
+import cn.hutool.core.util.ReflectUtil;
+import cn.hutool.core.util.StrUtil;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.lang.reflect.Field;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 日期工具类
+ * @Version: 1.0
+ */
+public class DateUtils {
+
+ /**
+ * 区间日期格式化为数据库日期格式
+ *
+ * @param obj 要处理的对象
+ * @param startTimeFieldName 起始时间字段名
+ * @param endTimeFieldName 结束时间字段名
+ */
+ public static void toDatabaseFormat(Object obj, String startTimeFieldName, String endTimeFieldName) {
+ Field startTimeField = ReflectUtil.getField(obj.getClass(), startTimeFieldName);
+ Field endTimeField = ReflectUtil.getField(obj.getClass(), endTimeFieldName);
+
+ if (startTimeField != null) {
+ processDateTimeField(obj, startTimeField, startTimeFieldName, "yyyy-MM-dd 00:00:00");
+ }
+
+ if (endTimeField != null) {
+ processDateTimeField(obj, endTimeField, endTimeFieldName, "yyyy-MM-dd 23:59:59");
+ }
+ }
+
+ /**
+ * 处理日期字段
+ *
+ * @param obj 要处理的对象
+ * @param field 字段
+ * @param fieldName 字段名
+ * @param targetPattern 目标数据库日期格式
+ */
+ private static void processDateTimeField(Object obj, Field field, String fieldName, String targetPattern) {
+ Object fieldValue = ReflectUtil.getFieldValue(obj, fieldName);
+ if (fieldValue != null) {
+ // 得到原始的日期格式
+ String pattern = field.isAnnotationPresent(DateTimeFormat.class) ? field.getAnnotation(DateTimeFormat.class).pattern() : "yyyy-MM-dd";
+ // 转换为日期对象
+ DateTime dateTime = DateUtil.parse(StrUtil.toString(fieldValue), pattern);
+ // 转换为目标数据库日期格式
+ ReflectUtil.setFieldValue(obj, fieldName, dateTime.toString(targetPattern));
+ }
+ }
+}
+
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/ExcelUtils.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/ExcelUtils.java
new file mode 100644
index 0000000..3470ab7
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/ExcelUtils.java
@@ -0,0 +1,19 @@
+package tech.hypersense.common.core.utils;
+
+import com.alibaba.excel.EasyExcel;
+import com.alibaba.excel.event.AnalysisEventListener;
+
+import java.io.InputStream;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: Excel 工具类
+ * @Version: 1.0
+ */
+public class ExcelUtils {
+
+ public static void importExcel(InputStream is, Class clazz, AnalysisEventListener listener) {
+ EasyExcel.read(is, clazz, listener).sheet().doRead();
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/IPUtils.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/IPUtils.java
new file mode 100644
index 0000000..61b5749
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/IPUtils.java
@@ -0,0 +1,138 @@
+package tech.hypersense.common.core.utils;
+
+import cn.hutool.core.util.StrUtil;
+import jakarta.annotation.PostConstruct;
+import jakarta.servlet.http.HttpServletRequest;
+import lombok.extern.slf4j.Slf4j;
+import org.lionsoul.ip2region.xdb.Searcher;
+import org.springframework.stereotype.Component;
+
+import java.io.FileNotFoundException;
+import java.io.InputStream;
+import java.net.InetAddress;
+import java.net.UnknownHostException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.StandardCopyOption;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: IP工具类
+ *
+ * 获取客户端IP地址和IP地址对应的地理位置信息
+ *
+ * 使用Nginx等反向代理软件， 则不能通过request.getRemoteAddr()获取IP地址
+ * 如果使用了多级反向代理的话，X-Forwarded-For的值并不止一个，而是一串IP地址，X-Forwarded-For中第一个非unknown的有效IP字符串，则为真实IP地址
+ * @Version: 1.0
+ */
+@Slf4j
+@Component
+public class IPUtils {
+
+ private static final String DB_PATH = "/data/ip2region.xdb";
+ private static Searcher searcher;
+
+ @PostConstruct
+ public void init() {
+ try {
+ // 从类路径加载资源文件
+ InputStream inputStream = getClass().getResourceAsStream(DB_PATH);
+ if (inputStream == null) {
+ throw new FileNotFoundException("Resource not found: " + DB_PATH);
+ }
+
+ // 将资源文件复制到临时文件
+ Path tempDbPath = Files.createTempFile("ip2region", ".xdb");
+ Files.copy(inputStream, tempDbPath, StandardCopyOption.REPLACE_EXISTING);
+
+ // 使用临时文件初始化 Searcher 对象
+ searcher = Searcher.newWithFileOnly(tempDbPath.toString());
+ } catch (Exception e) {
+ log.error("IpRegionUtil initialization ERROR, {}", e.getMessage());
+ }
+ }
+
+ /**
+ * 获取IP地址
+ *
+ * @param request HttpServletRequest对象
+ * @return 客户端IP地址
+ */
+ public static String getIpAddr(HttpServletRequest request) {
+ String ip = null;
+ try {
+ if (request == null) {
+ return "";
+ }
+ ip = request.getHeader("x-forwarded-for");
+ if (checkIp(ip)) {
+ ip = request.getHeader("Proxy-Client-IP");
+ }
+ if (checkIp(ip)) {
+ ip = request.getHeader("WL-Proxy-Client-IP");
+ }
+ if (checkIp(ip)) {
+ ip = request.getHeader("HTTP_CLIENT_IP");
+ }
+ if (checkIp(ip)) {
+ ip = request.getHeader("HTTP_X_FORWARDED_FOR");
+ }
+ if (checkIp(ip)) {
+ ip = request.getRemoteAddr();
+ if ("127.0.0.1".equals(ip) || "0:0:0:0:0:0:0:1".equals(ip)) {
+ // 根据网卡取本机配置的IP
+ ip = getLocalAddr();
+ }
+ }
+ } catch (Exception e) {
+ log.error("IPUtils ERROR, {}", e.getMessage());
+ }
+
+ // 使用代理，则获取第一个IP地址
+ if (StrUtil.isNotBlank(ip) && ip.indexOf(",") > 0) {
+ ip = ip.substring(0, ip.indexOf(","));
+ }
+
+ return ip;
+ }
+
+ private static boolean checkIp(String ip) {
+ String unknown = "unknown";
+ return StrUtil.isEmpty(ip) || unknown.equalsIgnoreCase(ip);
+ }
+
+ /**
+ * 获取本机的IP地址
+ *
+ * @return 本机IP地址
+ */
+ private static String getLocalAddr() {
+ try {
+ return InetAddress.getLocalHost().getHostAddress();
+ } catch (UnknownHostException e) {
+ log.error("InetAddress.getLocalHost()-error, {}", e.getMessage());
+ }
+ return null;
+ }
+
+ /**
+ * 根据IP地址获取地理位置信息
+ *
+ * @param ip IP地址
+ * @return 地理位置信息
+ */
+ public static String getRegion(String ip) {
+ if (searcher == null) {
+ log.error("Searcher is not initialized");
+ return null;
+ }
+
+ try {
+ return searcher.search(ip);
+ } catch (Exception e) {
+ log.error("IpRegionUtil ERROR, {}", e.getMessage());
+ return null;
+ }
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/ResponseUtils.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/ResponseUtils.java
new file mode 100644
index 0000000..30ceae7
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/utils/ResponseUtils.java
@@ -0,0 +1,80 @@
+package tech.hypersense.common.core.utils;
+
+import cn.hutool.json.JSONUtil;
+import jakarta.servlet.http.HttpServletResponse;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.MediaType;
+import tech.hypersense.common.core.domain.result.Result;
+import tech.hypersense.common.core.enums.ResultCode;
+
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.nio.charset.StandardCharsets;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 响应工具类
+ * @Version: 1.0
+ */
+@Slf4j
+public class ResponseUtils {
+ /**
+ * 异常消息返回(适用过滤器中处理异常响应)
+ *
+ * @param response HttpServletResponse
+ * @param resultCode 响应结果码
+ */
+ public static void writeErrMsg(HttpServletResponse response, ResultCode resultCode) {
+ int status = getHttpStatus(resultCode);
+
+ response.setStatus(status);
+ response.setContentType(MediaType.APPLICATION_JSON_VALUE);
+ response.setCharacterEncoding(StandardCharsets.UTF_8.name());
+
+ try (PrintWriter writer = response.getWriter()) {
+ String jsonResponse = JSONUtil.toJsonStr(Result.failed(resultCode));
+ writer.print(jsonResponse);
+ writer.flush(); // 确保将响应内容写入到输出流
+ } catch (IOException e) {
+ log.error("响应异常处理失败", e);
+ }
+ }
+
+ /**
+ * 异常消息返回(适用过滤器中处理异常响应)
+ *
+ * @param response HttpServletResponse
+ * @param resultCode 响应结果码
+ */
+ public static void writeErrMsg(HttpServletResponse response, ResultCode resultCode, String message) {
+ int status = getHttpStatus(resultCode);
+
+ response.setStatus(status);
+ response.setContentType(MediaType.APPLICATION_JSON_VALUE);
+ response.setCharacterEncoding(StandardCharsets.UTF_8.name());
+
+ try (PrintWriter writer = response.getWriter()) {
+ String jsonResponse = JSONUtil.toJsonStr(Result.failed(resultCode, message));
+ writer.print(jsonResponse);
+ writer.flush(); // 确保将响应内容写入到输出流
+ } catch (IOException e) {
+ log.error("响应异常处理失败", e);
+ }
+ }
+
+
+ /**
+ * 根据结果码获取HTTP状态码
+ *
+ * @param resultCode 结果码
+ * @return HTTP状态码
+ */
+ private static int getHttpStatus(ResultCode resultCode) {
+ return switch (resultCode) {
+ case ACCESS_UNAUTHORIZED, ACCESS_TOKEN_INVALID, REFRESH_TOKEN_INVALID -> HttpStatus.UNAUTHORIZED.value();
+ default -> HttpStatus.BAD_REQUEST.value();
+ };
+ }
+}
diff --git a/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/validator/FieldValidator.java b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/validator/FieldValidator.java
new file mode 100644
index 0000000..b450f71
--- /dev/null
+++ b/hypersense-common/hypersense-common-core/src/main/java/tech/hypersense/common/core/validator/FieldValidator.java
@@ -0,0 +1,34 @@
+package tech.hypersense.common.core.validator;
+
+import jakarta.validation.ConstraintValidator;
+import jakarta.validation.ConstraintValidatorContext;
+import tech.hypersense.common.core.annotation.ValidField;
+
+import java.util.Arrays;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 字段校验器
+ * @Version: 1.0
+ */
+public class FieldValidator implements ConstraintValidator {
+
+ private String[] allowedValues;
+
+ @Override
+ public void initialize(ValidField constraintAnnotation) {
+ // 初始化允许的值列表
+ this.allowedValues = constraintAnnotation.allowedValues();
+ }
+
+ @Override
+ public boolean isValid(String value, ConstraintValidatorContext context) {
+ if (value == null) {
+ return true; // 如果字段允许为空，可以返回 true
+ }
+ // 检查值是否在允许列表中
+ return Arrays.asList(allowedValues).contains(value);
+ }
+}
+
diff --git a/hypersense-common/hypersense-common-desensitize/pom.xml b/hypersense-common/hypersense-common-desensitize/pom.xml
new file mode 100644
index 0000000..648ae31
--- /dev/null
+++ b/hypersense-common/hypersense-common-desensitize/pom.xml
@@ -0,0 +1,18 @@
+
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-common
+ ${revision}
+
+
+ hypersense-common-desensitize
+
+
+ hypersense-common-desensitize 脱敏服务模块
+
+
+
\ No newline at end of file
diff --git a/hypersense-common/hypersense-common-ratelimiter/pom.xml b/hypersense-common/hypersense-common-ratelimiter/pom.xml
new file mode 100644
index 0000000..2fe8086
--- /dev/null
+++ b/hypersense-common/hypersense-common-ratelimiter/pom.xml
@@ -0,0 +1,13 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-common
+ ${revision}
+
+ hypersense-common-ratelimiter
+
+ hypersense-common-ratelimiter 限流服务模块
+
+
diff --git a/hypersense-common/hypersense-common-security/pom.xml b/hypersense-common/hypersense-common-security/pom.xml
new file mode 100644
index 0000000..5807a8a
--- /dev/null
+++ b/hypersense-common/hypersense-common-security/pom.xml
@@ -0,0 +1,13 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-common
+ ${revision}
+
+ hypersense-common-security
+
+ hypersense-common-security 安全服务模块
+
+
diff --git a/hypersense-common/hypersense-common-security/src/main/java/tech/hypersense/common/security/config/SecurityConfig.java b/hypersense-common/hypersense-common-security/src/main/java/tech/hypersense/common/security/config/SecurityConfig.java
new file mode 100644
index 0000000..0df599a
--- /dev/null
+++ b/hypersense-common/hypersense-common-security/src/main/java/tech/hypersense/common/security/config/SecurityConfig.java
@@ -0,0 +1,149 @@
+package tech.hypersense.common.security.config;
+
+import cn.binarywang.wx.miniapp.api.WxMaService;
+import cn.hutool.captcha.generator.CodeGenerator;
+import cn.hutool.core.util.ArrayUtil;
+import lombok.RequiredArgsConstructor;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.data.redis.core.RedisTemplate;
+import org.springframework.security.authentication.AuthenticationManager;
+import org.springframework.security.authentication.ProviderManager;
+import org.springframework.security.authentication.dao.DaoAuthenticationProvider;
+import org.springframework.security.config.annotation.method.configuration.EnableMethodSecurity;
+import org.springframework.security.config.annotation.web.builders.HttpSecurity;
+import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
+import org.springframework.security.config.annotation.web.configuration.WebSecurityCustomizer;
+import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer;
+import org.springframework.security.config.annotation.web.configurers.HeadersConfigurer;
+import org.springframework.security.config.http.SessionCreationPolicy;
+import org.springframework.security.crypto.password.PasswordEncoder;
+import org.springframework.security.web.SecurityFilterChain;
+import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
+
+/**
+ *
+ * Spring Security 配置类
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description:
+ * @Version: 1.0
+ */
+@Configuration
+@EnableWebSecurity
+@EnableMethodSecurity
+@RequiredArgsConstructor
+public class SecurityConfig {
+
+ private final RedisTemplate redisTemplate;
+ private final PasswordEncoder passwordEncoder;
+
+ private final TokenManager tokenManager;
+ private final WxMaService wxMaService;
+ private final UserService userService;
+ private final SysUserDetailsService userDetailsService;
+
+ private final CodeGenerator codeGenerator;
+ private final ConfigService configService;
+ private final SecurityProperties securityProperties;
+
+ /**
+ * 配置安全过滤链 SecurityFilterChain
+ */
+ @Bean
+ public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
+
+ return http
+ .authorizeHttpRequests(requestMatcherRegistry -> {
+ // 忽略认证的 URI 地址
+ String[] ignoreUrls = securityProperties.getIgnoreUrls();
+ if (ArrayUtil.isNotEmpty(ignoreUrls)) {
+ requestMatcherRegistry.requestMatchers(ignoreUrls).permitAll();
+ }
+ // 其他请求都需要认证
+ requestMatcherRegistry.anyRequest().authenticated();
+ }
+ )
+ .exceptionHandling(configurer ->
+ configurer
+ .authenticationEntryPoint(new MyAuthenticationEntryPoint()) // 未认证异常处理器
+ .accessDeniedHandler(new MyAccessDeniedHandler()) // 无权限访问异常处理器
+ )
+
+ // 禁用默认的 Spring Security 特性，适用于前后端分离架构
+ .sessionManagement(configurer ->
+ configurer.sessionCreationPolicy(SessionCreationPolicy.STATELESS) // 无状态认证，不使用 Session
+ )
+ .csrf(AbstractHttpConfigurer::disable) // 禁用 CSRF 防护，前后端分离无需此防护机制
+ .formLogin(AbstractHttpConfigurer::disable) // 禁用默认的表单登录功能，前后端分离采用 Token 认证方式
+ .httpBasic(AbstractHttpConfigurer::disable) // 禁用 HTTP Basic 认证，避免弹窗式登录
+ // 禁用 X-Frame-Options 响应头，允许页面被嵌套到 iframe 中
+ .headers(headers -> headers.frameOptions(HeadersConfigurer.FrameOptionsConfig::disable))
+ // 限流过滤器
+ .addFilterBefore(new RateLimiterFilter(redisTemplate, configService), UsernamePasswordAuthenticationFilter.class)
+ // 验证码校验过滤器
+ .addFilterBefore(new CaptchaValidationFilter(redisTemplate, codeGenerator), UsernamePasswordAuthenticationFilter.class)
+ // 验证和解析过滤器
+ .addFilterBefore(new TokenAuthenticationFilter(tokenManager), UsernamePasswordAuthenticationFilter.class)
+ .build();
+ }
+
+ /**
+ * 配置Web安全自定义器，以忽略特定请求路径的安全性检查。
+ *
+ * 该配置用于指定哪些请求路径不经过Spring Security过滤器链。通常用于静态资源文件。
+ */
+ @Bean
+ public WebSecurityCustomizer webSecurityCustomizer() {
+ return (web) -> {
+ String[] unsecuredUrls = securityProperties.getUnsecuredUrls();
+ if (ArrayUtil.isNotEmpty(unsecuredUrls)) {
+ web.ignoring().requestMatchers(unsecuredUrls);
+ }
+ };
+ }
+
+ /**
+ * 默认密码认证的 Provider
+ */
+ @Bean
+ public DaoAuthenticationProvider daoAuthenticationProvider() {
+ DaoAuthenticationProvider daoAuthenticationProvider = new DaoAuthenticationProvider();
+ daoAuthenticationProvider.setPasswordEncoder(passwordEncoder);
+ daoAuthenticationProvider.setUserDetailsService(userDetailsService);
+ return daoAuthenticationProvider;
+ }
+
+ /**
+ * 微信认证 Provider
+ */
+ @Bean
+ public WechatAuthenticationProvider weChatAuthenticationProvider() {
+ return new WechatAuthenticationProvider(userService, wxMaService);
+ }
+
+
+ /**
+ * 短信验证码认证 Provider
+ */
+ @Bean
+ public SmsAuthenticationProvider smsAuthenticationProvider() {
+ return new SmsAuthenticationProvider(userService, redisTemplate);
+ }
+
+ /**
+ * 认证管理器
+ */
+ @Bean
+ public AuthenticationManager authenticationManager(
+ DaoAuthenticationProvider daoAuthenticationProvider,
+ WechatAuthenticationProvider weChatAuthenticationProvider,
+ SmsAuthenticationProvider smsAuthenticationProvider
+ ) {
+ return new ProviderManager(
+ daoAuthenticationProvider,
+ weChatAuthenticationProvider,
+ smsAuthenticationProvider
+ );
+ }
+}
diff --git a/hypersense-common/hypersense-common-security/src/main/java/tech/hypersense/common/security/extension/sms/SmsAuthenticationProvider.java b/hypersense-common/hypersense-common-security/src/main/java/tech/hypersense/common/security/extension/sms/SmsAuthenticationProvider.java
new file mode 100644
index 0000000..b04ae12
--- /dev/null
+++ b/hypersense-common/hypersense-common-security/src/main/java/tech/hypersense/common/security/extension/sms/SmsAuthenticationProvider.java
@@ -0,0 +1,79 @@
+package tech.hypersense.common.security.extension.sms;
+
+import cn.hutool.core.util.ObjectUtil;
+import cn.hutool.core.util.StrUtil;
+import org.springframework.data.redis.core.RedisTemplate;
+import org.springframework.security.authentication.AuthenticationProvider;
+import org.springframework.security.authentication.DisabledException;
+import org.springframework.security.core.Authentication;
+import org.springframework.security.core.AuthenticationException;
+import org.springframework.security.core.userdetails.UsernameNotFoundException;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 短信验证码认证 Provider
+ * @Version: 1.0
+ */
+public class SmsAuthenticationProvider implements AuthenticationProvider {
+ private final UserService userService;
+
+ private final RedisTemplate redisTemplate;
+
+
+ public SmsAuthenticationProvider(UserService userService, RedisTemplate redisTemplate) {
+ this.userService = userService;
+ this.redisTemplate = redisTemplate;
+ }
+
+ /**
+ * 短信验证码认证逻辑，参考 Spring Security 认证密码校验流程
+ *
+ * @param authentication 认证对象
+ * @return 认证后的 Authentication 对象
+ * @throws AuthenticationException 认证异常
+ * @see org.springframework.security.authentication.dao.AbstractUserDetailsAuthenticationProvider#authenticate(Authentication)
+ */
+ @Override
+ public Authentication authenticate(Authentication authentication) throws AuthenticationException {
+ String mobile = (String) authentication.getPrincipal();
+ String inputVerifyCode = (String) authentication.getCredentials();
+
+ // 根据手机号获取用户信息
+ UserAuthInfo userAuthInfo = userService.getUserAuthInfoByMobile(mobile);
+
+ if (userAuthInfo == null) {
+ throw new UsernameNotFoundException("用户不存在");
+ }
+
+ // 检查用户状态是否有效
+ if (ObjectUtil.notEqual(userAuthInfo.getStatus(), 1)) {
+ throw new DisabledException("用户已被禁用");
+ }
+
+ // 校验发送短信验证码的手机号是否与当前登录用户一致
+ String cacheKey = StrUtil.format(RedisConstants.Captcha.SMS_LOGIN_CODE, mobile);
+ String cachedVerifyCode = (String) redisTemplate.opsForValue().get(cacheKey);
+
+ if (!StrUtil.equals(inputVerifyCode, cachedVerifyCode)) {
+ throw new CaptchaValidationException("验证码错误");
+ } else {
+ // 验证成功后删除验证码
+ redisTemplate.delete(cacheKey);
+ }
+
+ // 构建认证后的用户详情信息
+ SysUserDetails userDetails = new SysUserDetails(userAuthInfo);
+
+ // 创建已认证的 SmsAuthenticationToken
+ return SmsAuthenticationToken.authenticated(
+ userDetails,
+ userDetails.getAuthorities()
+ );
+ }
+
+ @Override
+ public boolean supports(Class authentication) {
+ return SmsAuthenticationToken.class.isAssignableFrom(authentication);
+ }
+}
diff --git a/hypersense-common/hypersense-common-tenant/pom.xml b/hypersense-common/hypersense-common-tenant/pom.xml
new file mode 100644
index 0000000..d2ccbff
--- /dev/null
+++ b/hypersense-common/hypersense-common-tenant/pom.xml
@@ -0,0 +1,13 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-common
+ ${revision}
+
+ hypersense-common-tenant
+
+ hypersense-common-tenant 租户服务模块
+
+
diff --git a/hypersense-common/hypersense-common-translation/pom.xml b/hypersense-common/hypersense-common-translation/pom.xml
new file mode 100644
index 0000000..fe11049
--- /dev/null
+++ b/hypersense-common/hypersense-common-translation/pom.xml
@@ -0,0 +1,13 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-common
+ ${revision}
+
+ hypersense-common-translation
+
+ hypersense-common-translation 翻译服务模块
+
+
diff --git a/hypersense-common/hypersense-common-web/pom.xml b/hypersense-common/hypersense-common-web/pom.xml
new file mode 100644
index 0000000..59f284d
--- /dev/null
+++ b/hypersense-common/hypersense-common-web/pom.xml
@@ -0,0 +1,14 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-common
+ ${revision}
+
+ hypersense-common-web
+
+ hypersense-common-web web服务模块
+
+
+
diff --git a/hypersense-common/hypersense-common-websocket/pom.xml b/hypersense-common/hypersense-common-websocket/pom.xml
new file mode 100644
index 0000000..d88912a
--- /dev/null
+++ b/hypersense-common/hypersense-common-websocket/pom.xml
@@ -0,0 +1,14 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-common
+ ${revision}
+
+ hypersense-common-websocket
+
+
+ hypersense-common-websocket websocket服务模块
+
+
diff --git a/hypersense-common/pom.xml b/hypersense-common/pom.xml
new file mode 100644
index 0000000..e16dd23
--- /dev/null
+++ b/hypersense-common/pom.xml
@@ -0,0 +1,26 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-template
+ ${revision}
+
+ hypersense-common
+ pom
+
+ hypersense-common-websocket
+ hypersense-common-web
+ hypersense-common-core
+ hypersense-common-security
+ hypersense-common-translation
+ hypersense-common-desensitize
+ hypersense-common-tenant
+ hypersense-common-ratelimiter
+ hypersense-common-bom
+
+
+
+ hypersense-common 内部公共服务模块
+
+
diff --git a/hypersense-modules/hypersense-system/pom.xml b/hypersense-modules/hypersense-system/pom.xml
new file mode 100644
index 0000000..67f9fb4
--- /dev/null
+++ b/hypersense-modules/hypersense-system/pom.xml
@@ -0,0 +1,18 @@
+
+ 4.0.0
+
+ tech.hypersense
+ hypersense-modules
+ ${revision}
+
+ hypersense-system
+
+
+ tech.hypersense
+ hypersense-common-core
+ 1.0.0
+ compile
+
+
+
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/DictCodeEnum.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/DictCodeEnum.java
new file mode 100644
index 0000000..012b8a2
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/DictCodeEnum.java
@@ -0,0 +1,27 @@
+package tech.hypersense.system.enums;
+
+import lombok.Getter;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 字典编码枚举
+ * @Version: 1.0
+ */
+@Getter
+public enum DictCodeEnum implements IBaseEnum {
+
+ GENDER("gender", "性别"),
+ NOTICE_TYPE("notice_type", "通知类型"),
+ NOTICE_LEVEL("notice_level", "通知级别");
+
+ private final String value;
+
+ private final String label;
+
+ DictCodeEnum(String value, String label) {
+ this.value = value;
+ this.label = label;
+ }
+
+}
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/MenuTypeEnum.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/MenuTypeEnum.java
new file mode 100644
index 0000000..2c029b6
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/MenuTypeEnum.java
@@ -0,0 +1,33 @@
+package tech.hypersense.system.enums;
+
+import com.baomidou.mybatisplus.annotation.EnumValue;
+import lombok.Getter;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 菜单类型枚举
+ * @Version: 1.0
+ */
+@Getter
+public enum MenuTypeEnum implements IBaseEnum {
+
+ NULL(0, null),
+ MENU(1, "菜单"),
+ CATALOG(2, "目录"),
+ EXTLINK(3, "外链"),
+ BUTTON(4, "按钮");
+
+ // Mybatis-Plus 提供注解表示插入数据库时插入该值
+ @EnumValue
+ private final Integer value;
+
+ // @JsonValue // 表示对枚举序列化时返回此字段
+ private final String label;
+
+ MenuTypeEnum(Integer value, String label) {
+ this.value = value;
+ this.label = label;
+ }
+
+}
\ No newline at end of file
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/NoticePublishStatusEnum.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/NoticePublishStatusEnum.java
new file mode 100644
index 0000000..b25f2ad
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/NoticePublishStatusEnum.java
@@ -0,0 +1,30 @@
+package tech.hypersense.system.enums;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+import tech.hypersense.common.core.enums.base.IBaseEnum;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 通告发布状态枚举
+ * @Version: 1.0
+ */
+@Getter
+@Schema(enumAsRef = true)
+public enum NoticePublishStatusEnum implements IBaseEnum {
+
+ UNPUBLISHED(0, "未发布"),
+ PUBLISHED(1, "已发布"),
+ REVOKED(-1, "已撤回");
+
+
+ private final Integer value;
+
+ private final String label;
+
+ NoticePublishStatusEnum(Integer value, String label) {
+ this.value = value;
+ this.label = label;
+ }
+}
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/NoticeTargetEnum.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/NoticeTargetEnum.java
new file mode 100644
index 0000000..a190d91
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/enums/NoticeTargetEnum.java
@@ -0,0 +1,29 @@
+package tech.hypersense.system.enums;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+import tech.hypersense.common.core.enums.base.IBaseEnum;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 通知目标类型枚举
+ * @Version: 1.0
+ */
+@Getter
+@Schema(enumAsRef = true)
+public enum NoticeTargetEnum implements IBaseEnum {
+
+ ALL(1, "全体"),
+ SPECIFIED(2, "指定");
+
+
+ private final Integer value;
+
+ private final String label;
+
+ NoticeTargetEnum(Integer value, String label) {
+ this.value = value;
+ this.label = label;
+ }
+}
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/event/UserConnectionEvent.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/event/UserConnectionEvent.java
new file mode 100644
index 0000000..71a91c0
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/event/UserConnectionEvent.java
@@ -0,0 +1,37 @@
+package tech.hypersense.system.event;
+
+import lombok.Getter;
+import org.springframework.context.ApplicationEvent;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 用户连接事件
+ * @Version: 1.0
+ */
+@Getter
+public class UserConnectionEvent extends ApplicationEvent {
+
+ /**
+ * 用户名
+ */
+ private final String username;
+
+ /**
+ * 是否连接
+ */
+ private final boolean connected;
+
+ /**
+ * 用户连接事件
+ *
+ * @param source 事件源
+ * @param username 用户名
+ * @param connected 是否连接
+ */
+ public UserConnectionEvent(Object source, String username, boolean connected) {
+ super(source);
+ this.username = username;
+ this.connected = connected;
+ }
+}
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/listener/UserImportListener.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/listener/UserImportListener.java
new file mode 100644
index 0000000..a7e761c
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/listener/UserImportListener.java
@@ -0,0 +1,13 @@
+package tech.hypersense.system.listener;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 用户导入监听器
+ *
+ * 最简单的读的监听器
+ *
+ * @Version: 1.0
+ */
+public class UserImportListener {
+}
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/ConfigMapper.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/ConfigMapper.java
new file mode 100644
index 0000000..7df1ad0
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/ConfigMapper.java
@@ -0,0 +1,16 @@
+package tech.hypersense.system.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+import tech.hypersense.system.model.entity.Config;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description:
+ * @Version: 1.0
+ */
+@Mapper
+public interface ConfigMapper extends BaseMapper {
+
+}
\ No newline at end of file
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DeptMapper.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DeptMapper.java
new file mode 100644
index 0000000..8f70da6
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DeptMapper.java
@@ -0,0 +1,25 @@
+package tech.hypersense.system.mapper;
+
+import com.baomidou.mybatisplus.core.conditions.Wrapper;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baomidou.mybatisplus.core.toolkit.Constants;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+import tech.hypersense.common.core.annotation.DataPermission;
+import tech.hypersense.system.model.entity.Dept;
+
+import java.util.List;
+
+/**
+*@Author: HyperSense
+*@CreateTime: 2025-03-25
+*@Description:
+*@Version: 1.0
+*/
+@Mapper
+public interface DeptMapper extends BaseMapper {
+
+ @DataPermission(deptIdColumnName = "id")
+ @Override
+ List selectList(@Param(Constants.WRAPPER) Wrapper queryWrapper);
+}
\ No newline at end of file
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DictDataMapper.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DictDataMapper.java
new file mode 100644
index 0000000..b950616
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DictDataMapper.java
@@ -0,0 +1,24 @@
+package tech.hypersense.system.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import org.apache.ibatis.annotations.Mapper;
+import tech.hypersense.system.model.entity.DictData;
+import tech.hypersense.system.model.query.DictDataPageQuery;
+import tech.hypersense.system.model.vo.DictDataPageVO;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 字典数据映射层
+ * @Version: 1.0
+ */
+@Mapper
+public interface DictDataMapper extends BaseMapper {
+
+ /**
+ * 字典数据分页列表
+ */
+ Page getDictDataPage(Page page, DictDataPageQuery queryParams);
+}
+
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DictMapper.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DictMapper.java
new file mode 100644
index 0000000..c726a6d
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/DictMapper.java
@@ -0,0 +1,36 @@
+package tech.hypersense.system.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import tech.hypersense.system.model.entity.Dict;
+import tech.hypersense.system.model.query.DictPageQuery;
+import tech.hypersense.system.model.vo.DictPageVO;
+import tech.hypersense.system.model.vo.DictVO;
+
+import java.util.List;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 字典 访问层
+ * @Version: 1.0
+ */
+public interface DictMapper extends BaseMapper {
+
+ /**
+ * 字典分页列表
+ *
+ * @param page 分页参数
+ * @param queryParams 查询参数
+ * @return 字典分页列表
+ */
+ Page getDictPage(Page page, DictPageQuery queryParams);
+
+ /**
+ * 获取字典列表（包含字典数据）
+ *
+ * @return 字典列表
+ */
+ List getAllDictWithData();
+
+}
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/LogMapper.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/LogMapper.java
new file mode 100644
index 0000000..e9df3f2
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/LogMapper.java
@@ -0,0 +1,54 @@
+package tech.hypersense.system.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import org.apache.ibatis.annotations.Mapper;
+import tech.hypersense.system.model.bo.VisitCount;
+import tech.hypersense.system.model.bo.VisitStatsBO;
+import tech.hypersense.system.model.entity.Log;
+import tech.hypersense.system.model.query.LogPageQuery;
+import tech.hypersense.system.model.vo.LogPageVO;
+
+import java.util.List;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description:
+ * @Version: 1.0
+ */
+@Mapper
+public interface LogMapper extends BaseMapper {
+
+ /**
+ * 获取日志分页列表
+ */
+ Page getLogPage(Page page, LogPageQuery queryParams);
+
+ /**
+ * 统计浏览数(PV)
+ *
+ * @param startDate 开始日期 yyyy-MM-dd
+ * @param endDate 结束日期 yyyy-MM-dd
+ */
+ List getPvCounts(String startDate, String endDate);
+
+ /**
+ * 统计IP数
+ *
+ * @param startDate 开始日期 yyyy-MM-dd
+ * @param endDate 结束日期 yyyy-MM-dd
+ */
+ List getIpCounts(String startDate, String endDate);
+
+ /**
+ * 获取浏览量(PV)统计
+ */
+ VisitStatsBO getPvStats();
+
+ /**
+ * 获取访问IP统计
+ */
+ VisitStatsBO getUvStats();
+}
+
diff --git a/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/MenuMapper.java b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/MenuMapper.java
new file mode 100644
index 0000000..2a79f21
--- /dev/null
+++ b/hypersense-modules/hypersense-system/src/main/java/tech/hypersense/system/mapper/MenuMapper.java
@@ -0,0 +1,26 @@
+package tech.hypersense.system.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+import tech.hypersense.system.model.entity.Menu;
+
+import java.util.List;
+import java.util.Set;
+
+/**
+ * @Author: HyperSense
+ * @CreateTime: 2025-03-25
+ * @Description: 菜单访问层
+ * @Version: 1.0
+ */
+@Mapper
+public interface MenuMapper extends BaseMapper