# aaa **Repository Path**: yydf1234/aaa ## Basic Information - **Project Name**: aaa - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-10 - **Last Updated**: 2026-07-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 介绍 {**以下是 Gitee 平台说明，您可以替换此简介** Gitee 是 OSCHINA 推出的基于 Git 的代码托管平台（同时支持 SVN）。专为开发者提供稳定、高效、安全的云端软件开发协作平台 无论是个人、团队、或是企业，都能够用 Gitee 实现代码托管、项目管理、协作开发。企业项目请看 [https://gitee.com/enterprises](https://gitee.com/enterprises)} # 软件架构 ## 单模块内部标准分层 ``` xxx模块 ├─constant 枚举、常量 ├─controller 接口入口 ├─dao Mapper接口 ├─domain 数据模型分层 │ ├─entity 数据库映射实体 │ ├─form 前端请求入参（新增/修改/查询） │ ├─dto 内部服务传输对象 │ └─vo 返回前端视图对象 ├─manager 缓存、复杂数据组装管理器 └─service 业务逻辑层 ``` ## 整体目录结构 ``` /aaa/ ├── .gitignore # Git 版本控制忽略文件配置，定义哪些文件/目录不被提交 ├── pom.xml # Maven 父级 POM 配置文件，定义公共依赖、插件、模块管理 ├── README.en.md # 英文版项目说明文档 ├── README.md # 中文版项目说明文档 │ ├── .idea/ # IntelliJ IDEA 项目配置目录（IDE 本地配置，不提交至仓库） │ ├── .gitignore # IDEA 本地忽略配置 │ ├── compiler.xml # IDEA 编译器配置（Java 编译版本等） │ ├── encodings.xml # IDEA 编码配置（项目字符集） │ ├── jarRepositories.xml # IDEA Maven 仓库源配置 │ ├── misc.xml # IDEA 杂项配置（组件、插件等） │ ├── vcs.xml # IDEA 版本控制系统配置（Git 关联） │ └── workspace.xml # IDEA 工作区配置（窗口布局、运行配置等） │ ├── sa-admin/ # 管理后台 Web 应用模块（Spring Boot 启动入口） │ ├── pom.xml # sa-admin 模块 Maven 配置文件 │ │ │ └── src/ # 源代码目录 │ ├── main/ # 主代码目录 │ │ ├── java/ # Java 源码根目录 │ │ │ └── net/ # 顶级包路径 │ │ │ └── lab1024/ # 组织/公司包名 │ │ │ └── sa/ # 项目核心包 │ │ │ └── admin/ # 管理后台包 │ │ │ ├── AdminApplication.java # Spring Boot 应用启动入口类 │ │ │ │ │ │ │ ├── config/ # 配置类目录 │ │ │ │ ├── MvcConfig.java # Spring MVC 配置（拦截器、跨域、视图解析等） │ │ │ │ └── OperateLogAspectConfig.java # 操作日志 AOP 切面配置 │ │ │ │ │ │ │ ├── constant/ # 常量定义目录 │ │ │ │ ├── AdminCacheConst.java # 后台缓存常量（缓存名称、过期时间等） │ │ │ │ ├── AdminRedisKeyConst.java # 后台 Redis Key 常量定义 │ │ │ │ └── AdminSwaggerTagConst.java # Swagger API 文档标签常量 │ │ │ │ │ │ │ ├── interceptor/ # 拦截器目录 │ │ │ │ └── AdminInterceptor.java # 管理员权限拦截器（登录校验、权限验证） │ │ │ │ │ │ │ ├── module/ # 业务模块根目录 │ │ │ │ ├── business/ # 业务模块（核心业务功能） │ │ │ │ │ ├── category/ # 分类管理模块 │ │ │ │ │ │ ├── constant/ # 分类模块常量 │ │ │ │ │ │ │ └── CategoryTypeEnum.java # 分类类型枚举 │ │ │ │ │ │ ├── controller/ # 分类控制器层 │ │ │ │ │ │ │ └── CategoryController.java # 分类 REST API 接口 │ │ │ │ │ │ ├── dao/ # 分类数据访问层 │ │ │ │ │ │ │ └── CategoryDao.java # 分类 Mapper 接口 │ │ │ │ │ │ ├── domain/ # 领域对象目录 │ │ │ │ │ │ │ ├── dto/ # 数据传输对象 │ │ │ │ │ │ │ │ ├── CategoryBaseDTO.java # 分类基础 DTO │ │ │ │ │ │ │ │ └── CategorySimpleDTO.java # 分类简明 DTO │ │ │ │ │ │ │ ├── entity/ # 实体类 │ │ │ │ │ │ │ │ └── CategoryEntity.java # 分类实体 │ │ │ │ │ │ │ ├── form/ # 表单对象（接收前端参数） │ │ │ │ │ │ │ │ ├── CategoryAddForm.java # 新增分类表单 │ │ │ │ │ │ │ │ ├── CategoryTreeQueryForm.java # 分类树查询表单 │ │ │ │ │ │ │ │ └── CategoryUpdateForm.java # 更新分类表单 │ │ │ │ │ │ │ └── vo/ # 视图对象（返回前端数据） │ │ │ │ │ │ │ ├── CategoryTreeVO.java # 分类树视图对象 │ │ │ │ │ │ │ └── CategoryVO.java # 分类视图对象 │ │ │ │ │ │ ├── manager/ # 业务管理层（缓存、复杂逻辑） │ │ │ │ │ │ │ └── CategoryCacheManager.java # 分类缓存管理器 │ │ │ │ │ │ └── service/ # 服务层 │ │ │ │ │ │ ├── CategoryQueryService.java # 分类查询服务接口 │ │ │ │ │ │ └── CategoryService.java # 分类服务接口 │ │ │ │ │ │ │ │ │ │ │ ├── goods/ # 商品管理模块 │ │ │ │ │ │ ├── constant/ # 商品模块常量 │ │ │ │ │ │ │ └── GoodsStatusEnum.java # 商品状态枚举 │ │ │ │ │ │ ├── controller/ # 商品控制器层 │ │ │ │ │ │ │ └── GoodsController.java # 商品 REST API 接口 │ │ │ │ │ │ ├── dao/ # 商品数据访问层 │ │ │ │ │ │ │ └── GoodsDao.java # 商品 Mapper 接口 │ │ │ │ │ │ ├── domain/ # 领域对象目录 │ │ │ │ │ │ │ ├── entity/ # 实体类 │ │ │ │ │ │ │ │ └── GoodsEntity.java # 商品实体 │ │ │ │ │ │ │ ├── form/ # 表单对象 │ │ │ │ │ │ │ │ ├── GoodsAddForm.java # 新增商品表单 │ │ │ │ │ │ │ │ ├── GoodsImportForm.java # 商品导入表单 │ │ │ │ │ │ │ │ ├── GoodsQueryForm.java # 商品查询表单 │ │ │ │ │ │ │ │ └── GoodsUpdateForm.java # 更新商品表单 │ │ │ │ │ │ │ └── vo/ # 视图对象 │ │ │ │ │ │ │ ├── GoodsExcelVO.java # 商品 Excel 导出 VO │ │ │ │ │ │ │ └── GoodsVO.java # 商品视图对象 │ │ │ │ │ │ └── service/ # 服务层 │ │ │ │ │ │ └── GoodsService.java # 商品服务接口 │ │ │ │ │ │ │ │ │ │ │ └── oa/ # OA 办公模块 │ │ │ │ │ ├── bank/ # 银行管理子模块 │ │ │ │ │ │ ├── controller/ # 银行控制器 │ │ │ │ │ │ │ └── BankController.java # 银行 REST API │ │ │ │ │ │ ├── dao/ # 银行数据访问层 │ │ │ │ │ │ │ └── BankDao.java # 银行 Mapper │ │ │ │ │ │ ├── domain/ # 银行领域对象 │ │ │ │ │ │ │ ├── BankCreateForm.java # 创建银行表单 │ │ │ │ │ │ │ ├── BankEntity.java # 银行实体 │ │ │ │ │ │ │ ├── BankQueryForm.java # 银行查询表单 │ │ │ │ │ │ │ ├── BankUpdateForm.java # 更新银行表单 │ │ │ │ │ │ │ └── BankVO.java # 银行视图对象 │ │ │ │ │ │ └── service/ # 银行服务层 │ │ │ │ │ │ └── BankService.java # 银行服务接口 │ │ │ │ │ │ │ │ │ │ │ ├── enterprise/ # 企业管理子模块 │ │ │ │ │ │ ├── constant/ # 企业常量 │ │ │ │ │ │ │ └── EnterpriseTypeEnum.java # 企业类型枚举 │ │ │ │ │ │ ├── controller/ # 企业控制器 │ │ │ │ │ │ │ └── EnterpriseController.java # 企业 REST API │ │ │ │ │ │ ├── dao/ # 企业数据访问层 │ │ │ │ │ │ │ ├── EnterpriseDao.java # 企业 Mapper │ │ │ │ │ │ │ └── EnterpriseEmployeeDao.java # 企业员工关联 Mapper │ │ │ │ │ │ ├── domain/ # 企业领域对象 │ │ │ │ │ │ │ ├── entity/ # 企业实体 │ │ │ │ │ │ │ │ ├── EnterpriseEmployeeEntity.java # 企业员工关联实体 │ │ │ │ │ │ │ │ └── EnterpriseEntity.java # 企业实体 │ │ │ │ │ │ │ ├── form/ # 企业表单 │ │ │ │ │ │ │ │ ├── EnterpriseCreateForm.java # 创建企业表单 │ │ │ │ │ │ │ │ ├── EnterpriseEmployeeForm.java # 企业员工表单 │ │ │ │ │ │ │ │ ├── EnterpriseEmployeeQueryForm.java # 企业员工查询表单 │ │ │ │ │ │ │ │ ├── EnterpriseQueryForm.java # 企业查询表单 │ │ │ │ │ │ │ │ └── EnterpriseUpdateForm.java # 更新企业表单 │ │ │ │ │ │ │ └── vo/ # 企业视图对象 │ │ │ │ │ │ │ ├── EnterpriseEmployeeVO.java # 企业员工 VO │ │ │ │ │ │ │ ├── EnterpriseExcelVO.java # 企业 Excel VO │ │ │ │ │ │ │ ├── EnterpriseListVO.java # 企业列表 VO │ │ │ │ │ │ │ └── EnterpriseVO.java # 企业 VO │ │ │ │ │ │ ├── manager/ # 企业业务管理层 │ │ │ │ │ │ │ └── EnterpriseEmployeeManager.java # 企业员工管理器 │ │ │ │ │ │ └── service/ # 企业服务层 │ │ │ │ │ │ └── EnterpriseService.java # 企业服务接口 │ │ │ │ │ │ │ │ │ │ │ ├── invoice/ # 发票管理子模块 │ │ │ │ │ │ ├── controller/ # 发票控制器 │ │ │ │ │ │ │ └── InvoiceController.java # 发票 REST API │ │ │ │ │ │ ├── dao/ # 发票数据访问层 │ │ │ │ │ │ │ └── InvoiceDao.java # 发票 Mapper │ │ │ │ │ │ ├── domain/ # 发票领域对象 │ │ │ │ │ │ │ ├── InvoiceAddForm.java # 新增发票表单 │ │ │ │ │ │ │ ├── InvoiceEntity.java # 发票实体 │ │ │ │ │ │ │ ├── InvoiceQueryForm.java # 发票查询表单 │ │ │ │ │ │ │ ├── InvoiceUpdateForm.java # 更新发票表单 │ │ │ │ │ │ │ └── InvoiceVO.java # 发票视图对象 │ │ │ │ │ │ └── service/ # 发票服务层 │ │ │ │ │ │ └── InvoiceService.java # 发票服务接口 │ │ │ │ │ │ │ │ │ │ │ └── notice/ # 通知公告子模块 │ │ │ │ │ ├── constant/ # 通知常量 │ │ │ │ │ │ └── NoticeVisibleRangeDataTypeEnum.java # 通知可见范围数据类型枚举 │ │ │ │ │ ├── controller/ # 通知控制器 │ │ │ │ │ │ └── NoticeController.java # 通知 REST API │ │ │ │ │ ├── dao/ # 通知数据访问层 │ │ │ │ │ │ ├── NoticeDao.java # 通知 Mapper │ │ │ │ │ │ └── NoticeTypeDao.java # 通知类型 Mapper │ │ │ │ │ ├── domain/ # 通知领域对象 │ │ │ │ │ │ ├── entity/ # 通知实体 │ │ │ │ │ │ │ ├── NoticeEntity.java # 通知实体 │ │ │ │ │ │ │ └── NoticeTypeEntity.java # 通知类型实体 │ │ │ │ │ │ ├── form/ # 通知表单 │ │ │ │ │ │ │ ├── NoticeAddForm.java # 新增通知表单 │ │ │ │ │ │ │ ├── NoticeEmployeeQueryForm.java # 通知员工查询表单 │ │ │ │ │ │ │ ├── NoticeQueryForm.java # 通知查询表单 │ │ │ │ │ │ │ ├── NoticeUpdateForm.java # 更新通知表单 │ │ │ │ │ │ │ ├── NoticeViewRecordQueryForm.java # 通知查看记录查询表单 │ │ │ │ │ │ │ └── NoticeVisibleRangeForm.java # 通知可见范围表单 │ │ │ │ │ │ └── vo/ # 通知视图对象 │ │ │ │ │ │ ├── NoticeDetailVO.java # 通知详情 VO │ │ │ │ │ │ ├── NoticeEmployeeVO.java # 通知员工 VO │ │ │ │ │ │ ├── NoticeTypeVO.java # 通知类型 VO │ │ │ │ │ │ ├── NoticeUpdateFormVO.java # 通知更新表单 VO │ │ │ │ │ │ ├── NoticeViewRecordVO.java # 通知查看记录 VO │ │ │ │ │ │ ├── NoticeVisibleRangeVO.java # 通知可见范围 VO │ │ │ │ │ │ └── NoticeVO.java # 通知 VO │ │ │ │ │ ├── manager/ # 通知业务管理层 │ │ │ │ │ │ └── NoticeManager.java # 通知管理器 │ │ │ │ │ └── service/ # 通知服务层 │ │ │ │ │ ├── NoticeEmployeeService.java # 通知员工服务 │ │ │ │ │ ├── NoticeService.java # 通知服务 │ │ │ │ │ └── NoticeTypeService.java # 通知类型服务 │ │ │ │ │ │ │ │ │ └── system/ # 系统管理模块 │ │ │ │ ├── datascope/ # 数据权限模块 │ │ │ │ │ ├── DataScope.java # 数据权限注解 │ │ │ │ │ ├── DataScopeController.java # 数据权限 REST API │ │ │ │ │ ├── MyBatisPlugin.java # MyBatis 数据权限插件 │ │ │ │ │ ├── constant/ # 数据权限常量 │ │ │ │ │ │ ├── DataScopeTypeEnum.java # 数据权限类型枚举 │ │ │ │ │ │ ├── DataScopeViewTypeEnum.java # 数据权限视图类型枚举 │ │ │ │ │ │ └── DataScopeWhereInTypeEnum.java # 数据权限 IN 类型枚举 │ │ │ │ │ ├── domain/ # 数据权限领域对象 │ │ │ │ │ │ ├── DataScopeAndViewTypeVO.java # 数据权限与视图类型 VO │ │ │ │ │ │ ├── DataScopeDTO.java # 数据权限 DTO │ │ │ │ │ │ ├── DataScopeSqlConfig.java # 数据权限 SQL 配置 │ │ │ │ │ │ └── DataScopeViewTypeVO.java # 数据权限视图类型 VO │ │ │ │ │ ├── service/ # 数据权限服务层 │ │ │ │ │ │ ├── DataScopeService.java # 数据权限服务 │ │ │ │ │ │ ├── DataScopeSqlConfigService.java # 数据权限 SQL 配置服务 │ │ │ │ │ │ └── DataScopeViewService.java # 数据权限视图服务 │ │ │ │ │ └── strategy/ # 数据权限策略 │ │ │ │ │ └── AbstractDataScopeStrategy.java # 数据权限抽象策略 │ │ │ │ │ │ │ │ │ ├── department/ # 部门管理模块 │ │ │ │ │ ├── controller/ # 部门控制器 │ │ │ │ │ │ └── DepartmentController.java # 部门 REST API │ │ │ │ │ ├── dao/ # 部门数据访问层 │ │ │ │ │ │ └── DepartmentDao.java # 部门 Mapper │ │ │ │ │ ├── domain/ # 部门领域对象 │ │ │ │ │ │ ├── entity/ # 部门实体 │ │ │ │ │ │ │ └── DepartmentEntity.java # 部门实体 │ │ │ │ │ │ ├── form/ # 部门表单 │ │ │ │ │ │ │ ├── DepartmentAddForm.java # 新增部门表单 │ │ │ │ │ │ │ └── DepartmentUpdateForm.java # 更新部门表单 │ │ │ │ │ │ └── vo/ # 部门视图对象 │ │ │ │ │ │ ├── DepartmentEmployeeTreeVO.java # 部门员工树 VO │ │ │ │ │ │ ├── DepartmentTreeVO.java # 部门树 VO │ │ │ │ │ │ └── DepartmentVO.java # 部门 VO │ │ │ │ │ ├── manager/ # 部门业务管理层 │ │ │ │ │ │ └── DepartmentCacheManager.java # 部门缓存管理器 │ │ │ │ │ └── service/ # 部门服务层 │ │ │ │ │ └── DepartmentService.java # 部门服务接口 │ │ │ │ │ │ │ │ │ ├── employee/ # 员工管理模块 │ │ │ │ │ ├── controller/ # 员工控制器 │ │ │ │ │ │ └── EmployeeController.java # 员工 REST API │ │ │ │ │ ├── dao/ # 员工数据访问层 │ │ │ │ │ │ └── EmployeeDao.java # 员工 Mapper │ │ │ │ │ ├── domain/ # 员工领域对象 │ │ │ │ │ │ ├── entity/ # 员工实体 │ │ │ │ │ │ │ └── EmployeeEntity.java # 员工实体 │ │ │ │ │ │ ├── form/ # 员工表单 │ │ │ │ │ │ │ ├── EmployeeAddForm.java # 新增员工表单 │ │ │ │ │ │ │ ├── EmployeeBatchUpdateDepartmentForm.java # 批量更新部门表单 │ │ │ │ │ │ │ ├── EmployeeQueryForm.java # 员工查询表单 │ │ │ │ │ │ │ ├── EmployeeUpdateAvatarForm.java # 更新头像表单 │ │ │ │ │ │ │ ├── EmployeeUpdateCenterForm.java # 更新个人中心表单 │ │ │ │ │ │ │ ├── EmployeeUpdateForm.java # 更新员工表单 │ │ │ │ │ │ │ ├── EmployeeUpdatePasswordForm.java # 更新密码表单 │ │ │ │ │ │ │ └── EmployeeUpdateRoleForm.java # 更新角色表单 │ │ │ │ │ │ └── vo/ # 员工视图对象 │ │ │ │ │ │ └── EmployeeVO.java # 员工 VO │ │ │ │ │ ├── manager/ # 员工业务管理层 │ │ │ │ │ │ └── EmployeeManager.java # 员工管理器 │ │ │ │ │ └── service/ # 员工服务层 │ │ │ │ │ └── EmployeeService.java # 员工服务接口 │ │ │ │ │ │ │ │ │ ├── login/ # 登录认证模块 │ │ │ │ │ ├── controller/ # 登录控制器 │ │ │ │ │ │ └── LoginController.java # 登录 REST API │ │ │ │ │ ├── domain/ # 登录领域对象 │ │ │ │ │ │ ├── LoginForm.java # 登录表单 │ │ │ │ │ │ ├── LoginResultVO.java # 登录结果 VO │ │ │ │ │ │ └── RequestEmployee.java # 请求上下文员工信息 │ │ │ │ │ ├── manager/ # 登录业务管理层 │ │ │ │ │ │ └── LoginManager.java # 登录管理器 │ │ │ │ │ └── service/ # 登录服务层 │ │ │ │ │ └── LoginService.java # 登录服务接口 │ │ │ │ │ │ │ │ │ ├── menu/ # 菜单管理模块 │ │ │ │ │ ├── constant/ # 菜单常量 │ │ │ │ │ │ ├── MenuPermsTypeEnum.java # 菜单权限类型枚举 │ │ │ │ │ │ └── MenuTypeEnum.java # 菜单类型枚举 │ │ │ │ │ ├── controller/ # 菜单控制器 │ │ │ │ │ │ └── MenuController.java # 菜单 REST API │ │ │ │ │ ├── dao/ # 菜单数据访问层 │ │ │ │ │ │ └── MenuDao.java # 菜单 Mapper │ │ │ │ │ ├── domain/ # 菜单领域对象 │ │ │ │ │ │ ├── entity/ # 菜单实体 │ │ │ │ │ │ │ └── MenuEntity.java # 菜单实体 │ │ │ │ │ │ ├── form/ # 菜单表单 │ │ │ │ │ │ │ ├── MenuAddForm.java # 新增菜单表单 │ │ │ │ │ │ │ ├── MenuBaseForm.java # 菜单基础表单 │ │ │ │ │ │ │ ├── MenuPointsOperateForm.java # 菜单权限点操作表单 │ │ │ │ │ │ │ └── MenuUpdateForm.java # 更新菜单表单 │ │ │ │ │ │ └── vo/ # 菜单视图对象 │ │ │ │ │ │ ├── MenuSimpleTreeVO.java # 菜单简明树 VO │ │ │ │ │ │ ├── MenuTreeVO.java # 菜单树 VO │ │ │ │ │ │ └── MenuVO.java # 菜单 VO │ │ │ │ │ └── service/ # 菜单服务层 │ │ │ │ │ └── MenuService.java # 菜单服务接口 │ │ │ │ │ │ │ │ │ ├── message/ # 消息管理模块 │ │ │ │ │ └── AdminMessageController.java # 管理后台消息 API │ │ │ │ │ │ │ │ │ ├── position/ # 岗位管理模块 │ │ │ │ │ ├── controller/ # 岗位控制器 │ │ │ │ │ │ └── PositionController.java # 岗位 REST API │ │ │ │ │ ├── dao/ # 岗位数据访问层 │ │ │ │ │ │ └── PositionDao.java # 岗位 Mapper │ │ │ │ │ ├── domain/ # 岗位领域对象 │ │ │ │ │ │ ├── entity/ # 岗位实体 │ │ │ │ │ │ │ └── PositionEntity.java # 岗位实体 │ │ │ │ │ │ ├── form/ # 岗位表单 │ │ │ │ │ │ │ ├── PositionAddForm.java # 新增岗位表单 │ │ │ │ │ │ │ ├── PositionQueryForm.java # 岗位查询表单 │ │ │ │ │ │ │ └── PositionUpdateForm.java # 更新岗位表单 │ │ │ │ │ │ └── vo/ # 岗位视图对象 │ │ │ │ │ │ └── PositionVO.java # 岗位 VO │ │ │ │ │ ├── manager/ # 岗位业务管理层 │ │ │ │ │ │ └── PositionManager.java # 岗位管理器 │ │ │ │ │ └── service/ # 岗位服务层 │ │ │ │ │ └── PositionService.java # 岗位服务接口 │ │ │ │ │ │ │ │ │ ├── role/ # 角色管理模块 │ │ │ │ │ ├── controller/ # 角色控制器 │ │ │ │ │ │ ├── RoleController.java # 角色 REST API │ │ │ │ │ │ ├── RoleDataScopeController.java # 角色数据权限 REST API │ │ │ │ │ │ ├── RoleEmployeeController.java # 角色员工 REST API │ │ │ │ │ │ └── RoleMenuController.java # 角色菜单 REST API │ │ │ │ │ ├── dao/ # 角色数据访问层 │ │ │ │ │ │ ├── RoleDao.java # 角色 Mapper │ │ │ │ │ │ ├── RoleDataScopeDao.java # 角色数据权限 Mapper │ │ │ │ │ │ ├── RoleEmployeeDao.java # 角色员工 Mapper │ │ │ │ │ │ └── RoleMenuDao.java # 角色菜单 Mapper │ │ │ │ │ ├── domain/ # 角色领域对象 │ │ │ │ │ │ ├── entity/ # 角色实体 │ │ │ │ │ │ │ ├── RoleDataScopeEntity.java # 角色数据权限实体 │ │ │ │ │ │ │ ├── RoleEmployeeEntity.java # 角色员工关联实体 │ │ │ │ │ │ │ ├── RoleEntity.java # 角色实体 │ │ │ │ │ │ │ └── RoleMenuEntity.java # 角色菜单关联实体 │ │ │ │ │ │ ├── form/ # 角色表单 │ │ │ │ │ │ │ ├── RoleAddForm.java # 新增角色表单 │ │ │ │ │ │ │ ├── RoleDataScopeUpdateForm.java # 角色数据权限更新表单 │ │ │ │ │ │ │ ├── RoleEmployeeQueryForm.java # 角色员工查询表单 │ │ │ │ │ │ │ ├── RoleEmployeeUpdateForm.java # 角色员工更新表单 │ │ │ │ │ │ │ ├── RoleMenuUpdateForm.java # 角色菜单更新表单 │ │ │ │ │ │ │ ├── RoleQueryForm.java # 角色查询表单 │ │ │ │ │ │ │ └── RoleUpdateForm.java # 更新角色表单 │ │ │ │ │ │ └── vo/ # 角色视图对象 │ │ │ │ │ │ ├── RoleDataScopeVO.java # 角色数据权限 VO │ │ │ │ │ │ ├── RoleEmployeeVO.java # 角色员工 VO │ │ │ │ │ │ ├── RoleMenuTreeVO.java # 角色菜单树 VO │ │ │ │ │ │ ├── RoleSelectedVO.java # 角色选择 VO │ │ │ │ │ │ └── RoleVO.java # 角色 VO │ │ │ │ │ ├── manager/ # 角色业务管理层 │ │ │ │ │ │ ├── RoleDataScopeManager.java # 角色数据权限管理器 │ │ │ │ │ │ ├── RoleEmployeeManager.java # 角色员工管理器 │ │ │ │ │ │ └── RoleMenuManager.java # 角色菜单管理器 │ │ │ │ │ └── service/ # 角色服务层 │ │ │ │ │ ├── RoleDataScopeService.java # 角色数据权限服务 │ │ │ │ │ ├── RoleEmployeeService.java # 角色员工服务 │ │ │ │ │ ├── RoleMenuService.java # 角色菜单服务 │ │ │ │ │ └── RoleService.java # 角色服务 │ │ │ │ │ │ │ │ │ └── support/ # 系统支撑功能（工具/辅助接口） │ │ │ │ ├── AdminApiEncryptController.java # API 加密测试接口 │ │ │ │ ├── AdminCacheController.java # 缓存管理接口 │ │ │ │ ├── AdminChangeLogController.java # 变更日志接口 │ │ │ │ ├── AdminConfigController.java # 系统配置接口 │ │ │ │ ├── AdminDataMaskingDemoController.java # 数据脱敏演示接口 │ │ │ │ ├── AdminDictController.java # 字典管理接口 │ │ │ │ ├── AdminFileController.java # 文件管理接口 │ │ │ │ ├── AdminHeartBeatController.java # 心跳检测接口 │ │ │ │ ├── AdminHelpDocController.java # 帮助文档接口 │ │ │ │ ├── AdminLoginLogController.java # 登录日志接口 │ │ │ │ ├── AdminOperateLogController.java # 操作日志接口 │ │ │ │ ├── AdminProtectController.java # 安全防护接口 │ │ │ │ ├── AdminReloadController.java # 热加载接口 │ │ │ │ ├── AdminSerialNumberController.java # 流水号生成接口 │ │ │ │ └── AdminSmartJobController.java # 智能任务接口 │ │ │ │ │ │ │ └── util/ # 工具类目录 │ │ │ └── AdminRequestUtil.java # 后台请求工具类（获取当前用户、IP 等） │ │ │ │ │ └── resources/ # 资源文件目录 │ │ ├── dev/ # 开发环境配置 │ │ │ ├── application.yaml # 开发环境 Spring Boot 配置文件 │ │ │ ├── log4j2-spring.xml # 开发环境 Log4j2 日志配置 │ │ │ └── spy.properties # 开发环境 MyBatis SQL 监控配置（p6spy） │ │ │ │ │ ├── mapper/ # MyBatis Mapper XML 文件目录 │ │ │ ├── business/ # 业务模块 Mapper XML │ │ │ │ ├── category/ # 分类 Mapper XML │ │ │ │ │ └── CategoryMapper.xml # 分类 SQL 映射文件 │ │ │ │ ├── goods/ # 商品 Mapper XML │ │ │ │ │ └── GoodsMapper.xml # 商品 SQL 映射文件 │ │ │ │ └── oa/ # OA 模块 Mapper XML │ │ │ │ ├── bank/ # 银行 Mapper XML │ │ │ │ │ └── BankMapper.xml # 银行 SQL 映射文件 │ │ │ │ ├── enterprise/ # 企业 Mapper XML │ │ │ │ │ ├── EnterpriseEmployeeMapper.xml # 企业员工 SQL 映射 │ │ │ │ │ └── EnterpriseMapper.xml # 企业 SQL 映射 │ │ │ │ ├── invoice/ # 发票 Mapper XML │ │ │ │ │ └── InvoiceMapper.xml # 发票 SQL 映射 │ │ │ │ └── notice/ # 通知 Mapper XML │ │ │ │ └── NoticeMapper.xml # 通知 SQL 映射 │ │ │ └── system/ # 系统模块 Mapper XML │ │ │ ├── PositionMapper.xml # 岗位 SQL 映射 │ │ │ ├── department/ # 部门 Mapper XML │ │ │ │ └── DepartmentMapper.xml # 部门 SQL 映射 │ │ │ ├── employee/ # 员工 Mapper XML │ │ │ │ └── EmployeeMapper.xml # 员工 SQL 映射 │ │ │ ├── menu/ # 菜单 Mapper XML │ │ │ │ └── MenuMapper.xml # 菜单 SQL 映射 │ │ │ └── role/ # 角色 Mapper XML │ │ │ ├── RoleDataScopeMapper.xml # 角色数据权限 SQL 映射 │ │ │ ├── RoleEmployeeMapper.xml # 角色员工 SQL 映射 │ │ │ ├── RoleMapper.xml # 角色 SQL 映射 │ │ │ └── RoleMenuMapper.xml # 角色菜单 SQL 映射 │ │ │ │ │ ├── pre/ # 预发布环境配置 │ │ │ ├── application.yaml # 预发布环境 Spring Boot 配置 │ │ │ └── log4j2-spring.xml # 预发布环境 Log4j2 日志配置 │ │ │ │ │ ├── prod/ # 生产环境配置 │ │ │ ├── application.yaml # 生产环境 Spring Boot 配置 │ │ │ └── log4j2-spring.xml # 生产环境 Log4j2 日志配置 │ │ │ │ │ └── test/ # 测试环境配置 │ │ ├── application.yaml # 测试环境 Spring Boot 配置 │ │ ├── log4j2-spring.xml # 测试环境 Log4j2 日志配置 │ │ └── spy.properties # 测试环境 MyBatis SQL 监控配置 │ │ │ └── test/ # 测试代码目录 │ └── java/ # 测试 Java 源码 │ └── net/ # 包路径 │ └── lab1024/ # 组织/公司包名 │ └── sa/ # 项目核心包 │ └── admin/ # 管理后台包 │ └── AdminApplicationTest.java # 应用启动测试类 │ └── target/ # Maven 编译输出目录（自动生成，通常不提交） ├── classes/ # 编译后的 class 文件及资源 │ ├── application.yaml # 编译后合并的配置文件 │ ├── log4j2-spring.xml # 编译后的日志配置 │ ├── spy.properties # 编译后的监控配置 │ ├── mapper/ # 编译后的 Mapper XML │ │ ├── business/ # 业务模块 Mapper │ │ │ ├── category/ # 分类 Mapper │ │ │ │ └── CategoryMapper.xml │ │ │ ├── goods/ # 商品 Mapper │ │ │ │ └── GoodsMapper.xml │ │ │ └── oa/ # OA Mapper │ │ │ ├── bank/ # 银行 Mapper │ │ │ │ └── BankMapper.xml │ │ │ ├── enterprise/ # 企业 Mapper │ │ │ │ ├── EnterpriseEmployeeMapper.xml │ │ │ │ └── EnterpriseMapper.xml │ │ │ ├── invoice/ # 发票 Mapper │ │ │ │ └── InvoiceMapper.xml │ │ │ └── notice/ # 通知 Mapper │ │ │ └── NoticeMapper.xml │ │ └── system/ # 系统模块 Mapper │ │ ├── PositionMapper.xml │ │ ├── department/ # 部门 Mapper │ │ │ └── DepartmentMapper.xml │ │ ├── employee/ # 员工 Mapper │ │ │ └── EmployeeMapper.xml │ │ ├── menu/ # 菜单 Mapper │ │ │ └── MenuMapper.xml │ │ └── role/ # 角色 Mapper │ │ ├── RoleDataScopeMapper.xml │ │ ├── RoleEmployeeMapper.xml │ │ ├── RoleMapper.xml │ │ └── RoleMenuMapper.xml │ └── net/ # 编译后的 Java class 文件 │ └── lab1024/ │ └── sa/ │ └── admin/ │ ├── AdminApplication.class # 启动类编译文件 │ ├── config/ # 配置类编译文件 │ ├── constant/ # 常量编译文件 │ ├── interceptor/ # 拦截器编译文件 │ ├── module/ # 业务模块编译文件 │ │ ├── business/ # 业务模块 │ │ │ ├── category/ # 分类模块 │ │ │ ├── goods/ # 商品模块 │ │ │ └── oa/ # OA 模块 │ │ └── system/ # 系统模块 │ └── util/ # 工具类编译文件 └── generated-sources/ # 编译生成的源码（如注解处理器） └── annotations/ # 注解处理器生成文件 ├── sa-base/ # 基础核心模块（公共组件、工具类、基础配置） │ ├── pom.xml # sa-base 模块 Maven 配置文件 │ │ │ └── src/ # 源代码目录 │ └── main/ # 主代码目录 │ ├── java/ # Java 源码根目录 │ │ └── net/ # 顶级包路径 │ │ └── lab1024/ # 组织/公司包名 │ │ └── sa/ # 项目核心包 │ │ └── base/ # 基础核心包 │ │ ├── common/ # 公共组件目录 │ │ │ ├── annoation/ # 自定义注解 │ │ │ │ └── NoNeedLogin.java # 免登录注解（标记接口无需登录） │ │ │ ├── code/ # 错误码定义 │ │ │ │ ├── ErrorCode.java # 错误码接口 │ │ │ │ ├── ErrorCodeRangeContainer.java # 错误码范围容器 │ │ │ │ ├── ErrorCodeRegister.java # 错误码注册器 │ │ │ │ ├── SystemErrorCode.java # 系统错误码 │ │ │ │ ├── UnexpectedErrorCode.java # 意外错误码 │ │ │ │ └── UserErrorCode.java # 用户业务错误码 │ │ │ ├── constant/ # 公共常量 │ │ │ │ ├── RequestHeaderConst.java # 请求头常量 │ │ │ │ └── StringConst.java # 字符串常量 │ │ │ ├── controller/ # 基础控制器 │ │ │ │ └── SupportBaseController.java # 基础控制器基类 │ │ │ ├── domain/ # 公共领域对象 │ │ │ │ ├── DataScopePlugin.java # 数据权限插件 │ │ │ │ ├── PageParam.java # 分页参数 │ │ │ │ ├── PageResult.java # 分页结果 │ │ │ │ ├── RequestUrlVO.java # 请求 URL VO │ │ │ │ ├── RequestUser.java # 请求用户信息 │ │ │ │ ├── ResponseDTO.java # 统一响应 DTO │ │ │ │ ├── SystemEnvironment.java # 系统环境对象 │ │ │ │ ├── UserPermission.java # 用户权限 │ │ │ │ ├── ValidateData.java # 校验数据 │ │ │ │ └── ValidateList.java # 校验列表 │ │ │ ├── enumeration/ # 公共枚举 │ │ │ │ ├── BaseEnum.java # 基础枚举接口 │ │ │ │ ├── DataTypeEnum.java # 数据类型枚举 │ │ │ │ ├── GenderEnum.java # 性别枚举 │ │ │ │ ├── SystemEnvironmentEnum.java # 系统环境枚举 │ │ │ │ └── UserTypeEnum.java # 用户类型枚举 │ │ │ ├── exception/ # 异常定义 │ │ │ │ └── BusinessException.java # 业务异常类 │ │ │ ├── json/ # JSON 序列化/反序列化 │ │ │ │ ├── deserializer/ # 反序列化器 │ │ │ │ │ ├── DictDataDeserializer.java # 字典数据反序列化 │ │ │ │ │ ├── DictDataIntDeserializer.java # 字典整数反序列化 │ │ │ │ │ ├── FileKeyVoDeserializer.java # 文件 Key VO 反序列化 │ │ │ │ │ └── LongJsonDeserializer.java # Long 反序列化 │ │ │ │ ├── serializer/ # 序列化器 │ │ │ │ │ ├── BigDecimalNullZeroSerializer.java # BigDecimal 零值序列化 │ │ │ │ │ ├── DataMaskingSerializer.java # 数据脱敏序列化 │ │ │ │ │ ├── FileKeySerializer.java # 文件 Key 序列化 │ │ │ │ │ ├── FileKeyVoSerializer.java # 文件 Key VO 序列化 │ │ │ │ │ └── LongJsonSerializer.java # Long 序列化 │ │ │ │ └── enumeration/ # 枚举序列化 │ │ │ │ ├── EnumSerialize.java # 枚举序列化接口 │ │ │ │ └── EnumSerializer.java # 枚举序列化器 │ │ │ ├── swagger/ # Swagger 增强 │ │ │ │ ├── SchemaEnum.java # 枚举 Schema │ │ │ │ ├── SchemaEnumPropertyCustomizer.java # Schema 枚举定制 │ │ │ │ └── SmartOperationCustomizer.java # 操作定制器 │ │ │ ├── util/ # 公共工具类 │ │ │ │ ├── SmartBeanUtil.java # Bean 工具 │ │ │ │ ├── SmartBigDecimalUtil.java # BigDecimal 工具 │ │ │ │ ├── SmartDateFormatterEnum.java # 日期格式化 │ │ │ │ ├── SmartEnumUtil.java # 枚举工具 │ │ │ │ ├── SmartExcelUtil.java # Excel 工具 │ │ │ │ ├── SmartIpUtil.java # IP 工具 │ │ │ │ ├── SmartLocalDateUtil.java # 日期工具 │ │ │ │ ├── SmartPageUtil.java # 分页工具 │ │ │ │ ├── SmartRequestUtil.java # 请求工具 │ │ │ │ ├── SmartResponseUtil.java # 响应工具 │ │ │ │ ├── SmartStringUtil.java # 字符串工具 │ │ │ │ └── SmartVerificationUtil.java # 校验工具 │ │ │ └── validator/ # 校验器 │ │ │ └── enumeration/ # 枚举校验 │ │ │ ├── CheckEnum.java # 校验枚举注解 │ │ │ └── EnumValidator.java # 枚举校验器 │ │ ├── config/ # 基础配置类 │ │ │ ├── AsyncConfig.java # 异步任务配置 │ │ │ ├── CacheConfig.java # 缓存配置 │ │ │ ├── CorsFilterConfig.java # 跨域配置 │ │ │ ├── DataSourceConfig.java # 数据源配置 │ │ │ ├── FileConfig.java # 文件存储配置 │ │ │ ├── HeartBeatConfig.java # 心跳配置 │ │ │ ├── JsonConfig.java # JSON 配置 │ │ │ ├── MybatisPlusConfig.java # MyBatis-Plus 配置 │ │ │ ├── RedisConfig.java # Redis 配置 │ │ │ ├── RepeatSubmitConfig.java # 防重复提交配置 │ │ │ ├── RestClientConfig.java # HTTP 客户端配置 │ │ │ ├── ScheduleConfig.java # 定时任务配置 │ │ │ ├── SwaggerConfig.java # Swagger 配置 │ │ │ ├── SystemEnvironmentConfig.java # 系统环境配置 │ │ │ ├── TokenConfig.java # Token 配置 │ │ │ ├── UrlConfig.java # URL 配置 │ │ │ └── YamlProcessor.java # YAML 处理器 │ │ ├── constant/ # 基础常量 │ │ │ ├── CacheKeyConst.java ``` # 安装教程 1. xxxx 2. xxxx 3. xxxx # 使用说明 1. xxxx 2. xxxx 3. xxxx # 参与贡献 1. Fork 本仓库 2. 新建 Feat_xxx 分支 3. 提交代码 4. 新建 Pull Request # 特技 1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md 2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com) 3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目 4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目 5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help) 6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)