How endurannsu/backend works
This repository implements a fitness-training platform: clients enter through a gateway, which routes requests to account and training APIs, exercise search, an LLM agent, and video-form analysis. The backend exposes user, exercise, training, and measurement capabilities; separate services handle retrieval and CV analysis. Exercise descriptions also use object storage, and the repository includes an exercise-ingestion workflow. Edges are limited to relationships visible in the excerpts or README; unsampled service internals and ingestion wiring are left unconnected where evidence is unavailable.
Main entry points: main.py Backend API · proxy.py API gateway · search.py Exercise retrieval · repository.go Exercise repository
Components 20
Client entry
- API gateway
gateway/src/gateway/proxy.py
Fitness APIs
- Backend API
backend/src/main.py - Accounts
backend/src/backend/routers/access - User profiles
backend/src/backend/routers/user.py - Exercises
backend/src/backend/routers/exercise.py - Training plans
backend/src/backend/routers/training.py - Measurements
backend/src/backend/routers/measurement.py - Backend database
backend/src/backend/database/sqlalchemy - Exercise service
exercise/internal/adapter/in/http - Exercise repository
exercise/internal/adapter/out/postgres/repository.go - Object storage
exercise/internal/minio/client.go
AI services
- Exercise retrieval
rag/src/retriever/routers/search.py - RAG pipelines
rag/src/retriever/core/pipelines - LLM agent
agent/src/agent/agent_backend/agent.py - Agent tools
agent/src/agent/agent_backend/tools/exercise_rag.py - LLM proxy
llm/src/llm/router.py - Video analysis
cv_service/src/cv_service/routers/analyze.py - Live analysis
cv_service/src/cv_service/routers/ws.py
Exercise ingestion
- Exercise ingestion
airflow/dags/exercise_ingestion/tasks
Other components
- Platform client
Connections 19
- Platform client → API gateway: sends requests
- API gateway → Backend API: routes API calls
gateway/src/gateway/proxy.py - API gateway → Exercise retrieval: routes search
gateway/src/gateway/proxy.py - API gateway → LLM agent: routes agent calls
gateway/src/gateway/proxy.py - API gateway → LLM proxy: routes LLM calls
gateway/src/gateway/proxy.py - API gateway → Video analysis: routes CV calls
gateway/src/gateway/proxy.py - Backend API → Accounts: registers routes
backend/src/main.py - Backend API → User profiles: registers routes
backend/src/main.py - Backend API → Exercises: registers routes
backend/src/main.py - Backend API → Training plans: registers routes
backend/src/main.py - Backend API → Measurements: registers routes
backend/src/main.py - Backend API → Backend database: uses persistence
- Exercise service → Exercise repository: delegates operations
- Exercise repository → Object storage: stores descriptions
exercise/internal/adapter/out/postgres/repository.go - Exercise retrieval → RAG pipelines: uses retrieval
- LLM agent → Agent tools: dispatches tools
- Agent tools → Exercise retrieval: queries exercises
- Video analysis → Live analysis: offers live analysis
- Exercise ingestion → Exercise retrieval: populates index