codecanyon-40825792-edemand-multi-vendor-on-demand-home-doorstep-services-marketplace-with-flutter-app-admin-panel

# eDemand - 多供应商按需上门服务平台

## 项目概述

eDemand 是一个功能完整的多供应商按需上门服务平台，类似于 TaskRabbit 或 Urban Company。系统支持多种服务类型，连接服务提供商与客户，提供完整的预订、支付、评价功能。

**版本**: 4.5.0
**定位**: 多供应商按需服务市场平台
**架构**: Flutter移动应用 + Next.js Web + CodeIgniter管理后台

## 主要功能

### 用户端应用 (Customer App)
- **用户认证**: 手机号/邮箱注册、OTP验证、Google/Apple登录
- **服务浏览**: 按分类浏览服务、搜索功能
- **提供商发现**: 查看附近服务提供商、评分、价格
- **预订管理**: 预约服务、选择时间、地址管理
- **订单追踪**: 实时订单状态追踪
- **支付系统**: 多支付网关支持（Stripe、Razorpay）
- **地址管理**: 多地址保存、GPS定位
- **实时聊天**: 与提供商沟通
- **评价系统**: 服务评分和评论
- **收藏功能**: 收藏喜欢的提供商
- **推送通知**: Firebase推送通知
- **多语言**: 国际化支持
- **广告集成**: Google Mobile Ads

### 服务提供商应用 (Provider App)
- **订单管理**: 接收/拒绝订单、订单状态更新
- **服务管理**: 添加/编辑服务项目、价格设置
- **时间管理**: 可服务时间设置
- **收入统计**: 收入报表、统计
- **订单历史**: 历史订单查询
- **客户沟通**: 与客户实时聊天
- **评价管理**: 查看客户评价
- **工作状态**: 在线/离线状态切换

### Web前端 (Next.js)
- **服务展示**: 服务分类、提供商列表
- **用户注册**: 客户和提供商注册
- **预订功能**: 在线预订服务
- **支付集成**: 在线支付
- **SEO优化**: 搜索引擎优化
- **响应式设计**: 移动端适配
- **PWA支持**: 渐进式Web应用

### 管理后台 (CodeIgniter 4)
- **仪表盘**: 数据统计、图表展示
- **用户管理**: 客户和提供商管理
- **服务管理**: 服务分类、子分类管理
- **订单管理**: 订单监控、争议处理
- **财务管理**: 支付管理、提现处理
- **营销工具**: 优惠券、推广管理
- **内容管理**: 页面、博客管理
- **系统设置**: 支付配置、通知设置
- **报表系统**: 多维度数据报表

## 技术栈

### 移动端应用 (Flutter)
- **框架**: Flutter 3.6.0+
- **状态管理**: Flutter Bloc 9.1.0
- **本地存储**: Hive、SharedPreferences
- **网络请求**: Dio 5.9.0
- **推送通知**: Firebase Messaging、Awesome Notifications
- **地图服务**: Google Maps Flutter、Geolocator
- **支付集成**: Razorpay、Stripe
- **社交登录**: Google Sign In、Sign in with Apple
- **图片处理**: Cached Network Image、Image Picker、Image Cropper
- **动画**: Lottie、Carousel Slider
- **广告**: Google Mobile Ads
- **UI组件**: Pinput、Shimmer、Flutter Slidable、Flutter SVG
- **字体**: Lexend字体家族

### Web前端 (Next.js)
- **框架**: Next.js 14.2+
- **React**: React 18
- **状态管理**: Redux Toolkit + Redux Persist
- **数据获取**: TanStack React Query
- **UI组件**: Radix UI组件库
- **样式**: Tailwind CSS 3.4
- **动画**: Framer Motion
- **地图**: React Google Maps API
- **支付**: Stripe React、Paystack Inline JS
- **日期**: Day.js、Date Fns
- **图标**: Lucide React、React Icons
- **轮播**: Swiper
- **工具**: Axios、JS Cookie

### 管理后台 (CodeIgniter 4)
- **框架**: CodeIgniter 4.5 (PHP 8.1+)
- **认证**: Ion Auth 4
- **数据库**: MySQL
- **支付网关**: Stripe、Razorpay、Paystack、Xendit
- **PDF生成**: mPDF
- **Excel处理**: PhpSpreadsheet
- **AWS SDK**: AWS S3文件存储
- **队列**: CodeIgniter Queue
- **日志查看**: CodeIgniter Log Viewer
- **Google API**: Firebase Cloud Messaging

### 第三方服务
- **Firebase**: 推送通知、认证、分析
- **Google Maps**: 地图和位置服务
- **Stripe**: 支付处理
- **Razorpay**: 印度支付网关
- **Paystack**: 非洲支付网关
- **Xendit**: 东南亚支付网关
- **AWS S3**: 文件存储

## 文件结构

```
eDemand 4.5.0/
├── eDemand app v4.5.0/           # Flutter移动应用
│   ├── eDemand Customer.zip      # 用户端应用
│   │   └── eDemand/
│   │       ├── lib/              # Dart源码
│   │       ├── assets/           # 静态资源
│   │       └── pubspec.yaml      # 依赖配置
│   └── eDemand Provider.zip      # 提供商应用
│
├── eDemand web v4.5.0/           # Next.js Web应用
│   ├── src/                      # 源码
│   ├── public/                   # 静态资源
│   ├── scripts/                  # 构建脚本
│   ├── next.config.mjs           # Next.js配置
│   ├── tailwind.config.js        # Tailwind配置
│   └── package.json              # 依赖配置
│
├── eDemand panels v4.5.0/        # CodeIgniter管理后台
│   └── Code 4.5.0 - Upload this to the server/
│       ├── app/                  # 应用代码
│       │   ├── Config/           # 配置
│       │   ├── Controllers/      # 控制器
│       │   ├── Models/           # 模型
│       │   └── Views/            # 视图
│       ├── public/               # 入口文件
│       ├── vendor/               # Composer依赖
│       ├── composer.json         # PHP依赖
│       └── .env                  # 环境配置
│
└── eDemand documentation/        # 项目文档
```

## 安装说明

### 管理后台安装

1. **环境要求**
   - PHP 8.1+
   - MySQL 5.7+
   - Composer

2. **安装步骤**
   ```bash
   cd "eDemand panels v4.5.0/Code 4.5.0 - Upload this to the server"
   
   # 安装依赖
   composer install
   
   # 环境配置
   cp env.example .env
   
   # 配置数据库 (编辑 .env)
   database.default.hostname = localhost
   database.default.database = edemand
   database.default.username = root
   database.default.password = your_password
   
   # 配置Firebase (编辑 .env)
   firebase.serverKey = your_firebase_server_key
   
   # 配置支付网关 (编辑 .env)
   stripe.key = your_stripe_key
   stripe.secret = your_stripe_secret
   razorpay.key = your_razorpay_key
   razorpay.secret = your_razorpay_secret
   
   # 设置目录权限
   chmod 777 writable/
   ```

### Web应用安装

1. **环境要求**
   - Node.js 18+
   - NPM 9+

2. **安装步骤**
   ```bash
   cd "eDemand web v4.5.0"
   
   # 安装依赖
   npm install
   
   # 环境配置
   cp .env.example .env
   
   # 配置API端点 (编辑 .env)

... (content truncated)