How lakshmadeepan/movie_recommendation-cinex- works
CineX is a movie discovery and recommendation platform. Users browse or search for movies, open details and trailers, and receive similar-title recommendations; they can also maintain local watchlists, favorites, and ratings. The frontend calls a FastAPI backend, which coordinates the local recommendation engine and TMDB metadata service. The README documents typo-tolerant search, dynamic recommendations for newer titles, community reviews, and ratings. Some frontend feature wiring and backend internals were not sampled, so those capabilities are represented without speculative call edges.
Main entry points: App.tsx App and pages · main.py REST endpoints · api.ts API client · recommendations.ts Local recommendations
Components 17
Movie experience
- App and pages
src/App.tsx - Browse and search
src/App.tsx - Movie details
src/App.tsx - Trailer player
src/App.tsx - Reviews and ratings
src/App.tsx - Watchlist and favorites
src/App.tsx
Application services
- API client
src/services/api.ts - Local recommendations
src/services/recommendations.ts - TMDB client
src/services/tmdb.ts
Recommendation backend
- REST endpoints
backend/main.py - Movie schemas
backend/models.py - Search and KNN
backend/recommender.py - Feature preparation
backend/prepare_features.py - Movie dataset
dataset/master_movies.csv
Metadata integration
- TMDB enrichment
backend/tmdb.py
Other components
- Movie viewer
- TMDB API
Connections 17
- Movie viewer → App and pages: browses
README.md - App and pages → Browse and search: shows
src/App.tsx - App and pages → Movie details: opens
src/App.tsx - App and pages → Trailer player: opens
src/App.tsx - App and pages → Reviews and ratings: supports
README.md - App and pages → Watchlist and favorites: persists
src/App.tsx - App and pages → API client: calls
src/App.tsx - App and pages → Local recommendations: loads recommendations
- API client → REST endpoints: requests
README.md - Local recommendations → API client: uses fallback data
src/services/recommendations.ts - TMDB client → TMDB API: fetches metadata
src/services/tmdb.ts - REST endpoints → Search and KNN: searches and recommends
backend/main.py - REST endpoints → TMDB enrichment: enriches and discovers
backend/main.py - REST endpoints → Movie schemas: validates responses
backend/main.py - TMDB enrichment → TMDB API: requests metadata
backend/tmdb.py - Feature preparation → Movie dataset: prepares features
- Search and KNN → Movie dataset: loads catalog