# sanhith30/summarization-platform architecture

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

- Interactive diagram: https://gitdiagram.com/sanhith30/summarization-platform
- Repository: https://github.com/sanhith30/summarization-platform

## Overview

This is an offline-first text, PDF, and YouTube summarization platform. The main workflow runs from the React input UI through the FastAPI routes into input-specific processing and hierarchical summarization, then returns summaries with confidence and explainability data for display. Supporting branches cover streamed text summaries, feedback, health, administration, model inference, caching, and persistence. The map preserves documented capabilities even where implementation excerpts are incomplete; dashed edges mark documented or plausible connections whose callers were not shown.

Main entry points: [`app/api/v1/endpoints/summarization.py`](https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/endpoints/summarization.py) (Summarization routes), [`app/main.py`](https://github.com/sanhith30/summarization-platform/blob/main/app/main.py) (FastAPI application), [`app/api/v1/router.py`](https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/router.py) (API v1 router), [`frontend/src/pages/HomePage.js`](https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/pages/HomePage.js) (Home page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User interface"]
  node_home["Home page<br/>[HomePage.js]"]
  node_input["Input controls<br/>[InputSection.js]"]
  node_ui_state["Summary state"]
  node_api_client["API client<br/>[api.js]"]
  node_summary_view["Summary display<br/>[SummaryDisplay.js]"]
  node_settings_history["Settings and history<br/>[HomePage.js]"]
end

subgraph group_api["API gateway"]
  node_gateway["FastAPI application<br/>[main.py]"]
  node_router["API v1 router<br/>[router.py]"]
  node_summarization_api["Summarization routes<br/>[summarization.py]"]
  node_api_models["Request and response models<br/>[models.py]"]
  node_rate_limit["Rate limiting<br/>[rate_limiter.py]"]
  node_feedback["Feedback routes<br/>[feedback.py]"]
  node_health["Health routes<br/>[health.py]"]
  node_admin["Admin routes<br/>[admin.py]"]
end

subgraph group_processing["Summarization pipeline"]
  node_pdf["PDF extraction<br/>[pdf.py]"]
  node_youtube["Video transcripts<br/>[youtube.py]"]
  node_hierarchical["Chunking and map-reduce<br/>[summarization.py]"]
  node_model_manager["Model ensemble and inference<br/>[models.py]"]
end

subgraph group_platform["Platform services"]
  node_redis[("Redis cache<br/>[cache.py]")]
  node_database[("SQL persistence<br/>[database.py]")]
  node_configuration["Runtime configuration<br/>[config.py]"]
end

node_user(("User"))
node_youtube_service{{"YouTube transcript service"}}
node_local_models{{"Local transformer models"}}

node_user -->|"uses"| node_home
node_home -->|"renders"| node_input
node_home -->|"renders"| node_summary_view
node_home -->|"renders"| node_settings_history
node_input -->|"updates"| node_ui_state
node_input -->|"submits to"| node_api_client
node_ui_state -.->|"provides state"| node_summary_view
node_api_client -.->|"sends requests"| node_gateway
node_gateway -->|"mounts"| node_router
node_router -->|"routes to"| node_summarization_api
node_router -->|"routes to"| node_feedback
node_router -->|"routes to"| node_health
node_router -->|"routes to"| node_admin
node_summarization_api -->|"validates with"| node_api_models
node_summarization_api -->|"checks limits"| node_rate_limit
node_summarization_api -->|"summarizes text"| node_hierarchical
node_summarization_api -->|"processes PDFs"| node_pdf
node_summarization_api -->|"processes videos"| node_youtube
node_youtube -.->|"extracts transcripts"| node_youtube_service
node_youtube -->|"summarizes segments"| node_hierarchical
node_hierarchical -->|"runs inference"| node_model_manager
node_model_manager -.->|"loads models"| node_local_models
node_hierarchical -->|"caches results"| node_redis
node_gateway -->|"initializes"| node_database
node_gateway -->|"initializes"| node_model_manager
node_gateway -->|"initializes"| node_redis
node_feedback -.->|"stores feedback"| node_database
node_admin -->|"manages cache"| node_redis
node_health -->|"checks health"| node_redis
node_summarization_api -.->|"records requests"| node_database
node_gateway -->|"reads settings"| node_configuration

click node_home "https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/pages/HomePage.js"
click node_input "https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/components/InputSection.js"
click node_ui_state "https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/context/SummarizationContext.js"
click node_api_client "https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/services/api.js"
click node_summary_view "https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/components/SummaryDisplay.js"
click node_settings_history "https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/pages/HomePage.js"
click node_gateway "https://github.com/sanhith30/summarization-platform/blob/main/app/main.py"
click node_router "https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/router.py"
click node_summarization_api "https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/endpoints/summarization.py"
click node_api_models "https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/models.py"
click node_rate_limit "https://github.com/sanhith30/summarization-platform/blob/main/app/core/rate_limiter.py"
click node_feedback "https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/endpoints/feedback.py"
click node_health "https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/endpoints/health.py"
click node_admin "https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/endpoints/admin.py"
click node_pdf "https://github.com/sanhith30/summarization-platform/blob/main/app/services/pdf.py"
click node_youtube "https://github.com/sanhith30/summarization-platform/blob/main/app/services/youtube.py"
click node_hierarchical "https://github.com/sanhith30/summarization-platform/blob/main/app/services/summarization.py"
click node_model_manager "https://github.com/sanhith30/summarization-platform/blob/main/app/core/models.py"
click node_redis "https://github.com/sanhith30/summarization-platform/blob/main/app/core/cache.py"
click node_database "https://github.com/sanhith30/summarization-platform/blob/main/app/core/database.py"
click node_configuration "https://github.com/sanhith30/summarization-platform/blob/main/app/core/config.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_home,node_input,node_ui_state,node_api_client,node_summary_view,node_settings_history,node_user toneBlue
class node_gateway,node_router,node_summarization_api,node_api_models,node_rate_limit,node_feedback,node_health,node_admin toneAmber
class node_pdf,node_youtube,node_hierarchical,node_model_manager toneMint
class node_redis,node_database,node_configuration toneRose
class node_youtube_service,node_local_models toneIndigo
```

## Components

### User interface

- [Home page](https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/pages/HomePage.js): `frontend/src/pages/HomePage.js`
- [Input controls](https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/components/InputSection.js): `frontend/src/components/InputSection.js`
- [Summary state](https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/context/SummarizationContext.js): `frontend/src/context/SummarizationContext.js`
- [API client](https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Summary display](https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/components/SummaryDisplay.js): `frontend/src/components/SummaryDisplay.js`
- [Settings and history](https://github.com/sanhith30/summarization-platform/blob/main/frontend/src/pages/HomePage.js): `frontend/src/pages/HomePage.js`

### API gateway

- [FastAPI application](https://github.com/sanhith30/summarization-platform/blob/main/app/main.py): `app/main.py`
- [API v1 router](https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/router.py): `app/api/v1/router.py`
- [Summarization routes](https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/endpoints/summarization.py): `app/api/v1/endpoints/summarization.py`
- [Request and response models](https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/models.py): `app/api/v1/models.py`
- [Rate limiting](https://github.com/sanhith30/summarization-platform/blob/main/app/core/rate_limiter.py): `app/core/rate_limiter.py`
- [Feedback routes](https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/endpoints/feedback.py): `app/api/v1/endpoints/feedback.py`
- [Health routes](https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/endpoints/health.py): `app/api/v1/endpoints/health.py`
- [Admin routes](https://github.com/sanhith30/summarization-platform/blob/main/app/api/v1/endpoints/admin.py): `app/api/v1/endpoints/admin.py`

### Summarization pipeline

- [PDF extraction](https://github.com/sanhith30/summarization-platform/blob/main/app/services/pdf.py): `app/services/pdf.py`
- [Video transcripts](https://github.com/sanhith30/summarization-platform/blob/main/app/services/youtube.py): `app/services/youtube.py`
- [Chunking and map-reduce](https://github.com/sanhith30/summarization-platform/blob/main/app/services/summarization.py): `app/services/summarization.py`
- [Model ensemble and inference](https://github.com/sanhith30/summarization-platform/blob/main/app/core/models.py): `app/core/models.py`

### Platform services

- [Redis cache](https://github.com/sanhith30/summarization-platform/blob/main/app/core/cache.py): `app/core/cache.py`
- [SQL persistence](https://github.com/sanhith30/summarization-platform/blob/main/app/core/database.py): `app/core/database.py`
- [Runtime configuration](https://github.com/sanhith30/summarization-platform/blob/main/app/core/config.py): `app/core/config.py`

### Other components

- **User**
- **YouTube transcript service**
- **Local transformer models**

## Connections

- User → Home page: uses (evidence: `README.md`)
- Home page → Input controls: renders (evidence: `frontend/src/pages/HomePage.js`)
- Home page → Summary display: renders (evidence: `frontend/src/pages/HomePage.js`)
- Home page → Settings and history: renders (evidence: `frontend/src/pages/HomePage.js`)
- Input controls → Summary state: updates (evidence: `frontend/src/components/InputSection.js`)
- Input controls → API client: submits to (evidence: `frontend/src/components/InputSection.js`)
- Summary state → Summary display: provides state
- API client → FastAPI application: sends requests (evidence: `README.md`)
- FastAPI application → API v1 router: mounts (evidence: `app/main.py`)
- API v1 router → Summarization routes: routes to (evidence: `app/api/v1/router.py`)
- API v1 router → Feedback routes: routes to (evidence: `app/api/v1/router.py`)
- API v1 router → Health routes: routes to (evidence: `app/api/v1/router.py`)
- API v1 router → Admin routes: routes to (evidence: `app/api/v1/router.py`)
- Summarization routes → Request and response models: validates with (evidence: `app/api/v1/endpoints/summarization.py`)
- Summarization routes → Rate limiting: checks limits (evidence: `app/api/v1/endpoints/summarization.py`)
- Summarization routes → Chunking and map-reduce: summarizes text (evidence: `app/api/v1/endpoints/summarization.py`)
- Summarization routes → PDF extraction: processes PDFs (evidence: `app/api/v1/endpoints/summarization.py`)
- Summarization routes → Video transcripts: processes videos (evidence: `app/api/v1/endpoints/summarization.py`)
- Video transcripts → YouTube transcript service: extracts transcripts
- Video transcripts → Chunking and map-reduce: summarizes segments (evidence: `app/services/youtube.py`)
- Chunking and map-reduce → Model ensemble and inference: runs inference (evidence: `app/services/summarization.py`)
- Model ensemble and inference → Local transformer models: loads models (evidence: `README.md`)
- Chunking and map-reduce → Redis cache: caches results (evidence: `app/services/summarization.py`)
- FastAPI application → SQL persistence: initializes (evidence: `app/main.py`)
- FastAPI application → Model ensemble and inference: initializes (evidence: `app/main.py`)
- FastAPI application → Redis cache: initializes (evidence: `app/main.py`)
- Feedback routes → SQL persistence: stores feedback (evidence: `app/api/v1/endpoints/feedback.py`)
- Admin routes → Redis cache: manages cache (evidence: `app/api/v1/endpoints/admin.py`)
- Health routes → Redis cache: checks health (evidence: `app/api/v1/endpoints/health.py`)
- Summarization routes → SQL persistence: records requests
- FastAPI application → Runtime configuration: reads settings (evidence: `app/main.py`)
