Skip to content
View wzkris's full-sized avatar
🤒
Out sick
🤒
Out sick

Block or report wzkris

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
wzkris/README.md

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。

Pinned Loading

  1. wzkris wzkris Public

    Java 2

  2. waoowaoo waoowaoo Public

    Forked from waooAI/waoowaoo

    首家工业级全流程 AI 影视生产平台。Industry-first professional AI Agent platform for controllable film & video production. From shorts to live-action with Hollywood-standard workflows.

    TypeScript