codecanyon-26400110-truelysell-ondemand-service-marketplace-nearby-service-finder-and-bookings

# TruelySell - 按需服务市场平台

## 项目概述
- **项目类型**：Web应用（Laravel框架 + 模块化架构）
- **主要功能**：多供应商按需服务市场平台，类似TaskRabbit，支持服务发布、预约、支付、评价
- **技术栈**：
  - 后端框架：Laravel 12
  - 前端：Livewire + Blade + Tailwind CSS
  - 数据库：MySQL/PostgreSQL
  - 模块系统：nwidart/laravel-modules
  - 支付网关：Stripe、PayPal、Razorpay、Mollie、Cashfree等
  - 实时通信：Firebase + Pusher
  - 地图服务：Google Maps API

## 模块结构

```
├── app/
│   ├── CentralLogics/        # 核心业务逻辑
│   ├── Console/              # 命令行工具
│   ├── Helpers/              # 辅助函数
│   ├── Http/
│   │   ├── Controllers/      # 控制器
│   │   └── Middleware/       # 中间件
│   ├── Library/              # 类库
│   ├── Models/               # Eloquent模型
│   ├── Observers/            # 模型观察者
│   ├── Providers/            # 服务提供者
│   ├── Repositories/         # 仓库模式
│   └── Services/             # 业务服务
├── Modules/                  # 模块化组件
│   ├── Blogs/                # 博客模块
│   ├── Categories/           # 分类模块
│   ├── Chat/                 # 即时通讯模块
│   ├── Communication/        # 通信模块
│   ├── Faq/                  # FAQ模块
│   ├── GlobalSetting/        # 全局设置模块
│   ├── Installer/            # 安装程序模块
│   ├── Leads/                # 潜在客户模块
│   ├── MenuBuilder/          # 菜单构建器
│   ├── Newsletter/           # 邮件订阅模块
│   ├── Page/                 # 页面管理模块
│   ├── Product/              # 产品模块
│   ├── Report/               # 报表模块
│   ├── RolesPermissions/     # 角色权限模块
│   ├── Service/              # 服务核心模块
│   └── Testimonials/         # 用户评价模块
├── bootstrap/
├── config/
├── database/
├── resources/
├── routes/
└── storage/
```

## 核心业务逻辑

### 1. 服务管理模块 (Service)
- **服务发布**：供应商发布服务项目，设置价格、描述、图片
- **服务分类**：多级分类系统，便于服务发现
- **服务搜索**：基于位置、分类、价格、评分的搜索
- **服务套餐**：支持多种服务套餐（基础、标准、高级）
- **服务收藏**：用户收藏感兴趣的服务

### 2. 预约与订单系统
- **在线预约**：用户选择服务时间进行预约
- **订单管理**：订单状态跟踪（待确认、已确认、进行中、已完成）
- **日程管理**：供应商管理自己的服务日程
- **冲突检测**：自动检测时间冲突

### 3. 支付系统
- **多支付网关**：支持Stripe、PayPal、Razorpay、Mollie、Cashfree等
- **钱包系统**：平台钱包，支持充值和提现
- **佣金管理**：平台从每笔交易中抽取佣金
- **退款处理**：支持部分和全额退款

### 4. 用户管理
- **多角色系统**：管理员、供应商、客户
- **供应商认证**：供应商资质审核流程
- **客户管理**：客户信息管理
- **角色权限**：基于Spatie Laravel Permission的细粒度权限控制

### 5. 评价与反馈
- **双向评价**：客户评价服务，供应商评价客户
- **星级评分**：1-5星评分系统
- **评价展示**：服务详情页展示评价
- **信誉系统**：基于评价的信誉积分

### 6. 即时通讯 (Chat模块)
- **实时聊天**：客户与供应商实时沟通
- **文件传输**：支持图片和文档传输
- **消息通知**：邮件和站内通知

### 7. 营销工具
- **博客系统**：内容营销和SEO
- **邮件订阅**：Newsletter功能
- **推荐系统**：基于位置和用户行为的服务推荐

## 核心代码分析

### 模块系统架构
使用 `nwidart/laravel-modules` 实现模块化架构，每个模块独立包含：
- Controllers/ - 控制器
- Models/ - 模型
- Views/ - 视图
- Config/ - 配置
- Routes/ - 路由
- Services/ - 业务逻辑

### 主要模型关系

#### Service模型
```php
class Service extends Model
{
    // 关联关系
    public function provider()      // 服务提供商
    public function category()      // 所属分类
    public function bookings()      // 预约记录
    public function reviews()       // 评价
    public function images()        // 服务图片
}
```

#### Booking模型
```php
class Booking extends Model
{
    // 关联关系
    public function service()       // 关联服务
    public function customer()      // 客户
    public function provider()      // 提供商
    public function payment()       // 支付记录
    public function reviews()       // 评价
}
```

### 支付集成
支持多种支付网关：
- **Stripe**：国际信用卡支付
- **PayPal**：PayPal账户支付
- **Razorpay**：印度市场支付
- **Mollie**：欧洲支付网关
- **Cashfree**：印度支付网关
- **Authorize.net**：信用卡处理

### 数据库核心表
```
users                          # 用户表
services                       # 服务表
service_categories             # 服务分类
service_images                 # 服务图片
bookings                       # 预约订单表
booking_statuses               # 订单状态
payments                       # 支付记录
reviews                        # 评价表
conversations                  # 聊天会话
messages                       # 消息表
provider_profiles              # 供应商资料
provider_documents             # 供应商认证文档
```

## 功能特点

1. **多供应商市场**：支持无限供应商入驻
2. **地理位置服务**：基于位置的服务搜索和匹配
3. **实时通讯**：内置聊天系统
4. **多支付网关**：支持全球主流支付方式
5. **评价系统**：双向评价机制
6. **SEO优化**：内置SEO工具和博客系统
7. **多语言支持**：国际化和本地化
8. **响应式设计**：移动端友好
9. **管理后台**：完整的后台管理系统
10. **模块化架构**：易于扩展和维护

## 技术亮点

1. **Laravel 12**：最新PHP框架
2. **模块化设计**：使用nwidart/laravel-modules
3. **Livewire**：无JavaScript的动态组件
4. **Spatie权限**：基于角色的权限管理
5. **Laravel Sanctum**：API认证
6. **Firebase集成**：推送通知和实时数据
7. **多支付网关**：灵活的支付集成
8. **Google Maps**：地图和位置服务

## 部署说明

### 环境要求
- PHP >= 8.4
- MySQL >= 5.7 或 PostgreSQL
- Composer
- Node.js & NPM
- Redis（可选，用于缓存和队列）

### 安装步骤
```bash
composer install
npm install && npm run build
php artisan migrate

... (content truncated)