# 旧物回收

**Repository Path**: malcador/recycling-of-old-items

## Basic Information

- **Project Name**: 旧物回收
- **Description**: 智能旧物回收系统
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2025-06-19
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 旧物回收系统

一个基于 Spring Boot 的旧物回收平台，支持用户发布旧物、预约回收、订单管理、评价反馈等功能。

## 项目简介

本系统是一个面向社区的旧物回收服务平台，主要功能包括：

- **用户管理**：注册、登录、角色管理（普通用户、回收员、管理员）
- **旧物管理**：发布待回收的旧物、审核状态管理
- **订单管理**：预约订单创建、取消、查询
- **分类管理**：旧物分类管理
- **评价反馈**：用户对回收员进行评价、反馈建议
- **统计分析**：订单统计、营业额报表、用户报表
- **支付集成**：支付宝支付

## 技术栈

- **后端**：Spring Boot、MyBatis-Plus
- **数据库**：MySQL
- **缓存**：Redis
- **文件存储**：阿里云 OSS
- **短信服务**：阿里云 SMS
- **支付**：支付宝
- **WebSocket**：实时通信

## 模块结构

```
recycling-of-old-items/
├── common/          # 公共模块（常量、异常、工具类、配置）
├── model/           # 数据模型（实体类、枚举）
└── web/web01/       # Web应用（Controller、Service、Mapper）
```

## 快速开始

### 环境要求

- JDK 1.8+
- Maven 3.6+
- MySQL 5.7+
- Redis

### 配置说明

在 `application.yml` 中配置数据库、Redis、阿里云OSS等服务：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/recycling
    username: root
    password: your_password
  redis:
    host: localhost
    port: 6379

alioss:
  endpoint: oss-cn-hangzhou.aliyuncs.com
  accessKeyId: your_access_key
  accessKeySecret: your_secret
  bucketName: your_bucket

minio:
  endpoint: http://localhost:9000
  accessKey: minioadmin
  secretKey: minioadmin
  bucketName: recycle

aliyun:
  sms:
    endpoint: dysmsapi.aliyuncs.com
    accessKeyId: your_access_key
    accessKeySecret: your_secret

alipay:
  appId: your_app_id
  privateKey: your_private_key
  # ... 其他配置
```

### 构建运行

```bash
# 打包项目
mvn clean package -DskipTests

# 运行项目
java -jar web/web01/target/web01-1.0-SNAPSHOT.jar
```

## 主要接口

### 用户接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/customer/login/register` | POST | 用户注册 |
| `/customer/login/username` | POST | 用户名登录 |
| `/customer/login/phone` | POST | 手机号登录 |
| `/customer/user/page` | GET | 分页查询用户 |

### 旧物接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/customer/item/create` | POST | 发布旧物 |
| `/customer/item/delete` | POST | 删除旧物 |
| `/customer/item/review` | POST | 审核旧物 |
| `/customer/item/page` | GET | 分页查询旧物 |

### 订单接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/customer/order/create` | POST | 创建订单 |
| `/customer/order/cancel` | POST | 取消订单 |
| `/customer/order/page` | GET | 查询订单 |

### 分类接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/admin/category/page` | GET | 分页查询分类 |
| `/admin/category/create` | POST | 新增分类 |
| `/admin/category/update` | PUT | 更新分类 |
| `/admin/category/delete` | DELETE | 删除分类 |

### 统计接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/statistic/getOrderCount` | GET | 订单统计 |
| `/statistic/getTurnover` | GET | 营业额统计 |
| `/statistic/getUserReport` | GET | 用户统计 |

## 数据库表

主要数据表：
- `users` - 用户信息
- `items` - 旧物信息
- `orders` - 订单信息
- `order_details` - 订单详情
- `categories` - 分类信息
- `addresses` - 收货地址
- `feedbacks` - 用户反馈
- `ratings` - 评价信息
- `roles` - 角色信息
- `notifications` - 通知信息

## 许可证

MIT License