# juanmedina100/mi_cora architecture

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

- Interactive diagram: https://gitdiagram.com/juanmedina100/mi_cora
- Repository: https://github.com/juanmedina100/mi_cora

## Overview

##### Project Type and Purpose
- This is a cross-platform Flutter application (“Mi Cora”) targeting Android, iOS, Web and desktop (Windows, Linux, macOS).
- It appears to be a personal finance/transaction-tracking app: users add transactions, view history and filtered data, stored locally.

##### File-Structure Analysis
- Top-level Flutter folders: android/, ios/, windows/, linux/, macos/, web/ – auto-generated platform hosts.
- lib/
- models/: domain entities (CategorieModel, TransactionModel, TransactionFiltered, TransactionModelInsert)
- providers/: state-management (TransactionsProvider using Provider package)
- services/: persistence & business logic (CoraDatabase for SQLite, ServiceTransacciones for CRUD)
- screens/: UI pages organized by function (home, add, history)
- widgets/: reusable UI components
- utils/: helper functions
- app_main.dart & main.dart: app bootstrap and routing.
- test/: placeholder for widget tests.
- pubspec.yaml: dependencies (Flutter SDK, provider, sqflite or similar).

a. Presentation Layer
- Screens (HomeScreen, AddScreen, HistoryScreen)
- Widgets (HistoryHorizontal, HistoryVertical, NoDataAvailable)
b. State Management
- TransactionsProvider
c. Data Layer
- ServiceTransacciones (business logic)
- CoraDatabase (SQLite wrapper)
d. Domain Layer
- Models (TransactionModel, CategorieModel, etc.)
e. Platform Hosts (Android, iOS, Web, Desktop runners)

##### Relationships & Data Flow
- User taps in a Screen → Screen invokes a method on TransactionsProvider.
- TransactionsProvider calls ServiceTransacciones to perform add/read/update/delete.
- ServiceTransacciones interacts with CoraDatabase (SQL queries) to persist/fetch raw data.
- Database returns rows → ServiceTransacciones maps rows to Model objects.
- Provider updates its state (List<TransactionModel>), notifies listeners.
- Screen rebuilds, renders updated Widgets.

##### Architectural Patterns & Principles
- Layered architecture: Presentation → State → Service → Persistence
- Separation of concerns: UI only handles rendering; business logic in services; state in providers; data in database class.
- Provider pattern for reactive state management.

##### Elements
- Component labels (e.g., “HomeScreen”, “TransactionsProvider”, “CoraDatabase”)
- Interfaces/APIs (e.g., “Future<List<TransactionModel>> getAllTransactions()”)

##### Detail Level
- Within Services, show two subcomponents: ServiceTransacciones and CoraDatabase.
- Within lib/models, list key model classes.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Platform Hosts"
        AndroidRunner["Android Host"]:::platform
        iOSRunner["iOS Host"]:::platform
        WebRunner["Web Host"]:::platform
        WindowsRunner["Windows Host"]:::platform
        LinuxRunner["Linux Host"]:::platform
        MacOSRunner["macOS Host"]:::platform
    end

    AndroidRunner -->|boots Flutter Engine| FlutterEngine
    iOSRunner -->|boots Flutter Engine| FlutterEngine
    WebRunner -->|boots Flutter Engine| FlutterEngine
    WindowsRunner -->|boots Flutter Engine| FlutterEngine
    LinuxRunner -->|boots Flutter Engine| FlutterEngine
    MacOSRunner -->|boots Flutter Engine| FlutterEngine

    FlutterEngine --> MainDot
    MainDot --> AppMainDot

    subgraph "Presentation Layer"
        subgraph "Screens"
            HomeScreen["HomeScreen"]:::frontend
            AddScreen["AddScreen"]:::frontend
            HistoryScreen["HistoryScreen"]:::frontend
        end
        subgraph "Widgets"
            HistoryHorizontal["HistoryHorizontal"]:::frontend
            HistoryVertical["HistoryVertical"]:::frontend
            NoDataAvailable["NoDataAvailable"]:::frontend
        end
    end

    AppMainDot --> HomeScreen
    AppMainDot --> AddScreen
    AppMainDot --> HistoryScreen

    HomeScreen -->|uses| HistoryHorizontal
    HomeScreen -->|uses| HistoryVertical
    HomeScreen -->|uses| NoDataAvailable

    subgraph "State Management"
        TransactionsProvider["TransactionsProvider"]:::provider
    end

    HomeScreen -->|"invoke action"| TransactionsProvider
    AddScreen -->|"invoke action"| TransactionsProvider
    HistoryScreen -->|"invoke action"| TransactionsProvider

    subgraph "Services Layer"
        ServiceTransacciones["ServiceTransacciones"]:::service
    end

    TransactionsProvider -->|"add/get/update/delete"| ServiceTransacciones

    subgraph "Data Layer"
        CoraDatabase["CoraDatabase"]:::database
    end

    ServiceTransacciones -->|"SQL queries"| CoraDatabase
    CoraDatabase -->|"raw rows"| ServiceTransacciones
    ServiceTransacciones -->|"mapped Models"| TransactionsProvider
    TransactionsProvider -->|"notify listeners"| HomeScreen
    TransactionsProvider -->|"notify listeners"| AddScreen
    TransactionsProvider -->|"notify listeners"| HistoryScreen

    subgraph "Domain Layer"
        TransactionModel["TransactionModel"]:::model
        CategorieModel["CategorieModel"]:::model
        TransactionFiltered["TransactionFiltered"]:::model
        TransactionModelInsert["TransactionModelInsert"]:::model
    end

    ServiceTransacciones -->|"uses"| TransactionModel
    ServiceTransacciones -->|"uses"| CategorieModel
    ServiceTransacciones -->|"uses"| TransactionFiltered
    ServiceTransacciones -->|"uses"| TransactionModelInsert

    click HomeScreen "https://github.com/juanmedina100/mi_cora/blob/master/lib/screens/home/home_screen.dart"
    click AddScreen "https://github.com/juanmedina100/mi_cora/blob/master/lib/screens/add/add_screen.dart"
    click HistoryScreen "https://github.com/juanmedina100/mi_cora/blob/master/lib/screens/history/history_ecreen.dart"
    click HistoryHorizontal "https://github.com/juanmedina100/mi_cora/blob/master/lib/widgets/history_horizontal.dart"
    click HistoryVertical "https://github.com/juanmedina100/mi_cora/blob/master/lib/widgets/histoty_vertical.dart"
    click NoDataAvailable "https://github.com/juanmedina100/mi_cora/blob/master/lib/widgets/no_data_available.dart"
    click TransactionsProvider "https://github.com/juanmedina100/mi_cora/blob/master/lib/providers/transactions_provider.dart"
    click ServiceTransacciones "https://github.com/juanmedina100/mi_cora/blob/master/lib/services/service_transaciones.dart"
    click CoraDatabase "https://github.com/juanmedina100/mi_cora/blob/master/lib/services/cora_database.dart"
    click TransactionModel "https://github.com/juanmedina100/mi_cora/blob/master/lib/models/transaction_model.dart"
    click CategorieModel "https://github.com/juanmedina100/mi_cora/blob/master/lib/models/categorie_model.dart"
    click TransactionFiltered "https://github.com/juanmedina100/mi_cora/blob/master/lib/models/transaction_filtered.dart"
    click TransactionModelInsert "https://github.com/juanmedina100/mi_cora/blob/master/lib/models/transaction_model_insert.dart"
    click MainDot "https://github.com/juanmedina100/mi_cora/blob/master/lib/main.dart"
    click AppMainDot "https://github.com/juanmedina100/mi_cora/blob/master/lib/app_main.dart"
    click AndroidRunner "https://github.com/juanmedina100/mi_cora/tree/master/android/"
    click iOSRunner "https://github.com/juanmedina100/mi_cora/tree/master/ios/"
    click WebRunner "https://github.com/juanmedina100/mi_cora/blob/master/web/index.html"
    click WindowsRunner "https://github.com/juanmedina100/mi_cora/tree/master/windows/"
    click LinuxRunner "https://github.com/juanmedina100/mi_cora/tree/master/linux/"
    click MacOSRunner "https://github.com/juanmedina100/mi_cora/tree/master/macos/"

    classDef frontend fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef provider fill:#90EE90,stroke:#000,stroke-width:1px
    classDef service fill:#FFA500,stroke:#000,stroke-width:1px
    classDef database fill:#D3D3D3,stroke:#000,stroke-width:1px,shape:cylinder
    classDef model fill:#FFFFE0,stroke:#000,stroke-width:1px
    classDef platform fill:#F0F0F0,stroke:#000,stroke-width:1px
    classDef engine fill:#E6E6FA,stroke:#000,stroke-width:1px
    classDef startup fill:#FFB6C1,stroke:#000,stroke-width:1px

    class FlutterEngine engine
    class MainDot,AppMainDot startup
```
