# takujoye14/fit-company architecture

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

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

## Overview

##### Project type and purpose
- This is a Python-based monolithic REST API (“fit monolith”) providing endpoints for an AI fitness coach.
- It exposes routes for authentication, user management, fitness data retrieval, and profile management.
- Docker is used to launch the database via docker‐compose; testing is done with pytest; “Bruno” collections exercise the API.

##### File structure
- Top‐level artifacts:
- Dockerfile, docker-compose.yml – containerization
- main.py – entry point / Uvicorn server launcher
- pyproject.toml – Python dependencies
- src/fit – application code
- tests – pytest suite
- bruno/ – API request collection
- Inside src/fit:
- app.py – FastAPI (or similar) app instantiation
- database.py & db_init_scripts – DB connection & initialization scripts
- models_db.py & models_dto.py – ORM/DB schemas and data‐transfer objects
- routes/ – HTTP routers (auth, fitness, profile, user)
- services/ – business logic (auth_service, user_service, fitness_service, fitness_data_init, fitness_coach_service)

##### README for additional insights
- Confirms startup steps: `docker compose up` for DB, `uv sync` + `./main.py` to run server.
- Encourages use of Bruno collection for API exploration.
- No built‐in frontend; it’s an API service only.

##### Essential elements
- Labels for each layer/component
- Deployment context: Docker host, docker-compose network

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients
    subgraph "Clients" 
        direction TB
        Client_Bruno["Bruno Collection"]:::client
        Client_CLI["CLI/Other HTTP Clients"]:::client
    end

    %% Infrastructure
    subgraph "Infrastructure (Docker Host)" 
        direction TB
        Dockerfile["Dockerfile"]:::infra
        Compose["docker-compose.yml"]:::infra
    end

    %% Docker compose network links
    Dockerfile -->|build| API_Container
    Compose -->|network| API_Container
    Compose -->|network| DB_Container

    %% API container
    subgraph "API Container" 
        direction TB
        Main["main.py"]:::api
        App["app.py"]:::api
        subgraph "Routing Layer"
            direction TB
            AuthRoutes["auth_routes.py"]:::router
            UserRoutes["user_routes.py"]:::router
            FitnessRoutes["fitness_routes.py"]:::router
            ProfileRoutes["profile_routes.py"]:::router
        end
        subgraph "Service Layer"
            direction TB
            AuthService["auth_service.py"]:::service
            UserService["user_service.py"]:::service
            FitnessService["fitness_service.py"]:::service
            CoachService["fitness_coach_service.py"]:::service
            DataInitService["fitness_data_init.py"]:::service
        end
        subgraph "Data Access Layer"
            direction TB
            DatabaseConn["database.py"]:::dao
            ModelsDB["models_db.py"]:::dao
            ModelsDTO["models_dto.py"]:::dao
            InitScripts["init_muscle_groups_exercises.sql"]:::dao
        end
    end

    %% Database container
    subgraph "Database Container" 
        direction TB
        DB["PostgreSQL"]:::db
    end

    %% Tests and load tests
    subgraph "Testing & Load Tests"
        direction TB
        Pytest["tests (pytest suite)"]:::test
        LoadTest["load_test.js & test_summary.md"]:::test
    end

    %% Dependencies & Docs
    subgraph "Project Files"
        direction TB
        PyProj["pyproject.toml"]:::infra
        Readme["README.md"]:::infra
        DocsDB["docs/fitness_database.md"]:::infra
        DocsAssign["docs/01-students_assignment.md"]:::infra
    end

    %% Flows
    Client_Bruno -->|HTTP| Main
    Client_CLI -->|HTTP| Main
    Main -->|"instantiate"| App
    App -->|"include routers"| AuthRoutes
    App -->|"include routers"| UserRoutes
    App -->|"include routers"| FitnessRoutes
    App -->|"include routers"| ProfileRoutes
    AuthRoutes -->|"calls"| AuthService
    UserRoutes -->|"calls"| UserService
    FitnessRoutes -->|"calls"| FitnessService
    ProfileRoutes -->|"calls"| CoachService
    AuthService -->|"uses"| DatabaseConn
    UserService -->|"uses"| DatabaseConn
    FitnessService -->|"uses"| DatabaseConn
    CoachService -->|"uses"| DatabaseConn
    DataInitService -->|"runs init script"| InitScripts
    DatabaseConn -->|"CRUD"| ModelsDB
    ModelsDB -->|"maps"| ModelsDTO
    InitScripts -->|populate| DB
    DatabaseConn -->|connect| DB
    Pytest -->|HTTP| Main
    LoadTest -->|HTTP| Main

    %% Click Events
    click Main "https://github.com/takujoye14/fit-company/blob/main/main.py"
    click App "https://github.com/takujoye14/fit-company/blob/main/src/fit/app.py"
    click Dockerfile "https://github.com/takujoye14/fit-company/tree/main/Dockerfile"
    click Compose "https://github.com/takujoye14/fit-company/blob/main/docker-compose.yml"
    click AuthRoutes "https://github.com/takujoye14/fit-company/blob/main/src/fit/routes/auth_routes.py"
    click UserRoutes "https://github.com/takujoye14/fit-company/blob/main/src/fit/routes/user_routes.py"
    click FitnessRoutes "https://github.com/takujoye14/fit-company/blob/main/src/fit/routes/fitness_routes.py"
    click ProfileRoutes "https://github.com/takujoye14/fit-company/blob/main/src/fit/routes/profile_routes.py"
    click AuthService "https://github.com/takujoye14/fit-company/blob/main/src/fit/services/auth_service.py"
    click UserService "https://github.com/takujoye14/fit-company/blob/main/src/fit/services/user_service.py"
    click FitnessService "https://github.com/takujoye14/fit-company/blob/main/src/fit/services/fitness_service.py"
    click CoachService "https://github.com/takujoye14/fit-company/blob/main/src/fit/services/fitness_coach_service.py"
    click DataInitService "https://github.com/takujoye14/fit-company/blob/main/src/fit/services/fitness_data_init.py"
    click DatabaseConn "https://github.com/takujoye14/fit-company/blob/main/src/fit/database.py"
    click ModelsDB "https://github.com/takujoye14/fit-company/blob/main/src/fit/models_db.py"
    click ModelsDTO "https://github.com/takujoye14/fit-company/blob/main/src/fit/models_dto.py"
    click InitScripts "https://github.com/takujoye14/fit-company/blob/main/src/fit/db_init_scripts/init_muscle_groups_exercises.sql"
    click Pytest "https://github.com/takujoye14/fit-company/blob/main/tests/conftest.py"
    click Pytest "https://github.com/takujoye14/fit-company/blob/main/tests/test_user_api.py"
    click Client_Bruno "https://github.com/takujoye14/fit-company/blob/main/bruno/collection.bru"
    click Client_Bruno "https://github.com/takujoye14/fit-company/blob/main/bruno/environments/local.bru"
    click LoadTest "https://github.com/takujoye14/fit-company/blob/main/load_estimation_WOD_api/load_test.js"
    click LoadTest "https://github.com/takujoye14/fit-company/blob/main/load_estimation_WOD_api/test_summary.md"
    click PyProj "https://github.com/takujoye14/fit-company/blob/main/pyproject.toml"
    click Readme "https://github.com/takujoye14/fit-company/blob/main/README.md"
    click DocsDB "https://github.com/takujoye14/fit-company/blob/main/docs/fitness_database.md"
    click DocsAssign "https://github.com/takujoye14/fit-company/blob/main/docs/01-students_assignment.md"

    %% Styles
    classDef client fill:#D6E9FE,stroke:#4A90E2,color:#1B4F72;
    classDef api fill:#D5F5E3,stroke:#27AE60,color:#145A32;
    classDef router fill:#E8F8F5,stroke:#1ABC9C,color:#117A65;
    classDef service fill:#FCF3CF,stroke:#F1C40F,color:#7D6608;
    classDef dao fill:#FDEBD0,stroke:#E67E22,color:#A04000;
    classDef db fill:#F5B7B1,stroke:#E74C3C,color:#641E16;
    classDef infra fill:#E5E7E9,stroke:#95A5A6,color:#2C3E50;
    classDef test fill:#EBDEF0,stroke:#9B59B6,color:#4A235A;
```
