# 乐意兑

**Repository Path**: abbasspace/lyd

## Basic Information

- **Project Name**: 乐意兑
- **Description**: 乐意兑是一款功能丰富的 Android 移动端应用，旨在为用户提供便捷的本地生活服务与电商购物体验。项目采用 MVVM 架构，集成了商品浏览与购买、积分赚取与兑换、短剧视频娱乐以及商家订单核销等核心业务场景。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-19
- **Last Updated**: 2026-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MVVM, dagger, dagger, Rxjava, CleanArch

## README



```markdown
# 乐益兑 (Lyd)

## 项目简介

乐益兑是一款功能丰富的 Android 移动端应用，旨在为用户提供便捷的本地生活服务与电商购物体验。项目采用 MVVM 架构，集成了商品浏览与购买、积分赚取与兑换、短剧视频娱乐以及商家订单核销等核心业务场景。

## 主要功能模块

### 1. 商城系统
- **同城商品**: 基于地理位置展示本地优质商品，支持快递配送和上门自提。
- **云购商品**: 提供云端产品的购买与议价功能，包含详细的进度追踪。
- **保本购**: 特色保本购活动，支持商家核销模式，具备任务管理与核销功能。
- **新品/新人购**: 针对新用户的专属优惠商品展示与购买。

### 2. 积分娱乐中心
- **签到有礼**: 每日签到获取积分，连续签到获得额外奖励。
- **看广告**: 观看广告视频获取积分，支持多种广告形式（激励视频、信息流等）。
- **小游戏**: 集成游戏入口，通过完成任务获取积分。
- **短剧/DJX**: 观看短剧视频，完成剧情解锁和奖励领取。

### 3. 用户中心
- **登录注册**: 支持微信快捷登录和手机号登录。
- **订单管理**: 全方位管理订单（待支付、待收货、已完成、售后退款等），支持分享邀请。
- **钱包管理**: 余额查询、充值、提现功能。
- **收货地址**: 便捷的地址管理，支持新增、编辑和删除。

### 4. 商家功能
- **订单核销**: 商家端订单核销功能，支持扫码核销和输入验券码。
- **店铺收益**: 查看店铺收入、结算记录和流水明细。

## 技术栈

- **开发语言**: Kotlin / Java
- **UI 框架**: Android ViewBinding / DataBinding
- **架构模式**: MVVM + Repository
- **依赖注入**: Dagger (通过 `AppComponent` 管理依赖)
- **网络层**: OkHttp + Retrofit + Gson
- **本地存储**: Room Database (用于缓存用户信息、地址、搜索历史等)
- **响应式编程**: RxJava / RxAndroid
- **图片加载**: Glide
- **广告 SDK**: 集成穿山甲等主流广告平台

## 项目结构

项目源码位于 `app/src/main/java/com/zx/leyidui`，主要结构如下：

- **`ad/`**: 广告业务逻辑及短剧(DJX) SDK 集成封装。
- **`adapter/`**: 涵盖首页、商品列表、订单、弹窗等场景的 RecyclerView 适配器。
- **`bean/`**: 数据传输对象 (DTO) 与实体类定义。
- **`data/`**:
    - **`local/`**: Room 数据库配置、本地实体 (Entity) 及 DAO。
    - **`remote/`**: Retrofit 网络接口定义、请求拦截器。
    - **`repository/`**: 数据仓库层，统一处理数据来源。
- **`dialog/`**: 各种业务弹窗（如登录、分享、地址选择、商品规格选择等）。
- **`di/`**: 依赖注入模块 (`AppComponent`, `Module`, `ViewModelModule`)。
- **`model/`**: 业务枚举、工具类及复合数据模型。
- **`viewmodel/`**: 对应各页面的 ViewModel 类。

## 编译说明

本项目为标准的 Android Gradle 项目。
1. 确保已安装 Android Studio 并配置好 Android SDK。
2. 使用 `git clone` 将项目克隆到本地。
3. 在 Android Studio 中打开项目，等待 Gradle 同步完成。
4. 连接真机或启动模拟器，点击 Run 按钮进行编译和安装。

## License

本项目仅供学习与内部使用。
```