# ecy_app_flutter

**Repository Path**: CZJpython/ecy_app_flutter

## Basic Information

- **Project Name**: ecy_app_flutter
- **Description**: 本项目为一款基于 Flutter 跨平台开发的移动应用，支持 Android、iOS、Web 等多端部署，主要面向潮玩、谷圈、寄售等业务场景，具备商品浏览、购物车、订单、寄售、社交圈、用户中心等完整功能
- **Primary Language**: Dart
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-08-28
- **Last Updated**: 2025-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ecy_app_flutter 项目说明

## 项目简介

本项目为一款基于 Flutter 跨平台开发的移动应用，支持 Android、iOS、Web 等多端部署，主要面向潮玩、谷圈、寄售等业务场景，具备商品浏览、购物车、订单、寄售、社交圈、用户中心等完整功能。

![1](./shots/1.png)
![1](./shots/2.png)
![1](./shots/3.jpg)
![1](./shots/4.jpg)
![1](./shots/5.jpg)
---

## 技术栈与架构设计

- **主框架**：Flutter 3.x
- **状态管理**：原生 setState + 局部状态管理
- **网络请求**：Dio
- **本地存储**：SharedPreferences 封装（EcyStorage）
- **事件总线**：自定义 EventBus（EcyEventBus）
- **多端适配**：flutter_screenutil
- **国际化**：Flutter 内置国际化
- **推送**：极光推送（jpush_flutter）
- **第三方支付**：微信支付（fluwx）、支付宝
- **WebView 支持**：webview_flutter
- **图片缓存**：cached_network_image
- **权限管理**：flutter_easy_permission
- **UI 框架**：Material3

---

## 目录结构与核心模块

- `lib/`
  - `main.dart`：应用入口，初始化全局配置、主题、路由、推送等。
  - `EcyRouter.dart`：全局路由表，统一管理页面导航。
  - `constant/`：常量、环境配置、颜色等。
  - `ecycommon/`：通用工具类、网络请求、事件总线、通用组件等。
  - `model/`、`models/`：数据模型定义。
  - `routes/`：业务页面，按功能模块划分：
    - `goods/`：商品浏览、搜索、分类、详情等
    - `goodscart/`：购物车相关
    - `pay/`：订单确认、地址、支付
    - `consignment/`：寄售、我的寄售、寄售详情、发布
    - `group/`：谷圈、社交圈、评论
    - `my/`：用户中心、订单、设置、售后、消息等
    - `login/`：登录、注册、找回密码
    - `common/`：通用页面（如聊天）
    - `blind_box/`：盲盒相关业务

---

## 页面导航与主流程

应用主界面采用四大 Tab 切换：

1. **吃谷（商品）**：商品首页、分类、IP、SKU、盲盒等浏览与搜索
2. **谷圈（社交）**：用户动态、圈子、评论、互动
3. **寄售**：寄售商品浏览、发布、管理、买卖流程
4. **我的**：个人中心、订单、地址、售后、设置、消息等

所有页面均通过 `EcyRouter` 统一路由跳转，支持参数传递和登录校验。

---

## 主要业务流程

- **商品浏览与购买**：
  - 商品首页 > 分类/IP筛选 > 商品详情 > 加入购物车/立即购买 > 订单确认 > 支付 > 订单管理
- **寄售流程**：
  - 发布寄售 > 审核 > 上架 > 买家下单 > 订单流转 > 售后
- **谷圈互动**：
  - 发布动态 > 评论/点赞 > 消息通知
- **用户中心**：
  - 个人信息管理 > 地址管理 > 订单管理 > 售后服务 > 消息中心

---

## 环境与配置

- 支持多环境切换（开发、测试、仿真、生产），详见 `lib/ecycommon/EcyEnvironment.dart`。
- API 地址、WebSocket 地址、H5 地址等均可按环境自动切换。
- 常量统一维护于 `lib/constant/constant.dart`。

---

## 运行与构建

- 依赖安装：
  ```bash
  flutter pub get
  ```
- 代码生成（如 json model）：
  ```bash
  flutter pub run build_runner build
  ```
- Android 构建：
  ```bash
  flutter build apk --release
  ```
- Web 调试（解决跨域）：
  ```bash
  flutter run -d chrome --web-renderer canvaskit --web-browser-flag "--disable-web-security"
  ```

---

## 其他说明

- 微信支付、极光推送等第三方服务需配置对应的 appid、密钥等。
- 详细业务流程、页面跳转、接口定义请参考代码注释与各模块实现。
- 本项目代码结构清晰，注释详细，便于二次开发与维护。

---

## 原有敏感信息与账号配置

（以下为原README保留内容，涉及账号、密钥、证书等信息，仅供开发内部参考，请勿泄露）