# hantsaniala/trosa architecture

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

- Interactive diagram: https://gitdiagram.com/hantsaniala/trosa
- Repository: https://github.com/hantsaniala/trosa

## Overview

##### Main Components

a. Mobile Application Layer
- iOS Client (Native Swift)
- Android Client (Native Kotlin)
- Flutter Cross-Platform Layer

b. Application Core
- UI Components
- Business Logic
- Local Database
- State Management

##### Detailed Architecture Breakdown

a. Presentation Layer (Top Level):
- Main screens (`lib/screens/trosa/`)
- UI components (`lib/components/`)
- Relationship with the state management system

b. Business Logic Layer (Middle Level):
- Notifier pattern for state management (`lib/notifier/trosa_notifier.dart`)
- Models (`lib/models/trosa.dart`)
- API services (`lib/api/trosa_api.dart`)

c. Data Layer (Bottom Level):
- Local database implementation (`lib/db/sqflite_provider.dart`)
- Data persistence flow

##### Specific Implementation Details

- Main Application Entry (`lib/main.dart`)
- Constants (`lib/const.dart`)
- Currency Formatting (`lib/components/currency_input_formatter.dart`)
- Database Provider (`lib/db/sqflite_provider.dart`)
- Trosa API Service (`lib/api/trosa_api.dart`)

**[Mobile Platforms]**
- ↓
**[Flutter Framework]**
- ↓
**[UI Layer] ←→ [State Management]**
- ↓           ↕
**[Business Logic] → [Models]**
- ↓
**[Data Layer]**
- ↓
**[Local Storage]**

##### Technical Stack Highlights

- Flutter for cross-platform development
- SQLite for local storage (sqflite)
- Provider pattern for state management
- Native platform integration (Swift/Kotlin)

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Platforms
        iOS["iOS Client (Swift)"]
        Android["Android Client (Kotlin)"]
    end

    subgraph "Flutter Framework"
        Main["Main Application"]
        
        subgraph "UI Layer"
            Screens["Screens"]
            Components["UI Components"]
            
            subgraph "Screen Components"
                MainScreen["Main Screen"]
                FormScreen["Form Screen"]
                AboutScreen["About Screen"]
                TrosaCard["Trosa Card"]
            end
            
            subgraph "Common Components"
                CurrencyFormatter["Currency Formatter"]
            end
        end
        
        subgraph "Business Logic"
            StateManagement["State Management"]
            Models["Data Models"]
            Constants["Constants"]
        end
        
        subgraph "Data Layer"
            API["Trosa API"]
            Database["Local Database (SQLite)"]
        end
        
        subgraph "Assets"
            Icons["Icons"]
            Images["Images"]
        end
    end
    
    %% Relationships
    iOS --> Main
    Android --> Main
    Main --> Screens
    Screens --> Components
    Components --> StateManagement
    StateManagement --> Models
    StateManagement --> API
    StateManagement --> Database
    
    %% Screen relationships
    Screens --> MainScreen
    Screens --> FormScreen
    Screens --> AboutScreen
    MainScreen --> TrosaCard
    Components --> CurrencyFormatter
    
    %% Click events
    click iOS "https://github.com/hantsaniala/trosa/blob/develop/ios/Runner/AppDelegate.swift"
    click Android "https://github.com/hantsaniala/trosa/blob/develop/android/app/src/main/kotlin/mg/hantsaniala/trosa/MainActivity.kt"
    click Main "https://github.com/hantsaniala/trosa/blob/develop/lib/main.dart"
    click MainScreen "https://github.com/hantsaniala/trosa/blob/develop/lib/screens/trosa/trosa_screen.dart"
    click FormScreen "https://github.com/hantsaniala/trosa/blob/develop/lib/screens/trosa/trosa_form_screen.dart"
    click AboutScreen "https://github.com/hantsaniala/trosa/blob/develop/lib/screens/trosa/trosa_about.dart"
    click TrosaCard "https://github.com/hantsaniala/trosa/blob/develop/lib/screens/trosa/components/trosa_card.dart"
    click CurrencyFormatter "https://github.com/hantsaniala/trosa/blob/develop/lib/components/currency_input_formatter.dart"
    click StateManagement "https://github.com/hantsaniala/trosa/blob/develop/lib/notifier/trosa_notifier.dart"
    click Models "https://github.com/hantsaniala/trosa/blob/develop/lib/models/trosa.dart"
    click Constants "https://github.com/hantsaniala/trosa/blob/develop/lib/const.dart"
    click API "https://github.com/hantsaniala/trosa/blob/develop/lib/api/trosa_api.dart"
    click Database "https://github.com/hantsaniala/trosa/blob/develop/lib/db/sqflite_provider.dart"
    click Icons "https://github.com/hantsaniala/trosa/tree/develop/assets/icons"
    click Images "https://github.com/hantsaniala/trosa/tree/develop/assets/images"
    
    %% Styling
    classDef platform fill:#f9f,stroke:#333
    classDef ui fill:#aef,stroke:#333
    classDef logic fill:#bfb,stroke:#333
    classDef data fill:#feb,stroke:#333
    classDef assets fill:#eee,stroke:#333
    
    class iOS,Android platform
    class MainScreen,FormScreen,AboutScreen,TrosaCard,Components,CurrencyFormatter ui
    class StateManagement,Models,Constants logic
    class API,Database data
    class Icons,Images assets
```
