# cat-cloud

**Repository Path**: wenxpro/catcat-cloud

## Basic Information

- **Project Name**: cat-cloud
- **Description**: 猫云-spring微服务
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-18
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cat Cloud - 云原生多租户管理平台

基于 Spring Cloud 微服务架构的多租户管理平台，提供统一认证授权、租户管理、权限管理等核心能力。

## 架构

```
前端 (React) → 网关 (Spring Gateway) → 服务 (Auth/System)
                                              ↓
                                    MySQL / Redis / Nacos
```

## 核心功能

- **统一认证** - OAuth2 + JWT，支持平台/租户两级用户
- **租户管理** - 租户创建、配置、数据隔离
- **权限管理** - RBAC 模型，资源:操作 权限格式
- **系统管理** - 用户、角色、菜单、部门、团队

> **注意**：当前平台用户和租户用户共用数据模型（通过 `user_type` 区分），未来版本将拆分。

## 技术栈

| 后端 | 前端 |
|------|------|
| Java 17 / Spring Boot 3.x | React 18 / TypeScript |
| Spring Cloud Gateway | Vite / Ant Design 5 |
| Spring Authorization Server | Zustand / React Query |
| MyBatis-Plus / MySQL 8 | Node.js 16+ |
| Redis / Nacos / Jaeger | |

## 快速开始

### 1. 初始化数据库
```bash
mysql -u root -p < cat-scripts/platform-schema.sql
mysql -u root -p < cat-scripts/platform-init-data.sql
```

### 2. 配置环境变量
```bash
export MYSQL_PASSWORD=your_password
export REDIS_PASSWORD=your_password
export NACOS_SERVER_ADDR=localhost:8848
export REMEMBER_ME_KEY=your_key
export CLIENT_SECRET=your_secret
```

### 3. 启动服务
```bash
# 后端
mvn clean install -DskipTests
cd cat-portal/cat-auth && mvn spring-boot:run
cd cat-portal/cat-gateway && mvn spring-boot:run
cd cat-module/cat-system && mvn spring-boot:run

# 前端
cd cat-web && npm install && npm run dev
```

访问 http://localhost:5173

## 项目结构

```
catcat-cloud/
├── cat-portal/
│   ├── cat-auth/         # 认证授权服务
│   └── cat-gateway/      # API 网关
├── cat-module/
│   ├── cat-system/       # 系统管理服务
│   └── cat-system-infra/ # 基础设施
├── cat-web/              # 前端项目
├── cat-deploy/           # K8s 部署配置
└── cat-scripts/          # 数据库脚本
```

## 配置说明

| 环境变量 | 说明 | 默认值 |
|----------|------|--------|
| MYSQL_PASSWORD | 数据库密码 | changeme |
| REDIS_PASSWORD | Redis 密码 | - |
| NACOS_SERVER_ADDR | Nacos 地址 | localhost:8848 |
| REMEMBER_ME_KEY | 记住我密钥 | changeme-remember-me-key |
| CLIENT_SECRET | OAuth2 密钥 | changeme-client-secret |

## API 文档

- 网关聚合：http://localhost:8080/doc.html
- 认证服务：http://localhost:8992/v3/api-docs
- 系统服务：http://localhost:8991/v3/api-docs

## 部署

```bash
cd cat-deploy
./build-push.sh
```

详见 [cat-deploy/README.md](cat-deploy/README.md)

## 许可证

MIT License