xuxiaowei-cloud

徐晓伟微服务

基于 JDK 8、Spring Boot 2.7.x、OAuth 2.1、Vite 3、Vue 3、Element Plus 的微服务

为简化开发工作、提高生产率、解决常见问题而生

代码格式规范 spring-javaformat

IntelliJ IDEA
项目添加 io.spring.javaformat:spring-javaformat-maven-plugin 依赖之后，可安装自动格式化插件（无需运行下列命令）：spring-javaformat-intellij-idea-plugin
```
./mvnw spring-javaformat:apply
```
或
```
mvn spring-javaformat:apply
```

阿里云盘分享

模块

依赖分析

cloud.xuxiaowei
├──xuxiaowei-cloud-starter-parent           // 微服务父模块
│    └──gateway                             // 网关服务
│    └──admin-server                        // 监控（管理）服务
│    └──passport-ui                         // 登录服务UI
│    └──passport                            // 登录服务
│    └──ui                                  // UI
│    └──resource-services-parent            // 资源服务父模块
│        └──canal                           // 阿里巴巴 MySQL binlog 增量订阅、消费服务
│        └──user                            // 用户服务
│        └──websocket                       // WebSocket 服务
│        └──webservice                      // WebService 服务
│        └──wechat-miniprogram              // 微信小程序服务
│        └──wechat-offiaccount              // 微信公众号服务
│    └──utils                               // 工具类
│    └──cloud-commons-parent                // 微服务公共组件父模块
│        └──cloud-starter-core              // 核心组件
│        └──cloud-starter-idempotent        // 幂等组件
│        └──cloud-starter-loadbalancer      // 负载均衡组件
│        └──cloud-starter-log               // 日志组件
│        └──cloud-starter-mybatis           // MyBatis 组件
│        └──cloud-starter-oauth2            // OAuth2 组件
│        └──cloud-starter-openfeign         // OpenFeign 组件
│        └──cloud-starter-redis             // Redis 组件
│        └──cloud-starter-session-redis     // Session Redis 组件
│        └──cloud-starter-validation        // 验证组件
│    └──xxl-job-admin                       // XXL JOB Admin
│    └──example-parent                      // 示例模块（独立模块）
│        └──oauth2-client                   // OAuth 2.0 客户端（独立服务）
│        └──cxf-client                      // CXF 2.0 客户端（独立服务）

端口

模块	模块名称	域名（虚拟）	端口
Nacos	注册、配置中心	nacos.example.xuxiaowei.cloud	8848
MySQL	数据库	mysql.example.xuxiaowei.cloud	3306
Redis	数据库	redis.example.xuxiaowei.cloud	6379
canal-deployer	阿里巴巴 MySQL binlog 增量订阅&消费组件	canal-deployer.example.xuxiaowei.cloud	11111

ui	UI	example.xuxiaowei.cloud	1001
gateway	网关	gateway.example.xuxiaowei.cloud	1101
admin-server	监控（管理）	admin-server.example.xuxiaowei.cloud	1201
passport	登录	passport.example.xuxiaowei.cloud	1401
passport-ui	登录UI	passport.example.xuxiaowei.cloud	1411
canal	阿里巴巴 MySQL binlog 增量订阅、消费服务		1601
user	用户服务		1701
websocket	WebSocket 服务		1801
webservice	WebService 服务		1901
wechat-miniprogram	微信小程序服务		2001
wechat-offiaccount	微信公众号服务		2101
xxl-job-admin	XXL Job Admin		2101
oauth2-client	OAuth 2.0 客户端（独立服务）		10001
cxf-client	CXF 客户端（独立服务）		10002

用户名与密码

账户名	密码	启用
xuxiaowei	123	1

XXL Job

地址	账户名	密码
http://127.0.0.1:2101/xxl-job-admin	admin	123456

权限

账户名	权限	说明
xuxiaowei	audit_authorization_consent_delete	删除授权同意书
xuxiaowei	audit_authorization_consent_read	查看授权同意书
xuxiaowei	audit_authorization_delete	删除授权记录
xuxiaowei	audit_authorization_read	查看授权记录
xuxiaowei	clientId_token_delete	客户Token 删除权限
xuxiaowei	manage_client_add	管理客户添加权限
xuxiaowei	manage_client_delete	管理客户删除权限
xuxiaowei	manage_client_edit	管理客户修改权限
xuxiaowei	manage_client_read	管理客户读取权限
xuxiaowei	manage_user_add	管理用户查询权限
xuxiaowei	manage_user_authority	管理用户授权权限
xuxiaowei	manage_user_delete	管理用户删除权限
xuxiaowei	manage_user_edit	管理用户修改权限
xuxiaowei	manage_user_read	管理用户查询权限
xuxiaowei	username_token_delete	用户Token 删除权限
xuxiaowei	user_authorities	查看用户权限
xuxiaowei	user_details	查看用户详情
xuxiaowei	user_info	查看用户信息
xuxiaowei	user_oauth2_oauth2Request	查看 oauth2 用户请求
xuxiaowei	user_oauth2_userAuthentication	查看 oauth2 用户身份验证

客户ID与秘钥

字段	id	client_id	client_id_issued_at	client_secret	client_secret_expires_at	client_authentication_methods	authorization_grant_types	redirect_uris	scopes	require-authorization-consent	access-token-time-to-live	refresh-token-time-to-live
说明	主键	客户ID	客户ID发布时间	客户秘钥	客户秘钥过期时间	授权认证方法	授权类型	授权码重定向地址	范围	是否需要客户授权同意	授权Token有效时间	刷新Token有效时间
	1	xuxiaowei_client_id	2022-05-30 17:17:41	xuxiaowei_client_secret		client_secret_post,client_secret_basic	refresh_token,implicit,client_credentials,authorization_code	http://127.0.0.1:1401/code,http://gateway.example.xuxiaowei.cloud:1101/passport/code,https://gateway.example.xuxiaowei.cloud/passport/code	snsapi_base,snsapi_info	false	43200	2592000
微信小程序使用	2	xuxiaowei_client_wechat_miniprogram_id	2022-05-30 17:17:41	xuxiaowei_client_wechat_miniprogram_secret		client_secret_post,client_secret_basic	refresh_token,wechat_miniprogram		snsapi_base,snsapi_info	false	43200	2592000

authorization_grant_types
- 授权码模式 authorization_code
- 刷新Token权限 refresh_token
- 客户端凭证模式 client_credentials
- 密码模式 password
- 简化模式 implicit
- 微信小程序（个人开发适配 OAuth 2.1、微信小程序的授权方式） wechat_miniprogram

Docker 说明

常用 exe 说明

Git

Gitlab Runner

Linux 脚本说明

SQL

Windows 脚本说明

仓库与分支？

使用了哪四个仓库？
1. Gitee
2. GitCode
3. GitHub
4. GitLab
上述四个仓库以哪个为准？其余仓库合适同步？
1. 以 Gitee 为准
2. 其余仓库每日同步
各个仓库的作用？
1. Gitee 供国内用户访问、提问、下载资源
2. GitLab 2022-06-06 之前使用 GitLab 的 CICD 流水线自动构建资源（.jar、.jar.asc 、.pom、.pom.asc、-javadoc.jar、-javadoc.jar.asc、-sources.jar、-sources.jar.asc），自动将资源发布（目前仅打包，未发布）到中央仓库
3. GitCode 2022-06-06 之后用于替换 GitLab 的 CICD 流水线， GitCode 流水线配额 2000 分钟（已申请到内侧资格）
4. GitHub 使用 CodeQL 每日扫描项目中的 main 分支是否存在漏洞
各分支的作用？
1. main
  - 主分支
  - 不可推送，只能合并
2. xuxiaowei
  - 个人分支，按功能PR到主分支main
3. pages
  - 文档分支
4. OAuth2.0
  - 历史版本分支，使用 OAuth 2.0 进行授权，后续不再维护（主分支使用 OAuth 2.1）
5. only-passport
  - 删除了passport-ui模块，在passport中使用CDN引入element-plus、vue进行网页编写（不推荐，后续不再维护）