# uvsl1/lista-de-compras-android architecture

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

- Interactive diagram: https://gitdiagram.com/uvsl1/lista-de-compras-android
- Repository: https://github.com/uvsl1/lista-de-compras-android

## Overview

##### Project type and purpose
- This is a native Android “Lista de Compras” (Shopping List) mobile app written in Kotlin.
- Purpose: allow users to create, edit, delete shopping lists and manage products within those lists. Data is stored locally via a SQLite-based helper.

##### File structure
- Top-level “app” module (standard Android Gradle project).
- Under `app/src/main/java/com/example/listinha/ui/app/` you have:
- adapters (RecyclerView adapters)
- data/database (SQLite helper: ListinhaDbHelper)
- data/models (ListaCompras, Produto)
- data/repository (ListinhaRepository)
- ui/activities (MainActivity, ListaActivity)
- ui/fragments (if any)
- viewmodels (exposed to UI)
- Resources (layouts, drawables, strings, themes).
- Tests under `androidTest` and `test`.

##### README for additional insights
- It implicitly follows MVVM: you have ViewModels and a Repository.

##### Main components & interactions (
a. Components:
- Android UI Layer: Activities & Fragments
- ViewModel Layer: classes in `viewmodels/`
- Repository: `ListinhaRepository`
- Data Access Layer: `ListinhaDbHelper` (SQLite)
- Local Database: SQLite file on device
- Adapters: RecyclerViews for list & product display
b. Relationships / Data Flow:
1. User taps UI in Activity/Fragment.
2. UI invokes methods on the corresponding ViewModel.
3. ViewModel calls Repository (ListinhaRepository).
4. Repository uses DbHelper to read/write SQLite.
5. Repository returns domain models (ListaCompras, Produto) back up to ViewModel.
6. ViewModel exposes LiveData or state for UI; UI updates via Adapters.
c. Architectural patterns / principles:
- MVVM: separation of concerns between UI, state (ViewModel), data persistence.
- Single responsibility: DbHelper only manages raw SQL, Repository orchestrates data retrieval.
d. Key technologies / libraries:
- Kotlin (language)
- Android Jetpack components (ViewModel, LiveData if used)
- SQLite (via custom ListinhaDbHelper)
- RecyclerView Adapters (ItemListaAdapter, ProdutoAdapter)
- Gradle Kotlin DSL for build scripts

##### Elements
- From User → UI
- UI → ViewModel
- ViewModel → Repository
- Repository → DbHelper → SQLite
- Return paths for data flowing back up.
- Data layer in a third (orange).

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Android App"
        subgraph "UI Layer"
            MainActivity["MainActivity"]:::ui
            ListaActivity["ListaActivity"]:::ui
            ToDoFragment["ToDoFragment"]:::ui
            ItemListaAdapter["ItemListaAdapter"]:::ui
            ProdutoAdapter["ProdutoAdapter"]:::ui
        end

        subgraph "ViewModel Layer"
            ToDoViewModel["ToDoViewModel"]:::vm
        end

        subgraph "Data Layer"
            ListinhaRepository["ListinhaRepository"]:::data
            subgraph "Domain Models"
                ListaCompras["ListaCompras"]:::model
                Produto["Produto"]:::model
            end
        end

        subgraph "Persistence Layer"
            ListinhaDbHelper["ListinhaDbHelper"]:::data
            SQLiteDB["SQLite DB"]:::db
        end
    end

    %% Data Flow
    MainActivity -->|"user action"| ToDoViewModel
    ListaActivity -->|"user action"| ToDoViewModel
    ToDoFragment -->|"user action"| ToDoViewModel
    ToDoViewModel -->|"getAllLists()/insertProduto()"| ListinhaRepository
    ListinhaRepository -->|"maps to models"| ListaCompras
    ListinhaRepository -->|"maps to models"| Produto
    ListinhaRepository -->|"query/insert/delete"| ListinhaDbHelper
    ListinhaDbHelper -->|"execSQL/query"| SQLiteDB

    %% Return Flow
    SQLiteDB -->|"cursor/results"| ListinhaDbHelper
    ListinhaDbHelper -->|"domain models"| ListinhaRepository
    ListinhaRepository -->|"LiveData<models>"| ToDoViewModel
    ToDoViewModel -->|"observe updates"| ItemListaAdapter
    ToDoViewModel -->|"observe updates"| ProdutoAdapter

    %% Click Events
    click MainActivity "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/ui/activities/MainActivity.kt"
    click ListaActivity "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/ui/activities/ListaActivity.kt"
    click ToDoFragment "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/ui/fragments/ToDo.kt"
    click ItemListaAdapter "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/adapters/ItemListaAdapter.kt"
    click ProdutoAdapter "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/adapters/ProdutoAdapter.kt"
    click ToDoViewModel "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/viewmodels/ToDo.kt"
    click ListinhaRepository "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/data/repository/ListinhaRepository.kt"
    click ListinhaDbHelper "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/data/database/ListinhaDbHelper.kt"
    click ListaCompras "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/data/models/ListaCompras.kt"
    click Produto "https://github.com/uvsl1/lista-de-compras-android/blob/main/app/src/main/java/com/example/listinha/ui/app/data/models/Produto.kt"

    %% Styles
    classDef ui fill:#AED6F1,stroke:#3498DB;
    classDef vm fill:#A9DFBF,stroke:#27AE60;
    classDef data fill:#F9E79F,stroke:#F1C40F;
    classDef db fill:#D7DBDD,stroke:#A6ACAF;
    classDef model fill:#FADBD8,stroke:#EB984E;
```
