How hemanthvnp/cinescope works
CineScope is a movie discovery and recommendation platform. Users browse and search in the React app, which calls the API gateway; recommendations can come from the ML service, with documented genre-service and TMDB fallbacks. A separate natural-language query workflow classifies queries, plans and executes service tools, then aggregates results and optional provider data. The graph also preserves profile/watchlist features and the standalone clustering capability. Several connections are documented in the README; unsampled modules are represented only where the tree or documentation supports their role.
Main entry points: app.js Gateway routes · hybrid.py Hybrid recommender · app.py Query endpoint · App.jsx React app
Components 34
Web app
- React app
frontend/src/App.jsx - Search pages
frontend/src/pages/SearchPage.jsx - Query Lab
frontend/src/pages/QueryLab.jsx - Query API client
frontend/src/api/query.js - Search filters
frontend/src/context/SearchFilterContext.jsx - HTTP client
frontend/src/api/axios.js
API gateway
- Gateway routes
backend/src/app.js - Authentication
backend/src/middleware/authMiddleware.js - User accounts
backend/src/controllers/userController.js - Movie search
backend/src/controllers/movieController.js - Ratings
backend/src/controllers/ratingController.js - Watchlist API
backend/src/routes/watchlistRoutes.js - TMDB gateway
backend/src/services/tmdbService.js - Email OTP
backend/src/services/emailService.js
Genre fallback
- Recommendation API
services/recommendation-service/src/controllers/recommendationController.js - Genre recommender
services/recommendation-service/src/services/recommendationService.js - Preference stores
services/recommendation-service/src/models/UserPreference.js - Mongo connection
services/recommendation-service/src/config/db.js - TMDB client
services/recommendation-service/src/services/tmdbClient.js
ML recommendations
- ML API
services/ml-service/app.py - Hybrid recommender
services/ml-service/recommender/hybrid.py - Collaborative model
services/ml-service/recommender/collaborative.py - Content model
services/ml-service/recommender/content_based.py - Recommendation explanations
services/ml-service/recommender/explainer.py - ML data access
services/ml-service/database.py - ML TMDB client
services/ml-service/tmdb_client.py - Movie clustering
services/ml-service/clustering/api.py
AI query
- Query endpoint
services/ai-orchestration/app.py - Query and filters
services/ai-orchestration/models/query.py - Intent classifier
services/ai-orchestration/orchestrator/intent_classifier.py - Tool planner
services/ai-orchestration/orchestrator/tool_planner.py - Execution engine
services/ai-orchestration/orchestrator/execution_engine.py - Tool cache
services/ai-orchestration/cache/semantic_cache.py
Other components
- Movie viewer
Connections 35
- Movie viewer → React app: uses
README.md - React app → Search pages: routes to
frontend/src/App.jsx - React app → Query Lab: routes to
frontend/src/App.jsx - Search pages → Search filters: uses filters
frontend/src/pages/SearchPage.jsx - Query Lab → Query API client: submits query
frontend/src/pages/QueryLab.jsx - Query API client → HTTP client: posts via
frontend/src/api/query.js - HTTP client → Gateway routes: calls gateway
README.md - Gateway routes → Authentication: protects routes
- Gateway routes → User accounts: routes requests
backend/src/app.js - Gateway routes → Movie search: routes requests
backend/src/app.js - Gateway routes → Ratings: routes requests
backend/src/app.js - Gateway routes → Watchlist API: mounts routes
- Movie search → TMDB gateway: fetches movies
backend/src/controllers/movieController.js - User accounts → Email OTP: sends OTP
backend/src/controllers/userController.js - User accounts → Recommendation API: syncs preferences
backend/src/controllers/userController.js - Gateway routes → ML API: requests recommendations
README.md - Gateway routes → Recommendation API: fallback recommendations
README.md - Gateway routes → TMDB gateway: fallback trending
README.md - Recommendation API → Genre recommender: delegates
services/recommendation-service/src/controllers/recommendationController.js - Genre recommender → Preference stores: reads and writes
services/recommendation-service/src/services/recommendationService.js - Genre recommender → TMDB client: discovers candidates
services/recommendation-service/src/services/recommendationService.js - Mongo connection → Preference stores: connects storage
- ML API → Hybrid recommender: gets recommendations
services/ml-service/app.py - Hybrid recommender → Content model: uses content model
services/ml-service/recommender/hybrid.py - Hybrid recommender → Collaborative model: uses collaborative model
services/ml-service/recommender/hybrid.py - Hybrid recommender → Recommendation explanations: generates explanations
services/ml-service/recommender/hybrid.py - Hybrid recommender → ML data access: loads user data
services/ml-service/recommender/hybrid.py - Hybrid recommender → ML TMDB client: fetches movie data
services/ml-service/recommender/hybrid.py - Movie viewer → Movie clustering: uses analysis
- Query endpoint → Query and filters: validates request
services/ai-orchestration/app.py - Query endpoint → Intent classifier: classifies query
services/ai-orchestration/app.py - Query endpoint → Tool planner: plans tools
README.md - Query endpoint → Execution engine: executes plan
README.md - Execution engine → Tool cache: checks and stores
services/ai-orchestration/orchestrator/execution_engine.py - Query endpoint → Movie viewer: returns results