# asobrados03/finanzas_personales architecture

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

- Interactive diagram: https://gitdiagram.com/asobrados03/finanzas_personales
- Repository: https://github.com/asobrados03/finanzas_personales

## Overview

##### Project type and purpose
- This is a Kotlin-based Android mobile application (“Planificador Financiero”), a standalone client app for personal financial planning.
- It employs Jetpack Compose for UI, Room (SQLite) for local data persistence, and follows an MVVM architectural pattern.

##### File structure
- Top-level “app” module contains all Android sources.
- app/src/main/java: Composable UI screens, custom components, navigation setup, MainActivity entry point.
- app/src/main/java/.../data: Room entities (Budget, Category, Transaction), DAOs, Repositories, and Database class.
- app/src/main/java/.../viewModels: ViewModel classes mediating UI and data layer.
- app/src/main/res: drawables, mipmaps, raw assets (e.g., delete_sound.mp3), XML resources, themes.
- Build scripts: Gradle Kotlin DSL (build.gradle.kts), ProGuard rules, settings.gradle.kts.
- Test directories for unit and instrumentation tests.

##### README
- No content provided, so rely on conventions and package names (“planificadorfinanciero”) to infer financial-planning features (budgets, transactions, graphs).

##### Diagramming recommendations
- UI layer (light blue)
- ViewModel layer (green)
- Data layer (orange)
- Resources & platform (grey)
- Rectangles for repositories/DAOs.

- Layers: Presentation, ViewModel, Data.
- Navigation graph between screens.
- Local storage via Room and link to entities/DAOs.
- Ports for resource access (themes, raw sounds).

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Resources & Configuration"
        Raw["Raw Assets"]:::resource
        XML["XML Configs"]:::resource
        Values["Values Resources"]:::resource
        Drawables["Drawable Resources"]:::resource
    end

    subgraph "Presentation Layer"
        FinancialApp["FinancialApp"]:::frontend
        MainActivity["MainActivity"]:::frontend
        Navigation["Navigation Setup"]:::frontend
        Dashboard["DashboardScreen"]:::frontend
        BudgetScr["BudgetScreen"]:::frontend
        History["HistoryScreen"]:::frontend
        Statics["StaticsScreen"]:::frontend
        AddBudget["AddEditDetailBudgetView"]:::frontend
        AddTrans["AddEditDetailTransactionView"]:::frontend
        AppBar["AppBar"]:::frontend
        TextField["AppTextField"]:::frontend
        FAB["FABCustom"]:::frontend
        Graph["Graph"]:::frontend
        DatePicker["DatePicker"]:::frontend
        MonthPicker["MonthPicker"]:::frontend
        NavBar["NavigationBar"]:::frontend
        StatusBar["SetStatusBarColor"]:::frontend
    end

    subgraph "ViewModel Layer"
        BudgetVM["BudgetViewModel"]:::viewmodel
        CategoryVM["CategoryViewModel"]:::viewmodel
        TransactionVM["TransactionViewModel"]:::viewmodel
    end

    subgraph "Data Layer"
        BudgetRepo["BudgetRepository"]:::data
        CategoryRepo["CategoryRepository"]:::data
        TransactionRepo["TransactionRepository"]:::data
        BudgetDao["BudgetDao"]:::dao
        CategoryDao["CategoryDao"]:::dao
        TransactionDao["TransactionDao"]:::dao
        DB[(FinancialDatabase)]:::database
        EntityBudget["Budget Entity"]:::data
        EntityCategory["Category Entity"]:::data
        EntityTransaction["Transaction Entity"]:::data
        EntityType["TransactionType Entity"]:::data
    end

    FinancialApp --> MainActivity
    MainActivity --> Navigation
    Navigation --> Dashboard
    Navigation --> BudgetScr
    Navigation --> History
    Navigation --> Statics

    Dashboard -->|"uses"| CategoryVM
    BudgetScr -->|"uses"| BudgetVM
    History -->|"uses"| TransactionVM
    Statics -->|"uses"| TransactionVM
    AddBudget -->|"uses"| BudgetVM
    AddTrans -->|"uses"| TransactionVM

    BudgetVM -->|"getBudgets()/insertBudget()"| BudgetRepo
    CategoryVM -->|"getCategories()"| CategoryRepo
    TransactionVM -->|"getTransactions()/insertTransaction()"| TransactionRepo

    BudgetRepo -->|"queries"| BudgetDao
    CategoryRepo -->|"queries"| CategoryDao
    TransactionRepo -->|"queries"| TransactionDao

    DB --> BudgetDao
    DB --> CategoryDao
    DB --> TransactionDao

    BudgetDao --> EntityBudget
    CategoryDao --> EntityCategory
    TransactionDao --> EntityTransaction

    Raw --> FinancialApp
    XML --> FinancialApp
    Values --> FinancialApp
    Drawables --> FinancialApp

    click FinancialApp "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/FinancialApp.kt"
    click MainActivity "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/MainActivity.kt"
    click Navigation "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/Navigation.kt"
    click Dashboard "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/DashboardScreen.kt"
    click BudgetScr "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/BudgetScreen.kt"
    click History "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/HistoryScreen.kt"
    click Statics "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/StaticsScreen.kt"
    click AddBudget "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/AddEditDetailBudgetView.kt"
    click AddTrans "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/AddEditDetailTransactionView.kt"
    click AppBar "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/AppBar.kt"
    click TextField "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/AppTextField.kt"
    click FAB "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/FABCustom.kt"
    click Graph "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/Graph.kt"
    click DatePicker "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/DatePicker.kt"
    click MonthPicker "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/MonthPicker.kt"
    click NavBar "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/NavigationBar.kt"
    click StatusBar "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/SetStatusBarColor.kt"
    click BudgetVM "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/viewModels/BudgetViewModel.kt"
    click CategoryVM "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/viewModels/CategoryViewModel.kt"
    click TransactionVM "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/viewModels/TransactionViewModel.kt"
    click BudgetRepo "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/data/BudgetRepository.kt"
    click CategoryRepo "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/data/CategoryRepository.kt"
    click TransactionRepo "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/data/TransactionRepository.kt"
    click BudgetDao "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/data/BudgetDao.kt"
    click CategoryDao "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/data/CategoryDao.kt"
    click TransactionDao "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/data/TransactionDao.kt"
    click DB "https://github.com/asobrados03/finanzas_personales/blob/master/app/src/main/java/es/uva/sg/psm/planificadorfinanciero/data/FinancialDatabase.kt"

    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef viewmodel fill:#90EE90,stroke:#333,stroke-width:1px
    classDef data fill:#FFA500,stroke:#333,stroke-width:1px
    classDef dao fill:#FFB347,stroke:#333,stroke-width:1px
    classDef database fill:#FF8C00,stroke:#333,stroke-width:1px
    classDef resource fill:#D3D3D3,stroke:#333,stroke-width:1px
```
