continew-admin

ContiNew Admin 多租户中后台管理框架

📚 在线文档 | 🚀 演示地址 | 💬 提交 Issue

简介

AI 编程纪元已经开启，基于 ContiNew 项目开发，让 AI 助手“学习”更优雅的代码规范，“写出”更优质的代码。

ContiNew Admin（Continue New Admin），页面现代美观，且专注设计与代码细节的 高质量多租户中后台 管理系统框架。开箱即用，持续迭代优化，持续提供舒适的开发体验。

当前采用的技术栈：Spring Boot 4（Java17）、Vue3 & Arco Design & TS & Vite、Sa-Token、MyBatis Plus、Redisson、Caffeine、FastExcel、CosId、JustAuth、Crane4j、Spring Doc、Hutool 等。

我们始终坚信好的产品必然是反复打磨出来的，而在工作中我们受限于客户需求、开发周期等因素，无法深度打磨、重构我们的代码，这也是架构腐烂的根源。所以，我们希望能在业余时间，通过开源社区的力量来打磨出一个好的产品，一个好的实践，一个好的生态。

我们的愿景在于，当你将 ContiNew 系列项目应用到工作场景时，不仅仅是得到效率的提高，更可以得到舒适的开发体验，让更多开发者的编程工作多一点“甜”。

项目源码

	后端	前端
GitHub	continew-org/continew-admin	continew-org/continew-admin-ui
AtomGit	continew/continew-admin	continew/continew-admin-ui
Gitee	continew/continew-admin	continew/continew-admin-ui

OpenContiNew 生态

ContiNew 系列项目均由 OpenContiNew 开源社区维护，除本项目外还包括：

项目	简介
ContiNew Starter	ContiNew Admin 的通用基础能力抽离形成的企业级 Starter 库，约定优于配置，开箱即用
ContiNew Admin UI	ContiNew Admin 前端适配项目

项目起源

我热衷于做数据归档，归档后的数据可以提高学习/工作效率，为记忆“减负”，在持续的数据归档中，优质的“沉淀”会带来非匀速、跨越式的学习/工作体验。数据归档是一件需要持续去做的事情。

从接触程序代码的第一天，我的程序数据归档也随之开始了，刷过的算法题、笔记、对接各种组件的配置文件，甚至于一些亮眼的样式设计、“如诗”的代码片段。这些数据的沉淀丰富了我的解决方案，提高了我的编程效率，逐渐为各种场景落实成了一个个雏形程序。再后来，我意识到，我归档的这些雏形程序，有一个更为妥贴的名称：程序框架/脚手架。

技术的发展，导致这些雏形程序的生命周期很是短暂，它们有别于我归档的其他数据，有时由于工作的原因，没有时间很好的去沉淀它们，在使用时变得越来越不顺手。所以，某段时间，我放弃了维护，而是去采用一些更为成熟的框架。

不过，在陆续几年使用了一些成熟框架后，我前后遇到了一些困难：

1. 代码洁癖想要找到一个扩展性佳，代码规范良好，开发体验舒适的框架很不容易，总是差些什么
2. 项目上手困难或是基础版功能不全，需要的全在专业版，亦或者代码阅读性差，文档收费
3. 部分解决方案缺失，已有解决方案也过于偏向样板化，无法形成良好的逻辑闭环
4. 好不容易找到一些相较合适的，没过多久，部分作者可能暂时没法对外发“电”了，随着了解深入，很多 Bug 或新技术趋势还是需要自己研究解决

在工作中，很多想法/设计受限于客户需求、开发工期，必须优先以交付为导向，但一些优秀的实践需要花时间持续进行沉淀，只要我没跳出这个圈子，我还是需要一直去做好程序归档。“种一棵树最好的时间是十年前，其次是现在”，最终，我选择在业余时间更加正视这件事，从头归档沉淀，从添加每一个依赖开始，我希望它能持续的迭代优化、演进，所以我把它命名为 ContiNew（Continue New）。并且这次我选择了开源，我希望它不仅仅能吸收我的需求和沉淀，而是依托开源协作模式，及时发现更多的问题，接受更多的可能性，沉淀更优秀的思考，设计。

为什么选我们？

AI 编程纪元已经开启，基于 ContiNew 项目开发，让 AI 助手“学习”更优雅的代码规范，“写出”更优质的代码。

1.长期稳定： 自 2022 年 12 月 8 日创建，2023 年 3 月 26 日发布 v1.0.0，至今持续迭代优化，完整版本发布记录见 更新日志。

2.甄选技术栈： ContiNew（Continue New） 项目致力于持续迭代优化，确保技术栈紧跟时代。在技术选型时，我们进行了深度广泛的调研，从流行度、成熟度和发展潜力等多维度精心挑选技术栈。

3.Starter 组件： 从 v2.1.0 版本开始，我们将后端基础组件及各框架集成配置抽取并封装到 ContiNew Starter 项目中，极大降低上手和升级难度。且 已发布至 Maven 中央仓库，你可以在任意项目中直接引入所需依赖使用。即使你不使用完整的中后台框架，这些能让你搭项目框架更快、更爽、更省力的 Starter 组件，难道不香吗？

4.CRUD 套件： 封装通用增删改查套件，适配后端各分层架构，几分钟即可提供一套完整的 CRUD API，包括新增、修改、批量删除、查询详情、分页列表、全部列表、树型列表、Excel 导出，甚至是字典列表（用于下拉选项场景）。所有 API 均可根据实际需求灵活开放或扩展。

@Tag(name = "部门管理 API")
@RestController
@CrudRequestMapping(value = "/system/dept", api = {Api.TREE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE, Api.EXPORT, Api.TREE_DICT})
public class DeptController extends BaseController<DeptService, DeptResp, DeptDetailResp, DeptQuery, DeptReq> {}

5.代码生成器： 同步提供了代码生成器，配套前后端代码生成模板。数据表设计完成后，简单配置即可生成前后端 80% 的代码，包括 CRUD API、权限控制、参数校验、接口文档等内容。若业务不复杂，甚至能覆盖 95% 的代码量。

6.提升开发体验： 持续优化并适配各类能提升开发体验的组件。

• ContiNew Starter 组件集合：针对 Spring 基础配置、通用解决方案及流行框架进行深度封装，改善你开发每个 Spring Boot Web 项目的体验（包含时间日期及枚举参数自动转换、默认线程池、跨域、加密、脱敏、限流、幂等、License、日志、异常及响应通用解决方案等）；
• Crane4j 数据填充组件：减少因单个字段（如用户名）而产生的联表查询；
• SpEL Validator：基于 SpEL 表达式的参数校验，强化复杂场景下的参数验证（如：当某字段为特定值时，另一字段不能为空）；
• P6Spy SQL 性能分析：开发期间可方便地监控 SQL 执行性能；
• Micrometer Tracing 链路追踪：在繁杂的日志中快速定位某次请求的完整日志；
• 多级缓存（Caffeine + Redis）：通过 Spring Cache 注解或 CacheUtils 实现方法级缓存，支持本地/远程两级缓存、集群 L1 失效广播与定时刷新；

7.Almost 最佳后端规范： 后端严格遵循阿里巴巴 Java 编码规范，注释覆盖率 > 45%，接口参数示例 100%。代码分层清晰，变量与方法命名统一规范，前端代码同样采用严格的 ESLint、StyleLint 等检查。优秀的设计带来极高的代码复用率！开发时，你会有一种“无需多写，理应如此”的流畅感。

8.卓越工程化实践： 后端采用模块化工程结构，集成了统一版本管理、编译时自动代码格式化等插件。提供自定义打包部署配置（配置文件、第三方依赖与主程序分离），以及全套环境和应用的 Docker Compose 部署脚本。

为减少新项目开发的改造成本，我们持续深度聚合项目品牌配置，通过简单的配置和结构修改，即可快速启动你的专属项目。

我们还进行了全局 Lombok 配置，继承场景默认自动应用 @EqualsAndHashCode(callSuper = true) 和 @ToString(callSuper = true)，无需手动添加。同时主动禁用了部分 Lombok 注解（如 @Val、@Log4j 等），避免“又菜又爱玩”的 partner 滥用。

9.全能业务脚手架： 支持 SaaS 租户架构，基于 RBAC 的权限控制与通用数据权限管理。精心设计的 UI 界面与色彩主题，兼具美观与实用性。内置丰富的通用业务解决方案：第三方登录、邮箱/短信服务（含生产级漏洞处理方案）、个人中心、用户管理、角色管理、组织管理、系统配置、系统日志、消息中心、通知公告等，逻辑闭环，开箱即用。

优秀的中后台框架不仅提供组件集成与配置，封装好用的工具，更应提供通用基础业务设计及解决方案，为初创团队减负。

10.质量与安全并重： 我们高度重视项目质量与安全，CI 已集成 SonarCloud 静态扫描与 Open Code Review AI 评审，提交 PR 即自动扫描与评审质量问题。定期扫描 CVE 漏洞，及时解决潜在风险。封装了数据库字段加密、JSON 脱敏、XSS 过滤等工具，提供全方位的安全解决方案。

许多项目在开发或交付过程中需满足 Sonarqube 等质量指标，使用 ContiNew Admin 框架，让你从一开始就站在高质量的起点。

---

由于篇幅有限，且项目正处于高速发展期，更多功能正在持续开发中，敬请关注仓库或加入交流群了解最新动态。至于统一异常处理、错误处理、基础线程池配置（默认线程参数、线程上下文支持异步传递）等基础特性，这里不再赘述，更多细节优化欢迎克隆代码体验。

Talk is cheap, show the code.

系统功能

[!TIP] 更多功能和优化正在赶来💦，最新项目计划、进展请查看 开发计划 和 更新日志。 功能不会用？请查看 功能手册。

• 仪表盘：提供工作台、分析页，工作台提供功能快捷导航入口、最新公告、动态；分析页提供全面数据可视化能力
• 个人中心：支持基础信息修改、密码修改、邮箱绑定、手机号绑定（并提供行为验证码、短信限流等安全处理）、第三方账号绑定/解绑（微信登录）、头像裁剪上传
• 消息中心：提供站内信消息统一查看、标记已读、全部已读、删除等功能（目前仅支持系统通知消息）、提供个人公告查看
• 用户管理：管理系统用户，包含新增、修改、删除、导入、导出、重置密码、分配角色等功能
• 角色管理：管理系统用户的功能权限及数据权限，包含新增、修改、删除、分配角色等功能
• 菜单管理：管理系统菜单及按钮权限，支持多级菜单，动态路由，包含新增、修改、删除等功能
• 部门管理：管理系统组织架构，包含新增、修改、删除、导出等功能，以树形列表进行展示
• 通知公告：管理系统公告，支持通知范围（所有人、指定用户）、通知方式（系统消息、登录弹窗）、定时发送、置顶设置
• 文件管理：管理系统文件及文件夹，支持回收站、上传/分片上传、下载、预览（目前支持图片、音视频、PDF、Word、Excel、PPT）、重命名、切换视图（列表、网格）等功能
• 字典管理：管理系统公用数据字典，例如：消息类型。支持字典标签背景色和排序等配置
• 系统配置：
  • 网站配置：提供修改系统标题、Logo、favicon、版权信息等基础配置功能，以方便用户系统与其自身品牌形象保持一致
  • 安全配置：提供密码策略修改，支持丰富的密码策略设定，包括但不限于 密码有效期、密码重复次数、密码错误锁定账号次数、时间 等
  • 登录配置：提供验证码开关等登录相关配置
  • 邮件配置：提供系统发件箱配置，也支持通过配置文件指定
  • 短信配置：提供系统短信服务配置，也支持通过配置文件指定
  • 存储配置：管理文件存储配置，支持本地存储、兼容 S3 协议对象存储
  • 客户端配置：多端（PC端、小程序端等）认证管理，可设置不同的 token 有效期，支持可轮换的 Refresh Token 双令牌会话
• 在线用户：管理当前登录用户，可一键踢除下线
• 日志管理：管理系统登录日志、操作日志，支持查看日志详情，包含请求头、响应头等报文信息
• 短信日志：管理系统短信发送日志，支持删除、导出
• 应用管理：管理第三方系统应用 AK、SK，包含新增、修改、删除、查看密钥、重置密钥等功能，支持设置密钥有效期
• 租户管理：管理租户信息，包含新增、修改、删除、分配角色等功能
• 租户套餐：管理租户套餐信息，包含新增、修改、删除、查看等功能
• 任务管理：管理系统定时任务，包含新增、修改、删除、执行功能，支持 Cron（可配置式生成 Cron 表达式） 和固定频率
• 任务日志：管理定时任务执行日志，包含停止、重试指定批次等功能
• 代码生成：提供根据数据库表自动生成相应的前后端 CRUD 代码的功能，支持同步最新表结构及代码生成预览

系统截图

核心技术栈

名称	版本	简介
Vue	3.5.4	渐进式 JavaScript 框架，易学易用，性能出色，适用场景丰富的 Web 前端框架。
Arco Design	2.57.0	字节跳动推出的前端 UI 框架，年轻化的色彩和组件设计。
TypeScript	5.0.4	TypeScript 是微软开发的一个开源的编程语言，通过在 JavaScript 的基础上添加静态类型定义构建而成。
Vite	5.1.5	下一代的前端工具链，为开发提供极速响应。
ContiNew Starter	3.0.0	ContiNew Starter 包含了一系列经过企业实践优化的依赖包（如 MyBatis-Plus、SaToken），可轻松集成到应用中，为开发人员减少手动引入依赖及配置的麻烦，为 Spring Boot Web 项目的灵活快速构建提供支持。
Spring Boot	4.1.1	简化 Spring 应用的初始搭建和开发过程，基于“约定优于配置”的理念，使开发人员不再需要定义样板化的配置。（Spring Boot 3.0 开始，要求 Java 17 作为最低版本）
Tomcat	11.0.24	采用 Java 开发的 Servlet 容器，Spring Boot 4 起内置并作为默认 Web 服务器。
Sa-Token + JWT	1.46.0	轻量级 Java 权限认证框架，让鉴权变得简单、优雅。
MyBatis Plus	3.5.17	MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，简化开发、提高效率。
dynamic-datasource-spring-boot-starter	4.6.0	基于 Spring Boot 的快速集成多数据源的启动器。
Hikari	7.0.2	JDBC 连接池，号称 “史上最快连接池”，SpringBoot 在 2.0 之后，采用的默认数据库连接池就是 Hikari。
MySQL	8.4.13	体积小、速度快、总体拥有成本低，是最流行的关系型数据库管理系统之一。
mysql-connector-j	9.7.0	MySQL Java 驱动。
P6Spy	3.9.1	SQL 性能分析组件。
Liquibase	5.0.3	用于管理数据库版本，跟踪、管理和应用数据库变化。
Caffeine	3.2.0	高性能 Java 本地缓存库，作为本项目多级缓存的 L1（本地）缓存。
Redisson	4.8.0	不仅仅是一个 Redis Java 客户端，Redisson 充分的利用了 Redis 键值数据库提供的一系列优势，为使用者提供了一系列具有分布式特性的常用工具：分布式锁、限流器等。
Redis	7.2.17	高性能的 key-value 数据库。
Snail Job	1.10.0	灵活，可靠和快速的分布式任务重试和分布式任务调度平台。
X File Storage	2.3.0	一行代码将文件存储到本地、FTP、SFTP、WebDAV、阿里云 OSS、华为云 OBS…等其它兼容 S3 协议的存储平台。
SMS4J	3.3.5	短信聚合框架，轻松集成多家短信服务，解决接入多个短信 SDK 的繁琐流程。
Just Auth	1.16.7	开箱即用的整合第三方登录的开源组件，脱离繁琐的第三方登录 SDK，让登录变得 So easy！
Fast Excel	1.3.0	（由原 EasyExcel 作者创建的新项目）一个基于 Java 的、快速、简洁、解决大文件内存溢出的 Excel 处理工具。
AJ-Captcha	1.4.0	Java 行为验证码，包含滑动拼图、文字点选两种方式，UI支持弹出和嵌入两种方式。
Easy Captcha	1.6.2	Java 图形验证码，支持 gif、中文、算术等类型，可用于 Java Web、JavaSE 等项目。
Crane4j	2.10.0	一个基于注解的，用于完成一切 “根据 A 的 key 值拿到 B，再把 B 的属性映射到 A” 这类需求的字段填充框架。
SpEL Validator	0.7.0	基于 SpEL 的 jakarta.validation-api 扩展增强包。
CosID	4.0.2	旨在提供通用、灵活、高性能的分布式 ID 生成器。
NextDoc4j	1.5.0	现代化 API 文档 UI 工具，全面替代 Swagger UI。
OpenFeign	2025.1.3	Spring Cloud OpenFeign 是一种基于 Spring Cloud 的声明式 REST 客户端，它简化了与 HTTP 服务交互的过程。
Hutool	5.8.47	小而全的 Java 工具类库，通过静态方法封装，降低相关 API 的学习成本，提高工作效率，使 Java 拥有函数式语言般的优雅，让 Java 语言也可以“甜甜的”。
Lombok	1.18.46	在 Java 开发过程中用注解的方式，简化了 JavaBean 的编写，避免了冗余和样板式代码，让编写的类更加简洁。

快速开始

# 1.克隆本项目
git clone https://github.com/continew-org/continew-admin.git

# 2.在 IDE（IntelliJ IDEA/Eclipse）中打开本项目

# 3.修改配置文件中的数据源配置信息、Redis 配置信息、邮件配置信息等
# [3.也可以在 IntelliJ IDEA 中直接配置程序启动环境变量（DB_HOST、DB_PORT、DB_USER、DB_PWD、DB_NAME；REDIS_HOST、REDIS_PORT、REDIS_PWD、REDIS_DB）]

# 4.启动程序
# 启动成功，在控制台末尾会输出 ContiNew Admin service started successfully.
# 并输出 API 地址及 API 接口文档地址

项目结构

continew-admin
├─ continew-server（打包部署模块）
│  ├─ src
│  │  ├─ main
│  │  │  ├─ java/top/continew/admin
│  │  │  │  ├─ config （配置）
│  │  │  │  │  ├─ log（操作日志配置）
│  │  │  │  │  └─ satoken（SaToken 认证配置）
│  │  │  │  ├─ controller（通用 API）
│  │  │  │  ├─ job （定时任务）
│  │  │  │  └─ ContiNewAdminApplication.java（ContiNew Admin 启动程序）
│  │  │  └─ resources
│  │  │     ├─ config（核心配置目录）
│  │  │     │  ├─ application-dev.yml（开发环境配置文件）
│  │  │     │  ├─ application-prod.yml（生产环境配置文件）
│  │  │     │  └─ application.yml（通用配置文件）
│  │  │     ├─ db/changelog（Liquibase 数据脚本配置目录）
│  │  │     │  ├─ mysql（MySQL 数据库初始 SQL 脚本目录）
│  │  │     │  ├─ postgresql（PostgreSQL 数据库初始 SQL 脚本目录）
│  │  │     │  └─ db.changelog-master.yaml（Liquibase 变更记录文件）
│  │  │     ├─ templates（模板配置目录，例如：邮件模板）
│  │  │     ├─ banner.txt（Banner 配置文件）
│  │  │     └─ logback-spring.xml（日志配置文件）
│  │  └─ test（测试相关代码目录）
│  └─ pom.xml（包含打包相关配置）
├─ continew-system（系统管理模块，存放系统管理相关业务功能，例如：部门管理、角色管理、用户管理等）
│  ├─ src
│  │  ├─ main
│  │  │  ├─ java/top/continew/admin
│  │  │  │  ├─ auth（系统认证相关业务）
│  │  │  │  │  ├─ controller（系统认证相关 API）
│  │  │  │  │  ├─ service（系统认证相关业务接口及实现类）
│  │  │  │  │  ├─ model（系统认证相关模型）
│  │  │  │  │  │  ├─ query（系统认证相关查询条件）
│  │  │  │  │  │  ├─ req（系统认证相关请求参数（Request））
│  │  │  │  │  │  └─ resp（系统认证相关响应参数（Response））
│  │  │  │  │  ├─ enums（系统认证相关枚举）
│  │  │  │  │  ├─ constant（系统认证相关常量）
│  │  │  │  │  ├─ handler（系统认证相关处理器）
│  │  │  │  │  └─ config（系统认证相关配置）
│  │  │  │  └─ system（系统管理相关业务）
│  │  │  │     ├─ api（系统管理相关公共业务 API 实现）
│  │  │  │     ├─ controller（系统管理相关 API）
│  │  │  │     ├─ service（系统管理相关业务接口及实现类）
│  │  │  │     ├─ mapper（系统管理相关 Mapper）
│  │  │  │     ├─ model（系统管理相关模型）
│  │  │  │     │  ├─ entity（系统管理相关实体）
│  │  │  │     │  ├─ query（系统管理相关查询条件）
│  │  │  │     │  ├─ req（系统管理相关请求参数（Request））
│  │  │  │     │  └─ resp（系统管理相关响应参数（Response））
│  │  │  │     ├─ enums（系统管理相关枚举）
│  │  │  │     ├─ constant（系统管理相关常量）
│  │  │  │     ├─ util（系统管理相关工具类）
│  │  │  │     ├─ validation（系统管理相关参数校验工具类）
│  │  │  │     ├─ container（系统管理相关 Crane4j 数据填充容器配置）
│  │  │  │     └─ config（系统管理相关配置）
│  │  │  └─ resources
│  │  │     └─ mapper（系统管理相关 Mapper XML 文件目录）
│  │  └─ test（测试相关代码目录）
│  └─ pom.xml
├─ continew-plugin（插件模块，存放能力开放、租户等扩展模块，后续会进行插件化改造）
│  ├─ continew-plugin-open（能力开放插件模块）
│  │  ├─ src
│  │  │  ├─ main/java/top/continew/admin/open
│  │  │  │  ├─ controller（能力开放相关 API）
│  │  │  │  ├─ service（能力开放相关业务接口及实现类）
│  │  │  │  ├─ mapper（能力开放相关 Mapper）
│  │  │  │  ├─ model（能力开放相关模型）
│  │  │  │  │  ├─ entity（能力开放相关实体）
│  │  │  │  │  ├─ query（能力开放相关查询条件）
│  │  │  │  │  ├─ req（能力开放相关请求参数（Request））
│  │  │  │  │  └─ resp（能力开放相关响应参数（Response））
│  │  │  │  ├─ util（能力开放相关工具类）
│  │  │  │  ├─ handler（能力开放相关处理器）
│  │  │  │  ├─ sign（能力开放相关 API 参数签名算法）
│  │  │  │  └─ config（能力开放相关配置）
│  │  │  └─ test（测试相关代码目录）
│  │  └─ pom.xml
│  ├─ continew-plugin-tenant（租户插件模块）
│  │  ├─ src
│  │  │  ├─ main/java/top/continew/admin/tenant
│  │  │  │  ├─ api（租户相关公共业务 API 实现）
│  │  │  │  ├─ controller（租户相关 API）
│  │  │  │  ├─ service（租户相关业务接口及实现类）
│  │  │  │  ├─ mapper（租户相关 Mapper）
│  │  │  │  ├─ model（租户相关模型）
│  │  │  │  │  ├─ entity（租户相关实体）
│  │  │  │  │  ├─ query（租户相关查询条件）
│  │  │  │  │  ├─ req（租户相关请求参数（Request））
│  │  │  │  │  └─ resp（租户相关响应参数（Response））
│  │  │  │  ├─ enums（租户相关枚举）
│  │  │  │  ├─ constant（租户相关常量类）
│  │  │  │  ├─ util（租户相关工具类）
│  │  │  │  └─ config（租户相关配置）
│  │  │  └─ test（测试相关代码目录）
│  │  └─ pom.xml
│  ├─ continew-plugin-schedule（任务调度插件模块）
│  │  ├─ src
│  │  │  ├─ main/java/top/continew/admin/schedule
│  │  │  │  ├─ controller（任务调度相关 API）
│  │  │  │  ├─ service（代码生成器相关业务接口及实现类）
│  │  │  │  ├─ api（任务调度中心相关 Feign API）
│  │  │  │  ├─ model（任务调度相关模型）
│  │  │  │  │  ├─ query（任务调度相关查询条件）
│  │  │  │  │  ├─ req（任务调度相关请求参数（Request））
│  │  │  │  │  └─ resp（任务调度相关响应参数（Response））
│  │  │  │  ├─ enums（任务调度相关枚举）
│  │  │  │  ├─ constant（任务调度相关常量类）
│  │  │  │  ├─ exception（任务调度相关异常）
│  │  │  │  ├─ annotation（任务调度相关注解）
│  │  │  │  └─ config（任务调度相关配置）
│  │  │  └─ test（测试相关代码目录）
│  │  └─ pom.xml
│  ├─ continew-plugin-generator（代码生成器插件模块）
│  │  ├─ src
│  │  │  ├─ main
│  │  │  │  ├─ java/top/continew/admin/generator
│  │  │  │  │  ├─ controller（代码生成器相关 API）
│  │  │  │  │  ├─ service（代码生成器相关业务接口及实现类）
│  │  │  │  │  ├─ mapper（代码生成器相关 Mapper）
│  │  │  │  │  ├─ model（代码生成器相关模型）
│  │  │  │  │  │  ├─ entity（代码生成器相关实体）
│  │  │  │  │  │  ├─ query（代码生成器相关查询条件）
│  │  │  │  │  │  ├─ req（代码生成器相关请求参数（Request））
│  │  │  │  │  │  └─ resp（代码生成器相关响应参数（Response））
│  │  │  │  │  ├─ enums（代码生成器相关枚举）
│  │  │  │  │  └─ config（代码生成器相关配置）
│  │  │  │  └─ resources
│  │  │  │     └─ templates（代码生成相关模板目录）
│  │  │  │       ├─ backend（后端模板目录）
│  │  │  │       └─ frontend（前端模板目录）
│  │  │  └─ test（测试相关代码目录）
│  │  └─ pom.xml
│  └─ pom.xml
├─ continew-common（公共模块，存放公共工具类，公共配置等）
│  ├─ src
│  │  ├─ main/java/top/continew/admin/common
│  │  │  ├─ api（公共业务 API）
│  │  │  ├─ base（公共基类）
│  │  │  │  ├─ controller（控制器基类）
│  │  │  │  ├─ mapper（Mapper 接口基类）
│  │  │  │  ├─ model（公共模型）
│  │  │  │  │  ├─ entity（实体基类）
│  │  │  │  │  └─ resp（列表、详情响应基类）
│  │  │  │  └─ service（业务接口及实现基类）
│  │  │  ├─ model（公共模型）
│  │  │  │  ├─ dto（公共数据传输对象（DTO））
│  │  │  │  └─ req（公共请求参数（Request））
│  │  │  ├─ context（公共上下文）
│  │  │  ├─ enums（公共枚举）
│  │  │  ├─ constant（公共常量类）
│  │  │  ├─ util（公共工具类）
│  │  │  └─ config（公共配置）
│  │  │    ├─ crud（CRUD 配置）
│  │  │    ├─ mybatis（MyBatis Plus 配置）
│  │  │    ├─ websocket（Websocket 配置）
│  │  │    ├─ doc（接口文档配置）
│  │  │    ├─ excel（Excel 配置）
│  │  │    └─ exception（全局异常处理）
│  │  └─ test（测试相关代码目录）
│  └─ pom.xml
├─ continew-extension（扩展模块）
│  ├─ continew-extension-schedule-server（任务调度服务端模块，实际开发时如果是公司统一提供环境，可直接删除本模块）
│  │  ├─ src
│  │  │  ├─ main
│  │  │  │  ├─ java/top/continew/admin/extension/schedule
│  │  │  │  │  └─ ScheduleServerApplication.java（任务调度服务端启动程序）
│  │  │  │  └─ resources
│  │  │  │     ├─ config（核心配置目录）
│  │  │  │     │  ├─ application-dev.yml（开发环境配置文件）
│  │  │  │     │  ├─ application-prod.yml（生产环境配置文件）
│  │  │  │     │  └─ application.yml（通用配置文件）
│  │  │  │     ├─ db/changelog（Liquibase 数据脚本配置目录）
│  │  │  │     │  ├─ mysql（MySQL 数据库初始 SQL 脚本目录）
│  │  │  │     │  ├─ postgresql（PostgreSQL 数据库初始 SQL 脚本目录）
│  │  │  │     │  └─ db.changelog-master.yaml（Liquibase 变更记录文件）
│  │  │  │     └─ logback-spring.xml（日志配置文件）
│  │  │  └─ test（测试相关代码目录）
│  │  └─ pom.xml
│  └─ pom.xml
├─ .github（GitHub 相关配置目录：工作流、Issue/PR 模板）
├─ .agents（Agent 技能目录，供 AI 编程智能体使用）
├─ .idea
│  └─ icon.png（IDEA 项目图标，实际开发时直接删除）
├─ .image（截图目录，实际开发时直接删除）
├─ .mvn（Maven Wrapper 配置目录）
├─ style（代码风格配置目录：Spotless/Checkstyle/IDEA 配置等，详见 style/STYLE.md）
├─ .gitignore（Git 忽略文件相关配置文件）
├─ docker（项目部署相关配置目录，实际开发时可备份后直接删除）
├─ LICENSE（开源协议文件）
├─ CHANGELOG.md（更新日志文件，实际开发时直接删除）
├─ CODE_OF_CONDUCT.md（贡献者行为准则）
├─ CONTRIBUTING.md（贡献指南）
├─ SECURITY.md（安全策略）
├─ README.md（项目 README 文件，实际开发时替换为真实内容）
├─ lombok.config（Lombok 全局配置文件）
├─ mvnw / mvnw.cmd（Maven Wrapper 脚本，锁定 Maven 3.9.16）
└─ pom.xml（包含版本锁定及全局插件相关配置）

参与贡献

ContiNew（Continue New）系列项目致力于通过持续迭代，为开发者提供舒适的开发体验。作为 OpenContiNew 开源社区，我们的初衷是希望通过开源协作模式，提升技术透明度、放大集体智慧、共创优秀实践，源源不断地为企业级项目开发提供助力。

我们诚挚邀请广大社区用户为 ContiNew 项目贡献力量，贡献并不仅限于写代码，以下方式都非常欢迎：

• 🐛 报告 Bug：提交 Issue 时请附上版本号、复现步骤与错误日志（Issue 表单）
• 💡 建议功能：描述使用场景与期望效果
• 📖 改进文档：修复错别字、完善说明、补充使用示例
• 👀 审查 PR：帮助我们审查其他贡献者的 Pull Request
• 💻 编写代码：修复 Bug、开发新功能、提升性能

完整的贡献流程（环境准备、门禁自检、commit 规范、CLA 签署等）请查阅 贡献指南。

分支说明

ContiNew 系列项目采用清晰的分支策略，确保开发与维护有序进行。提交 PR 前，请确认目标分支是否处于活跃维护状态，版本支持情况请查看 升级指南。

分支	说明
dev	开发分支，用于下个大版本的 SNAPSHOT 开发，接受新功能或功能优化 PR
x.x.x	维护分支，用于特定版本（如 vx.x.x）的 bug 修复，仅接受已有功能的修复 PR，不接受新功能

反馈交流

感谢您对 ContiNew 开源项目的关注与支持！我们非常重视每一位用户的反馈和建议，这是推动项目不断进步的动力。 欢迎扫描下方二维码加入我们的官方交流群，与项目维护团队及其他大佬用户实时交流探讨。

• 与项目核心团队直接沟通，获取第一手项目动态
• 解决使用过程中遇到的问题，分享经验心得
• 参与功能讨论和需求收集，影响项目未来发展
• 结识志同道合的技术爱好者，扩展人脉圈

鸣谢

感谢参与贡献的每一位小伙伴🥰

特别鸣谢

• 感谢 JetBrains 提供的 非商业开源软件开发授权
• 感谢 MyBatis Plus、Sa-Token、Caffeine、Crane4j、NextDoc4j、Hutool 等开源组件作者为国内开源世界作出的贡献
• 感谢项目使用或未使用到的每一款开源组件，致敬各位开源先驱 :fire:

License

• 遵循 Apache-2.0 开源许可协议
• Copyright © 2022-present Charles7c