codecanyon-24050041-fluxstore-woocommerce-flutter-ecommerce-full-app

# FluxStore WooCommerce - Flutter电商全端应用

## 项目概述

- **项目类型**：移动应用 - 跨平台电商App（iOS/Android/Web）
- **主要功能**：完整的电商移动应用，支持WooCommerce、Shopify、Magento等后端，包含商品浏览、购物车、支付、订单追踪、用户管理等功能
- **技术栈**：
  - 框架：Flutter 3.10+ (Dart)
  - 状态管理：Provider + GetIt + Injectable
  - UI组件：Material Design + 自定义组件
  - API：RESTful API + GraphQL (Shopify)
  - 本地存储：Hive + Flutter Secure Storage

## 模块结构

```
lib/
├── app.dart                 # 应用入口
├── app_init.dart           # 应用初始化
├── main.dart               # 主函数
├── env.dart                # 环境配置
├── common/                 # 公共组件
│   ├── config/             # 配置类
│   ├── constants/          # 常量定义
│   ├── extensions/         # 扩展方法
│   ├── tools/              # 工具类
│   └── mixins/             # Mixin类
├── config/                 # 应用配置
│   ├── states/             # 状态配置
│   ├── stories/            # 故事配置
│   └── ...                 # 其他配置
├── data/                   # 数据层
│   ├── models/             # 数据模型
│   ├── repositories/       # 数据仓库
│   └── datasources/        # 数据源
├── dependency_injection/   # 依赖注入
├── frameworks/             # 框架层
│   ├── firebase/           # Firebase集成
│   ├── woocommerce/        # WooCommerce API
│   ├── shopify/            # Shopify API
│   └── magento/            # Magento API
├── menu/                   # 菜单配置
├── models/                 # 业务模型
├── modules/                # 功能模块
│   ├── cart/               # 购物车模块
│   ├── checkout/           # 结算模块
│   ├── home/               # 首页模块
│   ├── product/            # 商品模块
│   ├── order/              # 订单模块
│   ├── user/               # 用户模块
│   └── ...                 # 其他模块
├── repositories/           # 仓库层
├── routes/                 # 路由配置
├── screens/                # 页面层
│   ├── app/                # 主应用页面
│   ├── cart/               # 购物车页面
│   ├── checkout/           # 结算页面
│   ├── detail/             # 详情页面
│   ├── dynamic/            # 动态页面
│   ├── home/               # 首页
│   ├── login_sms/          # 登录/短信
│   ├── onboarding/         # 引导页
│   ├── order_history/      # 订单历史
│   ├── products/           # 商品列表
│   ├── search/             # 搜索页面
│   ├── settings/           # 设置页面
│   ├── users/              # 用户页面
│   └── ...                 # 其他页面
├── services/               # 服务层
├── widgets/                # 组件库
└── generated_plugin_registrant.dart  # 插件注册

android/                    # Android原生代码
ios/                        # iOS原生代码
web/                        # Web版本
windows/                    # Windows版本
macos/                      # macOS版本
packages/                   # 本地包
├── flux_firebase/          # Firebase包
├── flux_interface/         # 接口定义
└── flux_localization/      # 本地化
_resource/                  # 资源文件
├── Design/                 # 设计文件
├── Firebase Functions/     # Firebase函数
└── WordPress-extension/    # WordPress插件
```

## 核心业务逻辑

### 1. 应用架构

采用分层架构设计：
```
UI层 (Screens/Widgets)
    ↓
状态管理层 (Provider)
    ↓
业务逻辑层 (Services)
    ↓
数据层 (Repositories)
    ↓
数据源层 (API/Local)
```

### 2. 用户流程

**购物流程：**
```
启动App → 引导页/首页 → 浏览商品 → 商品详情 → 加入购物车 → 结算 → 选择配送 → 支付 → 订单确认 → 订单追踪
```

**用户认证流程：**
```
启动 → 登录/注册 → 邮箱验证 → 设置密码 → 进入App
支持：邮箱登录、手机登录、社交登录(Google/Facebook/Apple)
```

### 3. 核心模块

#### 首页模块
- 轮播图展示
- 分类导航
- 推荐商品
- 热门商品
- 新品上架
- 促销活动

#### 商品模块
- 商品列表（网格/列表视图）
- 商品筛选（价格、品牌、属性）
- 商品排序
- 商品搜索
- 商品详情（图片轮播、规格选择、评价）
- 收藏商品

#### 购物车模块
- 添加商品
- 修改数量
- 删除商品
- 选择规格
- 优惠券应用
- 购物车持久化

#### 结算模块
- 地址管理
- 配送方式选择
- 支付方式选择
- 订单摘要
- 发票信息

#### 订单模块
- 订单列表
- 订单详情
- 订单状态追踪
- 物流追踪
- 订单评价
- 订单取消/退款

#### 用户模块
- 个人资料
- 地址管理
- 支付方式管理
- 订单历史
- 收藏列表
- 优惠券
- 积分
- 设置

### 4. 多平台支持

支持多种电商平台后端：

**WooCommerce：**
- REST API集成
- 自定义插件支持
- 支付网关集成

**Shopify：**
- GraphQL API
- Storefront API
- Admin API

**Magento：**
- REST API
- 自定义模块

### 5. 支付集成

支持多种支付方式：
- Stripe
- PayPal
- Razorpay
- PayTM
- Flutterwave
- Paystack
- PhonePe
- 货到付款

### 6. 推送通知


... (content truncated)