# FluxStore Listing - 商家目录 WooCommerce 应用
## 项目概述
**FluxStore Listing** 是一个基于 Flutter 构建的商家目录应用，专为 WooCommerce 设计。支持商家入驻、分类浏览、地图定位、预约服务等功能，适用于本地生活服务、商家黄页、分类信息网站。
- **版本**: v5.6.0
- **Flutter 版本**: 3.38.3
- **技术栈**: Flutter + Provider + 依赖注入
- **平台**: Android, iOS, Web, macOS, Windows
- **官网**: https://1.envato.market/7qoVO
---
## 技术架构
### 核心技术栈
- **前端框架**: 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_interface: (本地包)
flux_localization: (本地包)
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
```
---
## 项目结构
```
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 集成
│ └── ...
├── menu/ # 菜单配置
├── models/ # 数据模型
├── modules/ # 功能模块
├── repositories/ # 数据仓库层
├── routes/ # 路由管理
├── screens/ # 页面组件
├── services/ # 业务服务层
└── widgets/ # 可复用 UI 组件
```
---
## 核心功能模块
### 1. 商家目录 (Listing Directory)
- **商家列表**: 分类展示商家
- **商家详情**: 商家信息、服务、评价
- **商家搜索**: 关键词搜索商家
- **商家筛选**: 按分类、位置、评分筛选
### 2. 地图定位 (Map & Location)
- **地图展示**: Google Maps 集成
- **附近商家**: 基于位置的商家推荐
- **路线导航**: 导航到商家位置
- **地理编码**: 地址转坐标
### 3. 分类浏览 (Categories)
- **多级分类**: 支持多级分类结构
- **分类图标**: 自定义分类图标
- **热门分类**: 热门分类推荐
### 4. 商家入驻 (Vendor Registration)
- **商家注册**: 商家申请入驻
- **资料管理**: 商家信息管理
- **服务设置**: 设置提供的服务
- **营业时间**: 设置营业时间
### 5. 预约服务 (Booking)
- **在线预约**: 预约商家服务
- **时间选择**: 选择预约时间
- **预约管理**: 查看和管理预约
- **预约提醒**: 预约前提醒
### 6. 评价系统 (Reviews)
- **商家评价**: 对商家进行评价
- **评分系统**: 星级评分
- **评价展示**: 评价列表展示
- **商家回复**: 商家回复评价
### 7. 收藏功能 (Favorites)
- **商家收藏**: 收藏喜欢的商家
- **收藏列表**: 查看收藏商家
### 8. 用户功能
- **社交登录**: Google, Facebook, Apple
- **个人中心**: 用户信息管理
- **我的预约**: 查看预约记录
- **我的评价**: 查看我的评价
### 9. 营销功能
- **推送通知**: OneSignal, Firebase
- **深度链接**: Firebase Dynamic Links, Branch
- **广告集成**: Google Mobile Ads
- **社交分享**: 分享商家到社交媒体
### 10. 高级功能
- **动态布局**: FluxBuilder 可视化构建器支持
- **多语言**: 完整国际化支持
- **暗黑模式**: 主题切换
- **离线支持**: 部分功能离线可用
---
## 核心业务逻辑
### 1. 商家浏览流程
1. 浏览分类或地图
2. 查看商家列表
3. 筛选和排序
4. 查看商家详情
5. 查看评价
... (content truncated)
