codecanyon-51173007-ondemand24-multivendor-service-booking-ecommerce-dgtl-downld-platform-cust-web-mob-admin

# OnDemand24 - 多供应商服务预订电商平台

## 项目概述
- **项目类型**：Web应用 + API后端（Laravel框架）
- **主要功能**：多供应商服务预订平台，支持数字商品下载、服务预约、电商购物
- **技术栈**：
  - 后端框架：Laravel 12.x
  - PHP版本：8.4+
  - 数据库：MySQL/PostgreSQL
  - 前端：Blade模板 + Vue.js组件
  - API：RESTful API with Sanctum认证
  - 缓存：Redis
  - 队列：Laravel Queue
  - 支付：Stripe, PayPal, Razorpay, Paystack等

## 模块结构

```
app/
├── Console/                  # Artisan命令
├── Events/                   # 事件类
├── Exceptions/               # 异常处理
├── Exports/                  # 数据导出
├── Helpers/                  # 辅助函数
├── Http/
│   ├── Controllers/
│   │   ├── API/v1/          # API控制器
│   │   │   ├── Auth/        # 认证相关
│   │   │   ├── Dashboard/   # 仪表板
│   │   │   │   ├── Admin.php
│   │   │   │   ├── Deliveryman.php
│   │   │   │   ├── Master.php
│   │   │   │   ├── Payment.php
│   │   │   │   ├── Seller.php
│   │   │   │   └── User.php
│   │   │   └── Rest/        # REST资源控制器
│   │   │       ├── AdsPackageController.php
│   │   │       ├── AuctionController.php
│   │   │       ├── BookingController.php
│   │   │       ├── CartController.php
│   │   │       ├── CategoryController.php
│   │   │       ├── CouponController.php
│   │   │       ├── MasterController.php
│   │   │       ├── OrderController.php
│   │   │       ├── PaymentController.php
│   │   │       ├── ProductController.php
│   │   │       ├── ServiceController.php
│   │   │       ├── ServiceMasterController.php
│   │   │       ├── ShopController.php
│   │   │       └── ...
│   │   └── Controller.php
│   └── Middleware/           # 中间件
├── Imports/                  # 数据导入
├── Jobs/                     # 队列任务
├── Listeners/                # 事件监听器
├── Models/                   # Eloquent模型
├── Observers/                # 模型观察者
├── Providers/                # 服务提供者
├── Repositories/             # 仓库模式
├── Services/                 # 业务服务层
└── Traits/                   # 特性类

数据库模型（关键）：
├── User                      # 用户
├── Shop                      # 店铺/供应商
├── Service                   # 服务
├── ServiceMaster             # 服务师傅/提供者
├── Booking                   # 预订
├── Order                     # 订单
├── Product                   # 产品
├── Category                  # 分类
├── Coupon                    # 优惠券
├── Payment                   # 支付
├── Wallet                    # 钱包
├── Cart                      # 购物车
├── Review                    # 评价
├── Notification              # 通知
└── ...（100+模型）
```

## 核心业务逻辑

### 1. 多供应商服务预订系统
- **供应商注册**：服务商可以注册并创建店铺
- **服务发布**：供应商发布可预订的服务项目
- **服务搜索**：用户按分类、位置、价格筛选服务
- **在线预订**：选择服务时间、填写需求、提交预订
- **师傅分配**：系统分配或用户选择服务师傅

### 2. 电商系统
- **产品管理**：多供应商产品上架
- **购物车**：跨店铺购物车
- **订单处理**：订单创建、支付、发货、完成流程
- **库存管理**：实时库存跟踪
- **数字商品**：支持数字产品下载

### 3. 拍卖系统
- **商品拍卖**：支持竞价拍卖功能
- **拍卖管理**：拍卖创建、出价、结束流程

### 4. 会员与积分系统
- **会员等级**：多级会员体系
- **积分系统**：消费积分、积分兑换
- **推荐奖励**：推荐新用户获得奖励

### 5. 支付与钱包
- **多支付方式**：Stripe, PayPal, Razorpay, Paystack等
- **钱包系统**：用户钱包充值、支付、提现
- **分账系统**：平台与供应商分账

### 6. 配送系统
- **配送点管理**：设置配送点
- **配送员管理**：配送员注册、订单分配
- **实时追踪**：配送状态实时更新

## 核心代码分析

### 路由架构 (routes/api.php)
```php
// API版本控制：v1
// 认证路由：注册、登录、密码重置
// REST资源路由：产品、分类、订单、服务等
// 仪表板路由：按角色分组的仪表板API
```

### 控制器结构
- **Rest控制器**：处理前端REST API请求
- **Dashboard控制器**：按角色划分的管理后台API
  - Admin：管理员仪表板
  - Seller：供应商/商家仪表板
  - Master：服务师傅仪表板
  - Deliveryman：配送员仪表板
  - User：用户仪表板
  - Payment：支付相关

### 关键模型关系
```php
// 用户-店铺关系
User -> hasMany -> Shop

// 店铺-服务关系
Shop -> hasMany -> Service

// 服务-预订关系
Service -> hasMany -> Booking

// 订单关系
Order -> belongsTo -> User
Order -> hasMany -> OrderDetail
Order -> belongsTo -> Shop

// 支付关系
Payment -> belongsTo -> Order
Payment -> belongsTo -> User
```

### 支付集成
支持的支付网关：
- Stripe
- PayPal (srmklive/paypal)
- Razorpay
- Paystack
- MercadoPago
- PayTabs

### 第三方服务集成
```json
{
  "firebase": "推送通知",
  "aws": "AWS SDK for S3存储",
  "google": "Google API Client",
  "twilio": "短信服务",
  "sendgrid": "邮件服务",
  "botman": "聊天机器人",
  "socialite": "社交登录"
}
```

### 安全特性
- **Sanctum**：API认证
- **Spatie Permission**：RBAC权限控制
- **IP黑名单**：block.ip中间件
- **会话管理**：sessions中间件

### 性能优化
- **缓存**：Redis缓存支持
- **队列**：异步任务处理
- **备份**：Spatie Laravel Backup
- **图片处理**：Intervention Image

## 多应用架构

OnDemand24是一个多应用生态系统，包含：

1. **主平台** (当前项目)
   - Web端用户界面
   - 管理后台
   - REST API

2. **Manager App** (codecanyon-51450060)

... (content truncated)