# loo-admin-cloud

**Repository Path**: TitaniumCores/loo-admin-cloud

## Basic Information

- **Project Name**: loo-admin-cloud
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2025-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Loo Cloud Admin

> 基于 Spring Boot 3.2+、Spring Cloud 2023、Spring Cloud Alibaba 2023 及 ContiNew Starter 2.14.0 的企业级微服务管理平台

## 项目介绍

Loo Cloud Admin 是一个基于最新微服务技术栈构建的企业级管理平台，提供完整的微服务基础设施和开箱即用的技术解决方案。

### 核心技术栈

| 技术分类 | 技术选型 | 版本 |
|---------|---------|------|
| 基础框架 | Spring Boot | 3.2+ |
| 微服务框架 | Spring Cloud | 2023.0.0 |
| 微服务组件 | Spring Cloud Alibaba | 2023.0.1.0 |
| 开发套件 | ContiNew Starter | 2.14.0 |
| JDK | Java | 17+ |
| 构建工具 | Maven | 3.8+ |

### 技术特性

- ✨ **主流技术栈**：采用 Spring Boot 3.2+、Spring Cloud 2023、Spring Cloud Alibaba 2023 最新版本
- 🚀 **企业级最佳实践**：基于 ContiNew Starter 封装的企业级组件，开箱即用
- 📦 **模块化设计**：公共模块、业务模块清晰分离，便于维护和扩展
- 🔐 **完善的安全体系**：基于 SaToken 的认证鉴权，支持 XSS 防护、数据脱敏、字段加密等
- 📊 **数据权限控制**：支持多租户、数据权限隔离
- 📝 **接口文档自动生成**：基于 Spring Doc + Knife4j
- 🎯 **链路追踪**：自动生成 TraceId，方便问题排查
- 💾 **多级缓存**：Caffeine + Redis 多级缓存策略
- 📈 **完善的日志体系**：操作日志、登录日志自动记录

## 项目结构

```
loo-cloud-admin/
├── loo-cloud-common/              # 公共模块父工程
│   ├── loo-cloud-common-core/     # 核心公共模块
│   ├── loo-cloud-common-web/      # Web 公共模块
│   ├── loo-cloud-common-security/ # 安全公共模块
│   ├── loo-cloud-common-swagger/  # 接口文档公共模块
│   ├── loo-cloud-common-log/      # 日志公共模块
│   ├── loo-cloud-common-mybatis/  # 数据访问公共模块
│   └── loo-cloud-common-redis/    # 缓存公共模块
├── loo-cloud-gateway/             # 网关服务（端口：8080）
├── loo-cloud-auth/                # 认证授权服务（端口：8081）
├── loo-cloud-system/              # 系统管理服务（端口：8082）
│   ├── loo-cloud-system-api/      # 系统服务 API 模块
│   └── loo-cloud-system-biz/      # 系统服务业务模块
└── loo-cloud-modules/             # 业务模块父工程
    └── loo-cloud-module-demo/     # 示例业务模块
        ├── loo-cloud-module-demo-api/
        └── loo-cloud-module-demo-biz/
```

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.8+
- MySQL 5.7+ / 8.0+
- Redis 5.0+
- Nacos 2.2+

### 本地开发

1. **克隆项目**

```bash
git clone [your-repository-url]
cd loo-cloud-admin
```

2. **安装依赖**

```bash
mvn clean install -DskipTests
```

3. **启动 Nacos**

下载并启动 Nacos 服务（默认地址：http://127.0.0.1:8848）

4. **启动 MySQL**

创建数据库并导入初始化脚本（待完善）

5. **启动 Redis**

启动 Redis 服务（默认端口：6379）

6. **启动服务**

按照以下顺序启动各个服务：

```bash
# 1. 启动网关服务
cd loo-cloud-gateway
mvn spring-boot:run

# 2. 启动认证服务
cd loo-cloud-auth
mvn spring-boot:run

# 3. 启动系统服务
cd loo-cloud-system/loo-cloud-system-biz
mvn spring-boot:run
```

7. **访问服务**

- 网关服务：http://localhost:8080
- 认证服务接口文档：http://localhost:8081/doc.html
- 系统服务接口文档：http://localhost:8082/doc.html

## ContiNew Starter 集成

本项目基于 ContiNew Starter 2.14.0 构建，集成了以下模块：

### 核心模块
- `continew-starter-core`：线程池配置、通用工具类增强
- `continew-starter-web`：Web 开发基础能力（跨域、全局异常、响应封装、链路追踪）
- `continew-starter-validation`：参数校验增强
- `continew-starter-json-jackson`：JSON 处理

### 接口文档
- `continew-starter-api-doc`：Spring Doc + Knife4j 接口文档

### 缓存
- `continew-starter-cache-redisson`：Redis 客户端、分布式锁
- `continew-starter-cache-jetcache`：多级缓存（本地 + Redis）

### 认证授权
- `continew-starter-auth-satoken`：轻量级认证鉴权框架
- `continew-starter-auth-justauth`：第三方登录

### 数据访问
- `continew-starter-data-mp`：MyBatis Plus 集成
- `continew-starter-extension-crud-mp`：通用 CRUD 接口
- `continew-starter-extension-datapermission-mp`：数据权限控制
- `continew-starter-extension-tenant-mp`：多租户支持

### 安全
- `continew-starter-encrypt-field`：数据库字段加密
- `continew-starter-encrypt-password-encoder`：密码编码器
- `continew-starter-security-mask`：JSON 数据脱敏
- `continew-starter-security-xss`：XSS 攻击防护
- `continew-starter-security-sensitivewords`：敏感词过滤

### 其他
- `continew-starter-ratelimiter`：接口限流
- `continew-starter-idempotent`：接口幂等性
- `continew-starter-trace`：链路追踪
- `continew-starter-captcha-graphic`：图形验证码
- `continew-starter-captcha-behavior`：行为验证码
- `continew-starter-log-core`、`continew-starter-log-aop`：日志记录
- `continew-starter-excel-fastexcel`：Excel 处理
- `continew-starter-messaging-mail`：邮件发送
- `continew-starter-messaging-websocket`：WebSocket 通信

更多 ContiNew Starter 信息请访问：https://continew.top/docs/starter/

## 开发规范

### 代码分层

- **Controller 层**：接收 HTTP 请求，参数校验，调用 Service
- **Service 层**：业务逻辑编排，事务控制
- **Mapper 层**：数据访问
- **Model 层**：数据模型定义（Entity、DTO、VO、Query）

### 命名规范

- 查询单个：`getXxxById`、`getXxxByName`
- 查询列表：`listXxx`、`pageXxx`
- 新增：`createXxx`、`addXxx`
- 修改：`updateXxx`、`modifyXxx`
- 删除：`deleteXxx`、`removeXxx`

### 包结构

```
com.loo.cloud.{service-name}
├── controller      # 控制器层
├── service         # 服务层
│   └── impl        # 服务实现
├── mapper          # 数据访问层
├── model           # 模型层
│   ├── entity      # 实体类
│   ├── dto         # 数据传输对象
│   ├── vo          # 视图对象
│   └── query       # 查询对象
├── config          # 配置类
├── constant        # 常量类
├── enums           # 枚举类
└── util            # 工具类
```

## 贡献指南

欢迎提交 Issue 和 Pull Request！

## 许可证

[MIT License](LICENSE)

## 致谢

感谢以下优秀的开源项目：

- [Spring Boot](https://spring.io/projects/spring-boot)
- [Spring Cloud](https://spring.io/projects/spring-cloud)
- [Spring Cloud Alibaba](https://github.com/alibaba/spring-cloud-alibaba)
- [ContiNew Starter](https://github.com/continew-org/continew-starter)
- [MyBatis Plus](https://baomidou.com/)
- [Sa-Token](https://sa-token.cc/)
- [Redisson](https://redisson.org/)
- [Knife4j](https://doc.xiaominfo.com/)