# comecrd

**Repository Path**: xuyan2680/comecrd

## Basic Information

- **Project Name**: comecrd
- **Description**: 一个基于Vue.js的打卡社交应用，支持用户发布打卡记录、点赞、评论，分享生活点滴。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-16
- **Last Updated**: 2025-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ComeCrd 打卡应用

一个基于Vue.js的打卡社交应用，支持用户发布打卡记录、点赞、评论，分享生活点滴。

## 项目结构

```
├── backend/         # 后端代码（Spring Boot）
├── vue-frontend/    # Vue Web前端代码
├── design_document.md  # 设计文档
├── README.md        # 项目说明
└── .gitignore       # Git忽略文件
```

## 技术栈

### 后端
- Java 8
- Spring Boot 2.5.6
- MyBatis
- MySQL 数据库
- Redis 缓存
- JWT 身份认证
- Lombok

### 前端
- Vue.js + Vite + Vue Router

## 功能特性

1. **用户系统**
   - 用户登录
   - 用户信息管理

2. **打卡功能**
   - 发布打卡记录（支持文字、图片、位置）
   - 查看打卡列表
   - 查看打卡详情
   - 删除打卡记录

3. **社交互动**
   - 点赞功能
   - 评论功能
   - 查看用户主页

4. **个人中心**
   - 查看个人统计信息
   - 管理个人打卡记录

## 后端环境配置

1. **配置数据库**
   - 创建MySQL数据库 `comecrd_db`
   - 在 `backend/src/main/resources/application.properties` 中配置数据库连接信息

2. **配置Redis**
   - 确保Redis服务已启动
   - 在 `application.properties` 中配置Redis连接信息



## 运行项目

### 后端

```bash
cd backend
mvn clean install
mvn spring-boot:run
```

后端服务将在 http://localhost:8080/api 启动

### Vue Web前端

1. 安装依赖
```bash
cd vue-frontend
npm install
```

2. 启动开发服务器
```bash
npm run dev
```

Vue前端默认运行在 http://localhost:3000

3. 构建生产版本
```bash
npm run build
```

构建后的文件将输出到 `vue-frontend/dist` 目录

## API 文档

### 用户相关接口
- `POST /api/user/login` - 用户登录
- `POST /api/user/update` - 更新用户信息
- `GET /api/user/info` - 获取用户信息

### 打卡相关接口
- `POST /api/checkin/publish` - 发布打卡
- `GET /api/checkin/list` - 获取打卡列表
- `GET /api/checkin/user/list` - 获取用户的打卡列表
- `GET /api/checkin/detail/{id}` - 获取打卡详情
- `DELETE /api/checkin/delete/{id}` - 删除打卡

### 点赞相关接口
- `POST /api/like/toggle` - 点赞/取消点赞
- `GET /api/like/status/{checkInId}` - 检查是否已点赞

### 评论相关接口
- `POST /api/comment/add` - 添加评论
- `GET /api/comment/list/{checkInId}` - 获取评论列表
- `DELETE /api/comment/delete/{id}` - 删除评论

## 注意事项

1. 确保配置文件中的敏感信息（如数据库密码、微信小程序密钥等）已正确配置
2. 图片上传功能需要确保服务器上的上传目录存在且有写入权限
3. 在生产环境中，建议配置HTTPS和更严格的安全措施