# sarabjeet-singh-grimreaper/vocatask architecture

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

- Interactive diagram: https://gitdiagram.com/sarabjeet-singh-grimreaper/vocatask
- Repository: https://github.com/sarabjeet-singh-grimreaper/vocatask

## Overview

VoiceTasks AI is a multilingual, voice-first task manager: users record speech or enter text, review the extracted task, then save and manage it. The frontend’s App coordinates that flow; the backend routes audio through transcription and task parsing, while task endpoints persist confirmed tasks. The README also documents installable-PWA support and offline localStorage caching. The graph reflects sampled calls and README capabilities; the persistence implementation and some UI behavior were not excerpted, so uncertain links are omitted or marked unverified.

Main entry points: [`frontend/src/App.tsx`](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/App.tsx) (App Coordinator), [`frontend/src/services/api.ts`](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/services/api.ts) (API Client), [`backend/app/api/voice.py`](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/api/voice.py) (Voice Endpoints), [`backend/app/services/speech_service.py`](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/services/speech_service.py) (Speech Transcription)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["PWA Client"]
  node_app["App Coordinator<br/>[App.tsx]"]
  node_voice["Voice Recorder<br/>[VoiceRecorder.tsx]"]
  node_confirm["Task Confirmation"]
  node_tasklist["Task List<br/>[TaskList.tsx]"]
  node_taskcard["Task Card<br/>[TaskCard.tsx]"]
  node_header["Header<br/>[Header.tsx]"]
  node_settings["AI Settings<br/>[SettingsModal.tsx]"]
  node_pwa["PWA Install Banner"]
  node_clientapi["API Client<br/>[api.ts]"]
  node_cache[("Local Task Cache<br/>[api.ts]")]
end

subgraph group_api["Backend API"]
  node_server["FastAPI App<br/>[main.py]"]
  node_voiceapi["Voice Endpoints<br/>[voice.py]"]
  node_taskapi["Task Endpoints<br/>[tasks.py]"]
  node_schema["Task Schemas<br/>[task.py]"]
end

subgraph group_ai["Speech And Parsing"]
  node_speech["Speech Transcription<br/>[speech_service.py]"]
  node_parser["Task Extraction<br/>[ai_parser.py]"]
  node_config["Runtime Configuration<br/>[config.py]"]
end

subgraph group_storage["Task Storage"]
  node_store["Task Store<br/>[task_store.py]"]
  node_database[("Persistent Task Database")]
end

node_user(("User"))
node_sttproviders{{"STT Providers"}}
node_llmproviders{{"AI Providers"}}

node_user -->|"uses"| node_app
node_app -->|"renders"| node_voice
node_app -->|"renders"| node_confirm
node_app -->|"renders"| node_tasklist
node_app -->|"renders"| node_header
node_app -->|"renders"| node_settings
node_app -->|"renders"| node_pwa
node_app -->|"loads and saves"| node_clientapi
node_voice -->|"submits speech"| node_clientapi
node_tasklist -->|"renders"| node_taskcard
node_clientapi -->|"posts voice input"| node_voiceapi
node_clientapi -->|"manages tasks"| node_taskapi
node_clientapi -->|"reads and writes"| node_cache
node_server -->|"mounts router"| node_voiceapi
node_server -->|"mounts router"| node_taskapi
node_voiceapi -->|"transcribes audio"| node_speech
node_voiceapi -->|"parses transcript"| node_parser
node_voiceapi -->|"validates output"| node_schema
node_taskapi -->|"executes task operations"| node_store
node_speech -->|"requests transcription"| node_sttproviders
node_parser -->|"requests extraction"| node_llmproviders
node_speech -->|"reads provider keys"| node_config
node_parser -->|"reads settings"| node_config
node_store -.->|"persists tasks"| node_database

click node_app "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/App.tsx"
click node_voice "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/VoiceRecorder.tsx"
click node_confirm "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/TaskConfirmModal.tsx"
click node_tasklist "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/TaskList.tsx"
click node_taskcard "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/TaskCard.tsx"
click node_header "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/Header.tsx"
click node_settings "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/SettingsModal.tsx"
click node_pwa "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/InstallPwaBanner.tsx"
click node_clientapi "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/services/api.ts"
click node_cache "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/services/api.ts"
click node_server "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/main.py"
click node_voiceapi "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/api/voice.py"
click node_taskapi "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/api/tasks.py"
click node_schema "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/schemas/task.py"
click node_speech "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/services/speech_service.py"
click node_parser "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/services/ai_parser.py"
click node_config "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/core/config.py"
click node_store "https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/services/task_store.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_app,node_voice,node_confirm,node_tasklist,node_taskcard,node_header,node_settings,node_pwa,node_clientapi,node_cache,node_user toneBlue
class node_server,node_voiceapi,node_taskapi,node_schema toneAmber
class node_speech,node_parser,node_config toneMint
class node_store,node_database toneRose
class node_sttproviders,node_llmproviders toneIndigo
```

## Components

### PWA Client

- [App Coordinator](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Voice Recorder](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/VoiceRecorder.tsx): `frontend/src/components/VoiceRecorder.tsx`
- [Task Confirmation](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/TaskConfirmModal.tsx): `frontend/src/components/TaskConfirmModal.tsx`
- [Task List](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/TaskList.tsx): `frontend/src/components/TaskList.tsx`
- [Task Card](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/TaskCard.tsx): `frontend/src/components/TaskCard.tsx`
- [Header](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/Header.tsx): `frontend/src/components/Header.tsx`
- [AI Settings](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/SettingsModal.tsx): `frontend/src/components/SettingsModal.tsx`
- [PWA Install Banner](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/components/InstallPwaBanner.tsx): `frontend/src/components/InstallPwaBanner.tsx`
- [API Client](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Local Task Cache](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Backend API

- [FastAPI App](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/main.py): `backend/app/main.py`
- [Voice Endpoints](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/api/voice.py): `backend/app/api/voice.py`
- [Task Endpoints](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/api/tasks.py): `backend/app/api/tasks.py`
- [Task Schemas](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/schemas/task.py): `backend/app/schemas/task.py`

### Speech And Parsing

- [Speech Transcription](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/services/speech_service.py): `backend/app/services/speech_service.py`
- [Task Extraction](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/services/ai_parser.py): `backend/app/services/ai_parser.py`
- [Runtime Configuration](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/core/config.py): `backend/app/core/config.py`

### Task Storage

- [Task Store](https://github.com/sarabjeet-singh-grimreaper/vocatask/blob/main/backend/app/services/task_store.py): `backend/app/services/task_store.py`
- **Persistent Task Database**

### Other components

- **User**
- **STT Providers**
- **AI Providers**

## Connections

- User → App Coordinator: uses (evidence: `README.md`)
- App Coordinator → Voice Recorder: renders (evidence: `frontend/src/App.tsx`)
- App Coordinator → Task Confirmation: renders (evidence: `frontend/src/App.tsx`)
- App Coordinator → Task List: renders (evidence: `frontend/src/App.tsx`)
- App Coordinator → Header: renders (evidence: `frontend/src/App.tsx`)
- App Coordinator → AI Settings: renders (evidence: `frontend/src/App.tsx`)
- App Coordinator → PWA Install Banner: renders (evidence: `frontend/src/App.tsx`)
- App Coordinator → API Client: loads and saves (evidence: `frontend/src/App.tsx`)
- Voice Recorder → API Client: submits speech (evidence: `frontend/src/components/VoiceRecorder.tsx`)
- Task List → Task Card: renders (evidence: `frontend/src/components/TaskList.tsx`)
- API Client → Voice Endpoints: posts voice input (evidence: `frontend/src/services/api.ts`)
- API Client → Task Endpoints: manages tasks (evidence: `frontend/src/services/api.ts`)
- API Client → Local Task Cache: reads and writes (evidence: `frontend/src/services/api.ts`)
- FastAPI App → Voice Endpoints: mounts router (evidence: `backend/app/main.py`)
- FastAPI App → Task Endpoints: mounts router (evidence: `backend/app/main.py`)
- Voice Endpoints → Speech Transcription: transcribes audio (evidence: `backend/app/api/voice.py`)
- Voice Endpoints → Task Extraction: parses transcript (evidence: `backend/app/api/voice.py`)
- Voice Endpoints → Task Schemas: validates output (evidence: `backend/app/api/voice.py`)
- Task Endpoints → Task Store: executes task operations (evidence: `backend/app/api/tasks.py`)
- Speech Transcription → STT Providers: requests transcription (evidence: `backend/app/services/speech_service.py`)
- Task Extraction → AI Providers: requests extraction (evidence: `backend/app/services/ai_parser.py`)
- Speech Transcription → Runtime Configuration: reads provider keys (evidence: `backend/app/services/speech_service.py`)
- Task Extraction → Runtime Configuration: reads settings (evidence: `backend/app/services/ai_parser.py`)
- Task Store → Persistent Task Database: persists tasks (evidence: `README.md`)
