# francesco-pepe/fitconnect architecture

> Architecture diagram of the GitHub repository francesco-pepe/fitconnect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/francesco-pepe/fitconnect
- Repository: https://github.com/francesco-pepe/fitconnect

## Overview

This is a fitness-training planner for athletes and personal trainers, with CLI and GUI interfaces. The main workflow lets an athlete request a plan; a trainer reviews the request, builds a plan with exercises and techniques, and the system saves it and notifies the athlete. Users can also log in and view plans. The graph reflects the controller and DAO calls shown in excerpts and the SOURCE INDEX; several UI, persistence-selection, and notification details are not fully sampled, so uncertain connections are omitted.

Main entry points: [`src/main/java/controller/ManageCustomPlanRequestController.java`](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/controller/ManageCustomPlanRequestController.java) (Plan request controller), [`src/main/java/eng/DAOFactory.java`](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/eng/DAOFactory.java) (DAO selection), [`src/main/java/controller/LoginController.java`](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/controller/LoginController.java) (Login controller), [`src/main/java/view`](https://github.com/francesco-pepe/fitconnect/tree/main/src/main/java/view) (CLI / GUI screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interfaces"]
  node_main["Application entry<br/>[Main.java]"]
  node_navigator["Screen navigation<br/>[Navigator.java]"]
  node_views["CLI / GUI screens"]
end

subgraph group_workflow["Plan workflow"]
  node_login["Login controller"]
  node_plancontroller["Plan request controller"]
  node_athleteboundary["Athlete notifications"]
  node_trainerboundary["Trainer notifications"]
  node_exerciseapi["Exercise API client"]
end

subgraph group_domain["Training domain"]
  node_exercise_mapper["Exercise mapping"]
  node_models["Athlete and trainer<br/>[Athlete.java]"]
  node_request["Plan requests<br/>[PlanRequest.java]"]
  node_trainingplan["Training plans<br/>[TrainingPlan.java]"]
  node_exercise["Exercise techniques<br/>[Exercise.java]"]
  node_session["Session state"]
  node_beans["UI data beans"]
end

subgraph group_persistence["Persistence"]
  node_factory["DAO selection<br/>[DAOFactory.java]"]
  node_athletedao["Athlete storage<br/>[AthleteDAO.java]"]
  node_authdao["Authentication storage"]
  node_trainerdao["Trainer storage"]
  node_requestdao["Request storage"]
  node_plandao["Plan storage"]
end

node_user(("Athlete / trainer"))
node_externalapi{{"Exercise service"}}

node_user -->|"starts"| node_main
node_main -->|"starts navigation"| node_navigator
node_views -->|"navigates screens"| node_navigator
node_views -.->|"submits credentials"| node_login
node_views -->|"requests plan actions"| node_plancontroller
node_login -->|"loads athlete"| node_athletedao
node_login -->|"loads trainer"| node_trainerdao
node_login -->|"authenticates"| node_authdao
node_login -->|"creates session"| node_session
node_plancontroller -->|"fetches / updates"| node_athletedao
node_plancontroller -->|"fetches trainers"| node_trainerdao
node_plancontroller -->|"saves request status"| node_requestdao
node_plancontroller -->|"saves / loads plan"| node_plandao
node_plancontroller -->|"fetches exercises"| node_exerciseapi
node_exerciseapi -.->|"queries"| node_externalapi
node_plancontroller -->|"maps exercise data"| node_exercise_mapper
node_plancontroller -->|"sends notifications"| node_athleteboundary
node_plancontroller -->|"sends notifications"| node_trainerboundary
node_plancontroller -->|"updates athlete plan"| node_models
node_plancontroller -->|"accepts / declines"| node_request
node_plancontroller -->|"constructs plan"| node_trainingplan
node_plancontroller -->|"decorates exercises"| node_exercise
node_views -->|"uses view data"| node_beans
node_plancontroller -->|"gets DAO interfaces"| node_factory
node_factory -->|"provides interface"| node_athletedao
node_factory -->|"provides interface"| node_authdao
node_factory -->|"provides interface"| node_trainerdao
node_factory -->|"provides interface"| node_requestdao
node_factory -->|"provides interface"| node_plandao

click node_main "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/app/Main.java"
click node_navigator "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/view/Navigator.java"
click node_views "https://github.com/francesco-pepe/fitconnect/tree/main/src/main/java/view"
click node_login "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/controller/LoginController.java"
click node_plancontroller "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/controller/ManageCustomPlanRequestController.java"
click node_athleteboundary "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/view/boundary/AthleteBoundary.java"
click node_trainerboundary "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/view/boundary/TrainerBoundary.java"
click node_exerciseapi "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/api/RealExerciseApiService.java"
click node_exercise_mapper "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/eng/ExerciseMapper.java"
click node_models "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/Athlete.java"
click node_request "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/PlanRequest.java"
click node_trainingplan "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/TrainingPlan.java"
click node_exercise "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/Exercise.java"
click node_session "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/SessionManager.java"
click node_beans "https://github.com/francesco-pepe/fitconnect/tree/main/src/main/java/bean"
click node_factory "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/eng/DAOFactory.java"
click node_athletedao "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/athlete/AthleteDAO.java"
click node_authdao "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/authentication/AuthenticationDAO.java"
click node_trainerdao "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/personaltrainer/PersonalTrainerDAO.java"
click node_requestdao "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/planrequest/PlanRequestDAO.java"
click node_plandao "https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/trainingplan/TrainingPlanDAO.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_navigator,node_views toneBlue
class node_login,node_plancontroller,node_athleteboundary,node_trainerboundary,node_exerciseapi toneAmber
class node_exercise_mapper,node_models,node_request,node_trainingplan,node_exercise,node_session,node_beans toneMint
class node_factory,node_athletedao,node_authdao,node_trainerdao,node_requestdao,node_plandao toneRose
class node_user,node_externalapi toneIndigo
```

## Components

### User interfaces

- [Application entry](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/app/Main.java): `src/main/java/app/Main.java`
- [Screen navigation](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/view/Navigator.java): `src/main/java/view/Navigator.java`
- [CLI / GUI screens](https://github.com/francesco-pepe/fitconnect/tree/main/src/main/java/view): `src/main/java/view`

### Plan workflow

- [Login controller](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/controller/LoginController.java): `src/main/java/controller/LoginController.java`
- [Plan request controller](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/controller/ManageCustomPlanRequestController.java): `src/main/java/controller/ManageCustomPlanRequestController.java`
- [Athlete notifications](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/view/boundary/AthleteBoundary.java): `src/main/java/view/boundary/AthleteBoundary.java`
- [Trainer notifications](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/view/boundary/TrainerBoundary.java): `src/main/java/view/boundary/TrainerBoundary.java`
- [Exercise API client](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/api/RealExerciseApiService.java): `src/main/java/api/RealExerciseApiService.java`

### Training domain

- [Exercise mapping](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/eng/ExerciseMapper.java): `src/main/java/eng/ExerciseMapper.java`
- [Athlete and trainer](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/Athlete.java): `src/main/java/model/Athlete.java`
- [Plan requests](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/PlanRequest.java): `src/main/java/model/PlanRequest.java`
- [Training plans](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/TrainingPlan.java): `src/main/java/model/TrainingPlan.java`
- [Exercise techniques](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/Exercise.java): `src/main/java/model/Exercise.java`
- [Session state](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/model/SessionManager.java): `src/main/java/model/SessionManager.java`
- [UI data beans](https://github.com/francesco-pepe/fitconnect/tree/main/src/main/java/bean): `src/main/java/bean`

### Persistence

- [DAO selection](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/eng/DAOFactory.java): `src/main/java/eng/DAOFactory.java`
- [Athlete storage](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/athlete/AthleteDAO.java): `src/main/java/dao/athlete/AthleteDAO.java`
- [Authentication storage](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/authentication/AuthenticationDAO.java): `src/main/java/dao/authentication/AuthenticationDAO.java`
- [Trainer storage](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/personaltrainer/PersonalTrainerDAO.java): `src/main/java/dao/personaltrainer/PersonalTrainerDAO.java`
- [Request storage](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/planrequest/PlanRequestDAO.java): `src/main/java/dao/planrequest/PlanRequestDAO.java`
- [Plan storage](https://github.com/francesco-pepe/fitconnect/blob/main/src/main/java/dao/trainingplan/TrainingPlanDAO.java): `src/main/java/dao/trainingplan/TrainingPlanDAO.java`

### Other components

- **Athlete / trainer**
- **Exercise service**

## Connections

- Athlete / trainer → Application entry: starts (evidence: `src/main/java/app/Main.java`)
- Application entry → Screen navigation: starts navigation (evidence: `src/main/java/app/Main.java`)
- CLI / GUI screens → Screen navigation: navigates screens (evidence: `src/main/java/view/CreatePlanGraphicControllerCLI.java`)
- CLI / GUI screens → Login controller: submits credentials
- CLI / GUI screens → Plan request controller: requests plan actions (evidence: `src/main/java/view/RequestPlanGraphicControllerCLI.java`)
- Login controller → Athlete storage: loads athlete (evidence: `src/main/java/controller/LoginController.java`)
- Login controller → Trainer storage: loads trainer (evidence: `src/main/java/controller/LoginController.java`)
- Login controller → Authentication storage: authenticates (evidence: `src/main/java/controller/LoginController.java`)
- Login controller → Session state: creates session (evidence: `src/main/java/controller/LoginController.java`)
- Plan request controller → Athlete storage: fetches / updates (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Trainer storage: fetches trainers (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Request storage: saves request status (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Plan storage: saves / loads plan (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Exercise API client: fetches exercises (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Exercise API client → Exercise service: queries
- Plan request controller → Exercise mapping: maps exercise data (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Athlete notifications: sends notifications (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Trainer notifications: sends notifications (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Athlete and trainer: updates athlete plan (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Plan requests: accepts / declines (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Training plans: constructs plan (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- Plan request controller → Exercise techniques: decorates exercises (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- CLI / GUI screens → UI data beans: uses view data (evidence: `src/main/java/view/CreatePlanGraphicControllerCLI.java`)
- Plan request controller → DAO selection: gets DAO interfaces (evidence: `src/main/java/controller/ManageCustomPlanRequestController.java`)
- DAO selection → Athlete storage: provides interface (evidence: `src/main/java/eng/DAOFactory.java`)
- DAO selection → Authentication storage: provides interface (evidence: `src/main/java/eng/DAOFactory.java`)
- DAO selection → Trainer storage: provides interface (evidence: `src/main/java/eng/DAOFactory.java`)
- DAO selection → Request storage: provides interface (evidence: `src/main/java/eng/DAOFactory.java`)
- DAO selection → Plan storage: provides interface (evidence: `src/main/java/eng/DAOFactory.java`)
