How caspermohit/movie-review works
Project Type and Purpose
• This is a modern full-stack web application (“Movie Review Application”) with a React + TypeScript + Vite frontend and a Node.js + Express + MongoDB backend.
• Primary goal: Allow users to browse movies/TV/anime (via external APIs), register/login, post reviews, and manage a personal watchlist.
File Structure Analysis
• Top-level:
• frontend code under /src (React components, pages, services, contexts, assets)
• backend code under /backend (Express server, models, middleware, DB init)
• config/build files (.env, netlify.toml, render-build.sh, tsconfigs, package.json)
• Patterns:
• Frontend: SPA with React Router, Context for auth, service layer for HTTP calls
• Backend: RESTful API with JWT auth middleware, Mongoose models (User, Review, Wishlist)
• Deployment: Netlify (frontend) and likely Render or another host for backend
Core Components
• Frontend SPA
• React/Vite Development Server → Builds static assets → Served via Netlify
• UI Components (MovieCard, MovieDetails, Navbar, Pages)
• Service Layer:
– movieService: HTTP calls directly to external TMDB (and optionally Jikan) APIs
– authService: HTTP calls to your own backend’s /api/auth endpoints
• Backend API
• Express Server (server.ts)
• Middleware: JWT authentication (auth.ts)
• Controllers/Routes: Exposed under /api (e.g., /api/user, /api/review, /api/wishlist)
• Models: Mongoose schemas for User, Review, Wishlist
• DB Initialization (initDb.ts) connecting to MongoDB
• Database
• MongoDB (cloud or local instance)
• External Services
• TMDB API (The Movie Database)
• Jikan API (MyAnimeList)
Relationships and Data Flow
• User’s Browser
→ Requests HTML/JS from Netlify → Runs React SPA
→ On page load & interactions, React calls:
• Backend API (/api/*) for user data, reviews, watchlist
• External APIs (TMDB/Jikan) for fetching movie/TV/anime details
• Backend
→ Verifies JWT, processes CRUD operations against MongoDB
→ Returns JSON payloads to frontend
• MongoDB
← Stores user profiles, reviews, watchlist entries
Architectural Patterns & Principles
• Layered Architecture (Presentation → Service/Controller → Data Access)
• Separation of Concerns (frontend vs backend vs database)
• Single Page Application (React + client-side routing)
• RESTful API (Express)
• Token-based Authentication (JWT in HTTP headers)
• External API integration (Axios via service modules)
Technologies & Libraries to Annotate
• Frontend: React, React Router, TypeScript, Vite, Chakra UI, Axios
• Backend: Node.js, Express, TypeScript, Mongoose, JSON Web Token
• Database: MongoDB
• Deployment: Netlify (frontend), Render/Heroku/AWS (backend)
• External APIs: TMDB, Jikan