How carlos-estupinan/villaia works
Villa de Leyva Recommender is a tourism recommendation web application. A visitor enters travel preferences in the React interface; the FastAPI service uses the catalog and a loaded model to produce ranked, diversified recommendations with brief reasons, which the interface presents as place cards. The backend has distinct profile normalization, candidate scoring, business-rule reranking, and explanation stages. The frontend’s request call is not visible in the excerpt, so that connection is marked unverified; other links reflect shown calls or documented module references.
Main entry points: main.py FastAPI service · topn_recommender.py Top-N recommender · model_loader.py Model loading and scoring · recommender.py Pair recommender
Components 13
Visitor experience
- React entry
aplicacion/Frontend/vdl-reco/src/main.jsx - App shell
aplicacion/Frontend/vdl-reco/src/App.jsx - Survey and results
aplicacion/Frontend/vdl-reco/src/VillaLeyvaApp.jsx
Recommendation API
- FastAPI service
aplicacion/Backend/app/main.py - Survey schemas
aplicacion/Backend/app/schemas.py
Recommendation engine
- Top-N recommender
aplicacion/Backend/app/core/topn_recommender.py - Feature mapping
aplicacion/Backend/app/core/feature_map.py - Model loading and scoring
aplicacion/Backend/app/core/model_loader.py - Business reranking
aplicacion/Backend/app/core/business_controls.py - Pair recommender
aplicacion/Backend/app/core/recommender.py
Recommendation inputs
- Place catalog
aplicacion/Backend/app/data/catalogo_vdl_lugares_reformulado_v2.csv - Model files
aplicacion/Backend/models
Other components
- Traveler
Connections 13
- Traveler → React entry: uses
aplicacion/Frontend/vdl-reco/src/main.jsx - React entry → App shell: renders
aplicacion/Frontend/vdl-reco/src/main.jsx - App shell → Survey and results: renders
aplicacion/Frontend/vdl-reco/src/App.jsx - Survey and results → FastAPI service: requests recommendations
- FastAPI service → Place catalog: reads
aplicacion/Backend/app/main.py - FastAPI service → Model files: loads model
aplicacion/Backend/app/main.py - FastAPI service → Model loading and scoring: constructs
aplicacion/Backend/app/main.py - FastAPI service → Top-N recommender: constructs and calls
aplicacion/Backend/app/main.py - Top-N recommender → Feature mapping: uses features
aplicacion/Backend/app/core/topn_recommender.py - Top-N recommender → Model loading and scoring: uses model
aplicacion/Backend/app/core/topn_recommender.py - Top-N recommender → Business reranking: applies penalties
aplicacion/Backend/app/core/topn_recommender.py - Pair recommender → Feature mapping: builds features
aplicacion/Backend/app/core/recommender.py - Pair recommender → Model loading and scoring: predicts scores