codecanyon-34116985-gofresha-nearby-salon-spa-barber-appointment-flutter-app-backend-included

# GoFresha - 附近美容沙龙理发预约系统

## 项目概述

**GoFresha** 是一个完整的美容沙龙、SPA、理发店预约系统，包含用户端Flutter移动应用和Laravel后端管理系统。支持附近店铺搜索、服务预约、产品购买等功能。

- **项目类型**: 移动应用 + Web后端
- **主要功能**: 美容服务预约、理发预约、产品购买、店铺管理
- **技术栈**: Flutter + Laravel + PHP + MySQL

---

## 模块结构

### 1. 用户端应用 (Flutter)

**技术规格:**
- **Flutter SDK**: 3.27.3+
- **Dart SDK**: >=3.5.3 <4.0.0
- **状态管理**: Riverpod (^2.4.10)
- **架构模式**: Clean Architecture
- **平台**: Android, iOS, Web, Windows

**核心依赖:**
```yaml
dependencies:
  # 状态管理
  flutter_riverpod: ^2.4.10
  
  # 网络请求
  dio: ^5.4.3+1
  
  # 地图与定位
  google_maps_flutter: ^2.7.0
  geolocator: ^12.0.0
  
  # 支付集成
  razorpay_flutter: ^1.4.0
  flutter_paystack: (Git)
  
  # Firebase 服务
  firebase_core: ^3.6.0
  firebase_auth: ^5.3.1
  firebase_messaging: ^15.1.3
  firebase_analytics: ^11.3.3
  
  # 社交登录
  google_sign_in: ^6.1.5
  flutter_facebook_auth: ^7.0.0
  sign_in_with_apple: ^6.1.0
  
  # UI 组件
  cached_network_image: ^3.4.1
  carousel_slider: ^5.0.0
  shimmer: ^3.0.0
  
  # 其他
  shared_preferences: ^2.2.1
  image_picker: ^1.0.4
  url_launcher: ^6.1.14
```

**项目结构:**
```
lib/
├── core/                    # 核心基础设施
│   ├── constants/           # API常量、错误消息
│   ├── error/               # 错误类型、异常
│   ├── network/             # Dio HTTP客户端
│   ├── repositories/        # 基础仓库类
│   └── storage/             # 本地存储包装
├── features/                # 功能模块 (Clean Architecture)
│   ├── auth/                # 认证模块
│   ├── salon/               # 沙龙/理发店
│   ├── barber/              # 理发师
│   ├── booking/             # 预约管理
│   ├── service/             # 服务管理
│   ├── product/             # 产品商城
│   ├── cart/                # 购物车
│   ├── favorite/            # 收藏功能
│   ├── coupon/              # 优惠券
│   ├── notification/        # 通知
│   ├── reward/              # 奖励/刮刮卡
│   ├── home/                # 首页
│   └── settings/            # 设置
├── models/                  # 数据模型
├── screens/                 # UI页面
├── shared/                  # 共享代码
│   ├── providers/           # 全局Riverpod提供者
│   ├── utils/               # 工具类
│   └── widgets/             # 可复用组件
├── l10n/                    # 本地化文件
│   ├── app_en.arb           # 英文
│   └── app_ar.arb           # 阿拉伯语(RTL)
├── Theme/                   # 应用主题
└── main.dart                # 应用入口
```

### 2. 后端系统 (Laravel)

**技术规格:**
- **框架**: Laravel 10.x
- **语言**: PHP ^8.1
- **数据库**: MySQL
- **认证**: JWT Auth (tymon/jwt-auth)

**核心依赖:**
```json
{
  "php": "^8.1",
  "laravel/framework": "^v10.0",
  "laravel/socialite": "^5.2",
  "tymon/jwt-auth": "^2.0",
  "stripe/stripe-php": "^7.94",
  "razorpay/razorpay": "^2.7",
  "unicodeveloper/laravel-paystack": "^1.0",
  "twilio/sdk": "^6.28",
  "craftsys/msg91-laravel": "^v0.14.0"
}
```

**项目结构:**
```
source/
├── app/
│   ├── Http/
│   │   ├── Controllers/
│   │   │   ├── Api/           # API控制器
│   │   │   ├── Auth/          # 认证控制器
│   │   │   ├── Cityadmin/     # 城市管理
│   │   │   ├── Partner/       # 合作伙伴
│   │   │   └── Vendor/        # 商家管理
│   │   └── ...
│   ├── Models/                # 数据模型
│   │   ├── User.php
│   │   ├── Salon.php
│   │   ├── Barber.php
│   │   ├── Booking.php
│   │   ├── Service.php
│   │   ├── Product.php
│   │   ├── Cart.php
│   │   ├── Coupon.php
│   │   └── ...
│   ├── Helpers/               # 辅助函数
│   ├── Providers/             # 服务提供者
│   └── Traits/                # 特性类
├── config/                    # 配置文件
├── database/                  # 数据库
├── resources/                 # 视图和资源
├── routes/                    # 路由定义
└── tests/                     # 测试文件
```

---

## 核心业务逻辑

### 1. 用户认证流程
1. 用户注册/登录（手机号、邮箱、社交账号）
2. JWT Token 生成与验证
3. 用户资料完善
4. 地址管理

### 2. 店铺发现流程
1. 获取用户当前位置
2. 基于位置搜索附近店铺
3. 地图展示店铺位置
4. 筛选和排序（距离、评分、价格）

### 3. 服务预约流程
1. 浏览店铺服务列表
2. 选择服务和理发师
3. 选择日期和时间段
4. 确认预约信息
5. 支付定金/全款
6. 预约成功通知

### 4. 产品购买流程
1. 浏览产品目录
2. 加入购物车
3. 选择配送地址
4. 应用优惠券
5. 选择支付方式
6. 完成支付
7. 订单跟踪

### 5. 支付流程
支持的支付方式：
- **Stripe**: 国际信用卡支付
- **Razorpay**: 印度支付
- **Paystack**: 非洲支付
- **货到付款**: 现金支付

### 6. 奖励系统
- **刮刮卡**: 随机优惠券奖励
- **推荐奖励**: 邀请好友获得奖励
- **积分系统**: 消费累积积分

---


... (content truncated)