How syedaakibhossain-prog/cinmatch works
CineMatch serves movie-title searches through a browser UI and FastAPI: validated titles enter the recommendation model, which ranks similar films and enriches them with TMDB posters before returning results for cards and detail views. A separate request-control branch applies per-IP Redis sliding-window limits. README-described UI and deployment details are represented only where runtime behavior is supported; source excerpts do not show the Lua script or every frontend feature implementation.
Main entry points: main.py FastAPI routes · recomender.py Similarity ranking · rate_limiter.py IP rate limit · app.js Search and results UI
Components 12
Web client
- Search and results UI
frontend/app.js
API request handling
- FastAPI routes
backend/main.py - Title validation
backend/src/validators.py - Runtime settings
backend/src/config.py
Recommendation service
- Similarity ranking
backend/src/recomender.py - Movie model artifacts
backend/src/movies.pkl - Sparse movie vectors
backend/src/movie_vectors.npz - TMDB poster API
Rate limiting
- IP rate limit
backend/middleware/rate_limiter.py - Redis client
backend/shared/redis_client.py - Redis store
Other components
- Movie seeker
Connections 13
- Movie seeker → Search and results UI: searches titles
README.md - Search and results UI → FastAPI routes: requests recommendations
frontend/app.js - FastAPI routes → IP rate limit: applies dependency
backend/main.py - FastAPI routes → Title validation: validates title
backend/main.py - FastAPI routes → Similarity ranking: requests recommendations
backend/main.py - Similarity ranking → Movie model artifacts: loads titles
backend/src/recomender.py - Similarity ranking → Sparse movie vectors: loads vectors
backend/src/recomender.py - Similarity ranking → TMDB poster API: fetches posters
backend/src/recomender.py - IP rate limit → Redis client: uses client
backend/middleware/rate_limiter.py - Redis client → Runtime settings: reads URL
backend/shared/redis_client.py - IP rate limit → Runtime settings: reads limits
backend/middleware/rate_limiter.py - IP rate limit → Redis store: checks window
README.md - Search and results UI → Movie seeker: renders results
frontend/app.js