# web-dev-1

**Repository Path**: buptnetwork/web-dev-1

## Basic Information

- **Project Name**: web-dev-1
- **Description**: 一个基于 Vue 3 + Flask 的匿名校园社区平台，支持发帖、评论、点赞等功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 匿名校园社区

一个基于 Vue 3 + Flask 的匿名校园社区平台，支持发帖、评论、点赞等功能。

## 技术栈

- **前端**: Vue 3 + TypeScript + Vue Router + Pinia + Axios
- **后端**: Flask + Flask-SQLAlchemy + Flask-JWT-Extended + Flask-CORS
- **数据库**: SQLite (开发环境)

## 项目结构

```
web-dev-1/
├── frontend/          # Vue 3 前端项目
├── backend/           # Flask 后端项目
└── mvp-prd.md        # 产品需求文档
```

## 开发环境启动

### 1. 启动后端服务

```bash
cd backend

# 激活虚拟环境
source venv/bin/activate

# 启动 Flask 服务
python app.py
```

后端服务将运行在 http://127.0.0.1:5000

### 2. 启动前端服务

在另一个终端窗口中执行：

```bash
cd frontend

# 安装依赖（如未安装）
npm install

# 启动开发服务器
npm run dev
```

前端服务将运行在 http://localhost:5173

### 3. 访问应用

打开浏览器访问 http://localhost:5173 即可使用。

## 后端 API 接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/api/health` | GET | 健康检查 |
| `/api/auth/register` | POST | 用户注册 |
| `/api/auth/login` | POST | 用户登录 |
| `/api/auth/me` | GET | 获取当前用户信息 |
| `/api/posts/` | GET | 获取帖子列表 |
| `/api/posts/` | POST | 创建帖子 |
| `/api/posts/<id>` | GET | 获取帖子详情 |
| `/api/posts/<id>` | DELETE | 删除帖子 |
| `/api/posts/<id>/like` | POST | 点赞/取消点赞 |
| `/api/comments/` | POST | 创建评论 |
| `/api/comments/<id>` | DELETE | 删除评论 |
| `/api/admin/posts` | GET | 管理员获取所有帖子 |
| `/api/admin/posts/<id>/hide` | POST | 下架帖子 |

## 环境配置

后端环境变量配置在 `backend/.env` 文件中：

```env
FLASK_APP=app.py
FLASK_DEBUG=True
DATABASE_URL=sqlite:///campus_community.db
JWT_SECRET_KEY=your-secret-key
CORS_ORIGINS=http://localhost:5173
```

## 注意事项

1. 启动后端前请确保已激活虚拟环境
2. 首次运行会自动创建 SQLite 数据库文件
3. 前端开发服务器默认代理到 http://127.0.0.1:5000