# mohesmail143/coach-ai architecture

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

- Interactive diagram: https://gitdiagram.com/mohesmail143/coach-ai
- Repository: https://github.com/mohesmail143/coach-ai

## Overview

##### Project type and purpose
- Coach.ai is a full-stack mobile application (Flutter) with on-device ML inference and cloud backend services.
- Purpose: guide users through exercises by detecting pose and counting reps (using TensorFlow MoveNet and custom TFLite models), calculate BMI, track nutrition, and authenticate users via Firebase.

##### File structure
- Top-level platform folders: `android/`, `ios/`, `linux/`, `macos/`, `windows/`, `web/` — standard Flutter multi-platform support.
- Core Dart code under `lib/`:
- `lib/main.dart` — application entry point
- `lib/screens/` — UI pages (Intro, Login, Signup, Home, Camera, Exercise selection, BMI, Nutrition, Profile, etc.)
- `lib/services/` — Firebase authentication wrapper
- `lib/utils/camera/` — pose detector, isolate management, landmark rendering, rep counter, sample input
- `lib/utils/` — domain models (exercise, nutrition, session)
- `lib/widgets/` — reusable UI components (buttons, text fields)
- `assets/models/`: TFLite files (movenet, pushUp, pullUp, squat)
- Config files: `pubspec.yaml` (dependencies), platform build scripts, Firebase config in `android/app/google-services.json`, `lib/firebase_options.dart`.

##### README for additional insights
- Confirms ML usage (MoveNet + custom pose-classification models), Firebase for auth, BMI and nutrition modules.

##### Detailed breakdown of components
- Presentation Layer (lib/screens, lib/widgets)
- Screens: Login, Signup, Home, Camera, BMI, Nutrition, Profile
- Service Layer (lib/services/firebase_auth_service.dart)
- Methods: signIn(), signUp(), signOut(), getCurrentUser()
- Business Logic Layer (lib/utils)
- Exercise, NutritionPlan, WorkoutSession classes
- BMI calculation
- ML Inference Layer (lib/utils/camera)
- PoseDetector (MoveNet), PoseClassifier (custom)
- RepCounter, LandmarkRenderer, TTS (coach_tts)
- Cloud Layer (Firebase)
- Auth Service
- (Optional) Firestore for nutrition logs
- Asset Store
- TFLite models (assets/models/*.tflite)

Final advice
- Drill down into the client: separate UI, logic, ML sub-modules.
- Iterate: validate with team to ensure it matches the actual runtime interactions.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        FLApp["Flutter App Entry Point"]:::presentation
        UI["UI Layer (Screens)"]:::presentation
        Widgets["UI Layer (Widgets)"]:::presentation
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        direction TB
        BL["Business Logic"]:::logic
        ExerciseModel["Exercise Model"]:::logic
        NutritionPlanModel["Nutrition Plan Model"]:::logic
        WorkoutSessionModel["Workout Session Model"]:::logic
    end

    %% BMI Module
    subgraph "BMI Module"
        direction TB
        BMICalc["BMI Calculation UI & Logic"]:::logic
        BMIResult["BMI Result UI"]:::logic
    end

    %% Nutrition Module
    subgraph "Nutrition Module"
        direction TB
        NutritionScreen["Nutrition Screen UI"]:::logic
    end

    %% ML Inference Layer
    subgraph "ML Inference Layer"
        direction TB
        PoseDetector["pose_detector.dart"]:::ml
        PoseIsolate["pose_detector_isolate.dart"]:::ml
        FormClassifier["form_classifier.dart"]:::ml
        RepCounter["rep_counter.dart"]:::ml
        RenderLandmarks["render_landmarks.dart"]:::ml
        CoachTTS["coach_tts.dart"]:::ml
        SampleInput["sample_input_pose.dart"]:::ml
        Constants["constants.dart"]:::ml
    end

    %% Cloud Services Layer
    subgraph "Cloud Services Layer"
        direction TB
        FirebaseAuth["Firebase Auth Service"]:::cloud
        FirebaseDB["Firebase Database"]:::cloud
        FirebaseConfig["Firebase Config"]:::cloud
    end

    %% Asset Store
    subgraph "Asset Store"
        direction TB
        TFLiteModels["TFLite Model Assets"]:::asset
    end

    %% Platform Integration
    subgraph "Platform Integration"
        direction TB
        Android["MainActivity (Android)"]:::platform
        iOS["AppDelegate (iOS)"]:::platform
    end

    %% Connections
    FLApp -->|"uses"| UI
    FLApp -->|"initializes"| Widgets
    UI -->|"renders"| BL
    UI -->|"navigates to"| BMICalc
    UI -->|"shows"| BMIResult
    UI -->|"navigates to"| NutritionScreen
    UI -->|"triggers"| PoseDetector
    UI -->|"calls"| FirebaseAuth
    BL --> ExerciseModel
    BL --> NutritionPlanModel
    BL --> WorkoutSessionModel
    NutritionScreen --> NutritionPlanModel
    BMICalc --> BL
    BMIResult --> BL
    PoseDetector --> PoseIsolate
    PoseIsolate --> FormClassifier
    FormClassifier --> RepCounter
    RepCounter --> RenderLandmarks
    RenderLandmarks --> CoachTTS
    SampleInput --> PoseDetector
    PoseDetector --> Constants
    FirebaseAuth --> FirebaseConfig
    FirebaseAuth --> FirebaseDB
    NutritionScreen --> FirebaseDB
    TFLiteModels --> PoseDetector
    Android --> FLApp
    iOS --> FLApp

    %% Click Events
    click FLApp "https://github.com/mohesmail143/coach-ai/blob/main/lib/main.dart"
    click UI "https://github.com/mohesmail143/coach-ai/tree/main/lib/screens/"
    click Widgets "https://github.com/mohesmail143/coach-ai/tree/main/lib/widgets/"
    click FirebaseAuth "https://github.com/mohesmail143/coach-ai/blob/main/lib/services/firebase_auth_service.dart"
    click FirebaseConfig "https://github.com/mohesmail143/coach-ai/blob/main/lib/firebase_options.dart"
    click FirebaseConfig "https://github.com/mohesmail143/coach-ai/blob/main/android/app/google-services.json"
    click PoseDetector "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/camera/pose_detector.dart"
    click PoseIsolate "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/camera/pose_detector_isolate.dart"
    click FormClassifier "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/camera/form_classifier.dart"
    click RepCounter "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/camera/rep_counter.dart"
    click RenderLandmarks "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/camera/render_landmarks.dart"
    click CoachTTS "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/camera/coach_tts.dart"
    click SampleInput "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/camera/sample_input_pose.dart"
    click Constants "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/camera/constants.dart"
    click ExerciseModel "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/exercise.dart"
    click NutritionPlanModel "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/nutrition_plan.dart"
    click WorkoutSessionModel "https://github.com/mohesmail143/coach-ai/blob/main/lib/utils/workout_session.dart"
    click BMICalc "https://github.com/mohesmail143/coach-ai/blob/main/lib/screens/bmi/calculate_BMI.dart"
    click BMIResult "https://github.com/mohesmail143/coach-ai/blob/main/lib/screens/bmi/result_BMI.dart"
    click NutritionScreen "https://github.com/mohesmail143/coach-ai/blob/main/lib/screens/nutrition_screen.dart"
    click TFLiteModels "https://github.com/mohesmail143/coach-ai/tree/main/assets/models/"
    click Android "https://github.com/mohesmail143/coach-ai/blob/main/android/app/src/main/kotlin/com/example/coach_ai/MainActivity.kt"
    click iOS "https://github.com/mohesmail143/coach-ai/blob/main/ios/Runner/AppDelegate.swift"

    %% Styles
    classDef presentation fill:#AED6F1,stroke:#1F618D,color:#1B2631
    classDef logic fill:#A9DFBF,stroke:#196F3D,color:#1B2631
    classDef ml fill:#F5CBA7,stroke:#B9770E,color:#1B2631
    classDef cloud fill:#F9E79F,stroke:#B7950B,color:#1B2631
    classDef asset fill:#F5B7B1,stroke:#943126,color:#1B2631
    classDef platform fill:#D7DBDD,stroke:#566573,color:#1B2631
```
