# debojyotimishra/fit-company architecture

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

- Interactive diagram: https://gitdiagram.com/debojyotimishra/fit-company
- Repository: https://github.com/debojyotimishra/fit-company

## Overview

##### Project type and purpose
- This is a domain-split, message-driven Python fitness coach system that can run as a monolith (`main_monolith.py`) or as three separate microservices (`fit`, `coach`, `stats`).
- The README calls it an “AI fitness coach.” The code uses HTTP endpoints, RabbitMQ queues, and per-service databases, all containerized via Docker Compose.

##### File structure
- Top-level Docker artifacts:
- docker-compose.yml
- coach.Dockerfile, stats.Dockerfile, monolith.Dockerfile
- Entry points:
- main_monolith.py (all-in-one)
- main_coach.py, main_stats.py (service-specific runners)
- Service directories under `src`:
- src/fit (API layer: Flask/FastAPI blueprints, auth/user/workout endpoints)
- src/coach (queue consumer + fitness coaching logic + DB init scripts)
- src/stats (queue consumer + stats aggregation logic)
- Shared patterns: each service has its own `database.py`, `models_db.py`, `models_dto.py`, and defines its own queue messages in `queue_messages.py`.

##### README for additional insights
- System is started via Docker Compose (likely bringing up RabbitMQ, a relational DB, and one or more services).
- Testing is done via a Bruno collection (HTTP client) and K6 for load tests, so the “Fit” service is the public API surface.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Clients
    Client["Clients (Web/Mobile/Bruno)"]:::external
    K6["K6 Load Test"]:::external

    %% Fit Service Cluster
    subgraph "Fit Service" 
        direction TB
        FitApp["app.py"]:::api
        AuthBP["auth_blueprint.py"]:::api
        UserBP["user_blueprint.py"]:::api
        WorkoutBP["workout_blueprint.py"]:::api
        RabbitSvc["rabbitmq_service.py"]:::api
        FitDBMod["database.py"]:::api
    end

    %% Message Broker
    RabbitMQ["RabbitMQ Broker"]:::broker

    %% Coach Service Cluster
    subgraph "Coach Service"
        direction TB
        CoachApp["app.py"]:::consumer
        CoachCons["queue_consumer.py"]:::consumer
        CoachLogic["fitness_coach_service.py"]:::consumer
        DataInit["fitness_data_init.py"]:::consumer
        CoachDBMod["database.py"]:::consumer
    end

    %% Stats Service Cluster
    subgraph "Stats Service"
        direction TB
        StatsApp["app.py"]:::consumer
        StatsCons["queue_consumer.py"]:::consumer
        StatsLogic["stats_service.py"]:::consumer
        StatsDBMod["database.py"]:::consumer
    end

    %% Databases
    FitDB["Fit DB"]:::database
    CoachDB["Coach DB"]:::database
    StatsDB["Stats DB"]:::database

    %% Arrows
    Client -->|"HTTP requests"| FitApp
    K6 -->|"Load tests HTTP"| FitApp
    FitApp -->|"CRUD ops"| FitDB
    FitApp -->|"publish generate_wod, log_workout"| RabbitMQ
    RabbitMQ -->|"consume generate_wod"| CoachCons
    CoachCons -->|"persist workout"| CoachDB
    RabbitMQ -->|"consume workout_events"| StatsCons
    StatsCons -->|"aggregate metrics"| StatsDB

    %% Click Events - Fit Service
    click FitApp "https://github.com/debojyotimishra/fit-company/blob/main/src/fit/app.py"
    click AuthBP "https://github.com/debojyotimishra/fit-company/blob/main/src/fit/blueprints/auth_blueprint.py"
    click UserBP "https://github.com/debojyotimishra/fit-company/blob/main/src/fit/blueprints/user_blueprint.py"
    click WorkoutBP "https://github.com/debojyotimishra/fit-company/blob/main/src/fit/blueprints/workout_blueprint.py"
    click RabbitSvc "https://github.com/debojyotimishra/fit-company/blob/main/src/fit/services/rabbitmq_service.py"
    click FitDBMod "https://github.com/debojyotimishra/fit-company/blob/main/src/fit/database.py"

    %% Click Events - Coach Service
    click CoachApp "https://github.com/debojyotimishra/fit-company/blob/main/src/coach/app.py"
    click CoachCons "https://github.com/debojyotimishra/fit-company/blob/main/src/coach/queue_consumer.py"
    click CoachLogic "https://github.com/debojyotimishra/fit-company/blob/main/src/coach/fitness_coach_service.py"
    click DataInit "https://github.com/debojyotimishra/fit-company/blob/main/src/coach/fitness_data_init.py"
    click CoachDBMod "https://github.com/debojyotimishra/fit-company/blob/main/src/coach/database.py"

    %% Click Events - Stats Service
    click StatsApp "https://github.com/debojyotimishra/fit-company/blob/main/src/stats/app.py"
    click StatsCons "https://github.com/debojyotimishra/fit-company/blob/main/src/stats/queue_consumer.py"
    click StatsLogic "https://github.com/debojyotimishra/fit-company/blob/main/src/stats/stats_service.py"
    click StatsDBMod "https://github.com/debojyotimishra/fit-company/blob/main/src/stats/database.py"

    %% Styles
    classDef external fill:#D5D8DC,stroke:#1F618D,color:#1F618D
    classDef api fill:#AED6F1,stroke:#2874A6,color:#154360
    classDef broker fill:#F5B041,stroke:#CA6F1E,color:#6E2C00
    classDef consumer fill:#A9DFBF,stroke:#28B463,color:#1D8348
    classDef database fill:#E5E7E9,stroke:#7B7D7D,color:#424949
```
