Swinburne E-Commerce Mobile Application

Author: Do Gia Huy
Student ID: 104988294

---

📱 Project Overview

The Swinburne E-Commerce Mobile Application is a full-featured Android mobile app designed to provide users with a seamless shopping experience. This application allows users to browse products, manage shopping carts, make purchases, track orders, and manage user accounts through an intuitive interface.

---

✨ Features

Core Functionality

• Product Browsing: View a comprehensive catalog of products with detailed information
• Product Search & Filter: Easily find products using filters and search functionality
• Shopping Cart: Add/remove items, manage quantities, and calculate totals
• Checkout Process: Multi-step checkout with shipping and payment information
• User Authentication: Secure login and registration with Google Sign-In integration
• Order Management: View order history and track order status
• Favorite Products: Mark and manage favorite products for quick access
• User Profile: Manage user information and preferences
• Guest Checkout: Allow users to continue shopping without account creation

Technical Features

• Real-time Database: Firebase Firestore for scalable data management
• Modern UI/UX: Material Design components with smooth animations
• Bottom Navigation: Easy access to main sections (Home, Cart, Profile, Orders, Favorites)
• Image Optimization: Efficient image loading with Picasso and Glide
• Animations: Smooth transitions and slide animations between screens

---

🛠️ Technologies & Dependencies

Core Technologies

• Language: Kotlin
• Android SDK: Target SDK 36, Min SDK 27
• Build Tool: Gradle (Kotlin DSL)
• Architecture Components: ViewModel, LiveData, Navigation, Fragment

Key Dependencies

• Firebase:
  • Cloud Firestore (Database)
  • Firebase Authentication
  • Google Services
• UI Components:
  • AndroidX Material Design (Material 3)
  • ConstraintLayout
  • RecyclerView
• Image Loading:
  • Picasso
  • Glide
• Authentication:
  • Google Sign-In
  • AndroidX Credentials API
• Async Operations:
  • Kotlin Coroutines
• Testing:
  • JUnit
  • Robolectric
  • Espresso
  • Mockito
  • AndroidX Navigation Testing

---

📂 Project Structure

mobile/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/assignment3/
│   │   │   │   ├── MainActivity.kt          # Main activity with navigation
│   │   │   │   ├── adapters/                # RecyclerView adapters
│   │   │   │   ├── fragments/               # UI fragments
│   │   │   │   │   ├── auth/                # Login, Register, ResetPassword
│   │   │   │   │   ├── home/                # Home screen
│   │   │   │   │   ├── product/             # Product listing
│   │   │   │   │   ├── productdetail/       # Product details
│   │   │   │   │   ├── cart/                # Shopping cart
│   │   │   │   │   ├── checkout/            # Checkout process
│   │   │   │   │   ├── favorite/            # Favorites
│   │   │   │   │   ├── order/               # Order management
│   │   │   │   │   ├── profile/             # User profile
│   │   │   │   │   └── guest/               # Guest features
│   │   │   │   ├── models/                  # Data models
│   │   │   │   ├── repositories/            # Data access layer
│   │   │   │   └── interfaces/              # Interfaces and contracts
│   │   │   ├── res/
│   │   │   │   ├── layout/                  # XML layout files
│   │   │   │   ├── drawable/                # Vector drawables and resources
│   │   │   │   ├── anim/                    # Animation resources
│   │   │   │   ├── values/                  # Colors, strings, dimensions
│   │   │   │   ├── navigation/              # Navigation graph
│   │   │   │   └── mipmap-*/               # App icons
│   │   │   └── AndroidManifest.xml         # App manifest
│   │   ├── androidTest/                     # Instrumentation tests
│   │   └── test/                            # Local unit tests
│   ├── build.gradle.kts                     # App-level build configuration
│   └── google-services.json                 # Firebase configuration
├── gradle/
│   └── libs.versions.toml                   # Centralized dependency versions
├── build.gradle.kts                         # Root-level build configuration
├── settings.gradle.kts                      # Project settings
└── gradlew                                  # Gradle wrapper (Unix)

---

📋 Data Models

The application uses the following core data models:

• User: User account information and authentication details
• Product: Product information including price, description, images
• CartItem: Shopping cart items with quantity and product reference
• OrderItem: Order history and status tracking
• ShippingAddress: Delivery address information

---

🚀 Getting Started

Prerequisites

• Android Studio (latest version recommended)
• Java 11 or higher
• Android SDK 36
• Git
• Firebase account and project setup

Installation & Setup

1. Clone the Repository

   git clone <repository-url>
   cd mobile

2. Configure Firebase

   • Create a Firebase project in the Firebase Console
   • Enable Firestore Database and Firebase Authentication
   • Download your google-services.json file
   • Place it in the app/ directory

3. Build the Project

   ./gradlew build

4. Run the Application

   • Open the project in Android Studio
   • Connect an Android device or start an emulator
   • Click "Run" (or press Shift+F10)

Building APK

For release build:

./gradlew assembleRelease

The APK will be available in app/release/

---

🧪 Testing

The project includes comprehensive test coverage:

Run Unit Tests

./gradlew test

Run Instrumentation Tests

./gradlew connectedAndroidTest

Testing Frameworks Used

• JUnit: Unit testing
• Robolectric: Android component testing
• Espresso: UI testing
• Mockito: Mocking framework
• AndroidX Navigation Testing: Fragment navigation testing

---

📦 Build Configuration

• App ID: com.assignment3
• Version Code: 3
• Version Name: 1.1
• Target SDK: 36
• Minimum SDK: 27 (Android 8.1)
• Java Compatibility: Java 11

---

🔐 Security Notes

• Never commit sensitive files like keystores/password.txt to version control
• Keep google-services.json secure and out of public repositories
• Use environment variables for sensitive configuration

---

📝 Development Notes

Navigation

The app uses Android Navigation Component with bottom navigation for main sections. Some screens (login, product detail, checkout) hide the bottom navigation for a cleaner experience.

State Management

The app uses LiveData and ViewModel for managing UI state. Kotlin Coroutines handle asynchronous operations.

Database

Firebase Firestore is used for real-time data synchronization. Authentication is handled through Firebase Authentication with Google Sign-In support.

---

🐛 Troubleshooting

Gradle Build Issues

• Run ./gradlew clean before building
• Ensure you have the correct Android SDK versions installed
• Check that internet connection is available for dependency downloads

Firebase Connection Issues

• Verify google-services.json is in the correct location (app/)
• Check Firebase project configuration matches app package name
• Ensure Firebase services are enabled in your project

Android Emulator Issues

• Update Android Emulator to the latest version
• For better performance, enable hardware acceleration
• If issues persist, try running on a physical device

---

📄 License

This project is part of Swinburne University coursework.

---

👤 Author Information

• Name: Do Gia Huy
• Student ID: 104988294
• Institution: Swinburne University

---