How sivakrishna916/cinexa works
Cinexa takes users from account registration or login into a movie-browsing and rating experience, then returns personalized recommendations and taste insights. The React client uses the Node/Express service for JWT-backed account operations and the FastAPI service for movie, rating, recommendation, and profile operations. The ML service combines collaborative and content-based recommendation logic over PostgreSQL data. The README documents the major product capabilities; unsampled routes and page implementations are represented at their known paths, with relationships included only where the excerpts, source index, or README support them.
Main entry points: axios.js API client · App.jsx App navigation · postgres.py PostgreSQL access · User.js User model
Components 26
React client
- App navigation
frontend/src/App.jsx - Auth state
frontend/src/context/AuthContext.jsx - API client
frontend/src/api/axios.js - Login and register
frontend/src/pages/Login.jsx - Recommendations view
frontend/src/pages/Dashboard.jsx - Movie browser
frontend/src/pages/Movies.jsx - Taste profile
frontend/src/pages/Profile.jsx
Account service
- Express API
backend/app.js - Auth routes
backend/routes/auth.js - Auth operations
backend/controllers/authController.js - JWT protection
backend/middleware/authMiddleware.js - User routes
backend/routes/user.js - User model
backend/models/User.js - MongoDB
ML recommendation service
- ML API
ml_engine/app/main.py - Movie endpoints
ml_engine/app/routes/movies.py - Recommendation endpoints
ml_engine/app/routes/recommend.py - Hybrid recommender
ml_engine/app/services/hybrid.py - Collaborative filtering
ml_engine/app/services/collaborative.py - Content filtering
ml_engine/app/services/content_based.py
Movie data
- PostgreSQL access
ml_engine/app/db/postgres.py - PostgreSQL
- Dataset loader
ml_engine/data/preprocess.py - MovieLens data
ml_engine/data/movies.csv - Rating dataset
ml_engine/data/ratings.csv
Other components
- Movie viewer
Connections 36
- Movie viewer → App navigation: uses
frontend/src/App.jsx - App navigation → Login and register: routes to
frontend/src/App.jsx - App navigation → Recommendations view: routes to
frontend/src/App.jsx - App navigation → Movie browser: routes to
frontend/src/App.jsx - App navigation → Taste profile: routes to
frontend/src/App.jsx - App navigation → Auth state: checks state
frontend/src/App.jsx - Login and register → API client: calls
frontend/src/pages/Login.jsx - Recommendations view → API client: calls
frontend/src/pages/Dashboard.jsx - Movie browser → API client: calls
frontend/src/pages/Movies.jsx - Taste profile → API client: calls
frontend/src/pages/Profile.jsx - Auth state → API client: restores session
frontend/src/context/AuthContext.jsx - API client → Express API: auth requests
frontend/src/api/axios.js - API client → ML API: movie and taste requests
frontend/src/api/axios.js - Express API → Auth routes: mounts
backend/app.js - Express API → User routes: mounts
backend/app.js - Auth routes → Auth operations: dispatches
backend/routes/auth.js - Auth routes → JWT protection: protects session route
backend/routes/auth.js - JWT protection → User model: loads account
backend/middleware/authMiddleware.js - User routes → JWT protection: uses protection
backend/routes/user.js - User routes → User model: uses model
backend/routes/user.js - Auth operations → User model: reads and saves
backend/controllers/authController.js - User model → MongoDB: persists account
README.md - Auth operations → PostgreSQL: creates linked user
backend/controllers/authController.js - ML API → Movie endpoints: mounts
ml_engine/app/main.py - ML API → Recommendation endpoints: mounts
ml_engine/app/main.py - Movie endpoints → PostgreSQL access: queries movies
ml_engine/app/routes/movies.py - Recommendation endpoints → PostgreSQL access: reads and saves ratings
ml_engine/app/routes/recommend.py - Recommendation endpoints → Hybrid recommender: requests recommendations
ml_engine/app/routes/recommend.py - Hybrid recommender → Collaborative filtering: combines results
ml_engine/app/services/hybrid.py - Hybrid recommender → Content filtering: combines results
ml_engine/app/services/hybrid.py - Collaborative filtering → PostgreSQL access: loads ratings
ml_engine/app/services/collaborative.py - Content filtering → PostgreSQL access: loads movie data
ml_engine/app/services/content_based.py - PostgreSQL access → PostgreSQL: queries and updates
ml_engine/app/db/postgres.py - Dataset loader → MovieLens data: loads dataset
README.md - Dataset loader → Rating dataset: loads dataset
README.md - Dataset loader → PostgreSQL: loads data
README.md