# zedithx/javaandroidfe architecture

> Architecture diagram of the GitHub repository zedithx/javaandroidfe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zedithx/javaandroidfe
- Repository: https://github.com/zedithx/javaandroidfe

## Overview

##### Project type and purpose
- This is a native Android mobile application (written in Java, built with Gradle/Kotlin DSL) called “Bulkify.”
- Purpose: let organizations (e.g., schools) coordinate bulk purchases, manage orders, chat, handle payments, and interface with a QR-enabled hardware locker for secure pickup.

##### File structure
- Top-level “app” module contains:
- src/main/java/com/example/javaandroidapp/activities → UI controllers
- adapters → RecyclerView adapters for lists
- fragments → reusable UI components (date/time pickers, search)
- modals (models) → data entities (User, Order, Listing, Category)
- Res/ folder: layouts, drawables, animations, styles, themes – defines the UI.
- Build scripts: build.gradle.kts, proguard rules, gradle wrapper, indicating standard Android build pipeline.

##### README for additional insights
- Mentions integration with a hardware locker (IoT device) using QR-code scanning.
- References Firebase (MyFirebaseMessagingService), Algolia search, OAuth tokens.

##### Elements
- Clear component labels (e.g., “LandingActivity,” “AlgoliaHelper,” “Firestore”)
- Blue rectangles for on-device components (UI, adapters, utils)
- Orange clouds for external services (Firebase, Algolia, Stripe)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Android Client
    subgraph "Android Client" 
        direction TB
        subgraph "UI Layer" 
            direction TB
            Activities["Activities"]:::client
            Fragments["Fragments"]:::client
        end
        subgraph "Presentation/Adapters"
            direction TB
            Adapters["RecyclerView Adapters"]:::client
        end
        subgraph "Domain/Models"
            direction TB
            Modals["Modals (User, Order, Listing, Category)"]:::client
        end
        subgraph "Data/Service Layer"
            direction TB
            OAuthToken["OauthToken"]:::client
            Users["Users"]:::client
            Listings["Listings"]:::client
            Orders["Orders"]:::client
            Categories["Categories"]:::client
            MyFCM["MyFirebaseMessagingService"]:::client
            AlgoliaHelper["AlgoliaHelper"]:::client
            ChatSystem["ChatSystem"]:::client
            QRCode["QRCode Generator"]:::client
        end
    end

    %% Cloud Services
    subgraph "Cloud Services"
        direction TB
        FirebaseAuth["Firebase Authentication"]:::cloud
        Firestore["Firestore/Realtime DB"]:::cloud
        FCM["Firebase Cloud Messaging"]:::cloud
        AlgoliaSearch["Algolia Search"]:::cloud
        StripeSvc["Stripe Payment Gateway"]:::cloud
    end

    %% IoT Locker
    subgraph "Hardware Locker (IoT Device)"
        direction TB
        QRScanner["QR Scanner API"]:::iot
        Microcontroller["Lock Microcontroller"]:::iot
    end

    %% Flows: UI to Adapters and Data Layer
    Activities -->|uses| Adapters
    Fragments -->|uses| Adapters
    Adapters -->|binds to| Modals
    Adapters -->|invokes| OAuthToken
    Adapters -->|invokes| Users
    Adapters -->|invokes| Listings
    Adapters -->|invokes| Orders
    Adapters -->|invokes| Categories
    Adapters -->|invokes| AlgoliaHelper
    Adapters -->|invokes| ChatSystem
    Adapters -->|invokes| QRCode

    %% Data Layer to Cloud
    OAuthToken -->|HTTPS| FirebaseAuth
    Users -->|REST| Firestore
    Listings -->|REST| Firestore
    Orders -->|REST| Firestore
    Categories -->|REST| Firestore
    AlgoliaHelper -->|HTTPS| AlgoliaSearch
    ChatSystem -->|WebSocket| Firestore
    QRCode -->|display→scan| QRScanner
    Orders -->|payment request| StripeSvc

    %% Cloud to App via FCM
    Firestore -->|triggers| FCM
    StripeSvc -->|webhook| FCM
    FCM -->|push| MyFCM
    MyFCM -->|notifies| Fragments
    MyFCM -->|notifies| Activities

    %% IoT Locker sequence
    QRScanner -->|unlock command| Microcontroller

    %% Locker to Cloud Flow
    Microcontroller -->|status update| Firestore
    Firestore -->|trigger| FCM

    %% Click Events
    click Activities "https://github.com/zedithx/javaandroidfe/tree/main/app/src/main/java/com/example/javaandroidapp/activities"
    click Fragments "https://github.com/zedithx/javaandroidfe/tree/main/app/src/main/java/com/example/javaandroidapp/fragments"
    click Adapters "https://github.com/zedithx/javaandroidfe/tree/main/app/src/main/java/com/example/javaandroidapp/adapters"
    click Modals "https://github.com/zedithx/javaandroidfe/tree/main/app/src/main/java/com/example/javaandroidapp/modals"
    click OAuthToken "https://github.com/zedithx/javaandroidfe/blob/main/app/src/main/java/com/example/javaandroidapp/utils/OauthToken.java"
    click Users "https://github.com/zedithx/javaandroidfe/blob/main/app/src/main/java/com/example/javaandroidapp/utils/Users.java"
    click Listings "https://github.com/zedithx/javaandroidfe/blob/main/app/src/main/java/com/example/javaandroidapp/utils/Listings.java"
    click Orders "https://github.com/zedithx/javaandroidfe/blob/main/app/src/main/java/com/example/javaandroidapp/utils/Orders.java"
    click Categories "https://github.com/zedithx/javaandroidfe/blob/main/app/src/main/java/com/example/javaandroidapp/utils/Categories.java"
    click MyFCM "https://github.com/zedithx/javaandroidfe/blob/main/app/src/main/java/com/example/javaandroidapp/utils/MyFirebaseMessagingService.java"
    click AlgoliaHelper "https://github.com/zedithx/javaandroidfe/blob/main/app/src/main/java/com/example/javaandroidapp/utils/AlgoliaHelper.java"
    click ChatSystem "https://github.com/zedithx/javaandroidfe/blob/main/app/src/main/java/com/example/javaandroidapp/utils/ChatSystem.java"
    click QRCode "https://github.com/zedithx/javaandroidfe/blob/main/app/src/main/java/com/example/javaandroidapp/utils/QRCode.java"

    %% Styles
    classDef client fill:#cce5ff,stroke:#004085,stroke-width:2px
    classDef cloud fill:#ffe5cc,stroke:#994d00,stroke-width:2px
    classDef iot fill:#d4edda,stroke:#155724,stroke-width:2px
```
