codecanyon-36772112-6ammart-multivendor-food-grocery-ecommerce-parcel-pharmacy-delivery-app-with-admin-website

# 6amMart - 多商户外卖电商配送平台（管理后台）

## 项目概述

- **项目类型**：Web应用（多商户电商平台管理后台）
- **主要功能**：多商户管理、订单管理、配送调度、商品管理、营销活动、支付管理、AI助手
- **技术栈**：
  - 后端：Laravel 12 + PHP 8.2+
  - 前端：Laravel Blade + Vue.js（部分）
  - 移动端：Flutter（用户端App、配送员App、商家App）
  - 数据库：MySQL
  - 实时通信：Laravel Reverb（WebSocket）
  - 地图：Google Maps

## 模块结构

```
├── app/
│   ├── CentralLogics/        # 核心业务逻辑
│   │   ├── BannerLogic.php   # 横幅管理
│   │   ├── CategoryLogic.php # 分类管理
│   │   ├── CampaignLogic.php # 营销活动
│   │   ├── ProductLogic.php  # 商品管理
│   │   ├── StoreLogic.php    # 店铺管理
│   │   ├── OrderLogic.php    # 订单处理
│   │   ├── CouponLogic.php   # 优惠券
│   │   ├── CustomerLogic.php # 客户管理
│   │   ├── Helpers.php       # 辅助函数
│   │   └── SMS_module.php    # 短信模块
│   ├── Http/
│   │   ├── Controllers/      # 控制器
│   │   │   ├── Admin/        # 管理员控制器
│   │   │   ├── Vendor/       # 商家控制器
│   │   │   └── Api/          # API控制器
│   │   └── Middleware/       # 中间件
│   ├── Models/               # Eloquent模型
│   ├── Library/              # 工具库
│   └── Utils/                # 工具类
├── Modules/                  # 功能模块
│   ├── AI/                   # AI助手模块
│   └── TaxModule/            # 税务模块
├── database/
│   ├── migrations/           # 数据库迁移
│   └── seeders/              # 数据填充
├── resources/
│   └── views/                # Blade模板
├── routes/
│   ├── admin.php             # 管理后台路由
│   ├── vendor.php            # 商家后台路由
│   └── api.php               # API路由
└── config/                   # 配置文件
```

## 核心业务逻辑

### 1. 多商户电商系统
- **商户入驻**：商家注册、审核、套餐订阅
- **店铺管理**：店铺信息、营业时间、配送范围
- **商品管理**：分类、属性、库存、变体
- **订单管理**：订单状态流转、取消、退款

### 2. 配送管理系统
- **配送方式**：自配送、第三方配送、自取
- **配送员管理**：注册、审核、排班、绩效
- **实时追踪**：GPS定位、配送路径规划
- **配送费计算**：基于距离、重量、时段

### 3. 营销与促销
- **优惠券**：满减、折扣、免配送费
- **活动管理**：限时折扣、买赠活动
- **积分系统**：消费积分、积分兑换
- **推送通知**：Firebase消息推送

### 4. 支付系统
- **多支付网关**：Stripe、Razorpay、PayPal、Paystack
- **钱包系统**：用户余额、充值、提现
- **货到付款**：COD支持
- **分期付款**：部分支付方式支持

### 5. AI助手模块
- 基于OpenAI的智能客服
- 自动回复常见问题
- 订单状态查询助手

## 核心代码分析

### 后端架构
- **框架**：Laravel 12（PHP 8.2+）
- **模块化**：nwidart/laravel-modules
- **API认证**：Laravel Passport（OAuth2）
- **实时通信**：Laravel Reverb（WebSocket）
- **队列**：Laravel Queue（数据库驱动）

### 关键依赖
```json
{
  "laravel/framework": "^12.0",
  "laravel/passport": "^12.0",       // API认证
  "laravel/reverb": "^1.0",          // WebSocket
  "nwidart/laravel-modules": "^12.0", // 模块化
  "kreait/firebase-php": "^7.12",    // Firebase
  "intervention/image": "^3.11",     // 图片处理
  "matanyadaev/laravel-eloquent-spatial": "^4.5", // 地理空间
  "openai-php/laravel": "^0.17"      // AI集成
}
```

### CentralLogics模式
项目采用独特的`CentralLogics`目录集中管理核心业务逻辑：
- 每个Logic类负责一个业务领域
- 封装复杂查询和数据处理
- 控制器层保持简洁，调用Logic方法

### 数据库设计特点
- 地理空间数据支持（配送范围、位置追踪）
- 多态关联（图片、通知）
- 软删除设计
- 索引优化（订单查询、位置查询）

### API设计
- RESTful API规范
- 版本控制（v1, v2）
- 响应格式统一封装
- 速率限制保护

### 第三方集成
- **地图**：Google Maps API（定位、距离计算）
- **推送**：Firebase Cloud Messaging
- **短信**：Twilio、自定义SMS网关
- **支付**：Stripe、Razorpay、PayPal、MercadoPago、PhonePe、Xendit
- **AI**：OpenAI GPT API

### 移动端配套
- **用户App**：Flutter开发，iOS/Android双端
- **配送员App**：Flutter开发，配送专用功能
- **商家App**：Flutter开发，店铺管理功能

---

*版本：3.7 | 配套移动端：用户App、配送员App、商家App*