☕ Aurora Coffee

A modern Android coffee ordering application with rewards, missions, and social features.

Features • Installation • Architecture • Screenshots • License

---

📱 Overview

Aurora Android is a comprehensive mobile application that allows users to browse coffee shops, order products, earn rewards through missions, and manage their account. Built with modern Android development practices and integrated with Firebase for authentication and real-time features.

✨ Features

🔐 Authentication & Authorization

• Firebase Phone Authentication - Secure phone number verification
• Email/Password Login - Traditional authentication method
• Password Recovery - Email-based password reset with verification codes
• User Registration - Complete onboarding flow with validation

🏪 Shop & Product Management

• Shop Discovery - Browse nearby coffee shops with location-based filtering
• Product Catalog - View detailed product information with images and ratings
• Product Reviews - Read and write product reviews with star ratings
• Bookmarks - Save favorite products for quick access
• Search & Filter - Find products and shops easily

🛒 Order Management

• Shopping Cart - Add products and manage quantities
• Checkout Flow - Complete order placement with address and payment details
• Gift/Promo Codes - Apply discount codes at checkout
• Order History - Track past and current orders
• Order Cancellation - Cancel pending orders

🎁 Rewards & Missions

• Mission System - Complete challenges to earn rewards
• Gift Cards - Earn and redeem promotional gifts
• Progress Tracking - Monitor mission completion progress
• Expiration Management - Time-limited rewards and missions
• XP System - Earn experience points for activities

💳 Wallet & Payments

• Digital Wallet - Manage account balance
• Top-Up - Add funds to wallet
• Payment Card - Virtual card with unique code
• Transaction History - View all wallet transactions

👤 Profile Management

• Avatar Upload - Customize profile with image upload
• Account Settings - Update personal information
• Gallery Integration - Select images from device gallery
• Profile Viewing - View account details and balance

🔔 Notifications

• FCM Integration - Receive push notifications
• Order Updates - Get notified about order status changes
• Mission Alerts - Notifications for new missions and rewards

🛠️ Tech Stack

Core Technologies

• Language: Java
• Min SDK: API 21 (Android 5.0 Lollipop)
• Target SDK: Latest Android version
• Build System: Gradle

Libraries & Dependencies

🔥 Firebase

implementation 'com.google.firebase:firebase-auth'
implementation 'com.google.firebase:firebase-messaging'

🌐 Networking

implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

🖼️ Image Loading

implementation 'com.github.bumptech.glide:glide:4.15.1'

🎨 UI Components

implementation 'androidx.recyclerview:recyclerview'
implementation 'androidx.cardview:cardview'
implementation 'com.google.android.material:material'
implementation 'me.relex:circleindicator:2.1.6'

⚡ Reactive Programming

implementation 'io.reactivex.rxjava2:rxjava:2.2.21'
implementation 'io.reactivex.rxjava2:rxandroid:2.1.1'

📁 Project Structure

app/
├── src/
│   ├── main/
│   │   ├── java/com/example/coffee/
│   │   │   ├── adapters/          # RecyclerView adapters
│   │   │   ├── app/               # Application constants & data
│   │   │   ├── callbacks/         # API callback interfaces
│   │   │   ├── fcm/               # Firebase Cloud Messaging
│   │   │   ├── interfaces/        # Retrofit API interfaces
│   │   │   ├── models/            # Data models
│   │   │   │   ├── Order/
│   │   │   │   ├── Others/
│   │   │   │   ├── Product/
│   │   │   │   ├── Shop/
│   │   │   │   └── User/
│   │   │   ├── screens/           # Activities & Fragments
│   │   │   │   ├── auth/          # Authentication screens
│   │   │   │   ├── bottom/        # Bottom navigation screens
│   │   │   │   │   ├── Gift/
│   │   │   │   │   ├── Home/
│   │   │   │   │   ├── Product/
│   │   │   │   │   ├── Profile/
│   │   │   │   │   └── Shop/
│   │   │   │   └── others/        # Splash & onboarding
│   │   │   ├── services/          # API service classes
│   │   │   └── utils/             # Helper utilities
│   │   └── res/
│   │       ├── layout/            # XML layouts
│   │       ├── drawable/          # Images & icons
│   │       ├── font/              # Custom fonts
│   │       └── menu/              # Menu resources
│   ├── androidTest/               # Instrumented tests
│   └── test/                      # Unit tests
└── build.gradle

🏗️ Architecture

Design Pattern

The app follows MVC (Model-View-Controller) pattern with clear separation of concerns:

• Models (models/) - Data structures with Gson serialization
• Views (screens/) - Activities and Fragments
• Controllers (services/) - Business logic and API communication

Key Components

🔌 API Integration

• Base URL Configuration: BaseAPI
• Retrofit Interfaces: Separate interfaces for different features
  • AuthInterfaceAPI - Authentication endpoints
  • GiftInterfaceAPI - Rewards & missions
  • Product, Shop, Order interfaces

📦 Data Models

• Serializable Classes: All models implement Serializable for Intent passing
• Gson Annotations: @SerializedName for JSON mapping
• Response Wrappers: HttpResponse base class for API responses

🎯 Services Layer

Services handle API calls and business logic:

• AuthService - User authentication
• UserService - User profile management
• GiftService - Rewards and missions
• ProductService, ShopService, OrderService

🛠️ Utilities

• UserInformation - User session management
• LayoutLoading - Loading state UI
• Validation - Input validation
• HelperFunction - Common utilities
• Logger - Debugging helper

🚀 Installation

Prerequisites

• Android Studio Arctic Fox or later
• JDK 11 or higher
• Android SDK with API level 21+
• Firebase project setup

Setup Steps

1. Clone the repository

git clone https://github.com/yourusername/coffee_android.git
cd coffee_android

2. Configure Firebase

   • Create a Firebase project at Firebase Console
   • Add Android app to your Firebase project
   • Download google-services.json
   • Place it in app directory

3. Update API Configuration

   • Open BaseAPI.java
   • Update BASE_URL with your backend server URL

4. Sync Gradle

./gradlew sync

5. Build and Run

./gradlew assembleDebug
./gradlew installDebug

Or use Android Studio's Run button ▶️

📸 Screenshots

Authentication Flow

Splash Screen	Login	Register	Phone Verification
🌟	🔐	📝	📱

Main Features

Home	Shop	Gifts	Profile
🏠	🏪	🎁	👤

Product & Orders

Product List	Product Detail	Checkout	Payment
📋	📱	🛒	💳

🔧 Configuration

Gradle Configuration

The project uses Gradle for dependency management. Key configurations in build.gradle:

android {
    compileSdk 33
    defaultConfig {
        applicationId "com.example.coffee"
        minSdk 21
        targetSdk 33
        versionCode 1
        versionName "1.0"
    }
}

ProGuard Rules

ProGuard rules are defined in proguard-rules.pro for code obfuscation in release builds.

🧪 Testing

Unit Tests

Located in app/src/test/

./gradlew test

Instrumented Tests

Located in app/src/androidTest/

./gradlew connectedAndroidTest

📚 Key Features Implementation

🔥 Firebase Phone Authentication

Implementation in VerityActivity.java:

• Phone number validation
• OTP verification
• Auto-verification callbacks
• Resend code functionality

🎁 Mission System

Mission registration in RecyclePromoAdapter.java:

• Mission listing with progress
• Register for missions
• Track completion status
• Reward distribution

💳 Wallet System

Wallet management in CardActivity.java:

• Display balance and card code
• Top-up functionality
• Transaction history

📱 Image Upload

Avatar upload in ProfileFragment.java:

• Gallery permission handling
• Image selection
• File path resolution with RealPathUtil
• Multipart upload

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

⭐ Star this repo if you find it helpful!

Made with ❤️ and ☕