# arisguimera/android-expert architecture

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

- Interactive diagram: https://gitdiagram.com/arisguimera/android-expert
- Repository: https://github.com/arisguimera/android-expert

## Overview

##### Main Components

a. Application Layer (Main Container)
- MenuActivity (Central Hub)
- Individual Applications:
- IMC Calculator App
- TODO App
- Superhero Search App
- Settings App
- First App (Tutorial)

b. Feature Modules
- Exercises Module
- Syntax Examples Module
- UI Components Layer
- Data Layer

##### Architecture Patterns to Highlight

**┌─────────────────────────────────────────────────────────┐**
- Android Master App                    │
- ┤
- Menu Activity                       │
- ┬──────────┬──────────┬──────────┬────────────┤
- IMC    │  TODO    │ Superhero│ Settings │  First     │
- Calculator│   App    │   App    │   App    │   App      │
- ┴──────────┴──────────┴──────────┴────────────┘

##### Component Details

For each major application, show:

a. IMC Calculator:
- UI Components (Activity + Layout)
- Calculator Logic
- Results Display

b. TODO App:
- Task Management
- Categories System
- RecyclerView + Adapters
- Dialog Components

c. Superhero App:
- API Service Layer
- Data Models
- Search Functionality
- Detail View

d. Settings App:
- DataStore Integration
- Theme Management
- Configuration Options

##### External Dependencies

Connections to:
- Retrofit (API calls)
- DataStore (Data persistence)
- Android Framework Components

##### Important Relationships

- Data flow between activities
- API communication paths
- Storage interactions
- Navigation patterns

**┌─────────────────────────────────────────────┐**
- Presentation Layer             │
- (Activities, Fragments, XML Layouts)        │
- ┤
- Business Logic                 │
- (Kotlin Classes, Adapters, ViewHolders)    │
- ┤
- Data Layer                  │
- (API Service, DataStore, Models)           │
- ┘

##### Implementation Details

Use standardized UML notation where appropriate:
- Diamonds for composition relationships

Remember to maintain a balance between detail and clarity, focusing on the educational nature of the project while showing the professional implementation of Android development concepts.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Android_Master
        MA["Menu Activity"]
        click MA "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/MenuActivity.kt"
        
        subgraph Apps
            IMC["IMC Calculator"]
            TODO["TODO App"]
            SH["Superhero App"]
            SET["Settings App"]
            FA["First App"]
            
            click IMC "https://github.com/ArisGuimera/Android-Expert/tree/main/app/src/main/java/com/aristidevs/androidmaster/imccalculator"
            click TODO "https://github.com/ArisGuimera/Android-Expert/tree/main/app/src/main/java/com/aristidevs/androidmaster/todoapp"
            click SH "https://github.com/ArisGuimera/Android-Expert/tree/main/app/src/main/java/com/aristidevs/androidmaster/superheroapp"
            click SET "https://github.com/ArisGuimera/Android-Expert/tree/main/app/src/main/java/com/aristidevs/androidmaster/settings"
            click FA "https://github.com/ArisGuimera/Android-Expert/tree/main/app/src/main/java/com/aristidevs/androidmaster/firstapp"
        end

        subgraph Learning_Modules
            EX["Exercises Module"]
            SYN["Syntax Examples"]
            
            click EX "https://github.com/ArisGuimera/Android-Expert/tree/main/app/src/main/java/com/aristidevs/androidmaster/exercises"
            click SYN "https://github.com/ArisGuimera/Android-Expert/tree/main/app/src/main/java/com/aristidevs/androidmaster/sintaxis"
        end

        subgraph Resources
            RES["Resource Management"]
            click RES "https://github.com/ArisGuimera/Android-Expert/tree/main/app/src/main/res"
        end
    end

    subgraph IMC_Calculator
        IMCA["IMC Activity"]
        IMCR["Results Activity"]
        IMCL["Calculator Logic"]
        
        click IMCA "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/imccalculator/ImcCalculatorActivity.kt"
        click IMCR "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/imccalculator/ResultIMCActivity.kt"
    end

    subgraph TODO_App
        TA["TODO Activity"]
        TM["Task Management"]
        TC["Task Categories"]
        RV["RecyclerView + Adapters"]
        
        click TA "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/todoapp/TodoActivity.kt"
        click TC "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/todoapp/TaskCategory.kt"
        click RV "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/todoapp/TasksAdapter.kt"
    end

    subgraph Superhero_App
        SHA["Superhero List Activity"]
        SHD["Detail Activity"]
        API["API Service"]
        MDL["Data Models"]
        
        click SHA "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/superheroapp/SuperHeroListActivity.kt"
        click SHD "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/superheroapp/DetailSuperheroActivity.kt"
        click API "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/superheroapp/ApiService.kt"
        click MDL "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/superheroapp/SuperHeroDataResponse.kt"
    end

    subgraph Settings_App
        SA["Settings Activity"]
        DS["DataStore"]
        TH["Theme Management"]
        
        click SA "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/settings/SettingsActivity.kt"
    end

    subgraph First_App
        FAA["First App Activity"]
        RAC["Result Activity"]
        
        click FAA "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/firstapp/FirstAppActivity.kt"
        click RAC "https://github.com/ArisGuimera/Android-Expert/blob/main/app/src/main/java/com/aristidevs/androidmaster/firstapp/ResultActivity.kt"
    end

    MA --> IMC
    MA --> TODO
    MA --> SH
    MA --> SET
    MA --> FA

    IMC --> IMCA
    IMCA --> IMCR
    IMCA --> IMCL

    TODO --> TA
    TA --> TM
    TA --> TC
    TA --> RV

    SH --> SHA
    SHA --> SHD
    SHA --> API
    API --> MDL

    SET --> SA
    SA --> DS
    SA --> TH

    FA --> FAA
    FAA --> RAC

    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef data fill:#2ecc71,stroke:#27ae60,color:white
    classDef service fill:#e67e22,stroke:#d35400,color:white
    classDef logic fill:#9b59b6,stroke:#8e44ad,color:white
    classDef util fill:#95a5a6,stroke:#7f8c8d,color:white

    class MA,IMCA,IMCR,TA,SHA,SHD,SA,FAA,RAC ui
    class DS,MDL,TM data
    class API service
    class IMCL,TC logic
    class RV,TH util

    %% Legend
    subgraph Legend
        UI["UI Component"]:::ui
        DATA["Data Management"]:::data
        SERV["External Service"]:::service
        LOG["Core Logic"]:::logic
        UTIL["Utility"]:::util
    end
```
