# yeshendradhaker/netflix-app architecture

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

- Interactive diagram: https://gitdiagram.com/yeshendradhaker/netflix-app
- Repository: https://github.com/yeshendradhaker/netflix-app

## Overview

This repository implements a Netflix-like video platform. Admins create catalog entries and upload raw videos; encoding produces multi-quality HLS assets, event consumers update catalog and streaming state, and viewers request signed playback URLs through a custom HLS player. The README also documents catalog search, private S3 storage, Redis caching, and adaptive playback. Unsampled consumer/configuration behavior is represented only where documented; optional or unverified links are dashed.

Main entry points: [`encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`](https://github.com/yeshendradhaker/netflix-app/blob/main/encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java) (HLS Encoder), [`streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java`](https://github.com/yeshendradhaker/netflix-app/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java) (Streaming Service), [`streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java`](https://github.com/yeshendradhaker/netflix-app/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java) (Streaming API), [`video-service/src/main/java/com/netflix/videoservice/service/VideoService.java`](https://github.com/yeshendradhaker/netflix-app/blob/main/video-service/src/main/java/com/netflix/videoservice/service/VideoService.java) (Upload Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Movie Catalog"]
  node_catalog_api["Catalog API"]
  node_catalog_logic["Catalog Logic"]
  node_movie_model["Movie Model<br/>[Movie.java]"]
  node_movie_store["Movie Repository"]
  node_content_event["Encoding Event Consumer"]
end

subgraph group_ingest["Upload and Encoding"]
  node_upload_api["Video Upload API"]
  node_upload_logic["Upload Service<br/>[VideoService.java]"]
  node_encoding_consumer["Upload Consumer"]
  node_encoding_logic["HLS Encoder"]
end

subgraph group_playback["Streaming and Playback"]
  node_stream_event["Encoding Event Consumer"]
  node_stream_api["Streaming API"]
  node_stream_logic["Streaming Service"]
  node_player["HLS Player"]
end

subgraph group_infra["External Infrastructure"]
  node_mysql[("MySQL Catalog")]
  node_raw_s3[("Raw Video S3")]
  node_uploaded_topic["video.uploaded"]
  node_ffmpeg["FFmpeg"]
  node_encoded_s3[("Encoded HLS S3")]
  node_encoded_topic["video.encoded"]
  node_redis[("Redis Cache")]
  node_s3[("AWS S3")]
end

node_admin(("Admin"))
node_viewer(("Viewer"))

node_admin -->|"creates movie"| node_catalog_api
node_catalog_api -->|"calls"| node_catalog_logic
node_catalog_logic -->|"persists and queries"| node_movie_store
node_movie_store -.->|"stores catalog"| node_mysql
node_admin -->|"uploads video"| node_upload_api
node_upload_api -->|"calls"| node_upload_logic
node_upload_logic -->|"uploads raw file"| node_raw_s3
node_upload_logic -->|"publishes event"| node_uploaded_topic
node_uploaded_topic -->|"delivers event"| node_encoding_consumer
node_encoding_consumer -->|"invokes encoding"| node_encoding_logic
node_encoding_logic -->|"downloads source"| node_raw_s3
node_encoding_logic -->|"runs encoding"| node_ffmpeg
node_encoding_logic -->|"uploads HLS assets"| node_encoded_s3
node_encoding_logic -->|"publishes result"| node_encoded_topic
node_encoded_topic -->|"delivers event"| node_content_event
node_content_event -->|"updates movie state"| node_catalog_logic
node_encoded_topic -->|"delivers event"| node_stream_event
node_stream_event -->|"stores playlist key"| node_redis
node_viewer -->|"requests playback"| node_stream_api
node_player -->|"requests stream URL"| node_stream_api
node_stream_api -->|"calls"| node_stream_logic
node_stream_logic -->|"reads and caches"| node_redis
node_stream_logic -->|"reads playlists"| node_s3
node_stream_logic -->|"signs object URLs"| node_s3
node_stream_api -->|"returns playback response"| node_player
node_player -->|"fetches signed HLS"| node_s3

click node_catalog_api "https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/controller/ContentController.java"
click node_catalog_logic "https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/service/ContentService.java"
click node_movie_model "https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/model/Movie.java"
click node_movie_store "https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/repository/MovieRepository.java"
click node_upload_api "https://github.com/yeshendradhaker/netflix-app/blob/main/video-service/src/main/java/com/netflix/videoservice/controller/VideoController.java"
click node_upload_logic "https://github.com/yeshendradhaker/netflix-app/blob/main/video-service/src/main/java/com/netflix/videoservice/service/VideoService.java"
click node_encoding_consumer "https://github.com/yeshendradhaker/netflix-app/blob/main/encoding-service/src/main/java/com/netflix/encodingservice/service/VideoEventConsumer.java"
click node_encoding_logic "https://github.com/yeshendradhaker/netflix-app/blob/main/encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java"
click node_content_event "https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/service/VideoUploadedEncodedEventConsumer.java"
click node_stream_event "https://github.com/yeshendradhaker/netflix-app/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/service/VideoEncodedEventConsumer.java"
click node_stream_api "https://github.com/yeshendradhaker/netflix-app/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java"
click node_stream_logic "https://github.com/yeshendradhaker/netflix-app/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java"
click node_player "https://github.com/yeshendradhaker/netflix-app/blob/main/netflix-player.html"

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_catalog_api,node_catalog_logic,node_movie_model,node_movie_store,node_content_event,node_viewer toneBlue
class node_upload_api,node_upload_logic,node_encoding_consumer,node_encoding_logic toneAmber
class node_stream_event,node_stream_api,node_stream_logic,node_player toneMint
class node_mysql,node_raw_s3,node_uploaded_topic,node_ffmpeg,node_encoded_s3,node_encoded_topic,node_redis,node_s3 toneRose
class node_admin toneIndigo
```

## Components

### Movie Catalog

- [Catalog API](https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/controller/ContentController.java): `content-service/src/main/java/com/netflix/contentservice/controller/ContentController.java`
- [Catalog Logic](https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/service/ContentService.java): `content-service/src/main/java/com/netflix/contentservice/service/ContentService.java`
- [Movie Model](https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/model/Movie.java): `content-service/src/main/java/com/netflix/contentservice/model/Movie.java`
- [Movie Repository](https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/repository/MovieRepository.java): `content-service/src/main/java/com/netflix/contentservice/repository/MovieRepository.java`
- [Encoding Event Consumer](https://github.com/yeshendradhaker/netflix-app/blob/main/content-service/src/main/java/com/netflix/contentservice/service/VideoUploadedEncodedEventConsumer.java): `content-service/src/main/java/com/netflix/contentservice/service/VideoUploadedEncodedEventConsumer.java`

### Upload and Encoding

- [Video Upload API](https://github.com/yeshendradhaker/netflix-app/blob/main/video-service/src/main/java/com/netflix/videoservice/controller/VideoController.java): `video-service/src/main/java/com/netflix/videoservice/controller/VideoController.java`
- [Upload Service](https://github.com/yeshendradhaker/netflix-app/blob/main/video-service/src/main/java/com/netflix/videoservice/service/VideoService.java): `video-service/src/main/java/com/netflix/videoservice/service/VideoService.java`
- [Upload Consumer](https://github.com/yeshendradhaker/netflix-app/blob/main/encoding-service/src/main/java/com/netflix/encodingservice/service/VideoEventConsumer.java): `encoding-service/src/main/java/com/netflix/encodingservice/service/VideoEventConsumer.java`
- [HLS Encoder](https://github.com/yeshendradhaker/netflix-app/blob/main/encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java): `encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`

### Streaming and Playback

- [Encoding Event Consumer](https://github.com/yeshendradhaker/netflix-app/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/service/VideoEncodedEventConsumer.java): `streaming-service/src/main/java/com/netflix/streamingservice/service/VideoEncodedEventConsumer.java`
- [Streaming API](https://github.com/yeshendradhaker/netflix-app/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java): `streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java`
- [Streaming Service](https://github.com/yeshendradhaker/netflix-app/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java): `streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java`
- [HLS Player](https://github.com/yeshendradhaker/netflix-app/blob/main/netflix-player.html): `netflix-player.html`

### External Infrastructure

- **MySQL Catalog**
- **Raw Video S3**
- **video.uploaded**
- **FFmpeg**
- **Encoded HLS S3**
- **video.encoded**
- **Redis Cache**
- **AWS S3**

### Other components

- **Admin**
- **Viewer**

## Connections

- Admin → Catalog API: creates movie (evidence: `README.md`)
- Catalog API → Catalog Logic: calls (evidence: `content-service/src/main/java/com/netflix/contentservice/controller/ContentController.java`)
- Catalog Logic → Movie Repository: persists and queries (evidence: `content-service/src/main/java/com/netflix/contentservice/service/ContentService.java`)
- Movie Repository → MySQL Catalog: stores catalog (evidence: `README.md`)
- Admin → Video Upload API: uploads video (evidence: `README.md`)
- Video Upload API → Upload Service: calls (evidence: `video-service/src/main/java/com/netflix/videoservice/controller/VideoController.java`)
- Upload Service → Raw Video S3: uploads raw file (evidence: `video-service/src/main/java/com/netflix/videoservice/service/VideoService.java`)
- Upload Service → video.uploaded: publishes event (evidence: `video-service/src/main/java/com/netflix/videoservice/service/VideoService.java`)
- video.uploaded → Upload Consumer: delivers event (evidence: `README.md`)
- Upload Consumer → HLS Encoder: invokes encoding (evidence: `encoding-service/src/main/java/com/netflix/encodingservice/service/VideoEventConsumer.java`)
- HLS Encoder → Raw Video S3: downloads source (evidence: `encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`)
- HLS Encoder → FFmpeg: runs encoding (evidence: `encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`)
- HLS Encoder → Encoded HLS S3: uploads HLS assets (evidence: `encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`)
- HLS Encoder → video.encoded: publishes result (evidence: `encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`)
- video.encoded → Encoding Event Consumer: delivers event (evidence: `README.md`)
- Encoding Event Consumer → Catalog Logic: updates movie state (evidence: `content-service/src/main/java/com/netflix/contentservice/service/VideoUploadedEncodedEventConsumer.java`)
- video.encoded → Encoding Event Consumer: delivers event (evidence: `README.md`)
- Encoding Event Consumer → Redis Cache: stores playlist key (evidence: `README.md`)
- Viewer → Streaming API: requests playback (evidence: `README.md`)
- HLS Player → Streaming API: requests stream URL (evidence: `README.md`)
- Streaming API → Streaming Service: calls (evidence: `streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java`)
- Streaming Service → Redis Cache: reads and caches (evidence: `streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java`)
- Streaming Service → AWS S3: reads playlists (evidence: `streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java`)
- Streaming Service → AWS S3: signs object URLs (evidence: `streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java`)
- Streaming API → HLS Player: returns playback response (evidence: `README.md`)
- HLS Player → AWS S3: fetches signed HLS (evidence: `README.md`)
