ContiNew后端开发
ContiNew Admin 后端二次开发入口，给出工程通用约定与各专题页导航。
本文是 4.x 的归档文档（冻结于 v4.2.0）。该分支只接收勘误修正， 内容基本不再变动；文中的源码路径、配置项与版本号均以 4.2.x 为准，不建议用于新项目。
新项目请查看 5.x 最新文档。已在 4.2.x 上运行的项目，本文仍是可靠依据。
ContiNew Admin 后端基于 Spring Boot 3.5.16（Java 17），脚手架能力由 ContiNew Starter 2.17.0 供给。二次开发前先确认 项目结构 中的模块划分，再按本组专题页对照落地。
通用约定
以下三条约定贯穿全部业务代码，新增功能时先对齐这三条再动手。
分层子包
continew-system 的 auth、system 与 continew-plugin 下各插件按同一套分层子包组织：controller、service（含 impl）、mapper、model.entity / model.query / model.req / model.resp，按需补充 enums、constant、util、config、validation。实体继承 common 的 BaseDO（自带 id、createUser、createTime、updateUser、updateTime、deleted 字段），字段由 MyBatisPlusMetaObjectHandler 在插入与更新时自动填充。完整分层对照表见 项目结构。
内部 API 解耦
跨模块调用不直接依赖对方 Service。被调方在 continew-common 的 top.continew.admin.common.api 包定义接口（如 UserApi、TenantApi），业务模块在自己的 api/ 子包提供实现并注册为 Spring Bean，调用方只注入接口。模块依赖保持 server → system → common 单向，不会出现循环依赖。continew-plugin-tenant 的 TenantApiImpl、continew-system 的 UserApiImpl 都是这一模式的实例。
全局响应
Controller 直接返回业务对象，Graceful Response（5.0.5-boot3）在出口统一包装为 top.continew.starter.web.model.R，字段为 code、data、msg、success、timestamp。成功码 0、失败码 1、错误时 HTTP 状态码仍为 200，这些默认值由 application.yml 的 continew-starter.web.response 配置块固定。导出文件等需要绕过包装的场景，在方法上加 @ExcludeFromGracefulResponse（AbstractCrudController 的 export 方法即如此）。前端约定见 请求封装。
专题导航
项目结构
Maven 多模块划分、业务分层子包约定与前端 src 目录组织，改代码前先找对位置。
CRUD 开发
@CrudRequestMapping 声明接口集，BaseController 自动生成并校验权限码，五分钟跑通一个资源的全套增删改查。
认证与安全
Sa-Token + JWT 签发短期 Access Token，Refresh Token 双令牌轮换，RSA 加密密码传输，登录处理器扩展新登录方式。
数据权限
Mapper 继承 DataPermissionMapper 即接入行级数据权限，五种数据范围由角色-部门关系驱动。
多租户接入
新业务表加 tenant_id 字段并继承 TenantBaseDO 即纳入行级租户隔离，ignore-tables 白名单放行长共享表。
接口文档
NextDoc4j 渲染接口文档，springdoc 分组，CRUD 权限码自动展示。
Excel 导入导出
FastExcel 导入导出，DictExcelProperty 与 ExcelDictConverter 完成字典值与标签互转。
常见问题
后端二次开发高频问题，按症状组织，先对症状再找原因。