# fruit

**Repository Path**: openclaw_8/fruit

## Basic Information

- **Project Name**: fruit
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 水果社区团购管理系统 - 完整项目文档

## 项目概述

基于 RuoYi-Vue-Plus + plus-ui 架构的水果社区团购管理系统

### 技术栈
- **后端**: Spring Boot 2.7.x + MyBatis-Plus + Sa-Token
- **前端**: Vue3 + Vite + Element Plus
- **数据库**: MySQL 8.x
- **小程序**: UniApp

---

## 快速开始

### 1. 环境准备

```bash
# Java 8+
java -version

# Node.js 16+
node -v

# MySQL 8.x
mysql --version

# Maven 3.6+
mvn -v
```

### 2. 数据库初始化

```bash
cd E:/Project/fruit/sql
mysql -u root -p < fruit_group_buy.sql
```

### 3. 使用RuoYi代码生成器生成完整代码

#### 3.1 启动RuoYi-Vue-Plus基础项目
```bash
cd E:/Project/fruit/backend/ruoyi-admin
mvn clean package -DskipTests
java -jar target/ruoyi-admin.jar
```

#### 3.2 登录后台管理系统
- 地址: http://localhost:8080
- 账号: admin / admin123

#### 3.3 进入代码生成器
1. 系统工具 -> 代码生成
2. 点击"导入"按钮
3. 选择以下表导入：
   - `product_category` - 商品分类
   - `product_info` - 商品信息
   - `group_leader` - 团长信息
   - `order_info` - 订单信息
   - `order_item` - 订单明细
   - `shopping_cart` - 购物车
   - `user_address` - 用户地址

#### 3.4 配置生成参数
对于每张表，点击"编辑"配置：

**基本信息**
- 实体类名: ProductCategory
- 作者: ruoyi
- 上级菜单: 业务管理
- 生成方式: 自定义模板

**字段信息**
- 检查每个字段的配置
- 设置字段类型、是否必填、显示方式等

**生成信息**
- 生成模板: 单表（增删改查）
- 生成方式: 自定义模板
- 后端生成路径: E:/Project/fruit/backend/ruoyi-admin
- 前端生成路径: E:/Project/fruit/frontend/ruoyi-ui

#### 3.5 生成代码
1. 勾选需要生成的表
2. 点击"生成"按钮
3. 代码将自动生成到指定目录

### 4. 启动后端服务

```bash
cd E:/Project/fruit/backend/ruoyi-admin

# 修改数据库配置
vim src/main/resources/application-druid.yml

# 打包运行
mvn clean package -DskipTests
java -jar target/ruoyi-admin.jar
```

后端API地址: http://localhost:8080

### 5. 启动前端服务

```bash
cd E:/Project/fruit/frontend/ruoyi-ui

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端地址: http://localhost:80

---

## 项目结构

### 后端结构 (RuoYi-Vue-Plus)

```
ruoyi-admin/src/main/java/com/ruoyi/fruit/
├── controller/          # 控制器层
│   ├── ProductCategoryController.java
│   ├── ProductInfoController.java
│   ├── GroupLeaderController.java
│   └── OrderInfoController.java
├── service/             # 业务逻辑层
│   ├── IProductCategoryService.java
│   ├── IProductInfoService.java
│   ├── IGroupLeaderService.java
│   └── IOrderInfoService.java
│   └── impl/            # 实现类
│       ├── ProductCategoryServiceImpl.java
│       ├── ProductInfoServiceImpl.java
│       ├── GroupLeaderServiceImpl.java
│       └── OrderInfoServiceImpl.java
├── mapper/              # 数据访问层
│   ├── ProductCategoryMapper.java
│   ├── ProductInfoMapper.java
│   ├── GroupLeaderMapper.java
│   └── OrderInfoMapper.java
└── domain/              # 实体类
    ├── ProductCategory.java
    ├── ProductInfo.java
    ├── GroupLeader.java
    └── OrderInfo.java

resources/mapper/fruit/  # XML映射文件
├── ProductCategoryMapper.xml
├── ProductInfoMapper.xml
├── GroupLeaderMapper.xml
└── OrderInfoMapper.xml
```

### 前端结构 (plus-ui)

```
ruoyi-ui/src/
├── api/fruit/           # API接口
│   ├── category.js
│   ├── product.js
│   ├── leader.js
│   └── order.js
├── views/fruit/         # 管理后台页面
│   ├── category/        # 分类管理
│   │   └── index.vue
│   ├── product/         # 商品管理
│   │   └── index.vue
│   ├── leader/          # 团长管理
│   │   └── index.vue
│   └── order/           # 订单管理
│       └── index.vue
└── views/app/           # 小程序端页面（UniApp）
    ├── pages/
    │   ├── index/       # 首页
    │   ├── product/     # 商品详情
    │   ├── cart/        # 购物车
    │   └── order/       # 订单
    └── components/      # 公共组件
```

---

## 数据库设计

### 核心表结构

| 表名 | 说明 | 关键字段 |
|------|------|----------|
| product_category | 商品分类 | category_id, category_name, parent_id |
| product_info | 商品信息 | product_id, product_name, price, stock |
| group_leader | 团长信息 | leader_id, user_id, community_name |
| order_info | 订单主表 | order_id, order_no, order_status, pay_amount |
| order_item | 订单商品 | item_id, order_id, product_id, quantity |
| shopping_cart | 购物车 | cart_id, user_id, product_id, quantity |
| user_address | 用户地址 | address_id, user_id, detail_address |

---

## 功能模块

### 管理后台
1. **商品分类管理** - 分类增删改查、树形结构
2. **商品信息管理** - 商品上架、库存、价格管理
3. **团长管理** - 团长审核、佣金设置
4. **订单管理** - 订单查询、发货、退款处理
5. **数据统计** - 销售统计、团长业绩

### 小程序端
1. **首页** - 商品展示、分类筛选
2. **商品详情** - 商品信息、加入购物车、立即购买
3. **购物车** - 商品管理、结算
4. **订单** - 订单列表、订单详情、支付
5. **个人中心** - 地址管理、订单查看

---

## 部署说明

### 生产环境部署

```bash
# 1. 后端打包
cd E:/Project/fruit/backend/ruoyi-admin
mvn clean package -DskipTests

# 2. 前端打包
cd E:/Project/fruit/frontend/ruoyi-ui
npm run build:prod

# 3. 部署到服务器
scp backend/target/ruoyi-admin.jar root@server:/opt/fruit/
scp -r frontend/dist root@server:/opt/fruit/

# 4. 服务器启动
nohup java -jar /opt/fruit/ruoyi-admin.jar > /opt/fruit/server.log 2>&1 &

# 5. Nginx配置
# 将dist目录配置到nginx静态资源
```

---

## 开发规范

### 后端规范
- 遵循阿里巴巴Java开发手册
- 使用Lombok简化代码
- 统一返回AjaxResult
- 接口添加Swagger注解

### 前端规范
- 使用Vue3 Composition API
- 组件命名使用大驼峰
- API统一管理
- 路由配置统一维护

---

## 联系方式

项目文档维护: @cwo (首席牛马官)