# pineapple-epita/fit-company architecture

> Architecture diagram of the GitHub repository pineapple-epita/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/pineapple-epita/fit-company
- Repository: https://github.com/pineapple-epita/fit-company

## Overview

##### Project type and purpose
- From the README (“The fit monolith is a blazing fast, cutting edge AI fitness coach”) plus the file tree, this is a hybrid Python fitness-coach application in transition from a monolith toward microservices. It provides authentication, user management, fitness coaching (WODs), profiles, etc., and can be exercised via the Bruno API-testing collection.

##### File structure
- Top level
- Dockerfile, docker-compose.yml, nginx.conf → containerized deployment with an API gateway (NGINX) and services
- main.py → monolithic application entrypoint (“fit” monolith)
- src/fit/ → current monolith (Flask blueprints: auth, fitness, profile, user; models; database init)
- src/coach_microservice/ & src/user_microservice/ → two standalone microservices (each with its own Dockerfile, app.py, models, services)
- docs/, adr/ → documentation and architectural decision records
- Tests folder contains unit and load tests against the APIs.
- bruno/ holds API requests for the Bruno client.

##### README for additional insights
- Single command (“docker compose up -d”) to start the database
- “uv sync” / “./main.py” to run the monolith
- Encourages using Bruno for API exploration
- Tests are run via pytest

##### Essential details
- Environment files or config mounts if relevant (e.g., volumes in docker-compose)
- Ports (e.g., 80 on NGINX, 8000 on monolith, 8001/8002 on services)

## Diagram (Mermaid)

```mermaid
flowchart TD
    classDef client fill:#dddddd,stroke:#888888,color:#333333
    classDef gateway fill:#bbdefb,stroke:#2196f3,color:#0d47a1
    classDef monolith fill:#c8e6c9,stroke:#4caf50,color:#1b5e20
    classDef micro fill:#ffe0b2,stroke:#ff9800,color:#e65100
    classDef db fill:#e1bee7,stroke:#9c27b0,color:#4a148c

    subgraph "Clients"
        direction TB
        Client["HTTP Client (Bruno/Postman)"]:::client
        Tests["Automated Tests (pytest & k6)"]:::client
    end

    subgraph "Docker Compose"
        direction TB
        Gateway["API Gateway\n(nginx.conf)"]:::gateway
        Monolith["Monolith Service\n(fit:latest)"]:::monolith
        CoachSvc["Coach Microservice\n(coach-svc:latest)"]:::micro
        UserSvc["User Microservice\n(user-svc:latest)"]:::micro
        Database["Database Service\n(PostgreSQL)"]:::db
    end

    Client -->|HTTP requests| Gateway
    Tests -->|Test traffic| Gateway

    Gateway -->|routes to| Monolith
    Gateway -->|routes to| CoachSvc
    Gateway -->|routes to| UserSvc

    Monolith -->|SQL| Database
    CoachSvc -->|SQL| Database
    UserSvc -->|SQL| Database

    Monolith -->|internal HTTP calls| CoachSvc

    click Gateway "https://github.com/pineapple-epita/fit-company/blob/main/nginx.conf"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/main.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/app.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/blueprints/auth.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/blueprints/fitness.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/blueprints/profile.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/blueprints/user.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/database.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/db_init_scripts/init_muscle_groups_exercises.sql"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/models_db.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/models_dto.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/services/auth_service.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/services/fitness_coach_service.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/services/fitness_data_init.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/services/fitness_service.py"
    click Monolith "https://github.com/pineapple-epita/fit-company/blob/main/src/fit/services/user_service.py"

    click CoachSvc "https://github.com/pineapple-epita/fit-company/tree/main/src/coach_microservice/Dockerfile"
    click CoachSvc "https://github.com/pineapple-epita/fit-company/blob/main/src/coach_microservice/app.py"
    click CoachSvc "https://github.com/pineapple-epita/fit-company/blob/main/src/coach_microservice/models/models_dto.py"
    click CoachSvc "https://github.com/pineapple-epita/fit-company/blob/main/src/coach_microservice/services/wod_service.py"

    click UserSvc "https://github.com/pineapple-epita/fit-company/tree/main/src/user_microservice/Dockerfile"
    click UserSvc "https://github.com/pineapple-epita/fit-company/blob/main/src/user_microservice/app.py"
    click UserSvc "https://github.com/pineapple-epita/fit-company/blob/main/src/user_microservice/database.py"
    click UserSvc "https://github.com/pineapple-epita/fit-company/blob/main/src/user_microservice/models_db.py"
    click UserSvc "https://github.com/pineapple-epita/fit-company/blob/main/src/user_microservice/models_dto.py"
    click UserSvc "https://github.com/pineapple-epita/fit-company/blob/main/src/user_microservice/services/user_service.py"

    click Database "https://github.com/pineapple-epita/fit-company/blob/main/docker-compose.yml"

    class Client,Tests client
    class Gateway gateway
    class Monolith monolith
    class CoachSvc,UserSvc micro
    class Database db
```
