# FluxStore Multi Vendor - Flutter 多商户电商应用
## 项目概述
**FluxStore Multi Vendor** 是一个基于 Flutter 构建的多商户电商平台，支持 WooCommerce、Shopify 等多种电商平台。该项目是 FluxStore 系列的多商户版本，具有完整的购物功能、支付集成、多语言支持等特性。
- **版本**: v5.6.0
- **Flutter 版本**: 3.38.3
- **技术栈**: Flutter + Provider + 依赖注入
- **平台**: Android, iOS, Web, macOS, Windows
- **官网**: https://1.envato.market/NW4q1
---
## 技术架构
### 核心技术栈
- **前端框架**: Flutter (>=3.10.0 <4.0.0)
- **状态管理**: Provider 6.1.2
- **依赖注入**: GetIt 8.0.2 + Injectable 2.5.0
- **本地存储**: Hive 2.2.3
- **HTTP 客户端**: Dio 5.7.0 + http 1.2.2
- **UI 框架**: inspireui 2.4.1 + flux_ui 0.0.15
### 核心依赖
```yaml
dependencies:
# InspireUI 核心包
inspireui: 2.4.1
flux_ui: 0.0.15
flux_localization: (本地包)
flux_interface: (本地包)
flux_firebase: (本地包)
flux_dynamic_link: ^1.2.1
# 状态管理
provider: 6.1.2
get_it: ^8.0.2
injectable: ^2.5.0
# 本地存储
hive: 2.2.3
hive_flutter: 1.1.0
flutter_secure_storage: ^9.2.4
# 网络请求
dio: ^5.7.0
http: ^1.2.2
connectivity_plus: 6.1.5
# 地图与定位
google_maps_flutter: 2.10.0
location: 8.0.1
geocoding: ^3.0.0
# 认证
local_auth: 2.3.0
google_sign_in: 6.2.2
flutter_facebook_auth: 7.1.2
the_apple_sign_in: 1.1.1
# 媒体处理
video_player: ^2.9.2
youtube_player_iframe: (Git)
image_picker: ^1.1.2
file_picker: 8.1.3
cached_network_image: 3.4.1
# UI 组件
lottie: ^3.1.3
rive: 0.13.20
flutter_spinkit: ^5.2.1
smooth_page_indicator: 1.2.0+3
carousel_slider_plus: 7.1.0
flutter_staggered_grid_view: 0.7.0
flutter_animate: 4.5.2
# 支付集成
phonepe_payment_sdk: ^2.0.3
flutterwave_standard: 1.1.0
razorpay_flutter: (Git)
paytm_allinonesdk: (Git)
pay_with_paystack: (Git)
# 推送通知
flutter_local_notifications: 18.0.1
onesignal_flutter: (Git)
# 分析追踪
facebook_app_events: 0.20.1
flutter_branch_sdk: 8.10.0
# 其他工具
google_fonts: ^6.2.1
speech_to_text: 7.0.0
qr_code_scanner: 1.0.1
rate_my_app: ^2.2.0
```
---
## 项目结构
```
lib/
├── main.dart # 应用入口
├── app.dart # 应用主组件
├── app_init.dart # 应用初始化
├── env.dart # 环境配置
├── config/ # 配置文件
│ ├── states/ # 美国商店配置
│ ├── stories/ # 故事配置
│ ├── us_store/ # 美国商店
│ ├── vi_store/ # 越南商店
│ └── ...
├── common/ # 公共组件和工具
│ ├── config/ # 通用配置
│ ├── constants/ # 常量定义
│ ├── theme/ # 主题样式
│ └── tools/ # 工具函数
├── data/ # 数据模型和存储
├── dependency_injection/ # 依赖注入配置
├── frameworks/ # 电商框架集成
│ ├── woocommerce/ # WooCommerce 集成
│ ├── shopify/ # Shopify 集成
│ └── ...
├── menu/ # 菜单配置
├── models/ # 数据模型
├── modules/ # 功能模块
├── repositories/ # 数据仓库层
├── routes/ # 路由管理
├── screens/ # 页面组件
├── services/ # 业务服务层
└── widgets/ # 可复用 UI 组件
```
---
## 核心功能模块
### 1. 多商户支持
- **多商家平台**: 支持多个卖家入驻
- **商家管理**: 每个商家拥有独立店铺页面
- **佣金系统**: 平台对商家销售抽取佣金
- **商家筛选**: 按商家筛选商品
### 2. 电商平台集成
- **WooCommerce**: 完整的 WooCommerce REST API 集成
- **Shopify**: Shopify GraphQL 和 REST API 支持
- **WordPress**: 内容管理和博客系统集成
### 3. 支付系统
- **国际支付**: PayPal, Stripe
- **印度支付**: PhonePe, Razorpay, PayTM
- **非洲支付**: Flutterwave, Paystack
- **其他**: 支持多种本地支付方式
### 4. 用户功能
- **社交登录**: Google, Facebook, Apple
- **生物识别**: 指纹和面容 ID
- **愿望清单**: 收藏商品
- **订单跟踪**: 实时订单状态
### 5. 营销功能
- **推送通知**: OneSignal, Firebase
- **深度链接**: Firebase Dynamic Links, Branch
- **广告集成**: Google Mobile Ads
- **社交分享**: 分享商品到社交媒体
### 6. 高级功能
- **动态布局**: FluxBuilder 可视化构建器支持
- **多语言**: 完整国际化支持
- **暗黑模式**: 主题切换
- **离线支持**: 部分功能离线可用
---
## 核心业务逻辑
### 1. 购物流程
1. 浏览商品（分类/搜索/商家）
2. 查看商品详情（多图片/规格选择）
3. 添加到购物车
4. 选择配送地址
5. 选择支付方式
6. 确认订单
7. 订单跟踪
### 2. 多商户流程
1. 浏览商家列表
2. 进入商家店铺
3. 浏览该商家商品
4. 跨商家购物车管理
5. 统一结算
### 3. 认证流程
1. 多种登录方式（邮箱/手机/社交）
2. 游客浏览
3. 账户绑定
4. 个人信息管理
... (content truncated)
