# SwiftSummit

**Repository Path**: devilvoice/swift-summit

## Basic Information

- **Project Name**: SwiftSummit
- **Description**: 暑期实训-社团联盟管理系统
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-23
- **Last Updated**: 2025-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# SwiftSummit

## 介绍
SwiftSummit 是一个综合性平台，用于管理用户、社团以及社团相关的内容（如帖子、评论、活动等）。平台支持用户注册、登录、权限管理、信息更新、社团创建与管理、内容发布与互动等功能。

## 软件架构
该项目使用 Spring Boot 框架构建，基于 Java 实现后端服务。整体架构分为以下几个核心部分：
- **DTOs**: 数据传输对象，用于封装和传递请求数据。
- **Controller**: 处理 HTTP 请求，定义 API 接口。
- **Service**: 业务逻辑处理，调用 Mapper 与数据库交互。
- **Mapper**: 数据访问层接口，与数据库进行增删改查操作。
- **Entity**: 数据模型，对应数据库表结构。
- **Utils**: 工具类，例如 JWT 拦截器、密码加密等。
- **Configuration**: 项目配置，包括跨域设置、WebSocket 配置、OpenAPI 配置等。

## 安装教程
1. 确保您的开发环境已安装 Java 和 Maven。
2. 克隆项目到本地：
   ```bash
   git clone <repository-url>
   ```
3. 进入项目目录并构建：
   ```bash
   cd Server
   mvn clean install
   ```
4. 配置数据库连接信息（在 `application.properties` 文件中设置）。
5. 启动项目：
   ```bash
   mvn spring-boot:run
   ```

## 使用说明
- **用户注册与登录**: 使用 `/Auth/Register` 和 `/Auth/Login` 接口进行注册和登录。
- **创建社团**: 使用 `/api/clubs/create` 接口创建社团。
- **管理社团**: 社团负责人可以更新介绍、删除社团。
- **帖子管理**: 用户可以发布、查看、删除和点赞帖子。
- **评论与活动**: 用户可以提交评论和活动。
- **权限管理**: 通过 `/Auth/Op` 接口为用户分配权限。
- **文件上传**: 支持图片上传功能（如设置头像、上传帖子图片）。
- **消息和聊天**: 提供发送、删除和获取聊天消息的功能。
- **推荐社团**: 使用 AI 模型进行社团推荐。
- **收藏功能**: 用户可以收藏感兴趣的社团。

## 参与贡献
如果您希望为项目做出贡献，请按照以下步骤操作：
1. Fork 仓库。
2. 创建新的分支。
3. 提交您的修改。
4. 创建 Pull Request。

## 特性
- **RESTful API**: 提供简洁的接口，便于前后端分离。
- **JWT 鉴权**: 通过 JWT 拦截器实现用户身份验证。
- **WebSocket 支持**: 支持实时消息推送。
- **OpenAPI 支持**: 项目集成了 OpenAPI，便于接口测试和文档生成。
- **跨域配置**: 针对前后端分离架构，配置了全局跨域支持。

## 许可证
本项目遵循 MIT 许可证，详细信息请参考 LICENSE 文件。