# gauravsrc/gnani-task architecture

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

- Interactive diagram: https://gitdiagram.com/gauravsrc/gnani-task
- Repository: https://github.com/gauravsrc/gnani-task

## Overview

Audio Notes accepts recordings, stores them for playback, and processes them asynchronously into transcripts and English summaries. The principal flow runs from browser upload through a queued, resumable worker job to the recording page, which polls for progress and results. The README documents frontend capabilities and integrations; backend calls are supported by the indexed source references and excerpts. Frontend component-level wiring and some backend internals were not sampled, so those relationships are shown only where documented.

Main entry points: [`backend/app/main.py`](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/main.py) (HTTP API), [`backend/app/pipeline.py`](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/pipeline.py) (Resumable pipeline), [`backend/app/storage.py`](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/storage.py) (Audio storage access), [`backend/app/models.py`](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/models.py) (Recording and chunk state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Recording experience"]
  node_upload["Upload form<br/>[UploadForm.tsx]"]
  node_recordings["Recording list<br/>[RecordingList.tsx]"]
  node_recording_view["Recording view<br/>[RecordingView.tsx]"]
  node_server_status["Server status<br/>[ServerStatus.tsx]"]
  node_web_app["App pages<br/>[page.tsx]"]
  node_detail_page["Recording page<br/>[page.tsx]"]
end

subgraph group_api["API and job control"]
  node_api["HTTP API<br/>[main.py]"]
  node_worker["Job worker<br/>[worker.py]"]
end

subgraph group_processing["Audio processing"]
  node_pipeline["Resumable pipeline<br/>[pipeline.py]"]
  node_audio["Audio conversion and chunking<br/>[audio.py]"]
  node_gnani_client["Speech client<br/>[gnani.py]"]
  node_summarizer["Transcript summarizer<br/>[summarizer.py]"]
end

subgraph group_persistence["State and storage"]
  node_database[("Recording and chunk state<br/>[models.py]")]
  node_db_session["Database sessions<br/>[db.py]"]
  node_storage["Audio storage access<br/>[storage.py]"]
  node_settings["Application settings<br/>[config.py]"]
end

subgraph group_integrations["External services"]
  node_supabase_db[("Supabase Postgres")]
  node_supabase_storage[("Supabase Storage")]
  node_gnani["Gnani speech-to-text"]
  node_gemini["Google Gemini"]
end

node_person(("Recording user"))

node_person -->|"selects audio"| node_upload
node_upload -->|"uploads audio"| node_api
node_api -->|"stores audio"| node_storage
node_api -->|"queues recording"| node_database
node_worker -->|"claims jobs"| node_database
node_worker -->|"processes job"| node_pipeline
node_pipeline -->|"loads audio"| node_storage
node_pipeline -->|"prepares chunks"| node_audio
node_pipeline -->|"transcribes chunks"| node_gnani_client
node_gnani_client -->|"sends audio"| node_gnani
node_pipeline -->|"summarizes transcript"| node_summarizer
node_summarizer -->|"generates summary"| node_gemini
node_pipeline -->|"saves progress"| node_database
node_api -->|"reads recording state"| node_database
node_api -->|"signs playback URL"| node_storage
node_storage -->|"accesses bucket"| node_supabase_storage
node_db_session -->|"connects"| node_supabase_db
node_database -->|"uses base"| node_db_session
node_db_session -->|"uses connection settings"| node_settings
node_storage -->|"uses credentials"| node_settings
node_gnani_client -->|"uses service settings"| node_settings
node_summarizer -->|"uses model settings"| node_settings
node_person -->|"opens recordings"| node_web_app
node_web_app -->|"shows past uploads"| node_recordings
node_person -->|"opens recording"| node_detail_page
node_detail_page -->|"shows results"| node_recording_view
node_recording_view -->|"polls progress"| node_api
node_person -->|"sees wake notice"| node_server_status
node_server_status -->|"checks health"| node_api

click node_upload "https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/components/UploadForm.tsx"
click node_recordings "https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/components/RecordingList.tsx"
click node_recording_view "https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/components/RecordingView.tsx"
click node_server_status "https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/components/ServerStatus.tsx"
click node_web_app "https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/app/page.tsx"
click node_detail_page "https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/app/recordings/%5Bid%5D/page.tsx"
click node_api "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/main.py"
click node_worker "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/worker.py"
click node_pipeline "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/pipeline.py"
click node_audio "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/audio.py"
click node_gnani_client "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/gnani.py"
click node_summarizer "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/summarizer.py"
click node_database "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/models.py"
click node_db_session "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/db.py"
click node_storage "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/storage.py"
click node_settings "https://github.com/gauravsrc/gnani-task/blob/main/backend/app/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_upload,node_recordings,node_recording_view,node_server_status,node_web_app,node_detail_page,node_person toneBlue
class node_api,node_worker toneAmber
class node_pipeline,node_audio,node_gnani_client,node_summarizer toneMint
class node_database,node_db_session,node_storage,node_settings toneRose
class node_supabase_db,node_supabase_storage,node_gnani,node_gemini toneIndigo
```

## Components

### Recording experience

- [Upload form](https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/components/UploadForm.tsx): `frontend/src/components/UploadForm.tsx`
- [Recording list](https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/components/RecordingList.tsx): `frontend/src/components/RecordingList.tsx`
- [Recording view](https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/components/RecordingView.tsx): `frontend/src/components/RecordingView.tsx`
- [Server status](https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/components/ServerStatus.tsx): `frontend/src/components/ServerStatus.tsx`
- [App pages](https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Recording page](https://github.com/gauravsrc/gnani-task/blob/main/frontend/src/app/recordings/%5Bid%5D/page.tsx): `frontend/src/app/recordings/[id]/page.tsx`

### API and job control

- [HTTP API](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/main.py): `backend/app/main.py`
- [Job worker](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/worker.py): `backend/app/worker.py`

### Audio processing

- [Resumable pipeline](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/pipeline.py): `backend/app/pipeline.py`
- [Audio conversion and chunking](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/audio.py): `backend/app/audio.py`
- [Speech client](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/gnani.py): `backend/app/gnani.py`
- [Transcript summarizer](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/summarizer.py): `backend/app/summarizer.py`

### State and storage

- [Recording and chunk state](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/models.py): `backend/app/models.py`
- [Database sessions](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/db.py): `backend/app/db.py`
- [Audio storage access](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/storage.py): `backend/app/storage.py`
- [Application settings](https://github.com/gauravsrc/gnani-task/blob/main/backend/app/config.py): `backend/app/config.py`

### External services

- **Supabase Postgres**
- **Supabase Storage**
- **Gnani speech-to-text**
- **Google Gemini**

### Other components

- **Recording user**

## Connections

- Recording user → Upload form: selects audio (evidence: `README.md`)
- Upload form → HTTP API: uploads audio (evidence: `README.md`)
- HTTP API → Audio storage access: stores audio (evidence: `backend/app/main.py`)
- HTTP API → Recording and chunk state: queues recording (evidence: `README.md`)
- Job worker → Recording and chunk state: claims jobs (evidence: `backend/app/worker.py`)
- Job worker → Resumable pipeline: processes job (evidence: `backend/app/worker.py`)
- Resumable pipeline → Audio storage access: loads audio (evidence: `backend/app/pipeline.py`)
- Resumable pipeline → Audio conversion and chunking: prepares chunks (evidence: `backend/app/pipeline.py`)
- Resumable pipeline → Speech client: transcribes chunks (evidence: `backend/app/pipeline.py`)
- Speech client → Gnani speech-to-text: sends audio (evidence: `README.md`)
- Resumable pipeline → Transcript summarizer: summarizes transcript (evidence: `backend/app/pipeline.py`)
- Transcript summarizer → Google Gemini: generates summary (evidence: `README.md`)
- Resumable pipeline → Recording and chunk state: saves progress (evidence: `backend/app/pipeline.py`)
- HTTP API → Recording and chunk state: reads recording state (evidence: `backend/app/main.py`)
- HTTP API → Audio storage access: signs playback URL (evidence: `backend/app/main.py`)
- Audio storage access → Supabase Storage: accesses bucket (evidence: `README.md`)
- Database sessions → Supabase Postgres: connects (evidence: `README.md`)
- Recording and chunk state → Database sessions: uses base (evidence: `backend/app/models.py`)
- Database sessions → Application settings: uses connection settings (evidence: `backend/app/db.py`)
- Audio storage access → Application settings: uses credentials (evidence: `backend/app/storage.py`)
- Speech client → Application settings: uses service settings (evidence: `backend/app/gnani.py`)
- Transcript summarizer → Application settings: uses model settings (evidence: `backend/app/summarizer.py`)
- Recording user → App pages: opens recordings (evidence: `README.md`)
- App pages → Recording list: shows past uploads (evidence: `README.md`)
- Recording user → Recording page: opens recording (evidence: `README.md`)
- Recording page → Recording view: shows results (evidence: `README.md`)
- Recording view → HTTP API: polls progress (evidence: `README.md`)
- Recording user → Server status: sees wake notice (evidence: `README.md`)
- Server status → HTTP API: checks health (evidence: `README.md`)
