# foundryx

**Repository Path**: Little-Orange-O/foundryx

## Basic Information

- **Project Name**: foundryx
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# foundryx 微服务脚手架学习项目

## 项目说明

本项目为个人技术学习与架构沉淀项目，基于 Spring Cloud 微服务体系构建，旨在实践微服务工程化、组件封装、中间件适配等相关技术，搭建可复用的微服务脚手架原型，用于个人技术积累与学习实践，不涉及生产部署、不用于商业用途。

## 核心模块结构（共24个，按功能分类）

### 一、父工程与依赖管理模块

- fx-parent：项目根父工程，统一管理所有子模块的依赖版本、构建配置，是整个微服务脚手架的核心依赖入口，规范项目整体依赖体系。

- fx-middleware-dependencies：中间件专属依赖管理模块，统一管控各类中间件（Kafka、Redis、Zookeeper等）的依赖版本，避免版本冲突。

- fx-shared-dependencies：共享组件依赖管理模块，统一管理共享核心、异常、响应等通用组件的依赖版本，实现依赖标准化。

- fx-web-dependencies：Web层依赖管理模块，统一管理Web相关组件、启动器的依赖版本，简化Web模块搭建。

### 二、基础核心模块

- fx-base：基础核心模块，封装微服务通用工具类、全局配置、基础常量等核心能力，为所有子模块提供基础支撑。

- fx-base-auth：认证授权核心模块，基于DDD分层设计，实现认证服务、权限校验等核心逻辑，构建微服务统一认证体系。

- fx-base-gateway：微服务网关模块，封装路由转发、限流、鉴权等网关核心能力，作为微服务入口，统一管控接口访问。

- fx-base-idgenerator：分布式ID生成器模块，实现多种ID生成策略（如雪花算法），适配微服务分布式场景下的ID唯一需求。

### 三、中间件适配模块

- fx-middleware：中间件基础适配层，统一管理各类中间件的适配入口，规范中间件调用方式，降低模块间耦合。

- fx-middleware-kafka：Kafka中间件适配模块，封装Kafka生产者、消费者的通用操作，简化Kafka消息队列的集成与使用。

- fx-middleware-mybatis：MyBatis中间件适配模块，封装MyBatis通用Mapper、分页、事务管理等能力，简化数据访问层开发。

- fx-middleware-redis：Redis中间件适配模块，封装Redis通用操作、分布式锁、缓存预热等能力，满足微服务缓存需求。

- fx-middleware-zookeeper：Zookeeper中间件适配模块，封装Zookeeper连接管理、配置同步、分布式协调等基础能力，支撑微服务注册与发现。

### 四、共享组件模块

- fx-share-resources：共享资源模块，存放项目通用资源、配置文件、枚举类、静态资源等，实现资源共享与统一管理。

- fx-shared-annotation：共享注解模块，定义项目通用注解（如权限注解、日志注解、参数校验注解等），规范代码开发规范。

- fx-shared-cloud-client-starter：空项目，仅用于组织微服务云客户端相关依赖，无实际业务代码，核心作用是统一管理pom依赖。

- fx-shared-cloud-starter：云服务共享启动器模块，整合微服务云相关通用依赖与自动配置，简化微服务云组件的集成。

- fx-shared-core：共享核心模块，封装项目通用核心逻辑、工具类、基础模型，为各业务模块提供通用能力支撑。

- fx-shared-exception：共享异常模块，定义全局异常类型、异常处理策略，实现微服务统一异常响应格式。

- fx-shared-response：共享响应模块，封装接口统一返回体、响应码、响应消息，规范微服务接口响应格式。

- fx-shared-web-starter：Web共享启动器模块，整合Web层通用依赖（如拦截器、过滤器）与自动配置，简化Web项目搭建。

### 五、Web层模块

- fx-web：Web基础模块，提供Web项目通用启动模板、基础配置、接口规范，支撑微服务Web层开发。

- fx-web-core：Web核心模块，补充Web层核心功能封装（如请求参数解析、响应处理），适配各类Web开发场景。

- fx-web-starter：Web启动器模块，整合Web层核心依赖与自动配置，实现Web项目快速启动、开箱即用。

- fx-cloud-starter：微服务Cloud启动器模块，整合Spring Cloud核心组件依赖，简化微服务集群搭建与配置。

## 核心技术栈

Spring Boot、Spring Cloud Alibaba、MyBatis、Redis、Kafka、Zookeeper、Spring Cloud Gateway、DDD领域驱动设计

## 项目定位

个人技术学习与架构沉淀项目，聚焦微服务工程化实践、组件封装、中间件适配，搭建标准化微服务脚手架原型，用于积累微服务开发相关经验与可复用代码片段。

## 项目说明补充

本项目为个人学习实践项目，核心用于技术验证与能力沉淀，各模块围绕微服务开发核心需求设计，实现通用能力的封装与复用，为后续微服务项目开发提供参考。