# yashwanthreddy2807/mini-netflix architecture

> Architecture diagram of the GitHub repository yashwanthreddy2807/mini-netflix, 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/yashwanthreddy2807/mini-netflix
- Repository: https://github.com/yashwanthreddy2807/mini-netflix

## Overview

Mini Netflix is a microservice video-catalog and streaming application with a React interface. Users browse and search a movie catalog, open a movie for playback, or log in to upload a video. Uploads are stored and announced for encoding; encoding produces HLS assets and publishes completion, while the streaming service supplies signed playback URLs. The README contains no architecture details, and several HTTP/event integration points are unsampled, so those links are marked unverified rather than asserted.

Main entry points: [`mini-netflix-frontend/src/components/StreamingSection.jsx`](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/components/StreamingSection.jsx) (Catalog browser), [`content-service/src/main/java/com/netflix/contentservice/service/ContentService.java`](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/content-service/src/main/java/com/netflix/contentservice/service/ContentService.java) (Catalog operations), [`mini-netflix-frontend/src/App.jsx`](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/App.jsx) (Web app), [`encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java) (HLS encoder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_app["Web app<br/>[App.jsx]"]
  node_auth["Uploader login<br/>[auth.js]"]
  node_browse["Catalog browser"]
  node_moviecard["Movie card<br/>[MovieCard.jsx]"]
  node_player["Video player"]
  node_uploadui["Upload form<br/>[UploadSection.jsx]"]
end

subgraph group_catalog["Movie catalog"]
  node_contentapi["Catalog API"]
  node_catalogservice["Catalog operations"]
  node_moviemodel["Movie model<br/>[Movie.java]"]
  node_moviedto["Movie DTOs<br/>[MovieResponse.java]"]
  node_movierepo["Movie repository"]
  node_catalogdb[("Catalog database")]
end

subgraph group_upload["Video upload"]
  node_videoapi["Video API"]
  node_videoservice["Upload service<br/>[VideoService.java]"]
  node_rawstorage[("Video object storage")]
end

subgraph group_processing["Encoding pipeline"]
  node_kafka["Kafka events"]
  node_uploadconsumer["Upload event consumer"]
  node_encoder["HLS encoder"]
  node_encodedstorage[("Encoded HLS storage")]
end

subgraph group_playback["Streaming"]
  node_encodedconsumer["Encoding event consumer"]
  node_streamapi["Streaming API"]
  node_streamservice["Playback URL service"]
  node_urlcache[("URL cache")]
end

node_viewer(("Viewer / uploader"))
node_s3[("Amazon S3")]

node_viewer -->|"uses"| node_app
node_app -->|"shows"| node_browse
node_app -->|"shows"| node_uploadui
node_app -->|"checks session"| node_auth
node_browse -->|"renders"| node_moviecard
node_browse -->|"opens"| node_player
node_uploadui -->|"checks uploader"| node_auth
node_browse -.->|"requests catalog"| node_contentapi
node_browse -.->|"requests playback"| node_streamapi
node_uploadui -.->|"submits video"| node_videoapi
node_contentapi -->|"routes requests"| node_catalogservice
node_catalogservice -->|"reads and writes"| node_movierepo
node_catalogservice -->|"maps responses"| node_moviedto
node_catalogservice -->|"updates"| node_moviemodel
node_movierepo -.->|"persists"| node_catalogdb
node_videoapi -->|"routes upload"| node_videoservice
node_videoservice -->|"stores raw video"| node_s3
node_videoservice -->|"publishes upload event"| node_kafka
node_kafka -.->|"delivers upload event"| node_uploadconsumer
node_uploadconsumer -->|"invokes encoding"| node_encoder
node_encoder -->|"reads raw video"| node_s3
node_encoder -->|"writes HLS assets"| node_s3
node_encoder -->|"publishes result event"| node_kafka
node_kafka -.->|"delivers result event"| node_encodedconsumer
node_streamapi -->|"routes requests"| node_streamservice
node_streamservice -->|"reads and writes"| node_urlcache
node_streamservice -->|"reads playlists"| node_s3
node_streamservice -->|"signs playback URLs"| node_s3
node_encodedconsumer -.->|"updates movie status"| node_catalogservice

click node_app "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/App.jsx"
click node_auth "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/auth.js"
click node_browse "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/components/StreamingSection.jsx"
click node_moviecard "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/components/MovieCard.jsx"
click node_player "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/components/VideoPlayerModal.jsx"
click node_uploadui "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/components/UploadSection.jsx"
click node_contentapi "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/content-service/src/main/java/com/netflix/contentservice/controller/ContentController.java"
click node_catalogservice "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/content-service/src/main/java/com/netflix/contentservice/service/ContentService.java"
click node_moviemodel "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/content-service/src/main/java/com/netflix/contentservice/model/Movie.java"
click node_moviedto "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/content-service/src/main/java/com/netflix/contentservice/dto/MovieResponse.java"
click node_movierepo "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/content-service/src/main/java/com/netflix/contentservice/repository/MovieRepository.java"
click node_videoapi "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/video-service/src/main/java/com/netflix/videoservice/controller/VideoController.java"
click node_videoservice "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/video-service/src/main/java/com/netflix/videoservice/service/VideoService.java"
click node_uploadconsumer "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/encoding-service/src/main/java/com/netflix/encodingservice/service/VideoEventConsumer.java"
click node_encoder "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java"
click node_encodedconsumer "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/service/VideoEncodedEventConsumer.java"
click node_streamapi "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java"
click node_streamservice "https://github.com/yashwanthreddy2807/mini-netflix/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java"

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_auth,node_browse,node_moviecard,node_player,node_uploadui,node_viewer toneBlue
class node_contentapi,node_catalogservice,node_moviemodel,node_moviedto,node_movierepo,node_catalogdb,node_s3 toneAmber
class node_videoapi,node_videoservice,node_rawstorage toneMint
class node_kafka,node_uploadconsumer,node_encoder,node_encodedstorage toneRose
class node_encodedconsumer,node_streamapi,node_streamservice,node_urlcache toneIndigo
```

## Components

### Web interface

- [Web app](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/App.jsx): `mini-netflix-frontend/src/App.jsx`
- [Uploader login](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/auth.js): `mini-netflix-frontend/src/auth.js`
- [Catalog browser](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/components/StreamingSection.jsx): `mini-netflix-frontend/src/components/StreamingSection.jsx`
- [Movie card](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/components/MovieCard.jsx): `mini-netflix-frontend/src/components/MovieCard.jsx`
- [Video player](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/components/VideoPlayerModal.jsx): `mini-netflix-frontend/src/components/VideoPlayerModal.jsx`
- [Upload form](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/mini-netflix-frontend/src/components/UploadSection.jsx): `mini-netflix-frontend/src/components/UploadSection.jsx`

### Movie catalog

- [Catalog API](https://github.com/yashwanthreddy2807/mini-netflix/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 operations](https://github.com/yashwanthreddy2807/mini-netflix/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/yashwanthreddy2807/mini-netflix/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 DTOs](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/content-service/src/main/java/com/netflix/contentservice/dto/MovieResponse.java): `content-service/src/main/java/com/netflix/contentservice/dto/MovieResponse.java`
- [Movie repository](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/content-service/src/main/java/com/netflix/contentservice/repository/MovieRepository.java): `content-service/src/main/java/com/netflix/contentservice/repository/MovieRepository.java`
- **Catalog database**

### Video upload

- [Video API](https://github.com/yashwanthreddy2807/mini-netflix/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/yashwanthreddy2807/mini-netflix/blob/main/video-service/src/main/java/com/netflix/videoservice/service/VideoService.java): `video-service/src/main/java/com/netflix/videoservice/service/VideoService.java`
- **Video object storage**

### Encoding pipeline

- **Kafka events**
- [Upload event consumer](https://github.com/yashwanthreddy2807/mini-netflix/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/yashwanthreddy2807/mini-netflix/blob/main/encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java): `encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`
- **Encoded HLS storage**

### Streaming

- [Encoding event consumer](https://github.com/yashwanthreddy2807/mini-netflix/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/yashwanthreddy2807/mini-netflix/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java): `streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java`
- [Playback URL service](https://github.com/yashwanthreddy2807/mini-netflix/blob/main/streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java): `streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java`
- **URL cache**

### Other components

- **Viewer / uploader**
- **Amazon S3**

## Connections

- Viewer / uploader → Web app: uses
- Web app → Catalog browser: shows (evidence: `mini-netflix-frontend/src/App.jsx`)
- Web app → Upload form: shows (evidence: `mini-netflix-frontend/src/App.jsx`)
- Web app → Uploader login: checks session (evidence: `mini-netflix-frontend/src/App.jsx`)
- Catalog browser → Movie card: renders (evidence: `mini-netflix-frontend/src/components/StreamingSection.jsx`)
- Catalog browser → Video player: opens (evidence: `mini-netflix-frontend/src/components/StreamingSection.jsx`)
- Upload form → Uploader login: checks uploader (evidence: `mini-netflix-frontend/src/components/UploadSection.jsx`)
- Catalog browser → Catalog API: requests catalog
- Catalog browser → Streaming API: requests playback
- Upload form → Video API: submits video
- Catalog API → Catalog operations: routes requests (evidence: `content-service/src/main/java/com/netflix/contentservice/controller/ContentController.java`)
- Catalog operations → Movie repository: reads and writes (evidence: `content-service/src/main/java/com/netflix/contentservice/service/ContentService.java`)
- Catalog operations → Movie DTOs: maps responses (evidence: `content-service/src/main/java/com/netflix/contentservice/service/ContentService.java`)
- Catalog operations → Movie model: updates (evidence: `content-service/src/main/java/com/netflix/contentservice/service/ContentService.java`)
- Movie repository → Catalog database: persists
- Video API → Upload service: routes upload (evidence: `video-service/src/main/java/com/netflix/videoservice/controller/VideoController.java`)
- Upload service → Amazon S3: stores raw video (evidence: `video-service/src/main/java/com/netflix/videoservice/service/VideoService.java`)
- Upload service → Kafka events: publishes upload event (evidence: `video-service/src/main/java/com/netflix/videoservice/service/VideoService.java`)
- Kafka events → Upload event consumer: delivers upload event
- Upload event consumer → HLS encoder: invokes encoding (evidence: `encoding-service/src/main/java/com/netflix/encodingservice/service/VideoEventConsumer.java`)
- HLS encoder → Amazon S3: reads raw video (evidence: `encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`)
- HLS encoder → Amazon S3: writes HLS assets (evidence: `encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`)
- HLS encoder → Kafka events: publishes result event (evidence: `encoding-service/src/main/java/com/netflix/encodingservice/service/EncodingService.java`)
- Kafka events → Encoding event consumer: delivers result event
- Streaming API → Playback URL service: routes requests (evidence: `streaming-service/src/main/java/com/netflix/streamingservice/controller/StreamingController.java`)
- Playback URL service → URL cache: reads and writes (evidence: `streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java`)
- Playback URL service → Amazon S3: reads playlists (evidence: `streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java`)
- Playback URL service → Amazon S3: signs playback URLs (evidence: `streaming-service/src/main/java/com/netflix/streamingservice/service/StreamingService.java`)
- Encoding event consumer → Catalog operations: updates movie status
