ContiNew Admin 多租户中后台管理框架技术文档-优快云博客

ContiNew Admin 多租户中后台管理框架技术文档

【免费下载链接】continew-admin 🔥Almost最佳后端规范🔥页面现代美观，且专注设计与代码细节的高质量多租户中后台管理系统框架。开箱即用，持续迭代优化，持续提供舒适的开发体验。当前采用技术栈：Spring Boot3（Java17）、Vue3 & Arco Design、TS、Vite5 、Sa-Token、MyBatis Plus、Redisson、FastExcel、CosId、JetCache、JustAuth、Crane4j、Spring Doc、Hutool 等。 AI 编程纪元，从 ContiNew & AI 开始优雅编码，让 AI 也“吃点好的”。项目地址: https://gitcode.com/continew/continew-admin

一、安装指南

1.1 环境要求

JDK 17+
MySQL 8.0+
Redis 6.0+
Maven 3.6+
Node.js 16+

1.2 后端安装

克隆项目代码：

git clone https://github.com/continew-org/continew-admin.git

导入数据库：

# 创建数据库
CREATE DATABASE `continew_admin` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

# 执行初始化SQL脚本（位于docs/sql目录）

修改配置文件：

# application-dev.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/continew_admin
    username: root
    password: 123456
  redis:
    host: localhost
    port: 6379

1.3 前端安装

克隆前端项目：

git clone https://github.com/continew-org/continew-admin-ui.git

安装依赖：

npm install

启动开发环境：

npm run dev

二、项目使用说明

2.1 系统初始化

访问 http://localhost:8080 进入登录页
使用默认管理员账号登录：
- 用户名：admin
- 密码：123456

2.2 核心功能模块

权限管理：
- 用户管理：创建/编辑系统用户
- 角色管理：配置角色权限
- 菜单管理：配置系统菜单结构
系统配置：
- 网站配置：设置系统名称、Logo等
- 安全配置：配置密码策略
- 存储配置：管理文件存储方式
多租户管理：
- 租户管理：管理租户信息
- 租户套餐：配置租户服务套餐

三、项目API使用文档

3.1 基础API规范

请求方式：RESTful风格
认证方式：Bearer Token
响应格式：

{
  "success": true,
  "code": 200,
  "message": "操作成功",
  "data": {}
}

3.2 典型API示例

用户登录

@Tag(name = "认证 API")
@RestController
@RequestMapping("/auth")
public class AuthController {
    
    @Operation(summary = "用户登录")
    @PostMapping("/login")
    public R<LoginResp> login(@Valid @RequestBody LoginReq req) {
        return R.ok(authService.login(req));
    }
}

CRUD接口示例

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

四、项目安装方式

4.1 源码编译安装

后端打包：

mvn clean package -DskipTests

前端构建：

npm run build

4.2 Docker部署

后端Dockerfile示例：

FROM openjdk:17-jdk
COPY target/continew-admin.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

前端Dockerfile示例：

FROM nginx:alpine
COPY dist /usr/share/nginx/html
COPY nginx.conf /etc/nginx/conf.d/default.conf

4.3 生产环境建议

使用Nginx作为前端静态资源服务器
配置HTTPS安全访问
启用Redis集群提高缓存性能
配置数据库主从复制

五、常见问题解答

Q: 如何修改系统默认主题色？ A: 在前端项目的src/styles/theme目录下修改主题配置文件

Q: 如何扩展数据权限？ A: 继承AbstractDataPermissionHandler类并实现自定义逻辑

Q: 代码生成器如何使用？ A: 在系统管理->代码生成模块中配置表信息并生成代码

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考