# protrainingunaj/protraining-back architecture

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

- Interactive diagram: https://gitdiagram.com/protrainingunaj/protraining-back
- Repository: https://github.com/protrainingunaj/protraining-back

## Overview

ProTraining is a .NET microservice backend for athlete identity, organization, training, wellness tracking, and AI-assisted planning. The documented user entry is the gateway; a representative workflow is an athlete or coach using training routines and records, with check-ins and performance data supporting follow-up. Assistant capabilities include routine suggestions, plan drafts, preventive alerts, and resilient AI fallback. The README documents service-owned PostgreSQL databases; sampled handlers show selected repository and cross-service calls. Other service internals and most gateway routing are not sampled, so those relationships are omitted.

Main entry points: [`services/seguimiento/API/Controllers`](https://github.com/protrainingunaj/protraining-back/tree/develop/services/seguimiento/API/Controllers) (Wellness API), [`services/asistente/API/Controllers`](https://github.com/protrainingunaj/protraining-back/tree/develop/services/asistente/API/Controllers) (Assistant API), [`gateway/Program.cs`](https://github.com/protrainingunaj/protraining-back/blob/develop/gateway/Program.cs) (API gateway), [`services/asistente/Infrastructure/Services/Ai/ResilientAiService.cs`](https://github.com/protrainingunaj/protraining-back/blob/develop/services/asistente/Infrastructure/Services/Ai/ResilientAiService.cs) (AI fallback chain)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Entry gateway"]
  node_gateway["API gateway<br/>[Program.cs]"]
  node_perimeter["Perimeter security"]
  node_session["Session validation"]
end

subgraph group_identity["Identity and structure"]
  node_identity_api["Identity API"]
  node_identity_domain["Accounts"]
  node_identity_db[("Identity database")]
  node_structure_api["Athlete organization"]
  node_structure_db[("Structure database")]
end

subgraph group_training["Training service"]
  node_training_api["Training API"]
  node_exercise_catalog["Exercise catalog"]
  node_exercise_model["Exercise model<br/>[Exercise.cs]"]
  node_training_records["Plans and records"]
  node_routine["Today's routine"]
  node_training_db[("Training database")]
end

subgraph group_followup["Wellness tracking"]
  node_followup_api["Wellness API"]
  node_checkins["Check-ins and injuries"]
  node_evolution["Athlete evolution"]
  node_field_tests["Field tests"]
  node_followup_db[("Wellness database")]
end

subgraph group_assistant["AI assistance"]
  node_assistant_api["Assistant API"]
  node_routine_suggestions["Routine suggestions"]
  node_plan_drafts["Plan drafts"]
  node_alerts["Preventive alerts"]
  node_ai_fallback["AI fallback chain"]
  node_assistant_db[("Assistant database")]
end

node_front(("Frontend"))
node_ollama["Ollama"]
node_gemini["Google Gemini"]
node_rules["Local rule engine"]

node_front -->|"sends requests"| node_gateway
node_gateway -->|"routes requests"| node_structure_api
node_gateway --> node_perimeter
node_gateway --> node_session
node_identity_api -.->|"manages accounts"| node_identity_domain
node_identity_api -.->|"persists data"| node_identity_db
node_structure_api -.->|"persists data"| node_structure_db
node_training_api -.->|"handles training"| node_training_records
node_training_api -.->|"serves routines"| node_routine
node_exercise_catalog -->|"maps exercises"| node_exercise_model
node_routine -.->|"reads training data"| node_training_db
node_training_api -.->|"persists data"| node_training_db
node_followup_api -.->|"serves check-ins"| node_checkins
node_followup_api -.->|"serves evolution"| node_evolution
node_followup_api -.->|"serves tests"| node_field_tests
node_checkins -.->|"reads check-ins"| node_followup_db
node_evolution -.->|"reads tracking data"| node_followup_db
node_followup_api -.->|"persists data"| node_followup_db
node_assistant_api -.->|"handles suggestions"| node_routine_suggestions
node_assistant_api -.->|"handles drafts"| node_plan_drafts
node_assistant_api -.->|"handles alerts"| node_alerts
node_assistant_api -.->|"persists data"| node_assistant_db
node_routine_suggestions -.->|"requests generation"| node_ai_fallback
node_ai_fallback -.->|"tries local model"| node_ollama
node_ai_fallback -.->|"falls back"| node_gemini
node_ai_fallback -.->|"uses rules"| node_rules

click node_gateway "https://github.com/protrainingunaj/protraining-back/blob/develop/gateway/Program.cs"
click node_perimeter "https://github.com/protrainingunaj/protraining-back/blob/develop/gateway/Middleware/PerimeterSecurityMiddleware.cs"
click node_session "https://github.com/protrainingunaj/protraining-back/blob/develop/gateway/Services/SessionValidationClient.cs"
click node_identity_api "https://github.com/protrainingunaj/protraining-back/tree/develop/services/identidad/API/Controllers"
click node_identity_domain "https://github.com/protrainingunaj/protraining-back/tree/develop/services/identidad/Domain/Entities"
click node_identity_db "https://github.com/protrainingunaj/protraining-back/tree/develop/services/identidad"
click node_structure_api "https://github.com/protrainingunaj/protraining-back/blob/develop/services/estructura/API/Controllers/AthletesController.cs"
click node_structure_db "https://github.com/protrainingunaj/protraining-back/tree/develop/services/estructura"
click node_training_api "https://github.com/protrainingunaj/protraining-back/tree/develop/services/entrenamiento/API/Controllers"
click node_exercise_catalog "https://github.com/protrainingunaj/protraining-back/blob/develop/services/entrenamiento/Application/UseCases/Exercise/ListExercises/ListExercisesQueryHandler.cs"
click node_exercise_model "https://github.com/protrainingunaj/protraining-back/blob/develop/services/entrenamiento/Domain/Entities/Exercise.cs"
click node_training_records "https://github.com/protrainingunaj/protraining-back/blob/develop/services/entrenamiento/Application/Interfaces/Persistence/ITrainingPlanRepository.cs"
click node_routine "https://github.com/protrainingunaj/protraining-back/blob/develop/services/entrenamiento/Application/UseCases/Routines/GetTodayRoutine/GetTodayRoutineQueryHandler.cs"
click node_training_db "https://github.com/protrainingunaj/protraining-back/tree/develop/services/entrenamiento"
click node_followup_api "https://github.com/protrainingunaj/protraining-back/tree/develop/services/seguimiento/API/Controllers"
click node_checkins "https://github.com/protrainingunaj/protraining-back/blob/develop/services/seguimiento/Application/UseCases/CheckIns/ListAthleteCheckIns/ListAthleteCheckInsQueryHandler.cs"
click node_evolution "https://github.com/protrainingunaj/protraining-back/blob/develop/services/seguimiento/Application/UseCases/Evolution/GetAthleteEvolution/GetAthleteEvolutionQueryHandler.cs"
click node_field_tests "https://github.com/protrainingunaj/protraining-back/blob/develop/services/seguimiento/API/Controllers/FieldTests/FieldTestSessionsController.cs"
click node_followup_db "https://github.com/protrainingunaj/protraining-back/tree/develop/services/seguimiento"
click node_assistant_api "https://github.com/protrainingunaj/protraining-back/tree/develop/services/asistente/API/Controllers"
click node_routine_suggestions "https://github.com/protrainingunaj/protraining-back/blob/develop/services/asistente/Application/UseCases/Ai/SuggestRoutine/SuggestRoutineUseCase.cs"
click node_plan_drafts "https://github.com/protrainingunaj/protraining-back/tree/develop/services/asistente/Application/UseCases/PlanDrafts"
click node_alerts "https://github.com/protrainingunaj/protraining-back/tree/develop/services/asistente/Application/UseCases/Alerts"
click node_ai_fallback "https://github.com/protrainingunaj/protraining-back/blob/develop/services/asistente/Infrastructure/Services/Ai/ResilientAiService.cs"
click node_assistant_db "https://github.com/protrainingunaj/protraining-back/tree/develop/services/asistente"
click node_rules "https://github.com/protrainingunaj/protraining-back/blob/develop/services/asistente/Infrastructure/Services/Ai/Rules/DeterministicRuleEngine.cs"

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_gateway,node_perimeter,node_session,node_front toneBlue
class node_identity_api,node_identity_domain,node_identity_db,node_structure_api,node_structure_db toneAmber
class node_training_api,node_exercise_catalog,node_exercise_model,node_training_records,node_routine,node_training_db toneMint
class node_followup_api,node_checkins,node_evolution,node_field_tests,node_followup_db toneRose
class node_assistant_api,node_routine_suggestions,node_plan_drafts,node_alerts,node_ai_fallback,node_assistant_db,node_ollama,node_gemini toneIndigo
class node_rules toneTeal
```

## Components

### Entry gateway

- [API gateway](https://github.com/protrainingunaj/protraining-back/blob/develop/gateway/Program.cs): `gateway/Program.cs`
- [Perimeter security](https://github.com/protrainingunaj/protraining-back/blob/develop/gateway/Middleware/PerimeterSecurityMiddleware.cs): `gateway/Middleware/PerimeterSecurityMiddleware.cs`
- [Session validation](https://github.com/protrainingunaj/protraining-back/blob/develop/gateway/Services/SessionValidationClient.cs): `gateway/Services/SessionValidationClient.cs`

### Identity and structure

- [Identity API](https://github.com/protrainingunaj/protraining-back/tree/develop/services/identidad/API/Controllers): `services/identidad/API/Controllers`
- [Accounts](https://github.com/protrainingunaj/protraining-back/tree/develop/services/identidad/Domain/Entities): `services/identidad/Domain/Entities`
- [Identity database](https://github.com/protrainingunaj/protraining-back/tree/develop/services/identidad): `services/identidad`
- [Athlete organization](https://github.com/protrainingunaj/protraining-back/blob/develop/services/estructura/API/Controllers/AthletesController.cs): `services/estructura/API/Controllers/AthletesController.cs`
- [Structure database](https://github.com/protrainingunaj/protraining-back/tree/develop/services/estructura): `services/estructura`

### Training service

- [Training API](https://github.com/protrainingunaj/protraining-back/tree/develop/services/entrenamiento/API/Controllers): `services/entrenamiento/API/Controllers`
- [Exercise catalog](https://github.com/protrainingunaj/protraining-back/blob/develop/services/entrenamiento/Application/UseCases/Exercise/ListExercises/ListExercisesQueryHandler.cs): `services/entrenamiento/Application/UseCases/Exercise/ListExercises/ListExercisesQueryHandler.cs`
- [Exercise model](https://github.com/protrainingunaj/protraining-back/blob/develop/services/entrenamiento/Domain/Entities/Exercise.cs): `services/entrenamiento/Domain/Entities/Exercise.cs`
- [Plans and records](https://github.com/protrainingunaj/protraining-back/blob/develop/services/entrenamiento/Application/Interfaces/Persistence/ITrainingPlanRepository.cs): `services/entrenamiento/Application/Interfaces/Persistence/ITrainingPlanRepository.cs`
- [Today's routine](https://github.com/protrainingunaj/protraining-back/blob/develop/services/entrenamiento/Application/UseCases/Routines/GetTodayRoutine/GetTodayRoutineQueryHandler.cs): `services/entrenamiento/Application/UseCases/Routines/GetTodayRoutine/GetTodayRoutineQueryHandler.cs`
- [Training database](https://github.com/protrainingunaj/protraining-back/tree/develop/services/entrenamiento): `services/entrenamiento`

### Wellness tracking

- [Wellness API](https://github.com/protrainingunaj/protraining-back/tree/develop/services/seguimiento/API/Controllers): `services/seguimiento/API/Controllers`
- [Check-ins and injuries](https://github.com/protrainingunaj/protraining-back/blob/develop/services/seguimiento/Application/UseCases/CheckIns/ListAthleteCheckIns/ListAthleteCheckInsQueryHandler.cs): `services/seguimiento/Application/UseCases/CheckIns/ListAthleteCheckIns/ListAthleteCheckInsQueryHandler.cs`
- [Athlete evolution](https://github.com/protrainingunaj/protraining-back/blob/develop/services/seguimiento/Application/UseCases/Evolution/GetAthleteEvolution/GetAthleteEvolutionQueryHandler.cs): `services/seguimiento/Application/UseCases/Evolution/GetAthleteEvolution/GetAthleteEvolutionQueryHandler.cs`
- [Field tests](https://github.com/protrainingunaj/protraining-back/blob/develop/services/seguimiento/API/Controllers/FieldTests/FieldTestSessionsController.cs): `services/seguimiento/API/Controllers/FieldTests/FieldTestSessionsController.cs`
- [Wellness database](https://github.com/protrainingunaj/protraining-back/tree/develop/services/seguimiento): `services/seguimiento`

### AI assistance

- [Assistant API](https://github.com/protrainingunaj/protraining-back/tree/develop/services/asistente/API/Controllers): `services/asistente/API/Controllers`
- [Routine suggestions](https://github.com/protrainingunaj/protraining-back/blob/develop/services/asistente/Application/UseCases/Ai/SuggestRoutine/SuggestRoutineUseCase.cs): `services/asistente/Application/UseCases/Ai/SuggestRoutine/SuggestRoutineUseCase.cs`
- [Plan drafts](https://github.com/protrainingunaj/protraining-back/tree/develop/services/asistente/Application/UseCases/PlanDrafts): `services/asistente/Application/UseCases/PlanDrafts`
- [Preventive alerts](https://github.com/protrainingunaj/protraining-back/tree/develop/services/asistente/Application/UseCases/Alerts): `services/asistente/Application/UseCases/Alerts`
- [AI fallback chain](https://github.com/protrainingunaj/protraining-back/blob/develop/services/asistente/Infrastructure/Services/Ai/ResilientAiService.cs): `services/asistente/Infrastructure/Services/Ai/ResilientAiService.cs`
- [Assistant database](https://github.com/protrainingunaj/protraining-back/tree/develop/services/asistente): `services/asistente`

### Other components

- **Frontend**
- **Ollama**
- **Google Gemini**
- [Local rule engine](https://github.com/protrainingunaj/protraining-back/blob/develop/services/asistente/Infrastructure/Services/Ai/Rules/DeterministicRuleEngine.cs): `services/asistente/Infrastructure/Services/Ai/Rules/DeterministicRuleEngine.cs`

## Connections

- Frontend → API gateway: sends requests
- API gateway → Athlete organization: routes requests
- API gateway → Perimeter security (evidence: `gateway/Program.cs`)
- API gateway → Session validation (evidence: `gateway/Program.cs`)
- Identity API → Accounts: manages accounts
- Identity API → Identity database: persists data (evidence: `services/identidad/API/Controllers/UsersController.cs`)
- Athlete organization → Structure database: persists data (evidence: `services/estructura/API/Controllers/AthletesController.cs`)
- Training API → Plans and records: handles training
- Training API → Today's routine: serves routines
- Exercise catalog → Exercise model: maps exercises (evidence: `services/entrenamiento/Application/UseCases/Exercise/ListExercises/ListExercisesQueryHandler.cs`)
- Today's routine → Training database: reads training data (evidence: `services/entrenamiento/Application/UseCases/Routines/GetTodayRoutine/GetTodayRoutineQueryHandler.cs`)
- Training API → Training database: persists data
- Wellness API → Check-ins and injuries: serves check-ins
- Wellness API → Athlete evolution: serves evolution
- Wellness API → Field tests: serves tests
- Check-ins and injuries → Wellness database: reads check-ins (evidence: `services/seguimiento/Application/UseCases/CheckIns/ListAthleteCheckIns/ListAthleteCheckInsQueryHandler.cs`)
- Athlete evolution → Wellness database: reads tracking data (evidence: `services/seguimiento/Application/UseCases/Evolution/GetAthleteEvolution/GetAthleteEvolutionQueryHandler.cs`)
- Wellness API → Wellness database: persists data (evidence: `services/seguimiento/API/Controllers/Categories/CategoriesAveragesController.cs`)
- Assistant API → Routine suggestions: handles suggestions (evidence: `services/asistente/API/Controllers/AssistantController.cs`)
- Assistant API → Plan drafts: handles drafts
- Assistant API → Preventive alerts: handles alerts
- Assistant API → Assistant database: persists data (evidence: `services/asistente/API/Controllers/AssistantController.cs`)
- Routine suggestions → AI fallback chain: requests generation
- AI fallback chain → Ollama: tries local model
- AI fallback chain → Google Gemini: falls back
- AI fallback chain → Local rule engine: uses rules
