# ibtihalba/productcatalog architecture

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

- Interactive diagram: https://gitdiagram.com/ibtihalba/productcatalog
- Repository: https://github.com/ibtihalba/productcatalog

## Overview

##### Project type and purpose
- This is a native Android mobile application named “ProductCatalog.”
- Its primary purpose is to display a list of products, allow updates via dialogs, and run unit/instrumentation tests.

##### File structure
- Top-level Gradle files (build.gradle, settings.gradle, gradle.properties, gradlew): define project build and dependencies.
- app/ module: the Android application.
– src/main/java/mgarzon/createbest/productcatalog: contains MainActivity, domain models (Product, ProductList).
– src/androidTest: UI/instrumentation tests.
– src/test: local unit tests.
– google-services.json, proguard-rules.pro: config for Firebase services and release builds.
- .circleci/config.yml: handles CI pipeline.
- .gitignore, .gitattributes, IDE files: development metadata.

##### README
- Minimal content; shows CircleCI build badge.

##### Detailed breakdown
– Branch into two lanes: UI Lane (MainActivity → Layout XMLs → RecyclerView) and Data Lane (ProductList ↔ Product).
– At the bottom, show “CircleCI” pulling from GitHub, invoking Gradle tasks (assembleDebug, test, connectedAndroidTest).

## Diagram (Mermaid)

```mermaid
flowchart TB
    Device["Android Device/Emulator"]:::infra
    AndroidFW["Android Framework (Dalvik/ART)"]:::infra

    Device --> AndroidFW

    subgraph "UI Layer"
        MainActivity["MainActivity"]:::ui
        ActivityLayout["activity_main.xml"]:::ui
        RecyclerView["RecyclerView Binding"]:::ui
        ListLayout["layout_product_list.xml"]:::ui
        DialogLayout["update_dialog.xml"]:::ui
    end

    AndroidFW --> MainActivity
    MainActivity --> ActivityLayout
    MainActivity --> RecyclerView
    RecyclerView --> ListLayout
    MainActivity --> DialogLayout

    click MainActivity "https://github.com/ibtihalba/productcatalog/blob/master/app/src/main/java/mgarzon/createbest/productcatalog/MainActivity.java"
    click ActivityLayout "https://github.com/ibtihalba/productcatalog/blob/master/app/src/main/res/layout/activity_main.xml"
    click ListLayout "https://github.com/ibtihalba/productcatalog/blob/master/app/src/main/res/layout/layout_product_list.xml"
    click DialogLayout "https://github.com/ibtihalba/productcatalog/blob/master/app/src/main/res/layout/update_dialog.xml"

    subgraph "Domain Model"
        ProductList["ProductList"]:::data
        Product["Product"]:::data
    end

    MainActivity --> ProductList
    ProductList --> Product

    click ProductList "https://github.com/ibtihalba/productcatalog/blob/master/app/src/main/java/mgarzon/createbest/productcatalog/ProductList.java"
    click Product "https://github.com/ibtihalba/productcatalog/blob/master/app/src/main/java/mgarzon/createbest/productcatalog/Product.java"

    subgraph "Testing"
        UnitTests["JUnit Unit Tests"]:::test
        InstrTests["Instrumentation Tests"]:::test
    end

    UnitTests --> ProductList
    InstrTests --> MainActivity

    click UnitTests "https://github.com/ibtihalba/productcatalog/blob/master/app/src/test/java/mgarzon/createbest/productcatalog/ProductTest.java"
    click InstrTests "https://github.com/ibtihalba/productcatalog/blob/master/app/src/androidTest/java/mgarzon/createbest/productcatalog/ExampleInstrumentedTest.java"
    click InstrTests "https://github.com/ibtihalba/productcatalog/blob/master/app/src/androidTest/java/mgarzon/createbest/productcatalog/FirstTest.java"

    subgraph "CI/CD Pipeline"
        CircleCI["CircleCI"]:::infra
        GradleProject["Project-level Gradle Files"]:::infra
        GradleApp["App Module Gradle"]:::infra
        FirebaseCfg["google-services.json"]:::infra
        Proguard["proguard-rules.pro"]:::infra
    end

    CircleCI --> GradleProject
    CircleCI --> GradleApp
    CircleCI --> UnitTests
    CircleCI --> InstrTests
    GradleProject --> AndroidFW
    GradleApp --> AndroidFW

    click CircleCI "https://github.com/ibtihalba/productcatalog/blob/master/.circleci/config.yml"
    click GradleProject "https://github.com/ibtihalba/productcatalog/blob/master/build.gradle"
    click GradleProject "https://github.com/ibtihalba/productcatalog/blob/master/settings.gradle"
    click GradleProject "https://github.com/ibtihalba/productcatalog/blob/master/gradle.properties"
    click GradleApp "https://github.com/ibtihalba/productcatalog/blob/master/app/build.gradle"
    click FirebaseCfg "https://github.com/ibtihalba/productcatalog/blob/master/app/google-services.json"
    click Proguard "https://github.com/ibtihalba/productcatalog/blob/master/app/proguard-rules.pro"

    classDef ui fill:#AED6F1,stroke:#2E86C1,color:#1B4F72;
    classDef data fill:#ABEBC6,stroke:#27AE60,color:#1D8348;
    classDef test fill:#F9E79F,stroke:#D68910,color:#935116;
    classDef infra fill:#D5D8DC,stroke:#566573,color:#1B2631;
```
