# 农产品销售系统

**Repository Path**: Cheesezzc/nxt

## Basic Information

- **Project Name**: 农产品销售系统
- **Description**: 一个基于springbbot3+vue3的农产品销售系统
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-09-12
- **Last Updated**: 2025-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 农业销售平台

## 项目简介

本项目是一个基于 Spring Boot+vue3 的农业产品销售平台，旨在为农产品提供一个高效的在线销售渠道。平台支持商品管理、订单处理、支付集成、物流跟踪、用户评价、推荐系统等功能，适用于电商平台、农户及消费者之间的交易。

### 主要功能

- **商品管理**：支持商品的增删改查、分类管理、库存管理、商品推荐等。
- **订单管理**：支持订单创建、支付、状态更新、退款申请等。
- **支付集成**：集成支付宝支付，支持订单支付及支付回调处理。
- **物流跟踪**：支持物流信息创建、状态更新、签收确认等。
- **用户评价**：用户可对商品进行评价，支持评价状态管理。
- **推荐系统**：基于用户行为生成个性化推荐。
- **统计分析**：提供订单、销售额、用户增长等数据统计功能。
- **聊天系统**：集成 AI 聊天机器人，支持用户与商家沟通。
- **权限管理**：支持用户角色管理、菜单权限分配等。

### 技术栈

- **后端**：Spring Boot、MyBatis Plus、Redis、JWT、Alipay SDK、Caffeine 缓存
- **前端**：未提供，但可通过 REST API 接口对接任意前端框架
- **数据库**：MySQL（默认 ORM 框架为 MyBatis Plus）
- **部署**：Maven 构建工具，支持本地部署或云服务器部署

---

## 快速开始

### 环境要求

- Java 17+
- Maven 3.8+
- MySQL 8.0+
- Redis 6.0+
- 支付宝沙箱环境（用于支付功能）

### 项目结构

```
src/
├── main/
│   ├── java/
│   │   └── org.example.springboot/
│   │       ├── controller/        # 控制器层（REST API）
│   │       ├── service/           # 业务逻辑层
│   │       ├── mapper/            # 数据访问层（MyBatis Mapper）
│   │       ├── entity/            # 数据库实体类
│   │       ├── config/            # 配置类（Spring Boot 配置）
│   │       ├── aspect/            # AOP 切面
│   │       ├── util/              # 工具类
│   │       └── SpringbootApplication.java # 启动类
│   └── resources/
│       └── application.properties # 配置文件
└── test/
    └── java/
        └── org.example.springboot/
            └── SpringbootApplicationTests.java # 单元测试
```

### 启动步骤

1. **克隆项目**

```bash
git clone https://gitee.com/tanelei/agricultural-sales-channel.git
```

2. **配置数据库**

- 创建 MySQL 数据库并导入项目所需的表结构（可参考 `src/main/resources` 中的 SQL 文件）
- 修改 `application.properties` 中的数据库连接信息

3. **配置支付宝沙箱**

- 在 `application.properties` 中配置支付宝沙箱的 `appId`、`appPrivateKey`、`alipayPublicKey`、`notifyUrl`

4. **启动项目**

```bash
cd agricultural-sales-channel
mvn spring-boot:run
```

5. **访问接口文档**

- 项目集成 Knife4j 接口文档，访问地址：`http://localhost:8080/doc.html`

---

## API 接口说明

### 用户管理

- `POST /user/login`：用户登录
- `POST /user/add`：注册新用户
- `GET /user/{id}`：获取用户信息
- `PUT /user/{id}`：更新用户信息
- `DELETE /user/{id}`：删除用户

### 商品管理

- `POST /product`：创建商品
- `PUT /product/{id}`：更新商品
- `DELETE /product/{id}`：删除商品
- `GET /product/{id}`：获取商品详情
- `GET /product/page`：分页查询商品列表

### 订单管理

- `POST /order`：创建订单
- `PUT /order/{id}/pay`：支付订单
- `PUT /order/{id}/status`：更新订单状态
- `GET /order/{id}`：获取订单详情
- `GET /order/user/{userId}`：获取用户订单列表

### 支付管理

- `GET /alipay/pay/{orderId}`：支付宝支付接口
- `POST /alipay/notify`：支付宝支付回调通知

### 物流管理

- `POST /logistics`：创建物流信息
- `PUT /logistics/{id}/status`：更新物流状态
- `GET /logistics/order/{orderId}`：获取订单物流信息

### 聊天系统

- `POST /chat/new`：创建新对话
- `POST /chat/send`：发送消息
- `GET /chat/history/{userId}/{conversationId}`：获取聊天记录

---

## 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 本项目
2. 创建新分支 (`git checkout -b feature/your-feature`)
3. 提交代码 (`git commit -am 'Add some feature'`)
4. 推送分支 (`git push origin feature/your-feature`)
5. 创建 Pull Request

---

## 许可证

本项目采用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。

---