How unmonoqueteclea/voilib works
Main Components
a) Client Layer:
• Frontend (Svelte-based web application)
• Management Interface (Streamlit-based admin panel)
b) Backend Services:
• API Server (FastAPI)
• Worker Service (for async tasks)
• Authentication Service
c) Storage Layer:
• Vector Database (Qdrant)
• Relational Database (SQL with Alembic migrations)
• File Storage (for audio files)
d) Processing Pipeline:
• Collection Service (RSS feed crawler)
• Transcription Service (Whisper)
• Embedding Service (Vector processing)
Component Relationships
a) External Interactions:
• RSS Feeds → Collection Service
• User Uploads → Storage Layer
• User Queries → Frontend → API Server
b) Internal Data Flow:
• Collection Service → Storage Layer
• Audio Files → Transcription Service → Text Storage
• Text → Embedding Service → Vector Database
• Query Processing: User Input → Vector Embedding → Vector DB Search → Results
Specific Implementation Details
Technical elements:
a) Backend Structure:
• FastAPI Routers (/routers)
• Database Models (/models)
• Schema Definitions (/schemas)
• Task Queue System
b) Frontend Components:
• User Interface Routes
• Query Interface
• Audio Player
• Results Display
Key Processes to Highlight
Four main workflows:
Infrastructure Layer
Deployment-related components:
• Docker containers (as shown in compose.yml)
• Nginx reverse proxy
• Development vs Production environments
• Client Layer |
• Service Layer |
• Processing Layer |
• Storage Layer |
• Infrastructure Layer |