# 校园二手交易系统

**Repository Path**: dm_team/Student-Swap-Shop

## Basic Information

- **Project Name**: 校园二手交易系统
- **Description**: 校园二手交易系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-09
- **Last Updated**: 2026-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园二手交易系统 / Campus Secondhand Trading System

面向高校场景的二手交易与求购协同平台，包含商品管理、求购信息、交易订单、评价反馈、分类管理和用户管理等功能。

## 1. 技术栈

- 前端：React 18 + Vite + Ant Design + Recharts
- 后端：Node.js + Express
- 数据库：SQLite 文件数据库
- 推荐运行环境：Windows 10/11 + Node.js 20 LTS 或 22 LTS + npm 10+

SQLite 不需要单独安装，系统首次启动后端时会自动生成数据库文件。

## 2. 目录结构

```text
backend/      后端项目，接口服务和 SQLite 数据库文件
frontend/     前端项目，React 页面
database/     初始化 SQL 和演示数据 SQL
docs/         部署、接口、数据库、论文写作等说明文档
screenshots/  截图说明
```

## 3. 新手运行步骤

### 3.1 启动后端

```bash
cd D:\Ten-Projects\01-campus-secondhand-trading-system\backend
npm install
npm run dev
```

后端地址：

```text
http://localhost:9011
```

健康检查：

```text
http://localhost:9011/api/health
```

### 3.2 启动前端

重新打开一个终端：

```bash
cd D:\Ten-Projects\01-campus-secondhand-trading-system\frontend
npm install
npm run dev
```

前端地址：

```text
http://localhost:5173/
```

运行到这里后，浏览器会打开登录页。可直接使用下面账号登录：

- 管理员: `trade_admin` / `Pass@123`
- 普通用户: `trade_user` / `Pass@123`
- 演示用户: `buyer_demo` / `Pass@123`

建议第一次演示或检查时先使用管理员账号，因为管理员可以看到类别管理、用户管理和完整业务功能。
### 3.3 一键启动

Windows 可双击：

```text
start-project.bat
```

## 4. 默认账号

- 管理员：`trade_admin` / `Pass@123`
- 普通用户：`trade_user` / `Pass@123`
- 演示用户：`buyer_demo` / `Pass@123`

## 5. 数据库说明

数据库类型：SQLite。

数据库文件：

```text
backend/data/campus-secondhand-trading-system.db
```

首次启动后端会自动执行：

```text
database/init.sql
database/sample_data.sql
```

如果要恢复初始数据，关闭后端后删除 `backend/data` 下的 `.db`、`.db-shm`、`.db-wal` 文件，再重新启动后端。

## 6. 分类管理

系统已新增“分类管理”模块，默认预置不少于 100 个业务分类项，管理员可以随时新增、编辑、停用、启用和删除分类项。商品发布、求购发布和交易大厅筛选会读取启用状态的分类项。

## 7. 详细部署文档

新手请优先阅读：

[docs/06_部署说明.md](docs/06_部署说明.md)

该文档包含环境安装、目录说明、启动命令、数据库说明、Gitee 上传建议和常见问题。

## 8. 论文支持材料

- 项目简介：[docs/01_项目简介.md](docs/01_项目简介.md)
- 需求分析：[docs/02_需求分析.md](docs/02_需求分析.md)
- 系统设计：[docs/03_系统设计.md](docs/03_系统设计.md)
- 数据库设计：[docs/04_数据库设计.md](docs/04_数据库设计.md)
- 接口文档：[docs/05_接口文档.md](docs/05_接口文档.md)
- 部署说明：[docs/06_部署说明.md](docs/06_部署说明.md)
- 使用手册：[docs/07_使用手册.md](docs/07_使用手册.md)
- 测试说明：[docs/08_测试说明.md](docs/08_测试说明.md)