该项目目的提供一套可以快速开发微服务的框架，并作为个人工作经验技术的总结和提炼。
目标：向企业级开发框架靠拢
| 类别 | 技术 | 版本 |
|---|---|---|
| 基础框架 | JDK、Spring Boot、Spring Cloud Alibaba | 17+、3.2.7、2023.0.3.2 |
| 数据存储 | MySQL、Redis | 8.0+、7.0+ |
| 消息队列 | RabbitMQ | 3.12+ |
| 微服务 | Nacos（注册中心/配置中心）、Dubbo（RPC框架） | 2.3+、3.3.0（Dubbo协议） |
| ORM框架 | MyBatis-Plus | 3.5.16 |
| 工具库 | Hutool | 5.8.29 |
| 前端技术 | Vue 3、TypeScript、Vite、Element Plus | 3.5+、5.9+、7.0+、2.13+ |
| 前端架构 | pnpm Workspace Monorepo | 9.15+ |
| 构建工具 | Gradle | 8.8+ |
具体版本详情查看 build.gradle 及各模块 build.gradle
- 模块化设计：按功能维度模块化拆分，实现功能依赖可插拔引用
- Starter封装：类似Spring Boot Starter，内置自动化配置能力
- 响应式网关：基于Spring Cloud Gateway的非阻塞响应式网关
- 网关运维平台：独立的网关管理后台，支持渠道/路由/配置的动态管理
- Dubbo RPC：基于Dubbo协议的服务调用，支持CompletableFuture原生异步接口，实现同步Provider与响应式Consumer的无缝对接
- 多渠道接入：网关支持多渠道对接，包含签名验证、报文加解密等功能
- 操作日志：通过注解自动记录操作日志，支持敏感数据脱敏
- 代码生成：内置代码生成器，快速生成CRUD代码
- 配置热更新：通过Nacos实现配置的动态推送和热更新
采用企业级工程划分：按功能维度模块化拆分策略，将各核心能力封装为独立可发布的依赖库（类似 Spring Boot Starter）：
- 实现模块间依赖隔离与单一功能聚合，实现功能依赖可插拔引用，降低模块耦合性
- Starter 内置自动化配置能力，外部引用时可通过自定义配置灵活覆盖依赖库默认参数
- 后续功能迭代或重大调整可通过发布新版本依赖包支撑持续交付，最终使工程架构达成高内聚、低耦合的管理目标
| 模块名称 | 功能 | 说明 |
|---|---|---|
| blink-framework-common | 通用类封装 | 工具类、常量、基础DTO等 |
| blink-datasource-starter | MySQL数据库支持 | 数据源配置、MyBatis-Plus、代码生成器 |
| blink-redis-starter | Redis客户端支持 | 缓存操作、分布式ID生成 |
| blink-framework-validation | 数据校验支持 | 自定义校验注解 |
| blink-framework-mq | RabbitMQ支持 | 消息队列封装 |
| blink-framework-openfeign | RPC调用封装 | OpenFeign配置（同步服务调用） |
| blink-web-starter | WebApp通用功能 | 全局异常处理、日志、缓存预热等 |
| blink-log-starter | 日志组件 | 操作日志入库、敏感数据脱敏、Controller日志 |
| 模块名称 | 功能 | 说明 |
|---|---|---|
| blink-base | RBAC后台管理服务 | 用户、角色、权限、菜单、字典管理等 |
| ├─ blink-base-app | 后端实现 | Spring Boot 服务实现 |
| ├─ blink-base-api-dubbo | Dubbo接口定义 | BaseDubboService接口及DTO |
| ├─ blink-base-api | Feign接口定义 | OpenFeign接口定义（同步调用） |
| blink-gateway | 网关服务集群 | API网关与运维管理 |
| ├─ blink-gateway-reactive | 响应式网关 | 路由转发、认证鉴权、加解密、限流 |
| ├─ gateway-admin | 网关运维平台 | 渠道/路由/配置管理、监控运维 |
| ├─ blink-gateway-admin-api-dubbo | Dubbo接口定义 | GatewayAdminDubboService |
| frontend | 前端 Monorepo | 共享组件库 + 两个管理应用 |
| ├─ packages/components | 共享组件库 | @blink/components |
| ├─ packages/base-admin | Base Admin 前端 | Vue3 前端 (端口 4000) |
| ├─ packages/gateway-admin | Gateway Admin 前端 | Vue3 前端 (端口 3001) |
各个模块的具体功能详情，请查看各个模块的README文档
本项目采用Dubbo 3.3作为RPC框架，使用Dubbo协议进行服务通信。
Dubbo 3.x 对 CompletableFuture 返回类型的接口有专门的处理，实现真正的非阻塞异步调用：
- Consumer 调用异步方法后，通过 Netty NIO 发送请求，当前线程不阻塞
- 响应到达时，Netty EventLoop 线程触发回调，自动完成 CompletableFuture
blink-base-app 作为服务提供者，实现 BaseDubboService 接口，提供同步方法和异步方法：
@DubboService(interfaceClass = BaseDubboService.class)
public class BaseDubboServiceImpl implements BaseDubboService {
// 同步方法
@Override
public ResponseDTO<T> getOneConfig(RequestDTO<T> reqDto) {
// 业务逻辑...
}
// 异步方法 - 返回 CompletableFuture
@Override
public CompletableFuture<ResponseDTO<T>> getOneConfigAsync(RequestDTO<T> reqDto) {
return CompletableFuture.supplyAsync(() -> getOneConfig(reqDto), ioThreadPool);
}
}blink-gateway-reactive 作为响应式消费者，通过 Dubbo 原生异步接口实现响应式返回：
// 接口定义 - 直接返回 CompletableFuture
public interface BaseDubboService {
CompletableFuture<ResponseDTO<T>> getOneConfigAsync(RequestDTO<T> reqDto);
}
// Consumer 调用 - Dubbo 内部非阻塞网络通信
public class BaseAppDubboService {
private final BaseDubboService baseDubboService;
public Mono<SomeResult> someMethod(RequestDTO<T> reqDto) {
// 调用异步方法，Dubbo 通过 Netty NIO 发送请求，不阻塞当前线程
CompletableFuture<ResponseDTO<T>> future = baseDubboService.getOneConfigAsync(reqDto);
return Mono.fromFuture(future)
.subscribeOn(Schedulers.boundedElastic()) // 指定调度器，避免阻塞 Netty EventLoop
.mapNotNull(response -> response.getBody());
}
}dubbo:
application:
name: base-app
registry:
address: nacos://localhost:8848
protocol:
name: dubbo # 使用 Dubbo 协议
port: -1 # 自动分配端口
consumer:
check: false # 启动时不检查 Provider
timeout: 10000 # 调用超时时间| 工具 | 版本要求 |
|---|---|
| JDK | 17+ |
| Gradle | 8.8+ |
| MySQL | 8.0+ |
| Redis | 7.0+ |
| Nacos | 2.3+ |
| Nexus（可选） | 3.x |
下载项目后，可以在 build.gradle 修改私库配置，gradle执行publish任务打包发布各模块到私库。如果没有私库，可以配置为本地仓库。
使用IDEA创建新工程，或者下载本项目后在根目录上添加新模块，编写gradle构建脚本引入依赖：
dependencies {
implementation 'com.blink:blink-web-spring-boot-starter:1.0.0-SNAPSHOT'
implementation 'com.blink:blink-redis-spring-boot-starter:1.0.0-SNAPSHOT'
implementation 'com.blink:blink-dataSource-spring-boot-starter:1.0.0-SNAPSHOT'
implementation 'com.blink:blink-log-spring-boot-starter:1.0.0-SNAPSHOT'
implementation 'com.blink:blink-framework-common:1.0.0-SNAPSHOT'
implementation 'com.blink:blink-framework-validation:1.0.0-SNAPSHOT'
}参考 blink-base-app 或 blink-gateway-reactive 的配置文件，配置 Redis、Nacos、MySQL 等中间件连接信息。
使用类 CodeGenerator 生成代码：
public static void main(String[] args) {
String url = "jdbc:mysql://localhost:3306/blink?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8";
String username = "root";
String password = "123456";
var codeGenerator = new CodeGenerator();
codeGenerator.generateByCustomTemplate(url, username, password);
}运行后按输入数据表名可根据数据表信息自动生成：
- Controller、Service、ServiceImpl、Mapper、mapper.xml、DO实体
- CRUD相关的DTO
生成成功控制台显示：
请输入作者名称！
blink
请输入应用包名（已有前缀com.blink）！
请输入表名，多个英文逗号分隔 生成所有表则输入all ！
sys_user
请输入要过滤的表前缀，多个英文逗号分隔 都不过滤输入none字符串！
none
请选择模板类型输入1或者2（1.DTO 2.record）
1
18:21:57.113 [main] DEBUG com.baomidou.mybatisplus.generator.AutoGenerator -- ==========================文件生成完成！！！==========================
默认生成地址在项目根目录中，随后将生成的代码拖入项目对应目录即可。
@SpringBootApplication
@EnableDiscoveryClient
public class BlinkBaseAppApplication {
public static void main(String[] args) {
SpringApplication.run(BlinkBaseAppApplication.class, args);
}
}运行启动类，到此微服务应用构建完毕，可以进行业务开发了。
前端采用 pnpm Workspace Monorepo 架构，统一管理共享组件库和两个应用。
cd frontend
# 安装依赖
pnpm install
# 启动 Base Admin (端口 4000)
pnpm dev:base
# 启动 Gateway Admin (端口 3001)
pnpm dev:gateway详细文档：frontend/README.md
RBAC后台管理服务，具有用户、角色、权限、菜单、字典、操作日志等CRUD接口，是企业中必不可少的应用。除了RBAC外还提供：
- 系统参数管理
- 外接渠道管理
- 数据字典管理
- 错误消息管理
- 操作日志记录
模块结构：
blink-base-app: 后端服务实现blink-base-api-dubbo: Dubbo服务接口定义blink-base-api: Feign接口定义（同步调用）
详细文档：blink-base-app
网关服务集群，包含响应式API网关和运维管理平台。
基于Spring Cloud Gateway实现的响应式非阻塞网关：
- 请求路由转发（支持动态路由）
- 集中认证鉴权（JWT/Token）
- 多渠道接入管理
- 报文加密解密（AES+RSA混合加密）
- 签名验证（SHA-256）
- 限流熔断（Redis令牌桶）
- Dubbo服务响应式调用
- 防重放攻击保护
网关运维管理平台，提供渠道管理、路由管理、配置管理、监控运维等核心功能：
- 渠道管理：外部渠道接入、密钥管理、Token签发
- 路由管理：动态路由配置、路由刷新
- 配置管理：系统参数配置、IP黑白名单
- 配置推送：Nacos配置推送、版本管理、配置回滚
- 数据同步：配置数据同步到网关实例
- 实例管理：网关实例上下线、健康监控
- 监控中心：实例状态、统计数据、健康检查
通过 Dubbo RPC 与网关实例通信，实现配置的动态推送和实时监控。
详细文档：gateway-admin
前端 Monorepo 项目，基于 pnpm Workspace 架构：
模块结构：
packages/components: 共享组件库@blink/componentspackages/base-admin: Base Admin 前端应用 (端口 4000)packages/gateway-admin: Gateway Admin 前端应用 (端口 3001)
共享组件库主要导出：
- 布局组件：MainLayout、Sidebar、Header、TabsView、Breadcrumb
- 功能组件：ThemeToggle、LanguageSwitch、BlinkTable、ThemeSettings
- Composables：useSidebarState、useTabsState、useSubmitGuard、useTransition
- Directives：dataFadeDirective、rippleDirective
详细文档：frontend/README.md | frontend/RULES.md
┌─────────────────────────────────────────────────────────────────────────────┐
│ 前端层 (Frontend - pnpm Monorepo) │
├─────────────────────────────────────────────────────────────────────────────┤
│ packages/components (@blink/components) - 共享组件库 │
│ ├─ 布局: MainLayout, Sidebar, Header, TabsView, Breadcrumb │
│ ├─ 功能: ThemeToggle, LanguageSwitch, BlinkTable, ThemeSettings │
│ └─ Composables/Directives │
├─────────────────────────────┬───────────────────────────────────────────────┤
│ packages/base-admin │ packages/gateway-admin │
│ (Base Admin 前端) │ (Gateway Admin 前端) │
│ 端口: 4000 │ 端口: 3001 │
│ Vue3 + Element Plus │ Vue3 + Element Plus │
└───────────┬─────────────────┴───────────────────────┬───────────────────────┘
│ │
│ HTTP / HTTPS │
│ (经过网关统一入口) │
▼ ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ blink-gateway-reactive (响应式网关) │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │LogFilter│→│IpFilter │→│Header │→│Security │→│Sign │→│Route │ │
│ │ │ │ │ │Validate │→│Filter │→│Filter │→│Filter │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ 功能: 路由转发 / 认证鉴权 / 加解密 / 签名验证 / 限流熔断 / 防重放攻击 │
└──────────────────────┬──────────────────────────────────────────────────────┘
│
│ 路由转发
│
┌─────────────┼─────────────┐
│ │ │
▼ ▼ ▼
┌────────────────┐ ┌────────────────┐ ┌────────────────┐
│ blink-base-app │ │ gateway-admin │ │ 其他业务服务 │
│ (RBAC后端服务) │ │ (网关运维平台) │ │ │
│ 端口: 8001 │ │ 端口: 8008 │ │ │
└────────────────┘ └────────────────┘ └────────────────┘
│ │
│ Dubbo RPC │ Dubbo RPC / Nacos
│ │
▼ ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ 基础设施层 (Infrastructure) │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Nacos │ │ MySQL │ │ Redis │ │RabbitMQ │ │ Dubbo │ │
│ │注册/配置│ │ 数据 │ │ 缓存 │ │ 消息 │ │ RPC │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
正式生产环境 会添加一层 Nginx
开发测试环境为了方便调试，前端可直接连接后端服务：
┌─────────────────────────────────────────────────────────────────┐
│ frontend (pnpm Monorepo) │
│ ┌─────────────────────────┐ ┌───────────────────────────────┐ │
│ │ packages/base-admin │ │ packages/gateway-admin │ │
│ │ (Base Admin 前端) │ │ (Gateway Admin 前端) │ │
│ │ 端口: 4000 │ │ 端口: 3001 │ │
│ └───────┬─────────────────┘ └───────────┬───────────────────┘ │
└──────────┼─────────────────────────────────┼────────────────────┘
│ │
▼ ▼
┌─────────────────────┐ ┌─────────────────────┐
│ blink-base-app │ │ gateway-admin │
│ (RBAC后端服务) │ │ (网关运维平台) │
│ 端口: 8001 │ │ 端口: 8008 │
└─────────────────────┘ └─────────────────────┘
Vibe Coding项目开发规范请查看：CLAUDE.md
blink项目处于持续开发的状态，后续持续更新
另外求职 base深圳