# lakshmadeepan/movie_recommendation-cinex- architecture

> Architecture diagram of the GitHub repository lakshmadeepan/movie_recommendation-cinex-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lakshmadeepan/movie_recommendation-cinex-
- Repository: https://github.com/lakshmadeepan/movie_recommendation-cinex-

## Overview

CineX is a movie discovery and recommendation platform. Users browse or search for movies, open details and trailers, and receive similar-title recommendations; they can also maintain local watchlists, favorites, and ratings. The frontend calls a FastAPI backend, which coordinates the local recommendation engine and TMDB metadata service. The README documents typo-tolerant search, dynamic recommendations for newer titles, community reviews, and ratings. Some frontend feature wiring and backend internals were not sampled, so those capabilities are represented without speculative call edges.

Main entry points: [`src/App.tsx`](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx) (App and pages), [`backend/main.py`](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/main.py) (REST endpoints), [`src/services/api.ts`](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/services/api.ts) (API client), [`src/services/recommendations.ts`](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/services/recommendations.ts) (Local recommendations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Movie experience"]
  node_app["App and pages<br/>[App.tsx]"]
  node_discovery["Browse and search<br/>[App.tsx]"]
  node_movie_detail["Movie details<br/>[App.tsx]"]
  node_trailer["Trailer player<br/>[App.tsx]"]
  node_community["Reviews and ratings<br/>[App.tsx]"]
  node_collections["Watchlist and favorites<br/>[App.tsx]"]
end

subgraph group_services["Application services"]
  node_frontend_api["API client<br/>[api.ts]"]
  node_frontend_recs["Local recommendations<br/>[recommendations.ts]"]
  node_frontend_tmdb["TMDB client<br/>[tmdb.ts]"]
end

subgraph group_backend["Recommendation backend"]
  node_api["REST endpoints<br/>[main.py]"]
  node_schemas["Movie schemas<br/>[models.py]"]
  node_knn["Search and KNN<br/>[recommender.py]"]
  node_feature_prep["Feature preparation"]
  node_movie_data[("Movie dataset<br/>[master_movies.csv]")]
end

subgraph group_metadata["Metadata integration"]
  node_tmdb_service["TMDB enrichment<br/>[tmdb.py]"]
end

node_viewer(("Movie viewer"))
node_tmdb["TMDB API"]

node_viewer -->|"browses"| node_app
node_app -->|"shows"| node_discovery
node_app -->|"opens"| node_movie_detail
node_app -->|"opens"| node_trailer
node_app -.->|"supports"| node_community
node_app -->|"persists"| node_collections
node_app -->|"calls"| node_frontend_api
node_app -.->|"loads recommendations"| node_frontend_recs
node_frontend_api -->|"requests"| node_api
node_frontend_recs -->|"uses fallback data"| node_frontend_api
node_frontend_tmdb -->|"fetches metadata"| node_tmdb
node_api -->|"searches and recommends"| node_knn
node_api -->|"enriches and discovers"| node_tmdb_service
node_api -->|"validates responses"| node_schemas
node_tmdb_service -->|"requests metadata"| node_tmdb
node_feature_prep -.->|"prepares features"| node_movie_data
node_knn -.->|"loads catalog"| node_movie_data

click node_app "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx"
click node_discovery "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx"
click node_movie_detail "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx"
click node_trailer "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx"
click node_community "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx"
click node_collections "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx"
click node_frontend_api "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/services/api.ts"
click node_frontend_recs "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/services/recommendations.ts"
click node_frontend_tmdb "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/services/tmdb.ts"
click node_api "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/main.py"
click node_schemas "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/models.py"
click node_knn "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/recommender.py"
click node_feature_prep "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/prepare_features.py"
click node_movie_data "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/dataset/master_movies.csv"
click node_tmdb_service "https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/tmdb.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_discovery,node_movie_detail,node_trailer,node_community,node_collections,node_viewer toneBlue
class node_frontend_api,node_frontend_recs,node_frontend_tmdb toneAmber
class node_api,node_schemas,node_knn,node_feature_prep,node_movie_data,node_tmdb toneMint
class node_tmdb_service toneRose
```

## Components

### Movie experience

- [App and pages](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx): `src/App.tsx`
- [Browse and search](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx): `src/App.tsx`
- [Movie details](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx): `src/App.tsx`
- [Trailer player](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx): `src/App.tsx`
- [Reviews and ratings](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx): `src/App.tsx`
- [Watchlist and favorites](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/App.tsx): `src/App.tsx`

### Application services

- [API client](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/services/api.ts): `src/services/api.ts`
- [Local recommendations](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/services/recommendations.ts): `src/services/recommendations.ts`
- [TMDB client](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/src/services/tmdb.ts): `src/services/tmdb.ts`

### Recommendation backend

- [REST endpoints](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/main.py): `backend/main.py`
- [Movie schemas](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/models.py): `backend/models.py`
- [Search and KNN](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/recommender.py): `backend/recommender.py`
- [Feature preparation](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/prepare_features.py): `backend/prepare_features.py`
- [Movie dataset](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/dataset/master_movies.csv): `dataset/master_movies.csv`

### Metadata integration

- [TMDB enrichment](https://github.com/lakshmadeepan/movie_recommendation-cinex-/blob/main/backend/tmdb.py): `backend/tmdb.py`

### Other components

- **Movie viewer**
- **TMDB API**

## Connections

- Movie viewer → App and pages: browses (evidence: `README.md`)
- App and pages → Browse and search: shows (evidence: `src/App.tsx`)
- App and pages → Movie details: opens (evidence: `src/App.tsx`)
- App and pages → Trailer player: opens (evidence: `src/App.tsx`)
- App and pages → Reviews and ratings: supports (evidence: `README.md`)
- App and pages → Watchlist and favorites: persists (evidence: `src/App.tsx`)
- App and pages → API client: calls (evidence: `src/App.tsx`)
- App and pages → Local recommendations: loads recommendations
- API client → REST endpoints: requests (evidence: `README.md`)
- Local recommendations → API client: uses fallback data (evidence: `src/services/recommendations.ts`)
- TMDB client → TMDB API: fetches metadata (evidence: `src/services/tmdb.ts`)
- REST endpoints → Search and KNN: searches and recommends (evidence: `backend/main.py`)
- REST endpoints → TMDB enrichment: enriches and discovers (evidence: `backend/main.py`)
- REST endpoints → Movie schemas: validates responses (evidence: `backend/main.py`)
- TMDB enrichment → TMDB API: requests metadata (evidence: `backend/tmdb.py`)
- Feature preparation → Movie dataset: prepares features
- Search and KNN → Movie dataset: loads catalog
