# 风七六本地生活服务平台 - 用户端应用

## 项目介绍

风七六本地生活服务平台用户端应用，基于Flutter框架开发，支持iOS、Android、Web等多平台。提供外卖订餐、跑腿服务、本地商户查询等功能，为用户提供便捷的本地生活服务体验。

## 功能特性

- **外卖服务**：浏览附近商家、查看菜单、在线下单、支付
- **跑腿服务**：代取快递、代买商品、代办事项等
- **本地商户**：查询附近商户、查看商户详情、评价商户
- **订单管理**：查看历史订单、订单详情、订单状态追踪
- **个人中心**：用户信息管理、地址管理、支付管理
- **实时定位**：基于高德地图的位置服务
- **多种支付方式**：支付宝、微信支付等
- **优惠券管理**：领取和使用优惠券

## 技术栈

- **前端框架**：Flutter 3.0+
- **状态管理**：Provider
- **路由管理**：GoRouter
- **网络请求**：Dio
- **本地存储**：Hive
- **地图服务**：高德地图 Flutter SDK
- **支付集成**：支付宝、微信支付
- **图片加载**：cached_network_image
- **动画效果**：Flutter内置动画

## 项目结构

```
lib/
├── components/         # 通用组件
├── models/             # 数据模型
├── providers/          # 状态管理
├── screens/            # 页面
│   ├── errand/         # 跑腿相关页面
├── services/           # 服务
├── utils/              # 工具类
├── routes/             # 路由配置
├── middlewares/        # 中间件
├── l10n/               # 国际化
└── main.dart           # 应用入口
```

## 安装步骤

1. **克隆项目**
   ```bash
   git clone https://github.com/your-repo/fzx-user-app.git
   cd fzx-user-app
   ```

2. **安装依赖**
   ```bash
   flutter pub get
   ```

3. **配置环境变量**
  - 复制 `.env.example` 文件为 `.env`
  - 填写相关配置信息，如高德地图API Key、后端API地址等

4. **运行项目**
   ```bash
   # 运行Web版本
   flutter run -d chrome

   # 运行Android版本
   flutter run -d android

   # 运行iOS版本
   flutter run -d ios
   ```

## 构建项目

```bash
# 构建Web版本
flutter build web

# 构建Android版本
flutter build apk

# 构建iOS版本
flutter build ios
```

## 开发规范

- **代码风格**：遵循Dart官方代码风格指南
- **命名规范**：使用驼峰命名法
- **注释规范**：关键代码添加注释
- **提交规范**：遵循Git提交规范

## 注意事项

- 确保已安装Flutter 3.0或更高版本
- 运行Web版本时，需要配置Chrome浏览器的跨域访问权限
- 部分功能需要后端服务支持，请确保后端服务正常运行

## 相关项目

- [风七六平台端](https://github.com/your-repo/fzx-admin-web)
- [风七六商家端](https://github.com/your-repo/fzx-merchant-app)
- [风七六骑手端](https://github.com/your-repo/fzx-rider-app)

## 许可证

MIT License

