How jonbuwembo/movie-recommender-app works
Midnight Scoop is a full-stack movie discovery and recommendation platform. Users authenticate, browse or search films, view details, rate movies, manage a watchlist, and ask a movie chatbot; the Flask API serves these actions and recommendation results. Recommendations combine popularity for new users, content similarity for lightly rated users, and collaborative filtering for more active users. The README documents the main product capabilities and React-to-API architecture; sampled backend excerpts show service and persistence behavior, but not every route implementation.
Main entry points: app.py Flask application · recommendation_service.py Recommendation service · App.tsx React application · search_service.py Search service
Components 23
Web experience
- React application
frontend/src/App.tsx - Auth context
frontend/src/AuthContext.tsx - Navigation and search
frontend/src/components/Navbar/Navbar.js - Movie discovery
frontend/src/pages/MoviesDisplay.js - Home recommendations
frontend/src/pages/LandingPage.js - Movie details and ratings
frontend/src/pages/MovieDetails.js - Watchlist actions
frontend/src/useWatchlist.tsx - Chat screen
frontend/src/pages/ChatStartScreen.js
API and services
- Flask application
backend/app.py - Authentication routes
backend/routes/auth.py - Movie routes
backend/routes/movies.py - Search routes
backend/routes/search.py - Chat routes
backend/routes/chatbot.py - Movie services
backend/services/movie_service.py - Search service
backend/services/search_service.py - Chatbot service
backend/services/chatbot_service.py
Recommendation engine
- Recommendation service
backend/services/recommendation_service.py - Content similarity
backend/models/content_based.py - Collaborative model
backend/recommender/svd_recommender.py
Persistence and identity
- JWT identity
backend/utils/auth_utils.py - Movie and user records
backend/models/movie_model.py - PostgreSQL
backend/database/db_connection.py
Other components
- Movie viewer
Connections 32
- Movie viewer → React application: uses
README.md - React application → Movie discovery: routes to
frontend/src/App.tsx - React application → Home recommendations: routes to
frontend/src/App.tsx - React application → Movie details and ratings: routes to
frontend/src/App.tsx - React application → Chat screen: routes to
frontend/src/App.tsx - Navigation and search → Movie discovery: navigates to
frontend/src/components/Navbar/Navbar.js - Auth context → Flask application: sends REST requests
README.md - Movie discovery → Flask application: requests movie data
README.md - Home recommendations → Flask application: requests recommendations
README.md - Movie details and ratings → Flask application: requests details and ratings
README.md - Watchlist actions → Flask application: calls watchlist API
frontend/src/useWatchlist.tsx - Chat screen → Flask application: uses REST API
README.md - Flask application → Authentication routes: registers
backend/app.py - Flask application → Movie routes: registers
backend/app.py - Flask application → Search routes: registers
backend/app.py - Flask application → Chat routes: registers
backend/app.py - Authentication routes → JWT identity: uses
backend/routes/auth.py - Authentication routes → Movie and user records: uses
backend/routes/auth.py - Movie routes → Movie services: dispatches to
backend/routes/movies.py - Movie routes → Recommendation service: dispatches to
backend/routes/movies.py - Search routes → Search service: dispatches to
backend/routes/search.py - Chat routes → Chatbot service: dispatches to
backend/routes/chatbot.py - Search service → Content similarity: gets similar films
backend/services/search_service.py - Search service → Recommendation service: looks up films
backend/services/search_service.py - Movie services → Movie and user records: uses records
backend/services/movie_service.py - Movie services → JWT identity: gets current user
backend/services/movie_service.py - Recommendation service → Content similarity: gets similar films
backend/services/recommendation_service.py - Recommendation service → Collaborative model: loads recommender
backend/services/recommendation_service.py - Recommendation service → Movie and user records: reads ratings and history
backend/services/recommendation_service.py - Recommendation service → PostgreSQL: queries movie data
backend/services/recommendation_service.py - Search service → PostgreSQL: queries catalog
backend/services/search_service.py - Movie and user records → PostgreSQL: persists records