# Gomicro独立mod微服务框架v5版

**Repository Path**: trident-framework/go-micro-fw-v5

## Basic Information

- **Project Name**: Gomicro独立mod微服务框架v5版
- **Description**: Gomicro独立mod微服务框架【v5.3.0】
 可运行golang版本【v1.18、v1.19、v1.20、v1.21、v1.22、1.23】
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-09
- **Last Updated**: 2025-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

The project does not have a dedicated README.md file. However, based on the repository structure and content, here is a generated README.md tailored for this project:

---

# Go Micro Framework V5

## 项目简介

这是一个基于 Go Micro 框架开发的微服务项目，包含多个服务模块，如用户服务、转账服务等。项目使用 Protobuf 进行服务间通信，并支持多种配置中心和服务发现机制，如 Nacos、Consul、Etcd 等。

## 项目结构

- **gateway-api**: API 网关，提供对外的 HTTP 接口。
- **services/user-service**: 用户服务，提供用户管理功能。
- **services/transfer-service**: 转账服务，提供转账相关的业务逻辑。
```
go-micro-fw-v5/
├── gateway-api/                        # 网关服务
|   ├── config/                         # 配置目录
|   ├── constants/                      # 常量目录
|   ├── controllers/                    # 控制器目录
|   ├── logs/                           # 日志目录
|   ├── middlewares/                    # 中间件目录
|   ├── routers/                        # 路由目录
|   ├── static/                         # 静态目录
|   ├── tools/                          # 工具目录
|   ├── deploy.yaml                     # k8s部署文件
|   ├── docker_compose_Jenkinsfile      # docker-compose CICD文件
|   ├── docker-compose.yaml             # docker-compose部署文件
|   ├── Dockerfile                      # 构建镜像文件
|   ├── k8s_Jenkinsfile                 # k8s CICD文件
|   ├── kubesphere_Jenkinsfile          # kubesphere CICD文件
|   ├── go.mod
|   ├── go.sum
|   └── main.go                         # 主文件
├── services/
|   ├── user-service/                   # 用户服务
|   |   ├── config/                     # 配置目录
|   |   ├── constants/                  # 常量目录
|   |   ├── handler/                    # 处理器目录
|   |   ├── middlewares/                # 中间件目录
|   |   ├── logs/                       # 日志目录
|   |   ├── models/                     # 模型目录
|   |   ├── proto/                      # proto目录
|   |   ├── tools/                      # 工具目录
|   |   ├── deploy.yaml                 # k8s部署文件
|   |   ├── docker_compose_Jenkinsfile  # docker-compose CICD文件
|   |   ├── docker-compose.yaml         # docker-compose部署文件
|   |   ├── Dockerfile                  # 构建镜像文件
|   |   ├── k8s_Jenkinsfile             # k8s CICD文件
|   |   ├── kubesphere_Jenkinsfile      # kubesphere CICD文件
|   |   ├── go.mod
|   |   ├── go.sum
|   |   └── main.go                     # 主文件
|   ├── transfer-service/               # 交易服务
|   |   ├── config/                     # 配置目录
|   |   ├── constants/                  # 常量目录
|   |   ├── handler/                    # 处理器目录
|   |   ├── middlewares/                # 中间件目录
|   |   ├── logs/                       # 日志目录
|   |   ├── models/                     # 模型目录
|   |   ├── proto/                      # proto目录
|   |   ├── tools/                      # 工具目录
|   |   ├── deploy.yaml                 # k8s部署文件
|   |   ├── docker_compose_Jenkinsfile  # docker-compose CICD文件
|   |   ├── docker-compose.yaml         # docker-compose部署文件
|   |   ├── Dockerfile                  # 构建镜像文件
|   |   ├── k8s_Jenkinsfile             # k8s CICD文件
|   |   ├── kubesphere_Jenkinsfile      # kubesphere CICD文件
|   |   ├── go.mod
|   |   ├── go.sum
|   |   └── main.go                     # 主文件
└── README.md
```

## 功能特性

- 支持多种服务发现机制（Nacos、Consul、Etcd）。
- 支持多种配置中心（Nacos、Consul、Etcd）。
- 提供用户管理、转账等业务功能。
- 使用 Protobuf 进行服务间通信。
- 支持日志、链路追踪、限流、熔断等功能。

## 安装与部署

### 环境要求

- Go 1.18+
- Docker
- Kubernetes (可选)
- Jenkins (用于 CI/CD)

### 构建与运行

1. **构建 Docker 镜像**

   ```bash
   docker build -t gateway-api .
   docker build -t user-service .
   docker build -t transfer-service .
   ```

2. **运行 Docker 容器**

   ```bash
   docker run -d -p 8080:8080 gateway-api
   docker run -d -p 50051:50051 user-service
   docker run -d -p 50052:50052 transfer-service
   ```

3. **使用 Kubernetes 部署**

   使用 `deploy.yaml` 文件进行 Kubernetes 部署。

4. **使用 Jenkins 进行 CI/CD**

   使用 `Jenkinsfile` 进行持续集成和持续部署。

## 使用说明

### API 网关

- **用户管理**: 提供用户注册、登录、信息修改等功能。
- **转账服务**: 提供转账、转出、转入等功能。
- **文件上传**: 支持本地上传、OSS 上传、MinIO 上传等。
- **消息队列**: 支持 RabbitMQ 消息队列。

### 微服务

- **用户服务**: 提供用户管理功能，如添加、删除、修改、查询用户信息。
- **转账服务**: 提供转账相关的业务逻辑，如转账、转出、转入等。

## 配置中心

支持多种配置中心，如 Nacos、Consul、Etcd。配置文件位于 `config` 目录。

## 服务发现

支持多种服务发现机制，如 Nacos、Consul、Etcd。

## 日志与监控

- 使用 Zap 进行日志记录。
- 支持链路追踪（Jaeger）。
- 支持限流、熔断等功能。

## 贡献指南

欢迎贡献代码和文档。请提交 Pull Request 或创建 Issue。

## 许可证

本项目使用 MIT 许可证。

--- 

请根据实际需求调整和补充内容。