# cws

**Repository Path**: zhulj/cws

## Basic Information

- **Project Name**: cws
- **Description**: 用于中心工作台快速开发，基于springcloudalibaba 开发微服务
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: cws_jdk17_saas
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2020-12-14
- **Last Updated**: 2023-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


## 系统说明

- 基于 Spring Cloud 2022 、Spring Boot 3.0、 OAuth2 的 RBAC **权限管理系统**
- 基于数据驱动视图的理念封装 element-plus，即使没有 vue 的使用经验也能快速上手
- 提供对常见容器化支持 Docker、Kubernetes、Rancher2 支持
- 提供 lambda 、stream api 、webflux 的生产实践



## 快速开始

### 核心依赖

| 依赖                   | 版本         |
| ---------------------- |------------|
| Spring Boot            | 3.0.0  |
| Spring Cloud           | 2022.0.0 |
| Spring Cloud Alibaba   | 2022.0.0.0-RC1 |
| Spring Authorization Server | 1.0.0 |
| Mybatis Plus           | 3.5.3     |
| hutool                 | 5.8.10     |

### 模块说明

```lua
cws-ui  

cws
├── cws-auth -- 授权服务提供[3000]
└── cws-common -- 系统公共模块
     ├── cws-common-bom -- 全局依赖管理控制
     ├── cws-common-core -- 公共工具类核心包
     ├── cws-common-datasource -- 动态数据源包
     ├── cws-common-job -- xxl-job 封装
     ├── cws-common-log -- 日志服务
     ├── cws-common-mybatis -- mybatis 扩展封装
     ├── cws-common-seata -- 分布式事务
     ├── cws-common-security -- 安全工具类
     ├── cws-common-swagger -- 接口文档
     ├── cws-common-feign -- feign 扩展封装
     └── cws-common-xss -- xss 安全封装
├── cws-register -- Nacos Server[8848]
├── cws-gateway -- Spring Cloud Gateway网关[9999]
└── cws-upms -- 通用用户权限管理模块
     └── cws-upms-api -- 通用用户权限管理系统公共api模块
     └── cws-upms-biz -- 通用用户权限管理系统业务处理模块[4000]
└── cws-visual
     └── cws-monitor -- 服务监控 [5001]
     ├── cws-codegen -- 图形化代码生成 [5002]
     ├── cws-sentinel-dashboard -- 流量高可用 [5003]
     └── cws-xxl-job-admin -- 分布式定时任务管理台 [5004]
```

### 本地开发 运行

#### 开发环境

| 工具        | 版本    | 备注     |
| ----------- | ------- | -------- |
| JDK         | 17+     | 强制要求 |
| Maven       | 3.5+    |          |
| MySQL       | 5.7.8 + | 强制要求 |
| Redis       | 3.2 +   |          |
| node        | 16+     | 强制要求 |
| 常用工具    | idea    | 非必须   |
| navicat     |         |          |
| switchHosts |         |          |

#### 服务端启动

##### 配置本地hosts

```
127.0.0.1   cws-mysql
127.0.0.1   cws-redis
127.0.0.1   cws-gateway
127.0.0.1   cws-register
127.0.0.1   cws-sentinel
127.0.0.1	cws-monitor
127.0.0.1	cws-job
127.0.0.1   cws-seata
```

##### 初始化数据库

```

核心数据库： cws/db/cws.sql
nacos配置： cws/db/cws_config.sql
代码生成脚本： cws/db/cws_codegen.sql
```

##### 配置文件修改

1、nocas数据库源信息

redis/mysql的相关配置在nacos中，启动cws-register后进行修改

2、redis信息

3、mysql数据源

#### 前端启动

##### 安装依赖

```
npm i
```

##### 启动

```
npm run dev
```



### Docker 运行

```
# 下载并运行服务端代码

cd cws && mvn clean install && docker-compose up -d

# 下载并运行前端UI

cd cws-ui && npm install -g cnpm --registry=https://registry.npm.taobao.org

cnpm install && cnpm run build:docker && cd docker && docker-compose up -d
```