# 校园网上店铺

**Repository Path**: dm_team/campus-online-store

## Basic Information

- **Project Name**: 校园网上店铺
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园网上店铺

校园二手交易与服务平台。每个学生都可以开店卖东西，支持全新/二手/服务三种商品类型，涵盖完整购物流程。

## 环境要求

| 工具 | 版本 |
|------|------|
| JDK | 17+ |
| MySQL | 8.0+ |
| Node.js | 20+ |
| Maven | 3.8+ |

## 数据库初始化

### 1. 创建数据库

```sql
CREATE DATABASE campus_shop CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

### 2. 导入表结构和数据

```bash
mysql -u root -p campus_shop < init.sql
```

或在 MySQL 中执行：

```sql
source /你的项目路径/init.sql;
```

## 后端启动

### 1. 修改数据库连接

编辑 `backend/src/main/resources/application.yml`，将 `password` 改为你的数据库密码。

### 2. 启动后端服务

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

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

## 前端启动

```bash
cd frontend
npm install
npm run dev
```

前端服务将在 `http://localhost:3000` 启动。

## 默认账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | admin123 |
| 普通用户 | test | test123 |
| 卖家（张三） | zhangsan | test123 |
| 卖家（零食坊） | wujiu | test123 |
| 卖家（跑腿站） | huangxiao | test123 |

> 所有普通用户注册后自动获得卖家能力，登录后进入"卖家中心"即可开店卖东西。

## 功能模块

| 模块 | 功能 |
|------|------|
| 认证 | 注册、登录、个人信息编辑、密码修改 |
| 商品浏览 | 首页推荐、分类筛选、关键词搜索、排序、商品详情 |
| 购物车 | 增删改、数量调整、优惠券选择 |
| 订单 | 下单、支付、取消、发货、确认收货、退款售后 |
| 卖家中心 | 店铺管理、商品发布/编辑、订单处理、优惠券管理 |
| 管理后台 | 仪表盘、用户管理、商品审核、分类管理、轮播图、公告、举报、退款 |
| 用户中心 | 地址管理、收藏、浏览足迹、消息通知、优惠券 |
| 互动 | 商品评价、收藏、关注店铺、举报、站内信 |

## 项目结构

```
├── init.sql              # 数据库初始化脚本（23张表 + 种子数据）
├── README.md
├── backend/              # Spring Boot 3.2 + MyBatis-Plus + JWT
│   └── src/main/java/com/campus/shop/
│       ├── common/       # 通用组件（配置/异常/结果/安全/工具）
│       ├── entity/       # 23个实体类
│       ├── mapper/       # MyBatis-Plus Mapper
│       ├── service/      # 业务逻辑层
│       ├── controller/   # REST API（80+接口）
│       ├── dto/          # 请求参数
│       └── vo/           # 响应值对象
└── frontend/             # Vue 3 + Element Plus + Pinia + Axios
    └── src/
        ├── api/          # Axios 请求封装
        ├── router/       # 路由守卫
        ├── store/        # Pinia 状态管理
        ├── layouts/      # 三套布局（用户/卖家/管理）
        └── views/        # 24个页面（含卖家端、管理端）
```