# kyq

**Repository Path**: chansgen/kyq

## Basic Information

- **Project Name**: kyq
- **Description**: 坑友圈
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-06-17
- **Last Updated**: 2025-07-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 坑友圈 (KYQ)

## 项目介绍
坑友圈是一个面向学生和毕业生的社区平台，旨在帮助用户分享和获取各种"避坑经验"。用户可以在平台上分享自己的经历，提出问题，或者回答他人的疑问，形成一个互助共赢的社区生态。

### 核心功能
- **避坑经验分享**：用户可以发布自己的避坑经验，帮助他人避免类似问题
- **填坑问答**：用户可以提出问题，获取社区中其他成员的解答
- **同校坑友**：连接相同学校的用户，形成校园社交网络
- **学校认证**：提供学校身份认证功能，增强社区可信度
- **个人中心**：管理个人资料、发布内容、收藏和关注

## 项目架构

### 技术栈
- **前端**：uni-app (支持多端发布：H5、Android、iOS、各类小程序)
- **后端**：Spring Boot + MyBatis
- **数据库**：MySQL
- **缓存**：Redis
- **认证**：JWT (JSON Web Token)
- **文件存储**：本地文件系统

### 项目结构
```
坑友圈/
├── sx-api/              # 后端API项目
│   ├── src/             # 源代码
│   ├── pom.xml          # Maven配置
│   └── ...
├── sx-front/            # 前端项目
│   ├── pages/           # 页面
│   ├── components/      # 组件
│   ├── utils/           # 工具类
│   ├── static/          # 静态资源
│   └── ...
├── 接口文档/             # API接口文档
└── sql/                 # SQL脚本
```

## 数据模型

系统主要包含以下核心数据模型：

- **用户(User)**：用户基本信息、认证状态、积分等
- **文章(Post)**：包含标题、内容、分类、评分等
- **评论(Comment)**：用户对内容的评论和互动
- **关注(Follow)**：用户之间的关注关系
- **学校认证(SchoolVerification)**：用户的学校认证信息
- **内容互动(Like/Share)**：点赞、分享等互动数据

## 安装部署

### 环境要求
- JDK 1.8+
- MySQL 5.7+
- Redis 5.0+
- Node.js 12.0+
- HBuilderX (推荐用于前端开发)

### 后端部署
1. 克隆项目到本地
   ```bash
   git clone git@gitee.com:chansgen/kyq.git
   ```

2. 导入数据库
   ```bash
   mysql -u username -p database_name < sql/init.sql
   ```

3. 配置后端
   ```
   cd sx-api
   # 修改 src/main/resources/application.yml 中的数据库和Redis配置
   ```

4. 启动后端服务
   ```bash
   # Windows
   start.bat
   
   # Linux/Mac
   ./start.sh
   ```

### 前端部署
1. 使用HBuilderX打开sx-front目录
2. 修改utils/api.js中的API地址配置
3. 运行到浏览器或打包发布到需要的平台

## 使用指南

### 用户注册与登录
1. 通过手机号注册账号
2. 使用手机号+验证码或账号密码登录

### 浏览内容
1. 首页展示推荐内容和轮播图
2. 社区页面按分类浏览内容
3. 可通过搜索查找特定内容

### 发布内容
1. 点击发布按钮创建新内容
2. 选择内容类型(填坑问答/避坑经验/同校坑友)
3. 填写标题、内容、添加标签和图片
4. 提交发布

### 互动功能
- 评论：对内容发表评论
- 点赞：对喜欢的内容点赞
- 收藏：收藏有用的内容
- 关注：关注感兴趣的用户

### 个人中心
- 查看和编辑个人资料
- 管理发布的内容
- 查看收藏和关注
- 进行学校认证

## 贡献指南

1. Fork 本仓库
2. 新建分支 `git checkout -b feature/your-feature`
3. 提交代码 `git commit -m 'Add some feature'`
4. 推送到分支 `git push origin feature/your-feature`
5. 提交 Pull Request

## 联系方式

如有问题或建议，请通过以下方式联系我们：
- 项目地址：[https://gitee.com/chansgen/kyq](https://gitee.com/chansgen/kyq)
- 电子邮件：[联系邮箱]

## 版权信息

Copyright © 2023 坑友圈团队