# insolve-wojciech-bednorz/artificial_voiceline_playback architecture

> Architecture diagram of the GitHub repository insolve-wojciech-bednorz/artificial_voiceline_playback, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/insolve-wojciech-bednorz/artificial_voiceline_playback
- Repository: https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback

## Overview

##### Project type and purpose
- This is a full-stack “voice-line management and radio playback” system.
- Frontend: a Next.js (React) SPA under `nextjs-voiceline-app/` for adding/editing/searching/scheduling voice lines.
- Backend: Python scripts (`main.py`, `voice_system.py`, `models.py`, etc.) that handle data storage, TTS generation (ElevenLabs), scheduling, and radio streaming.

##### File structure
- Top level:
- `audio_files/` – stored MP3 voice lines
- `voice_lines.json` – metadata DB for lines and schedules
- `config.yaml` – global settings (station parameters, scheduler rules, TTS voice settings)
- `main.py` & `voice_system.py` – core orchestrators (API endpoints? CLI? scheduler loop)
- `models.py` – data definitions (VoiceLine, Schedule, StationConfig)
- `requirements.txt` – Python dependencies (e.g., Flask/FastAPI? APScheduler?)
- Frontend (`nextjs-voiceline-app/`):
- `src/app/` – pages (dashboard, settings)
- `src/components/` – UI building blocks (modals, tables, settings panels)
- `src/utils/api.ts` – HTTP calls to backend
- `src/utils/elevenlabs.ts` – client wrapper (optional)
- Deployment/build files: `package.json`, `next.config.ts`, `tailwind.config.js`, build scripts (`setup.sh`/`.bat`).

##### README
- Confirms: “Program tworzący, zarządzający i odtwarzający linie głosowe wraz z radiem.”
- Key functions: create TTS lines, manage metadata & schedule, play back on a radio stream.

## Diagram (Mermaid)

```mermaid
graph TD
    %% User Layer
    Admin["Admin User"]:::frontend
    Admin -->|"Uses UI"| UI

    %% Frontend Layer
    UI["Next.js UI"]:::frontend
    UI -->|"HTTP: CRUD /api/voice-lines"| API

    %% Backend Layer
    subgraph "Backend Services"
        direction TB
        API["API Service (main.py)"]:::backend
        Models["Data Models (models.py)"]:::backend
        Core["VoiceSystem Core (voice_system.py)"]:::backend
        Scheduler["Scheduler Worker"]:::backend
        Config["Config (config.yaml)"]:::storage
        StorageMeta["Metadata (voice_lines.json)"]:::storage
        StorageAudio["Audio Files (audio_files/)"]:::storage
    end

    UI --> API
    API -->|"Uses models"| Models
    API -->|"Read/Write metadata"| StorageMeta
    API -->|"Store/Retrieve MP3"| StorageAudio
    Core -->|"Read config"| Config
    Core -->|"Poll schedules"| StorageMeta
    Core -->|"POST /tts/generate"| TTS
    TTS -->|"Returns MP3 file"| StorageAudio
    Core -->|"Stream audio"| Streaming

    %% External Services
    TTS["ElevenLabs TTS API"]:::external
    Streaming["Radio Stream Endpoint"]:::streaming

    %% Click Events
    click UI "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/tree/main/nextjs-voiceline-app/"
    click pages "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/tree/main/nextjs-voiceline-app/src/app/"
    click components "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/tree/main/nextjs-voiceline-app/src/components/"
    click apiUtils "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/blob/main/nextjs-voiceline-app/src/utils/api.ts"
    click elevenlabsUtils "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/blob/main/nextjs-voiceline-app/src/utils/elevenlabs.ts"
    click API "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/blob/main/main.py"
    click Core "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/blob/main/voice_system.py"
    click Models "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/blob/main/models.py"
    click StorageMeta "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/blob/main/voice_lines.json"
    click StorageAudio "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/tree/main/audio_files/"
    click Config "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/blob/main/config.yaml"
    click radioPlaylist "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/blob/main/RMF_FM.pls"
    click radioTest "https://github.com/insolve-wojciech-bednorz/artificial_voiceline_playback/blob/main/radio-test.py"

    %% Styles
    classDef frontend fill:#E0F7FA,stroke:#006064,color:#006064;
    classDef backend fill:#E8F5E9,stroke:#2E7D32,color:#2E7D32;
    classDef storage fill:#FFF3E0,stroke:#EF6C00,color:#E65100;
    classDef external fill:#FFEBEE,stroke:#C62828,color:#B71C1C;
    classDef streaming fill:#F3E5F5,stroke:#6A1B9A,color:#4A148C;
```
