# marcos-queiroz/calculadora-imc architecture

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

- Interactive diagram: https://gitdiagram.com/marcos-queiroz/calculadora-imc
- Repository: https://github.com/marcos-queiroz/calculadora-imc

## Overview

##### Project type and purpose
- From the file tree and README, this is a cross-platform mobile application built in Flutter. Its purpose is a simple Body Mass Index (IMC) calculator. It contains:
- lib/main.dart (the Dart entrypoint and widget tree)
- android/ (Android project scaffolding)
- ios/ (iOS project scaffolding)

##### File structure
- Top-level:
- android/ – Gradle build scripts, platform code, AndroidManifest, resources.
- ios/ – Xcode project, native app delegate, asset catalogs, plist.
- lib/ – Dart code.
- pubspec.yaml – Flutter dependencies and assets.
- No backend or server directories—this is a purely on-device mobile client.
- No subdirectories in lib/, so it’s likely a small app with UI and simple business logic inline in main.dart.

##### README for additional insights
- The README is the default Flutter template. No references to external services, databases, or advanced architecture.
- This suggests simplicity: UI widgets → business logic (IMC calculation) → display result.

a. Main components
1. Presentation layer (Flutter widgets in lib/main.dart)
2. Business logic layer (IMC calculation code inside Dart)
3. Flutter Engine & Dart runtime
4. Platform adapters (Android and iOS shells)
5. OS (iOS/Android) and Device Hardware
b. Relationships & interactions
- User taps UI button → Flutter widget tree handles tap → Dart logic computes IMC → Widget state updates → Flutter Engine renders pixels via Skia → platform draws on screen.
- No network or external services.
c. Architectural patterns & principles
- Layered architecture: Presentation → Business Logic → Engine → Platform
- Single codebase for UI/business logic (DRY principle)
d. Relevant technologies
- Flutter framework (widgets, rendering via Skia)
- Dart VM / AOT compilation
- Gradle / Android SDK
- Xcode / iOS SDK
- pub.dev (dependency management)

##### Elements
- Clear labels: “Flutter Widgets”, “Business Logic”, “Flutter Engine”, “Android Shell”, “iOS Shell”, “Device OS”
– UI events → Widget tree → Business logic
– Business logic → Engine → Platform APIs → GPU/Screen

##### Detailed breakdown of components
1. Widget Layer (lib/main.dart)
– StatelessWidget / StatefulWidget classes
– TextFields, Buttons, Layouts
2. Logic Layer (inside Dart)
– IMC calculation function(s)
3. Flutter Engine + Dart Runtime
– Skia rendering
– Dart AOT/JIT execution
– Platform channel plug-ins
4. Android Shell
– MainActivity.java → FlutterActivity
– AndroidManifest.xml, resources
5. iOS Shell
– AppDelegate.m → FlutterAppDelegate
– Info.plist, Storyboards, asset catalogs
6. Device OS & Hardware
– Touch input, display, CPU/GPU

Putting it all together
[User & Touch Input]
↓
[Flutter Widget Tree (lib/main.dart)]
↓
[Business Logic (Dart IMC Calculation)]
↓
[Flutter Engine & Dart Runtime]
↓
[Platform Shells: Android / iOS]
↓
[Device OS & Hardware]
– Annotate each layer with the key files/technologies.

## Diagram (Mermaid)

```mermaid
flowchart TD
    User["User & Touch Input"]:::user
    Widgets["Flutter Widget Tree<br/>(lib/main.dart)"]:::dart
    Logic["Business Logic<br/>(IMC Calculation)<br/>(lib/main.dart)"]:::dart

    subgraph "Flutter Engine & Dart Runtime"
        AndroidEmbedder["Android embedder config"]:::engine
        iOSEmbedder["iOS engine config"]:::engine
    end

    subgraph "Platform Shells"
        subgraph "Android Shell"
            ARoot["android/"]:::platform
            MainActivity["MainActivity.java"]:::platform
            Manifest["AndroidManifest.xml"]:::platform
        end
        subgraph "iOS Shell"
            IORoot["ios/"]:::platform
            AppDelegate["AppDelegate.m"]:::platform
            InfoPlist["Info.plist"]:::platform
        end
    end

    OS["Device OS & Hardware"]:::os

    User --> Widgets --> Logic
    Logic --> AndroidEmbedder --> ARoot --> OS
    Logic --> iOSEmbedder --> IORoot --> OS
    AndroidEmbedder --> MainActivity
    ARoot --> MainActivity
    ARoot --> Manifest
    IORoot --> AppDelegate
    IORoot --> InfoPlist

    click Widgets "https://github.com/marcos-queiroz/calculadora-imc/blob/master/lib/main.dart"
    click Logic "https://github.com/marcos-queiroz/calculadora-imc/blob/master/lib/main.dart"
    click ARoot "https://github.com/marcos-queiroz/calculadora-imc/tree/master/android/"
    click MainActivity "https://github.com/marcos-queiroz/calculadora-imc/blob/master/android/app/src/main/java/br/com/beecoffee/calculadora_imc/MainActivity.java"
    click Manifest "https://github.com/marcos-queiroz/calculadora-imc/blob/master/android/app/src/main/AndroidManifest.xml"
    click IORoot "https://github.com/marcos-queiroz/calculadora-imc/tree/master/ios/"
    click AppDelegate "https://github.com/marcos-queiroz/calculadora-imc/blob/master/ios/Runner/AppDelegate.m"
    click InfoPlist "https://github.com/marcos-queiroz/calculadora-imc/blob/master/ios/Runner/Info.plist"
    click AndroidEmbedder "https://github.com/marcos-queiroz/calculadora-imc/blob/master/android/app/src/main/java/br/com/beecoffee/calculadora_imc/MainActivity.java"
    click iOSEmbedder "https://github.com/marcos-queiroz/calculadora-imc/blob/master/ios/Flutter/AppFrameworkInfo.plist"

    classDef user fill:#f9f,stroke:#333,stroke-width:1px
    classDef dart fill:#bbf,stroke:#333,stroke-width:1px
    classDef engine fill:#bfb,stroke:#333,stroke-width:1px
    classDef platform fill:#ffb,stroke:#333,stroke-width:1px
    classDef os fill:#ddd,stroke:#333,stroke-width:1px
```
