# suhelbhatari/elastiflix architecture

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

- Interactive diagram: https://gitdiagram.com/suhelbhatari/elastiflix
- Repository: https://github.com/suhelbhatari/elastiflix

## Overview

Elastiflix is a movie-search demo: users browse home content, search and filter movies, use autocomplete, and open movie details. The frontend routes Search UI requests through an Express backend to Elasticsearch, which offers lexical, semantic, reranked, and hybrid search. A separate loader indexes movie data and can configure inference endpoints; logging supports the ELK dashboard capability. Edges reflect shown imports, calls, or README statements; ELK wiring and some unsampled feature connections are left unverified.

Main entry points: [`backend/src/Backend.js`](https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/Backend.js) (Express API), [`frontend/src/services/SearchConnector.js`](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/services/SearchConnector.js) (API proxy), [`frontend/src/components/Routes.js`](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Routes.js) (Page routes), [`frontend/src/components/Home.js`](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Home.js) (Home page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Movie interface"]
  node_app["App router<br/>[App.js]"]
  node_routes["Page routes<br/>[Routes.js]"]
  node_layout["Page layout<br/>[Layout.js]"]
  node_home["Home page<br/>[Home.js]"]
  node_header["Search header<br/>[Header.js]"]
  node_popular["Popular movies<br/>[Popular.js]"]
  node_recent["Recent movies<br/>[Recent.js]"]
  node_searchpage["Search page<br/>[SearchPage.js]"]
  node_searchbar["Autocomplete bar<br/>[SearchBar.js]"]
  node_nav["Navigation<br/>[Nav.js]"]
  node_results["Search results<br/>[Results.js]"]
  node_card["Movie card<br/>[Card.js]"]
  node_facet["Facet controls"]
  node_movie["Movie details<br/>[Movie.js]"]
  node_webconnector["API proxy<br/>[SearchConnector.js]"]
end

subgraph group_backend["Search API"]
  node_backend["Express API<br/>[Backend.js]"]
end

subgraph group_search["Search modes"]
  node_lexical["Lexical connector<br/>[SearchConnector.js]"]
  node_semantic["Semantic search"]
  node_rerank["Rerank search<br/>[RerankConnector.js]"]
  node_hybrid["Hybrid search<br/>[HybridConnector.js]"]
end

subgraph group_data["Movie data"]
  node_loader["Movie indexer<br/>[index-data.py]"]
  node_movies[("Elasticsearch")]
end

subgraph group_observability["Observability"]
  node_logger["Request logging<br/>[logger.js]"]
  node_elk["ELK dashboards"]
end

node_visitor(("Movie viewer"))

node_visitor -->|"opens"| node_app
node_app -->|"renders"| node_routes
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_searchpage
node_routes -->|"routes to"| node_movie
node_routes -->|"wraps with"| node_layout
node_home -->|"renders"| node_header
node_home -->|"renders"| node_popular
node_home -->|"renders"| node_recent
node_home -->|"renders"| node_nav
node_header -->|"uses"| node_webconnector
node_popular -->|"queries"| node_webconnector
node_recent -->|"queries"| node_webconnector
node_searchpage -->|"renders"| node_nav
node_searchpage -->|"renders"| node_results
node_searchpage -->|"configures"| node_webconnector
node_nav -->|"renders"| node_searchbar
node_searchbar -->|"uses"| node_webconnector
node_results -->|"renders"| node_card
node_movie -->|"queries"| node_webconnector
node_webconnector -->|"proxies requests"| node_backend
node_backend -->|"dispatches lexical"| node_lexical
node_backend -->|"dispatches semantic"| node_semantic
node_backend -->|"dispatches rerank"| node_rerank
node_backend -->|"dispatches hybrid"| node_hybrid
node_backend -->|"serves autocomplete"| node_lexical
node_backend -->|"logs requests"| node_logger
node_lexical -->|"searches"| node_movies
node_semantic -->|"searches"| node_movies
node_rerank -->|"reranks"| node_movies
node_hybrid -->|"combines retrieval"| node_movies
node_loader -->|"indexes data"| node_movies
node_backend -.->|"emits dashboard logs"| node_elk
node_facet -.->|"supports filtering"| node_searchpage

click node_app "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/App.js"
click node_routes "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Routes.js"
click node_layout "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Layout.js"
click node_home "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Home.js"
click node_header "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Header.js"
click node_popular "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Popular.js"
click node_recent "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Recent.js"
click node_searchpage "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/SearchPage.js"
click node_searchbar "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/SearchBar.js"
click node_nav "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Nav.js"
click node_results "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Results.js"
click node_card "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Card.js"
click node_facet "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/MultiCheckboxFacet.js"
click node_movie "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Movie.js"
click node_webconnector "https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/services/SearchConnector.js"
click node_backend "https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/Backend.js"
click node_lexical "https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/SearchConnector.js"
click node_semantic "https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/SemanticConnector.js"
click node_rerank "https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/RerankConnector.js"
click node_hybrid "https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/HybridConnector.js"
click node_logger "https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/logger.js"
click node_loader "https://github.com/suhelbhatari/elastiflix/blob/main/data-loader/index-data.py"
click node_elk "https://github.com/suhelbhatari/elastiflix/tree/main/elk"

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_routes,node_layout,node_home,node_header,node_popular,node_recent,node_searchpage,node_searchbar,node_nav,node_results,node_card,node_facet,node_movie,node_webconnector,node_visitor toneBlue
class node_backend toneAmber
class node_lexical,node_semantic,node_rerank,node_hybrid toneMint
class node_loader,node_movies toneRose
class node_logger,node_elk toneIndigo
```

## Components

### Movie interface

- [App router](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Page routes](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Routes.js): `frontend/src/components/Routes.js`
- [Page layout](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Layout.js): `frontend/src/components/Layout.js`
- [Home page](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Home.js): `frontend/src/components/Home.js`
- [Search header](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Header.js): `frontend/src/components/Header.js`
- [Popular movies](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Popular.js): `frontend/src/components/Popular.js`
- [Recent movies](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Recent.js): `frontend/src/components/Recent.js`
- [Search page](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/SearchPage.js): `frontend/src/components/SearchPage.js`
- [Autocomplete bar](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/SearchBar.js): `frontend/src/components/SearchBar.js`
- [Navigation](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Nav.js): `frontend/src/components/Nav.js`
- [Search results](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Results.js): `frontend/src/components/Results.js`
- [Movie card](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Card.js): `frontend/src/components/Card.js`
- [Facet controls](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/MultiCheckboxFacet.js): `frontend/src/components/MultiCheckboxFacet.js`
- [Movie details](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/components/Movie.js): `frontend/src/components/Movie.js`
- [API proxy](https://github.com/suhelbhatari/elastiflix/blob/main/frontend/src/services/SearchConnector.js): `frontend/src/services/SearchConnector.js`

### Search API

- [Express API](https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/Backend.js): `backend/src/Backend.js`

### Search modes

- [Lexical connector](https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/SearchConnector.js): `backend/src/SearchConnector.js`
- [Semantic search](https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/SemanticConnector.js): `backend/src/SemanticConnector.js`
- [Rerank search](https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/RerankConnector.js): `backend/src/RerankConnector.js`
- [Hybrid search](https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/HybridConnector.js): `backend/src/HybridConnector.js`

### Movie data

- [Movie indexer](https://github.com/suhelbhatari/elastiflix/blob/main/data-loader/index-data.py): `data-loader/index-data.py`
- **Elasticsearch**

### Observability

- [Request logging](https://github.com/suhelbhatari/elastiflix/blob/main/backend/src/logger.js): `backend/src/logger.js`
- [ELK dashboards](https://github.com/suhelbhatari/elastiflix/tree/main/elk): `elk`

### Other components

- **Movie viewer**

## Connections

- Movie viewer → App router: opens (evidence: `frontend/src/App.js`)
- App router → Page routes: renders (evidence: `frontend/src/App.js`)
- Page routes → Home page: routes to (evidence: `frontend/src/components/Routes.js`)
- Page routes → Search page: routes to (evidence: `frontend/src/components/Routes.js`)
- Page routes → Movie details: routes to (evidence: `frontend/src/components/Routes.js`)
- Page routes → Page layout: wraps with (evidence: `frontend/src/components/Routes.js`)
- Home page → Search header: renders (evidence: `frontend/src/components/Home.js`)
- Home page → Popular movies: renders (evidence: `frontend/src/components/Home.js`)
- Home page → Recent movies: renders (evidence: `frontend/src/components/Home.js`)
- Home page → Navigation: renders (evidence: `frontend/src/components/Home.js`)
- Search header → API proxy: uses (evidence: `frontend/src/components/Header.js`)
- Popular movies → API proxy: queries (evidence: `frontend/src/components/Popular.js`)
- Recent movies → API proxy: queries (evidence: `frontend/src/components/Recent.js`)
- Search page → Navigation: renders (evidence: `frontend/src/components/SearchPage.js`)
- Search page → Search results: renders (evidence: `frontend/src/components/SearchPage.js`)
- Search page → API proxy: configures (evidence: `frontend/src/components/SearchPage.js`)
- Navigation → Autocomplete bar: renders (evidence: `frontend/src/components/Nav.js`)
- Autocomplete bar → API proxy: uses (evidence: `frontend/src/components/SearchBar.js`)
- Search results → Movie card: renders (evidence: `frontend/src/components/Results.js`)
- Movie details → API proxy: queries (evidence: `frontend/src/components/Movie.js`)
- API proxy → Express API: proxies requests (evidence: `README.md`)
- Express API → Lexical connector: dispatches lexical (evidence: `backend/src/Backend.js`)
- Express API → Semantic search: dispatches semantic (evidence: `backend/src/Backend.js`)
- Express API → Rerank search: dispatches rerank (evidence: `backend/src/Backend.js`)
- Express API → Hybrid search: dispatches hybrid (evidence: `backend/src/Backend.js`)
- Express API → Lexical connector: serves autocomplete (evidence: `backend/src/Backend.js`)
- Express API → Request logging: logs requests (evidence: `backend/src/Backend.js`)
- Lexical connector → Elasticsearch: searches (evidence: `backend/src/SearchConnector.js`)
- Semantic search → Elasticsearch: searches (evidence: `backend/src/SemanticConnector.js`)
- Rerank search → Elasticsearch: reranks (evidence: `backend/src/RerankConnector.js`)
- Hybrid search → Elasticsearch: combines retrieval (evidence: `backend/src/HybridConnector.js`)
- Movie indexer → Elasticsearch: indexes data (evidence: `README.md`)
- Express API → ELK dashboards: emits dashboard logs
- Facet controls → Search page: supports filtering
