# wechat

**Repository Path**: ehsbsbksje/wechat

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-04
- **Last Updated**: 2025-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 微信聊天系统

基于Spring Boot 3.x + Spring Cloud Alibaba 2022的微服务架构微信聊天系统，支持单聊、群聊、朋友圈、红包等核心功能。

## 📋 目录

- [项目特性](#-项目特性)
- [技术栈](#-技术栈)
- [架构设计](#-架构设计)
- [快速开始](#-快速开始)
- [数据库设计](#-数据库设计)
- [服务说明](#-服务说明)
- [API文档](#-api文档)
- [部署指南](#-部署指南)
- [开发规范](#-开发规范)
- [贡献指南](#-贡献指南)

## ✨ 项目特性

- 🏗️ **微服务架构** - 基于Spring Cloud Alibaba的分布式架构
- 💬 **实时通信** - WebSocket支持实时消息推送
- 👥 **社交功能** - 好友管理、群聊、朋友圈
- 💰 **支付功能** - 红包发送、领取、退回
- 📁 **文件管理** - 支持图片、视频、文档上传
- 🔔 **消息通知** - 系统通知、消息推送
- 📱 **响应式设计** - 支持多端适配
- 🔐 **安全认证** - JWT Token认证授权
- 📊 **监控运维** - Spring Boot Actuator健康检查

## 🛠 技术栈

### 后端技术

- **Spring Boot** 3.2.1 - 应用框架
- **Spring Cloud** 2023.0.0 - 微服务框架
- **Spring Cloud Alibaba** 2022.0.0.0 - 阿里巴巴微服务套件
- **Spring Security** - 安全框架
- **Spring Cloud Gateway** - API网关
- **Nacos** - 服务注册与配置中心
- **MyBatis-Plus** 3.5.5 - 持久层框架
- **MySQL** 8.2.0 - 关系型数据库
- **Redis** - 缓存数据库
- **Kafka** - 消息队列
- **MinIO** 8.5.7 - 对象存储
- **WebSocket** - 实时通信

### 工具库

- **Hutool** 5.8.24 - Java工具库
- **Lombok** - 代码简化
- **Knife4j** 4.4.0 - API文档
- **JWT** 4.4.0 - 令牌认证
- **Redisson** 3.25.2 - Redis客户端

## 🏛 架构设计

### 系统整体架构图

```mermaid
graph TB
    subgraph "客户端层"
        WebApp[Web前端<br/>Vue3 + Element Plus]
        MobileApp[移动客户端<br/>UniApp + Vue3]
        AdminPanel[管理后台<br/>Vue3 + Ant Design]
    end
    
    subgraph "负载均衡层"
        LB[负载均衡器<br/>Nginx/SLB]
    end
    
    subgraph "API网关层"
        Gateway[API网关<br/>wechat-gateway<br/>Spring Cloud Gateway]
    end
    
    subgraph "认证授权"
        Auth[认证中心<br/>JWT + Redis]
    end
    
    subgraph "核心业务服务"
        UserSvc[用户服务<br/>wechat-user-service<br/>用户管理/认证]
        ChatSvc[聊天服务<br/>wechat-chat-service<br/>WebSocket实时通信]
        MessageSvc[消息服务<br/>wechat-message-service<br/>消息存储/会话]
        FriendSvc[好友服务<br/>wechat-friend-service<br/>社交关系管理]
        GroupSvc[群组服务<br/>wechat-group-service<br/>群聊管理]
    end
    
    subgraph "扩展功能服务"
        MomentSvc[朋友圈服务<br/>wechat-moment-service<br/>动态社交]
        RedPacketSvc[红包服务<br/>wechat-redpacket-service<br/>红包系统]
        FileSvc[文件服务<br/>wechat-file-service<br/>文件存储]
        NotificationSvc[通知服务<br/>wechat-notification-service<br/>消息推送]
    end
    
    subgraph "管理服务"
        AdminSvc[管理服务<br/>wechat-admin-service<br/>后台管理]
    end
    
    subgraph "服务注册发现"
        Nacos[Nacos<br/>服务注册中心<br/>配置中心]
    end
    
    subgraph "数据存储层"
        MySQL[(MySQL 8.0<br/>主数据库)]
        Redis[(Redis 6.0<br/>缓存/会话)]
        MinIO[(MinIO<br/>对象存储)]
    end
    
    subgraph "消息队列"
        Kafka[Apache Kafka<br/>消息队列]
    end
    
    subgraph "监控运维"
        Monitor[Spring Boot Actuator<br/>健康检查]
        Logs[ELK Stack<br/>日志收集]
    end
    
    WebApp --> LB
    MobileApp --> LB
    AdminPanel --> LB
    LB --> Gateway
    
    Gateway --> Auth
    Gateway --> UserSvc
    Gateway --> ChatSvc
    Gateway --> MessageSvc
    Gateway --> FriendSvc
    Gateway --> GroupSvc
    Gateway --> MomentSvc
    Gateway --> RedPacketSvc
    Gateway --> FileSvc
    Gateway --> NotificationSvc
    Gateway --> AdminSvc
    
    UserSvc --> Nacos
    ChatSvc --> Nacos
    MessageSvc --> Nacos
    FriendSvc --> Nacos
    GroupSvc --> Nacos
    MomentSvc --> Nacos
    RedPacketSvc --> Nacos
    FileSvc --> Nacos
    NotificationSvc --> Nacos
    AdminSvc --> Nacos
    
    UserSvc --> MySQL
    MessageSvc --> MySQL
    FriendSvc --> MySQL
    GroupSvc --> MySQL
    MomentSvc --> MySQL
    RedPacketSvc --> MySQL
    AdminSvc --> MySQL
    
    UserSvc --> Redis
    ChatSvc --> Redis
    MessageSvc --> Redis
    
    FileSvc --> MinIO
    
    ChatSvc --> Kafka
    NotificationSvc --> Kafka
    RedPacketSvc --> Kafka
    
    Gateway --> Monitor
    UserSvc --> Monitor
    ChatSvc --> Monitor
    MessageSvc --> Monitor
```

### 微服务依赖关系图

```mermaid
graph LR
    subgraph "网关层"
        Gateway[wechat-gateway]
    end
    
    subgraph "核心服务"
        User[wechat-user-service]
        Chat[wechat-chat-service]
        Message[wechat-message-service]
        Friend[wechat-friend-service]
        Group[wechat-group-service]
    end
    
    subgraph "扩展服务"
        Moment[wechat-moment-service]
        RedPacket[wechat-redpacket-service]
        File[wechat-file-service]
        Notification[wechat-notification-service]
        Admin[wechat-admin-service]
    end
    
    Gateway --> User
    Gateway --> Chat
    Gateway --> Message
    Gateway --> Friend
    Gateway --> Group
    Gateway --> Moment
    Gateway --> RedPacket
    Gateway --> File
    Gateway --> Notification
    Gateway --> Admin
    
    Chat --> Message
    Chat --> User
    Chat --> Friend
    
    Group --> User
    Group --> Message
    
    Friend --> User
    Friend --> Notification
    
    Moment --> User
    Moment --> File
    
    RedPacket --> User
    RedPacket --> Message
    RedPacket --> Notification
    
    Admin --> User
    Admin --> Message
    Admin --> Friend
    Admin --> Group
    Admin --> Moment
    Admin --> RedPacket
```

## 🚀 快速开始

### 环境要求

- **JDK** 17+
- **Maven** 3.8+
- **MySQL** 8.0+
- **Redis** 6.0+
- **Kafka** 2.8+
- **MinIO** 最新版
- **Nacos** 2.2+

### 1. 克隆项目

```bash
git clone https://github.com/your-repo/wechat.git
cd wechat
```

### 2. 数据库初始化

```bash
# 创建数据库
mysql -u root -p < sql/wechat_init.sql
```

### 3. 启动基础服务

```bash
# 启动 Nacos (服务注册中心)
sh startup.sh -m standalone

# 启动 Redis
redis-server

# 启动 Kafka
bin/kafka-server-start.sh config/server.properties

# 启动 MinIO
minio server /data
```

### 4. 修改配置文件

每个服务的 `application.yml` 中需要配置：

- 数据库连接信息
- Redis连接信息
- Nacos注册中心地址
- MinIO配置

### 5. 编译启动

```bash
# 编译项目
mvn clean package -DskipTests

# 启动网关
java -jar wechat-service/wechat-gateway/target/wechat-gateway-1.0-SNAPSHOT.jar

# 启动其他服务（按需启动）
java -jar wechat-service/wechat-user-service/target/wechat-user-service-1.0-SNAPSHOT.jar
java -jar wechat-service/wechat-chat-service/target/wechat-chat-service-1.0-SNAPSHOT.jar
# ... 其他服务
```

### 6. 访问应用

- **网关地址**: http://localhost:8080
- **API文档**: http://localhost:8080/doc.html
- **Nacos控制台**: http://localhost:8848/nacos

## 🗄 数据库设计

### 核心数据表

```sql
-- 用户相关
user                    -- 用户信息表
user_balance           -- 用户余额表  
balance_log            -- 余额变动记录

-- 好友相关
friend                 -- 好友关系表
apply_friend          -- 好友申请表

-- 消息相关  
message               -- 消息表
session               -- 会话表
user_session          -- 用户会话关系表

-- 朋友圈相关
moment                -- 朋友圈表
moment_comment        -- 朋友圈评论表
moment_like           -- 朋友圈点赞表

-- 红包相关
red_packet            -- 红包主表
red_packet_receive    -- 红包领取记录表

-- 系统相关
file_attachment       -- 文件附件表
notification          -- 系统通知表
```

### ER关系图

```mermaid
erDiagram
    USER ||--o{ FRIEND : has
    USER ||--o{ MESSAGE : sends
    USER ||--o{ MOMENT : creates
    USER ||--o{ RED_PACKET : sends
    USER ||--o{ NOTIFICATION : receives
    
    MOMENT ||--o{ MOMENT_COMMENT : has
    MOMENT ||--o{ MOMENT_LIKE : has
    
    SESSION ||--o{ MESSAGE : contains
    SESSION ||--o{ USER_SESSION : includes
    
    RED_PACKET ||--o{ RED_PACKET_RECEIVE : records
```

## 📖 服务说明

### 🌐 wechat-gateway (API网关服务)

**核心功能**: 统一入口、路由转发、负载均衡、认证鉴权

```mermaid
flowchart TD
    A[客户端请求] --> B{Gateway接收}
    B --> C[请求预处理]
    C --> D[认证检查]
    D --> E{Token有效?}
    E -->|否| F[返回401未授权]
    E -->|是| G[权限验证]
    G --> H{权限检查}
    H -->|无权限| I[返回403禁止访问]
    H -->|有权限| J[限流检查]
    J --> K{是否超限?}
    K -->|超限| L[返回429限流]
    K -->|正常| M[路由转发]
    M --> N[目标微服务]
    N --> O[响应处理]
    O --> P[加密响应]
    P --> Q[返回客户端]
    
    style A fill:#e1f5fe
    style Q fill:#e8f5e8
    style F fill:#ffebee
    style I fill:#ffebee
    style L fill:#fff3e0
```

**技术特点**:
- Spring Cloud Gateway反应式网关
- 统一JWT认证和权限控制
- 请求限流和熔断保护
- 请求响应加密解密
- 分布式链路追踪

### 👤 wechat-user-service (用户管理服务)

**核心功能**: 用户注册登录、信息管理、余额管理

```mermaid
flowchart TD
    A[用户注册/登录] --> B{请求类型}
    B -->|注册| C[手机号验证]
    B -->|登录| D[密码验证]
    
    C --> E[发送短信验证码]
    E --> F[验证码校验]
    F --> G{验证成功?}
    G -->|否| H[返回验证失败]
    G -->|是| I[创建用户账号]
    I --> J[生成JWT Token]
    
    D --> K[密码加密校验]
    K --> L{密码正确?}
    L -->|否| M[返回登录失败]
    L -->|是| N[更新登录状态]
    N --> J
    
    J --> O[用户信息管理]
    O --> P[头像上传]
    O --> Q[个人资料修改]
    O --> R[余额管理]
    R --> S[充值记录]
    R --> T[消费记录]
    
    style A fill:#e1f5fe
    style J fill:#e8f5e8
    style H fill:#ffebee
    style M fill:#ffebee
```

**业务流程**:
1. **注册流程**: 手机验证 → 短信验证码 → 密码设置 → 账号创建
2. **登录流程**: 账号验证 → 密码校验 → Token生成 → 状态更新
3. **信息管理**: 头像上传 → 个人资料维护 → 隐私设置
4. **余额管理**: 充值操作 → 消费记录 → 余额查询

### 💬 wechat-chat-service (实时聊天服务)

**核心功能**: WebSocket连接管理、实时消息推送、在线状态

```mermaid
flowchart TD
    A[客户端连接] --> B[WebSocket握手]
    B --> C[Token验证]
    C --> D{认证成功?}
    D -->|否| E[拒绝连接]
    D -->|是| F[建立连接]
    F --> G[用户上线]
    G --> H[更新在线状态]
    
    H --> I[监听消息]
    I --> J{收到消息?}
    J -->|是| K[消息类型判断]
    J -->|否| I
    
    K --> L{单聊消息}
    K --> M{群聊消息}
    K --> N{系统消息}
    
    L --> O[检查好友关系]
    O --> P{是好友?}
    P -->|否| Q[拒绝发送]
    P -->|是| R[推送给目标用户]
    
    M --> S[检查群成员]
    S --> T[群消息广播]
    
    N --> U[系统通知推送]
    
    R --> V[发送确认]
    T --> V
    U --> V
    
    V --> W[连接断开检测]
    W --> X{连接正常?}
    X -->|是| I
    X -->|否| Y[用户下线]
    Y --> Z[清理连接]
    
    style A fill:#e1f5fe
    style F fill:#e8f5e8
    style E fill:#ffebee
    style Q fill:#ffebee
```

**技术实现**:
- WebSocket长连接管理
- 心跳检测机制
- 消息路由分发
- 集群环境下的连接同步

### 📨 wechat-message-service (消息存储服务)

**核心功能**: 消息持久化、会话管理、历史记录

```mermaid
flowchart TD
    A[接收消息请求] --> B[消息内容验证]
    B --> C{内容合法?}
    C -->|否| D[返回验证失败]
    C -->|是| E[生成消息ID]
    E --> F[消息内容处理]
    
    F --> G{消息类型}
    G -->|文本| H[文本内容存储]
    G -->|图片| I[图片信息存储]
    G -->|语音| J[语音信息存储]
    G -->|视频| K[视频信息存储]
    G -->|文件| L[文件信息存储]
    
    H --> M[保存到数据库]
    I --> M
    J --> M
    K --> M
    L --> M
    
    M --> N[更新会话信息]
    N --> O[更新最后消息]
    O --> P[更新未读计数]
    P --> Q[消息同步]
    
    Q --> R[查询历史消息]
    R --> S[分页查询]
    S --> T[消息列表返回]
    
    T --> U[会话列表管理]
    U --> V[会话创建/更新]
    V --> W[会话成员管理]
    
    style A fill:#e1f5fe
    style M fill:#e8f5e8
    style D fill:#ffebee
```

**核心功能点**:
- 支持多种消息类型
- 消息状态跟踪(未读/已读)
- 会话创建和管理
- 历史消息分页查询

### 👥 wechat-friend-service (好友关系服务)

**核心功能**: 好友申请、关系管理、社交网络

```mermaid
flowchart TD
    A[好友功能入口] --> B{操作类型}
    
    B -->|搜索用户| C[用户搜索]
    C --> D[根据手机号/昵称搜索]
    D --> E[返回用户信息]
    
    B -->|添加好友| F[发送好友申请]
    F --> G[检查申请条件]
    G --> H{可以申请?}
    H -->|否| I[返回限制信息]
    H -->|是| J[创建申请记录]
    J --> K[发送申请通知]
    
    B -->|处理申请| L[好友申请处理]
    L --> M{接受/拒绝}
    M -->|接受| N[创建好友关系]
    M -->|拒绝| O[更新申请状态]
    
    N --> P[双向好友关系]
    P --> Q[发送通过通知]
    
    B -->|好友管理| R[好友列表查询]
    R --> S[分组管理]
    S --> T[好友信息更新]
    
    B -->|删除好友| U[删除好友关系]
    U --> V[移除双向关系]
    V --> W[清理相关数据]
    
    style A fill:#e1f5fe
    style N fill:#e8f5e8
    style P fill:#e8f5e8
    style I fill:#ffebee
```

**业务规则**:
- 双向好友关系维护
- 好友申请有效期管理
- 黑名单功能
- 好友分组管理

### 👥 wechat-group-service (群组管理服务)

**核心功能**: 群聊创建、成员管理、权限控制

```mermaid
flowchart TD
    A[群组功能] --> B{操作类型}
    
    B -->|创建群组| C[群组创建]
    C --> D[设置群信息]
    D --> E[添加初始成员]
    E --> F[设置群主权限]
    F --> G[群组创建完成]
    
    B -->|加入群组| H[申请加入]
    H --> I{加入方式}
    I -->|邀请码| J[验证邀请码]
    I -->|好友邀请| K[验证邀请权限]
    I -->|二维码| L[扫码加入]
    
    J --> M[检查群组状态]
    K --> M
    L --> M
    M --> N{可以加入?}
    N -->|否| O[返回加入失败]
    N -->|是| P[添加群成员]
    
    B -->|成员管理| Q[成员权限管理]
    Q --> R{权限操作}
    R -->|设置管理员| S[权限提升]
    R -->|移除成员| T[成员踢出]
    R -->|禁言设置| U[发言权限]
    
    B -->|群组设置| V[群组信息管理]
    V --> W[群名称/头像]
    V --> X[群公告管理]
    V --> Y[群组解散]
    
    style A fill:#e1f5fe
    style G fill:#e8f5e8
    style P fill:#e8f5e8
    style O fill:#ffebee
```

**权限体系**:
- 群主: 最高权限，可以解散群组
- 管理员: 管理成员，设置群信息
- 普通成员: 发送消息，查看群信息

### 🎉 wechat-moment-service (朋友圈服务)

**核心功能**: 动态发布、互动社交、隐私控制

```mermaid
flowchart TD
    A[朋友圈功能] --> B{操作类型}
    
    B -->|发布动态| C[创建朋友圈]
    C --> D[内容编辑]
    D --> E[图片/视频上传]
    E --> F[隐私设置]
    F --> G{谁可以看}
    G -->|公开| H[所有好友可见]
    G -->|部分好友| I[指定好友可见]
    G -->|仅自己| J[私密动态]
    
    H --> K[发布动态]
    I --> K
    J --> K
    K --> L[推送给好友]
    
    B -->|查看动态| M[朋友圈时间线]
    M --> N[权限过滤]
    N --> O[按时间排序]
    O --> P[分页加载]
    
    B -->|互动功能| Q{互动类型}
    Q -->|点赞| R[点赞操作]
    Q -->|评论| S[评论功能]
    Q -->|转发| T[动态转发]
    
    R --> U[更新点赞数]
    S --> V[评论存储]
    V --> W[评论通知]
    T --> X[转发处理]
    
    B -->|动态管理| Y[个人动态管理]
    Y --> Z[动态删除]
    Y --> AA[隐私修改]
    
    style A fill:#e1f5fe
    style K fill:#e8f5e8
    style L fill:#e8f5e8
```

**隐私控制**:
- 多级可见性设置
- 黑名单屏蔽
- 评论权限控制
- 地理位置隐私

### 🧧 wechat-redpacket-service (红包系统服务)

**核心功能**: 红包发送、抢夺、资金管理

```mermaid
flowchart TD
    A[红包功能] --> B{操作类型}
    
    B -->|发红包| C[红包创建]
    C --> D[设置红包参数]
    D --> E{红包类型}
    E -->|普通红包| F[固定金额]
    E -->|拼手气红包| G[随机金额分配]
    
    F --> H[余额检查]
    G --> H
    H --> I{余额充足?}
    I -->|否| J[余额不足提示]
    I -->|是| K[扣减余额]
    K --> L[创建红包记录]
    L --> M[发送红包消息]
    
    B -->|抢红包| N[红包领取]
    N --> O[红包状态检查]
    O --> P{可以领取?}
    P -->|否| Q[返回领取失败]
    P -->|是| R[分配红包金额]
    R --> S[更新余额]
    S --> T[记录领取]
    T --> U[返回领取结果]
    
    B -->|红包查询| V[红包详情]
    V --> W[领取记录查询]
    W --> X[资金流水]
    
    B -->|退回处理| Y[红包退回]
    Y --> Z[24小时超时检查]
    Z --> AA[未领完退回]
    AA --> BB[余额返还]
    
    style A fill:#e1f5fe
    style M fill:#e8f5e8
    style U fill:#e8f5e8
    style J fill:#ffebee
    style Q fill:#ffebee
```

**核心算法**:
- 拼手气红包随机算法
- 并发抢夺防超发
- 分布式锁保证一致性
- 资金安全保障机制

### 📁 wechat-file-service (文件存储服务)

**核心功能**: 文件上传下载、多媒体处理、存储管理

```mermaid
flowchart TD
    A[文件操作] --> B{操作类型}
    
    B -->|文件上传| C[上传处理]
    C --> D[文件验证]
    D --> E{文件合法?}
    E -->|否| F[返回验证失败]
    E -->|是| G[文件类型判断]
    
    G --> H{文件类型}
    H -->|图片| I[图片压缩处理]
    H -->|视频| J[视频转码处理]
    H -->|音频| K[音频转码处理]
    H -->|文档| L[文档预览生成]
    
    I --> M[存储到MinIO]
    J --> M
    K --> M
    L --> M
    
    M --> N[生成访问URL]
    N --> O[返回文件信息]
    
    B -->|文件下载| P[下载请求]
    P --> Q[权限验证]
    Q --> R{有权限?}
    R -->|否| S[拒绝下载]
    R -->|是| T[生成下载链接]
    T --> U[返回文件流]
    
    B -->|文件管理| V[文件列表]
    V --> W[文件搜索]
    W --> X[文件删除]
    X --> Y[清理存储]
    
    style A fill:#e1f5fe
    style O fill:#e8f5e8
    style U fill:#e8f5e8
    style F fill:#ffebee
    style S fill:#ffebee
```

**存储策略**:
- 分布式文件存储(MinIO)
- 多格式自动转换
- CDN加速访问
- 文件访问权限控制

### 🔔 wechat-notification-service (通知推送服务)

**核心功能**: 消息通知、推送管理、多渠道通知

```mermaid
flowchart TD
    A[通知触发] --> B[通知类型识别]
    B --> C{通知类型}
    
    C -->|好友申请| D[好友通知]
    C -->|消息提醒| E[消息通知]
    C -->|系统公告| F[系统通知]
    C -->|红包提醒| G[红包通知]
    
    D --> H[构建通知内容]
    E --> H
    F --> H
    G --> H
    
    H --> I[用户偏好检查]
    I --> J{推送设置}
    J -->|关闭| K[跳过推送]
    J -->|开启| L[选择推送渠道]
    
    L --> M{推送渠道}
    M -->|站内信| N[系统内通知]
    M -->|短信| O[短信推送]
    M -->|邮件| P[邮件推送]
    M -->|APP推送| Q[移动端推送]
    
    N --> R[保存通知记录]
    O --> R
    P --> R
    Q --> R
    
    R --> S[推送状态跟踪]
    S --> T[送达确认]
    T --> U[统计分析]
    
    style A fill:#e1f5fe
    style R fill:#e8f5e8
    style K fill:#fff3e0
```

**推送策略**:
- 多渠道推送支持
- 用户偏好设置
- 推送频率控制
- 送达率统计分析

### ⚙️ wechat-admin-service (管理后台服务)

**核心功能**: 系统管理、用户管理、数据监控

```mermaid
flowchart TD
    A[管理后台] --> B{管理模块}
    
    B -->|用户管理| C[用户管理]
    C --> D[用户列表查询]
    D --> E[用户状态管理]
    E --> F[用户信息编辑]
    F --> G[账号冻结/解冻]
    
    B -->|内容管理| H[内容审核]
    H --> I[朋友圈内容审核]
    I --> J[违规内容处理]
    J --> K[内容删除/警告]
    
    B -->|系统监控| L[系统监控]
    L --> M[服务状态监控]
    M --> N[性能指标监控]
    N --> O[异常告警]
    
    B -->|数据统计| P[数据分析]
    P --> Q[用户活跃度]
    Q --> R[消息发送统计]
    R --> S[功能使用统计]
    
    B -->|系统配置| T[系统设置]
    T --> U[参数配置]
    U --> V[功能开关]
    V --> W[版本管理]
    
    B -->|财务管理| X[财务模块]
    X --> Y[红包流水]
    Y --> Z[充值记录]
    Z --> AA[提现处理]
    
    style A fill:#e1f5fe
    style G fill:#e8f5e8
    style K fill:#fff3e0
    style O fill:#ffebee
```

**管理功能**:
- 多角色权限管理
- 实时数据监控
- 内容审核机制
- 财务数据管理

## 📚 API文档

项目集成了Knife4j，启动服务后可通过以下地址访问API文档：

- **网关聚合文档**: http://localhost:8080/doc.html
- **各服务独立文档**: http://localhost:端口/doc.html

### API设计规范

```
GET    /api/v1/users          # 获取用户列表
GET    /api/v1/users/{id}     # 获取用户详情  
POST   /api/v1/users          # 创建用户
PUT    /api/v1/users/{id}     # 更新用户
DELETE /api/v1/users/{id}     # 删除用户
```

## 🐳 部署指南

### Docker部署

```dockerfile
# Dockerfile示例
FROM openjdk:17-jre-slim
COPY target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]
```

### Docker Compose

```yaml
version: '3.8'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: wechat_db
    ports:
      - "3306:3306"
  
  redis:
    image: redis:6.2
    ports:
      - "6379:6379"
  
  nacos:
    image: nacos/nacos-server:v2.2.0
    environment:
      MODE: standalone
    ports:
      - "8848:8848"
  
  wechat-gateway:
    build: ./wechat-service/wechat-gateway
    ports:
      - "8080:8080"
    depends_on:
      - nacos
      - redis
```

### Kubernetes部署

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: wechat-gateway
spec:
  replicas: 2
  selector:
    matchLabels:
      app: wechat-gateway
  template:
    metadata:
      labels:
        app: wechat-gateway
    spec:
      containers:
      - name: wechat-gateway
        image: wechat/gateway:latest
        ports:
        - containerPort: 8080
```

## 📐 开发规范

### 代码规范

- 遵循阿里巴巴Java开发手册
- 使用Lombok简化代码
- 统一异常处理
- 完善的日志记录

### 提交规范

```
feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 代码重构
test: 测试相关
chore: 构建工具相关
```

### 分支规范

- `main` - 主分支，生产环境
- `develop` - 开发分支
- `feature/*` - 功能分支
- `hotfix/*` - 热修复分支

## 🤝 贡献指南

1. Fork 本项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'feat: Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📄 许可证

本项目基于 [MIT](LICENSE) 许可证开源。

## 📞 联系我们

- **项目维护者**: [Your Name]
- **邮箱**: your.email@example.com
- **问题反馈**: [Issues](https://github.com/your-repo/wechat/issues)

## 🔗 相关链接

- [Spring Boot 官方文档](https://spring.io/projects/spring-boot)
- [Spring Cloud Alibaba 官方文档](https://spring-cloud-alibaba-group.github.io/github-pages/hoxton/zh-cn/index.html)
- [MyBatis-Plus 官方文档](https://baomidou.com/)
- [Nacos 官方文档](https://nacos.io/zh-cn/docs/quick-start.html)

---

⭐ 如果这个项目对你有帮助，请给我们一个星标！