# 仿微信聊天页面模块

**Repository Path**: bmscj/wechat-chat-interface-module

## Basic Information

- **Project Name**: 仿微信聊天页面模块
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-13
- **Last Updated**: 2025-12-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FWeChat 项目说明
# ！！！！！！
- 此项目是25届软件开发创客实验室的谢宏翔、王银贵亲传圣遗物，主要作用：简单的用户对话，使用websocket分发技术实现用户间的实时聊天，后端文件：/src，前端文件/demo，
- 此项目主要目的是实现一个聊天组件，所以只需要复制/demo/src/components/chat.vue，把这个文件复制到你的前端直接import就行，支持设置height和weight，默认为height：100%
- 此项目高度低耦合，只使用users表的user_id,user_img,user_name这三个字段，其中user_img是string类型的url，此项目存在前端，如果使用OSS存储，前端不用动
- 需要提供端口：（其他的使用项目内的Controller即可）
```
  端口                           功能                          返回值
 /api/users/{user_id}           根据用户id查询用户完整信息      Json数组
 /api/users/{user_id}/img       根据用户id查询用户图片url       String
``` 
# ！！！！！！
# 下面是AI生成的readme，基本无误


## 项目简介
FWeChat 是一个基于 Vue.js 和 Spring Boot 的即时通讯应用，包含聊天、好友管理、群组管理等功能。

## 技术栈
- 前端：Vue.js
- 后端：Spring Boot
- 数据库：MySQL
- 实时通信：WebSocket

## 功能模块
1. **用户管理**
   - 注册
   - 登录
   - 用户信息管理

2. **好友管理**
   - 发送好友请求
   - 接受/拒绝好友请求
   - 删除好友
   - 查看好友列表

3. **群组管理**
   - 创建群组
   - 加入群组
   - 管理群组成员
   - 修改群组信息

4. **消息管理**
   - 发送文本消息
   - 发送文件/图片消息
   - 查看历史消息
   - 消息已读状态管理

5. **实时通信**
   - WebSocket 实时消息推送
   - 在线状态管理

## 项目结构
```
fweChat/
├── demo/                  # Vue.js 前端项目
├── src/                   # Spring Boot 后端项目
│   ├── main/
│   │   ├── java/            # Java 源代码
│   │   └── resources/       # 配置文件和资源
├── node_modules/            # 前端依赖库
└── pom.xml                  # Maven 项目配置
```

## 安装与运行
### 前端 (Vue.js)
```bash
# 进入前端项目目录
cd demo

# 安装依赖
npm install

# 开发环境运行
npm run serve

# 生产环境构建
npm run build

# 代码检查与修复
npm run lint
```

### 后端 (Spring Boot)
```bash
# 使用 Maven 构建
mvn clean install

# 运行项目
mvn spring-boot:run
```

## API 文档
详见后端各 Controller 类的注解，使用 Spring Boot 的 RESTful 风格接口。

## 数据库设计
包含用户表、好友关系表、群组表、消息表等，具体见实体类和 Mapper 文件。

## 实时通信
使用 WebSocket 和 STOMP 协议实现实时消息推送，配置见 WebSocketConfig 类。

## 开发规范
- 前端：遵循 Vue.js 最佳实践
- 后端：遵循 Spring Boot 最佳实践
- 数据库：使用 MyBatis 进行 ORM 映射

## 贡献指南
欢迎贡献代码，请遵循以下步骤：
1. Fork 项目
2. 创建新分支
3. 提交 Pull Request

## 许可证
本项目采用 MIT 许可证。详见 LICENSE 文件。