# openfwm_backend

**Repository Path**: sgyang/openfwm_backend

## Basic Information

- **Project Name**: openfwm_backend
- **Description**: 这是"一起钓鱼" 后端服务项目，项目采用JAVA技术栈，配合微信小程序及Android端和后台管理端，开箱即用。
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2025-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 户外钓鱼, 钓点分享, Java, SpringBoot

## README

# openfwm_backend

## 项目简介
OpenFWM是一个开源的休闲钓鱼平台后端服务，提供钓鱼点分享、社交互动、积分管理等功能，旨在为钓鱼爱好者提供便捷的信息交流和活动组织平台。

## 功能特性
- **用户管理**：支持账号密码登录与微信登录，用户信息管理
- **钓鱼点管理**：发布、查询、详情查看，支持地理位置信息
- **社交圈**：创建和管理钓鱼圈，发布动态，组织活动
- **互动系统**：评论、点赞功能，增强用户互动
- **积分系统**：用户积分管理，等级规则设置
- **文件服务**：支持图片等媒体文件上传下载
- **系统设置**：用户反馈、服务协议管理

## 技术栈
- **后端框架**：Spring Boot 3.1.5
- **安全框架**：Spring Security
- **ORM框架**：MyBatis-Plus 3.5.4
- **数据库**：MySQL 8.2.0
- **缓存**：Redis
- **认证**：JWT (JSON Web Token)
- **API文档**：Swagger (SpringDoc OpenAPI)
- **文件存储**：FastDFS
- **构建工具**：Maven

## 系统架构
项目采用典型的分层架构设计：
- **表现层(Controller)**：处理HTTP请求，返回响应
- **业务层(Service)**：实现核心业务逻辑
- **数据访问层(Mapper)**：与数据库交互
- **基础设施层(Infrastructure)**：提供安全、缓存、工具类等支持

## 安装教程

### 环境要求
- JDK 11+
- Maven 3.6+
- MySQL 8.0+
- Redis 6.0+
- FastDFS

### 安装步骤
1. 克隆项目
```bash
git clone https://gitee.com/your_username/openfwm_backend.git
```

2. 配置数据库
   - 创建MySQL数据库
   - 修改`src/main/resources/application.properties`中的数据库连接信息

3. 配置Redis
   - 确保Redis服务运行
   - 修改Redis连接配置

4. 构建项目
```bash
cd openfwm_backend
mvn clean package
```

5. 运行项目
```bash
java -jar target/fishingwithme-1.2.0.jar
```

## 使用说明

### API文档
项目启动后，可以访问以下地址查看API文档：
```
http://localhost:8080/swagger-ui.html
```

### 主要接口
- 用户认证：`/api/auth/*`
- 钓鱼点管理：`/api/spot/*`
- 社交圈：`/api/circle/*`
- 评论：`/api/comment/*`
- 文件上传：`/api/file/*`

## 许可证
本项目采用GPLv3开源许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 相关项目链接

- [微信小程序端](https://gitee.com/sgyang/openfwm_mini)
- [Android端](https://gitee.com/sgyang/openfwm_android)
- [管理后台](https://gitee.com/sgyang/openfwm_mgr)

## 赞助支持
如果您喜欢这个项目并希望支持其发展，可以通过以下微信二维码进行赞助：

### 赞助倡议
各位钓友！​
作为免费开源的钓鱼平台，「一起钓鱼」从 0 到 1 全靠个人利用业余时间开发 —— 我们使用原生小程序 + Java 后端，和安卓端以及后台管理端，后续还会开发鸿蒙和IOS端，平台集成腾讯地图精准标钓点，只为让大家出钓少踩坑。​
但服务器维护、新功能迭代（比如离线钓点缓存、渔获数据统计）需要更多时间精力，现诚邀大家小额赞助！

<img src="https://gitee.com/sgyang/openfwm_mini/raw/master/demo/sponsors.jpg" width="200" alt="赞助收款码" style="display: block; margin: 10px 0; border: 1px solid #eee; padding: 5px;" />

## 联系方式
如有问题,建议或者软件开发合作，请通过Issues或邮件联系项目维护者
email: answerme0918@foxmail.com
qq:314343793