Skip to content
wzkrisPublic

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

wzkris-cloud

version JDK Spring Boot Spring Cloud

Spring Boot 4.0.8 + Spring Cloud 2025.1.3 + Spring Cloud Alibaba 2025.1.0.0 + JDK 21 的多应用微服务工程。 统一身份域承载所有注册应用:应用之间以 system_id 收窄数据、以角色授权隔离权限,无租户维度。

能力

能力 实现
统一身份 一套 system_user 覆盖全部注册应用(business_system);域在登录时声明一次
令牌 auth-service 是唯一签发方:JWT 签发 / 续期 / 撤销 + JWK 分发,网关本地验签
会话 会话快照存 Redis;网关按令牌坐标还原一次并写入下游请求头,下游不回查认证中心
数据域 ORM 统一处理:读改写 where、写归位实体域,DDL system_id NOT NULL 兜底
权限 角色 / 菜单 / 端点授权 + 角色继承,唯一入口 @CheckPerms
日志 登录、操作日志由切面发布事件,经 RPC 汇入 user-infra 落库
验证码与风控 proof-service 统一 /captcha 派发(图形 / 滑块 / 算力),换发风控通行票;网关按路径强制
灰度路由 route-decision 策略(CLOSE / OPEN / FORCE)+ 实例元数据标签 + X-LB-Hint 透传
支付 渠道 SPI(微信 / 支付宝)、原子额度预留防超退、回调验签与幂等、商户通知 outbox
横向组件 幂等、分布式锁、限流熔断、Excel、字段脱敏、告警通知

请求链路

client → gateway :10001 ─┬─ 验签 → 查会话快照(auth /session/query)
                         ├─ 注入 X-User-Context / X-Tracing-Id / X-LB-Hint
                         └─ 按路径前缀转发
  • 下游仅从头还原上下文(UserContextFilter),不产生额外 RPC
  • 头值是上下文 JSON 的 Base64(URL-safe)编码:HTTP 头只接受 ASCII,角色名、部门名等含中文无法直传
  • 服务间 RPC 出站自动透传同一组头

远程调用:Spring 只认显式声明(官方入口 @ImportHttpServices),本项目用 @RpcScan(启动类声明扫描根)

  • @RpcClient(group, url)(接口自声明分组)替代,一个扫描根覆盖多服务接口,注册器在启动期校验分组与方法级 exchange 注解。寻址只由 spring.http.serviceclient.<group>.base-url 决定(lb://服务名 走注册中心, http(s)://地址 直连);该属性缺省时请求到运行期才失败,故启动期提前校验。

模块与端口

wzkris
├── sql/postgresql                  // user / payment / nacos 建库脚本
├── wzkris-bom                      // 版本清单
├── wzkris-common                   // 横切能力
│   ├── common-core                 // 模型、枚举、工具、异常
│   ├── common-orm                  // MyBatis-Plus 封装 + 数据域拦截器
│   ├── common-redis                // Redis、幂等、分布式锁
│   ├── common-security             // 身份上下文与 @CheckPerms
│   ├── common-web                  // 上下文过滤器、全局异常、Jackson、Facade 基类
│   ├── common-remote               // HTTP Service Client 契约与拦截器
│   ├── common-loadbalancer         // 灰度路由
│   ├── common-validator / excel / sentinel / notifier / weixin-sdk
├── wzkris-gateway            :10001 // SCG WebMVC,唯一入口
├── wzkris-auth-service       :9000  // 令牌、会话、JWK
├── wzkris-manage-agg         :4000  // 管理端聚合与登录入口,不落库
├── wzkris-proof-service      :9300  // 验证码与风控票,仅用 Redis
├── wzkris-modules-infra
│   ├── wzkris-user-infra     :3031  // 用户、角色、部门、菜单、日志
│   └── wzkris-payment-infra  :3032  // 下单、退款、余额、渠道配置
└── wzkris-extends
    ├── wzkris-monitor-admin  :9100  // 应用监控
    ├── wzkris-mqtt-server    :1883  // MQTT Broker
    └── wzkris-track          :9102  // 埋点采集

快速开始

依赖 版本 用途
JDK 21 开发与运行
Maven 3.6+ 构建
PostgreSQL 15+ 业务库(schema biz)与 Nacos 配置库
Redis 8.0+ 缓存、会话、锁
Nacos 3.x 注册发现与配置(配置存 PostgreSQL,脚本 sql/postgresql/nacos.sql)
# 1. 初始化:依次执行 user_db、payment_db、nacos.sql
# 2. 启动 Nacos 与 Redis,导入配置(命名空间 application-dev,分组 APPLICATION_GROUP / COMMON_GROUP)
# 3. 构建并启动(建议顺序)
mvn clean package -DskipTests

gateway(10001) → auth(9000) → proof(9300) → user-infra(3031) → payment-infra(3032) → manage-agg(4000)

访问:网关 http://localhost:10001;接口文档 <context-path>/doc.html;监控中心 http://localhost:9100

技术选型

场景 选择 备注
远程调用 HttpServiceProxyFactory 非 Feign;用 @RpcScan + @RpcClient 替代官方 @ImportHttpServices,接口自声明分组
网关 Spring Cloud Gateway WebMVC Servlet 栈,与业务服务同一套过滤器约定
对象映射 BeanCopierUtil 非 MapStruct
序列化 Jackson 3 Long / BigDecimal 输出为字符串,避免前端精度丢失
认证 Spring Security JWT (JOSE) 自建签发与 JWK 分发,不引入 OAuth2 授权服务器
接口文档 Knife4j OpenAPI 3,按服务聚合

相关项目

许可证

zlib License · 欢迎提交 Issue 与 Pull Request。

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages