# 校园跑腿服务平台

**Repository Path**: zeng-luhao66/python-project

## Basic Information

- **Project Name**: 校园跑腿服务平台
- **Description**: python项目仓库1.0
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园跑腿服务平台

#### 介绍
基于 Vue 3 + Express 的全栈校园跑腿服务平台，学生可发布跑腿任务（取快递、打印文件、购物等），其他同学可接单赚取报酬。包含完整的任务生命周期管理、实时聊天、用户信誉评价体系以及管理员数据看板。

在线地址：[https://paotui.cyou/](https://paotui.cyou/)
管理员UN/PW：admin/admin123

###页面展示
![任务大厅](yemian/renwudating.png)
![任务发布](yemian/fabu.png)
![接单进行中](yemian/jiedan.png)
![任务沟通](yemian/goutong.png)
![接单完成](yemian/jiedanwancheng.png)
![后台管理](yemian/3.png)
![任务管理](yemian/4.png)

#### 软件架构
前后端分离架构：

- **前端**：Vue 3（Composition API）+ Element Plus + Pinia + Vue Router 4 + Vite 5
- **后端**：Node.js + Express 4 + Socket.IO + JWT 认证
- **数据库**：MySQL 8.0 + Knex.js 迁移工具
- **部署**：Docker Compose 编排（MySQL + Backend + Frontend）
- **地图服务**：高德地图 JSAPI（位置选择）
- **实时通信**：Socket.IO（即时消息）

```
├── frontend/          # Vue 3 前端 SPA
│   ├── src/
│   │   ├── views/          # 页面组件
│   │   ├── components/     # 通用组件
│   │   ├── stores/         # Pinia 状态管理
│   │   ├── api/            # API 接口封装
│   │   ├── router/         # 路由配置
│   │   └── styles/         # 全局样式
│   └── ...
├── backend/           # Express 后端服务
│   ├── src/
│   │   ├── routes/        # 路由层
│   │   ├── controllers/   # 控制器
│   │   ├── services/      # 业务逻辑层
│   │   ├── middlewares/    # 中间件（JWT、权限、错误处理）
│   │   └── config/        # 配置
│   └── ...
├── db/                # 数据库脚本与迁移
│   ├── init/              # 初始化 SQL
│   └── migrations/        # Knex 迁移文件
└── docker-compose.yml # Docker 编排
```

#### 功能特性

- **任务管理**：发布任务、浏览任务、按类别/价格/距离筛选
- **任务生命周期**：发布 → 接单 → 进行中 → 完成 → 评价
- **实时聊天**：接单后任务双方即时沟通
- **用户系统**：注册登录、个人中心、信誉评价
- **管理员后台**：用户管理、任务管理、数据统计看板（ECharts 图表）
- **地图定位**：高德地图集成，支持发布任务时选择位置

#### 安装教程

1. **环境要求**
   - Node.js >= 18
   - MySQL >= 8.0
   - Docker & Docker Compose（可选）

2. **数据库初始化**
   ```bash
   # 创建数据库并导入初始表结构
   mysql -u root -p < db/init/01-init.sql

   # 或者使用 Knex 迁移
   cd backend
   npm run migrate
   npm run seed
   ```

3. **后端启动**
   ```bash
   cd backend
   npm install
   cp .env.example .env    # 修改数据库和 JWT 配置
   npm run dev             # 开发模式，默认端口 3000
   ```

4. **前端启动**
   ```bash
   cd frontend
   npm install
   npm run dev             # 开发模式，默认端口 5173
   ```

5. **Docker 部署（一键启动）**
   ```bash
   docker-compose up -d
   ```

#### 使用说明

1. 访问 `http://localhost:5173` 进入首页
2. 注册账号并登录
3. 浏览首页跑腿任务列表，可按类别/价格筛选
4. 点击"发布任务"填写表单（标题、描述、价格、位置等）
5. 选择任务点击"接单"开始跑腿
6. 接单后可通过聊天功能与对方沟通
7. 任务完成后互相评价，积累信誉分
8. 管理员登录后可访问 `/admin` 管理后台

#### 参与贡献

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

#### 开源协议

本项目基于 MIT 协议开源。