replace frontend with swagger

Dockerfile

@@ -4,8 +4,6 @@ FROM python:3.9-slim
 RUN apt-get update && \
     apt-get install -y \
     ffmpeg \
-    libsm6 \
-    libxext6 \
     curl \
     && apt-get clean \
     && rm -rf /var/lib/apt/lists/*
@@ -25,13 +23,11 @@ ENV PATH="/home/user/.local/bin:$PATH"
 RUN pip install --no-cache-dir --upgrade pip && \
     pip install --no-cache-dir -r requirements.txt
 
-# Copy application code maintaining structure
+# Copy application code
 COPY --chown=user:user . .
 
 # Create necessary directories
-RUN mkdir -p /tmp/audio_extractor && \
-    mkdir -p interfaces/web/static && \
-    mkdir -p interfaces/web/templates
+RUN mkdir -p /tmp/audio_extractor
 
 # Set environment variables
 ENV PYTHONPATH=/app

app.py

@@ -1,7 +1,6 @@
-"""FastAPI application initialization with DDD architecture."""
-from fastapi import FastAPI, Request
-from fastapi.staticfiles import StaticFiles
-from fastapi.templating import Jinja2Templates
+"""FastAPI API-only application with DDD architecture."""
+from fastapi import FastAPI
+from fastapi.responses import RedirectResponse
 from contextlib import asynccontextmanager
 import logging
 
@@ -43,23 +42,41 @@ async def lifespan(app: FastAPI):
     # Start background services
     await service_container.startup()
     
-    logger.info("Application started successfully")
+    logger.info("API service started successfully")
     
     yield
     
     # Shutdown
-    logger.info("Shutting down application")
+    logger.info("Shutting down API service")
     
     # Stop background services
     await service_container.shutdown()
     
-    logger.info("Application shut down successfully")
+    logger.info("API service shut down successfully")
 
-# Create FastAPI app
+# Create FastAPI app with API documentation
 app = FastAPI(
     title=settings.app_name,
+    description="""
+    ## Audio Extraction API
+    
+    Extract audio from video files in various formats with customizable quality settings.
+    
+    ### Features
+    - 🎥 Support for multiple video formats (MP4, AVI, MOV, MKV, WebM, etc.)
+    - 🎵 Multiple audio output formats (MP3, AAC, WAV, FLAC, M4A, OGG)
+    - 📊 Three quality levels (High, Medium, Low)
+    - 🚀 Automatic handling based on file size
+    - 📦 Async processing for large files
+    
+    ### Processing Flow
+    1. **Small files (<10MB)**: Direct processing with immediate response
+    2. **Large files (≥10MB)**: Background processing with job tracking
+    """,
     version=settings.app_version,
-    description="Extract audio from video files using FFmpeg",
+    docs_url="/docs",
+    redoc_url="/redoc",
+    openapi_url="/openapi.json",
     lifespan=lifespan
 )
 
@@ -70,17 +87,11 @@ register_exception_handlers(app)
 # Register API routes
 register_routes(app)
 
-# Mount static files
-app.mount("/static", StaticFiles(directory="interfaces/web/static"), name="static")
-
-# Setup templates
-templates = Jinja2Templates(directory="interfaces/web/templates")
-
-# Root route for web interface
+# Root redirect to documentation
 @app.get("/", include_in_schema=False)
-async def home(request: Request):
-    """Serve the web interface."""
-    return templates.TemplateResponse("index.html", {"request": request})
+async def root():
+    """Redirect root to API documentation."""
+    return RedirectResponse(url="/docs")
 
 # Dependency injection functions for routes
 def get_service_container() -> ServiceContainer:

interfaces/api/routes/extraction_routes.py

@@ -1,5 +1,5 @@
 """Audio extraction API routes."""
-from fastapi import APIRouter, BackgroundTasks, Response, Request, UploadFile
+from fastapi import APIRouter, BackgroundTasks, Response, Request, File, UploadFile, Form
 from fastapi.responses import FileResponse, JSONResponse
 from typing import Dict, Any
 from dataclasses import asdict
@@ -10,7 +10,27 @@ from application.dto.extraction_request import ExtractionRequestDTO
 
 router = APIRouter()
 
-@router.post("/extract", response_model=None)
+@router.post("/extract", 
+            response_model=None,
+            summary="Extract Audio from Video",
+            description="""
+            Extract audio from uploaded video file.
+            
+            - **Small files (<10MB)**: Returns the audio file directly
+            - **Large files (≥10MB)**: Returns a job ID for async processing
+            """,
+            responses={
+                200: {
+                    "description": "Direct audio file response (small files)",
+                    "content": {"audio/mpeg": {}, "audio/aac": {}, "audio/wav": {}}
+                },
+                202: {
+                    "description": "Job created for async processing (large files)",
+                    "model": JobCreatedResponse
+                },
+                400: {"description": "Invalid input"},
+                500: {"description": "Processing error"}
+            })
 async def extract_audio(
     background_tasks: BackgroundTasks,
     video: ValidatedVideo,
@@ -21,8 +41,9 @@ async def extract_audio(
     """
     Extract audio from uploaded video file.
     
-    For small files (<10MB), returns the audio file directly.
-    For large files, returns a job ID for async processing.
+    The API automatically determines the processing method based on file size:
+    - Files under 10MB are processed immediately and the audio file is returned
+    - Files 10MB or larger are processed asynchronously, returning a job ID for tracking
     """
     # Get file size
     file_size = _get_file_size(video)

interfaces/api/routes/info_routes.py

@@ -6,7 +6,10 @@ from ..responses import ApiInfoResponse
 
 router = APIRouter()
 
-@router.get("/info", response_model=ApiInfoResponse)
+@router.get("/info", 
+           response_model=ApiInfoResponse,
+           summary="Get API Information",
+           description="Returns information about supported formats, quality levels, and available endpoints")
 async def get_api_info():
     """Get API information and supported formats."""
     return ApiInfoResponse(
@@ -19,11 +22,15 @@ async def get_api_info():
             "/api/v1/extract": "POST - Extract audio from video",
             "/api/v1/jobs/{job_id}": "GET - Check job status",
             "/api/v1/jobs/{job_id}/download": "GET - Download processed audio",
-            "/api/v1/info": "GET - API information"
+            "/api/v1/info": "GET - API information",
+            "/api/v1/health": "GET - Health check"
         }
     )
 
-@router.get("/health")
+@router.get("/health",
+           summary="Health Check",
+           description="Simple health check endpoint for monitoring",
+           response_model=Dict[str, str])
 async def health_check():
     """Simple health check endpoint."""
-    return {"status": "healthy", "service": "audio-extractor"}
+    return {"status": "healthy", "service": "audio-extractor-api"}

interfaces/api/routes/job_routes.py

@@ -1,5 +1,5 @@
 """Job management API routes."""
-from fastapi import APIRouter, HTTPException
+from fastapi import APIRouter, HTTPException, Request, Path
 from fastapi.responses import FileResponse
 from typing import Any
 
@@ -9,9 +9,16 @@ from domain.exceptions.domain_exceptions import JobNotFoundError, JobNotComplete
 
 router = APIRouter()
 
-@router.get("/jobs/{job_id}", response_model=JobStatusResponse)
+@router.get("/jobs/{job_id}", 
+           response_model=JobStatusResponse,
+           summary="Get Job Status",
+           description="Check the status of an audio extraction job",
+           responses={
+               200: {"description": "Job status retrieved successfully"},
+               404: {"description": "Job not found"}
+           })
 async def get_job_status(
-    job_id: str,
+    job_id: str = Path(..., description="The job ID returned from the extraction endpoint"),
     use_cases: UseCases
 ):
     """Get the status of a background processing job."""
@@ -36,9 +43,19 @@ async def get_job_status(
     except Exception as e:
         raise HTTPException(500, f"Error checking job status: {str(e)}")
 
-@router.get("/jobs/{job_id}/download")
+@router.get("/jobs/{job_id}/download",
+           summary="Download Extracted Audio",
+           description="Download the audio file from a completed extraction job",
+           responses={
+               200: {
+                   "description": "Audio file",
+                   "content": {"audio/mpeg": {}, "audio/aac": {}, "audio/wav": {}}
+               },
+               400: {"description": "Job not completed"},
+               404: {"description": "Job not found"}
+           })
 async def download_job_result(
-    job_id: str,
+    job_id: str = Path(..., description="The job ID of the completed extraction"),
     use_cases: UseCases
 ):
     """Download the result of a completed job."""

interfaces/web/__init__.py

@@ -1 +0,0 @@
-"""Web interface components."""

interfaces/web/static/script.js

@@ -1,186 +0,0 @@
-class AudioExtractor {
-    constructor() {
-        this.form = document.getElementById('extractionForm');
-        this.fileInput = document.getElementById('videoFile');
-        this.fileLabel = document.querySelector('.file-input-label');
-        this.fileInfo = document.getElementById('fileInfo');
-        this.submitBtn = document.getElementById('submitBtn');
-        this.resultSection = document.getElementById('resultSection');
-        
-        this.initializeEventListeners();
-    }
-    
-    initializeEventListeners() {
-        this.form.addEventListener('submit', (e) => this.handleSubmit(e));
-        this.fileInput.addEventListener('change', (e) => this.handleFileSelect(e));
-        
-        // Drag and drop
-        this.fileLabel.addEventListener('dragover', (e) => this.handleDragOver(e));
-        this.fileLabel.addEventListener('dragleave', (e) => this.handleDragLeave(e));
-        this.fileLabel.addEventListener('drop', (e) => this.handleDrop(e));
-    }
-    
-    handleFileSelect(e) {
-        const file = e.target.files[0];
-        if (file) {
-            this.displayFileInfo(file);
-        }
-    }
-    
-    handleDragOver(e) {
-        e.preventDefault();
-        this.fileLabel.classList.add('drag-over');
-    }
-    
-    handleDragLeave(e) {
-        e.preventDefault();
-        this.fileLabel.classList.remove('drag-over');
-    }
-    
-    handleDrop(e) {
-        e.preventDefault();
-        this.fileLabel.classList.remove('drag-over');
-        
-        const files = e.dataTransfer.files;
-        if (files.length > 0) {
-            this.fileInput.files = files;
-            this.displayFileInfo(files[0]);
-        }
-    }
-    
-    displayFileInfo(file) {
-        const sizeMB = (file.size / (1024 * 1024)).toFixed(2);
-        this.fileInfo.textContent = `${file.name} (${sizeMB} MB)`;
-        this.fileLabel.classList.add('has-file');
-        this.fileLabel.querySelector('span').textContent = 'Change file';
-    }
-    
-    async handleSubmit(e) {
-        e.preventDefault();
-        
-        const file = this.fileInput.files[0];
-        if (!file) return;
-        
-        const formData = new FormData();
-        formData.append('video', file);
-        formData.append('output_format', document.getElementById('outputFormat').value);
-        formData.append('quality', document.getElementById('quality').value);
-        
-        this.setLoading(true);
-        this.showStatus('loading', 'Processing your video...');
-        
-        try {
-            const response = await fetch('/api/v1/extract', {
-                method: 'POST',
-                body: formData
-            });
-            
-            if (response.headers.get('content-type')?.includes('audio')) {
-                // Direct file response
-                await this.handleDirectResponse(response);
-            } else {
-                // Job response
-                const data = await response.json();
-                if (response.status === 202) {
-                    await this.handleJobResponse(data);
-                } else {
-                    throw new Error(data.error || 'Unknown error');
-                }
-            }
-        } catch (error) {
-            this.showStatus('error', `Error: ${error.message}`);
-        } finally {
-            this.setLoading(false);
-        }
-    }
-    
-    async handleDirectResponse(response) {
-        const blob = await response.blob();
-        const url = URL.createObjectURL(blob);
-        const filename = this.extractFilename(response);
-        
-        this.showResult({
-            type: 'direct',
-            url: url,
-            filename: filename
-        });
-    }
-    
-    async handleJobResponse(data) {
-        this.showStatus('loading', `Processing large file (${data.file_size_mb.toFixed(1)} MB)...`);
-        
-        const checkInterval = setInterval(async () => {
-            try {
-                const response = await fetch(`/api/v1/jobs/${data.job_id}`);
-                const status = await response.json();
-                
-                if (status.status === 'completed') {
-                    clearInterval(checkInterval);
-                    this.showResult({
-                        type: 'job',
-                        downloadUrl: status.download_url,
-                        filename: status.filename
-                    });
-                } else if (status.status === 'failed') {
-                    clearInterval(checkInterval);
-                    this.showStatus('error', `Processing failed: ${status.error}`);
-                }
-            } catch (error) {
-                clearInterval(checkInterval);
-                this.showStatus('error', `Error checking status: ${error.message}`);
-            }
-        }, 2000);
-    }
-    
-    showStatus(type, message) {
-        this.resultSection.style.display = 'block';
-        this.resultSection.innerHTML = `
-            <div class="result-card">
-                <div class="status-message ${type}">
-                    ${type === 'loading' ? '<span class="spinner"></span>' : ''}
-                    <span>${message}</span>
-                </div>
-            </div>
-        `;
-    }
-    
-    showResult(result) {
-        const format = document.getElementById('outputFormat').value;
-        
-        this.resultSection.style.display = 'block';
-        this.resultSection.innerHTML = `
-            <div class="result-card">
-                <div class="status-message success">
-                    <span>✅ Audio extracted successfully!</span>
-                </div>
-                ${result.type === 'direct' ? `
-                    <audio controls src="${result.url}"></audio>
-                ` : ''}
-                <a href="${result.type === 'direct' ? result.url : result.downloadUrl}" 
-                   download="${result.filename || `extracted.${format}`}" 
-                   class="download-btn">
-                    📥 Download Audio
-                </a>
-            </div>
-        `;
-    }
-    
-    setLoading(loading) {
-        this.submitBtn.disabled = loading;
-        this.submitBtn.textContent = loading ? 'Processing...' : 'Extract Audio';
-    }
-    
-    extractFilename(response) {
-        const disposition = response.headers.get('content-disposition');
-        if (disposition) {
-            const match = disposition.match(/filename="(.+)"/);
-            if (match) return match[1];
-        }
-        return 'extracted_audio';
-    }
-}
-
-// Initialize the app
-document.addEventListener('DOMContentLoaded', () => {
-    new AudioExtractor();
-});

interfaces/web/static/style.css

@@ -1,250 +0,0 @@
-:root {
-    --primary-color: #3b82f6;
-    --primary-hover: #2563eb;
-    --success-color: #10b981;
-    --error-color: #ef4444;
-    --warning-color: #f59e0b;
-    --bg-color: #f3f4f6;
-    --card-bg: #ffffff;
-    --text-primary: #111827;
-    --text-secondary: #6b7280;
-    --border-color: #e5e7eb;
-}
-
-* {
-    margin: 0;
-    padding: 0;
-    box-sizing: border-box;
-}
-
-body {
-    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-    background-color: var(--bg-color);
-    color: var(--text-primary);
-    line-height: 1.6;
-}
-
-.container {
-    max-width: 800px;
-    margin: 0 auto;
-    padding: 2rem;
-}
-
-header {
-    text-align: center;
-    margin-bottom: 3rem;
-}
-
-header h1 {
-    font-size: 2.5rem;
-    margin-bottom: 0.5rem;
-}
-
-header p {
-    color: var(--text-secondary);
-    font-size: 1.125rem;
-}
-
-.upload-section {
-    background: var(--card-bg);
-    border-radius: 1rem;
-    padding: 2rem;
-    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
-}
-
-.file-input-wrapper {
-    margin-bottom: 2rem;
-}
-
-#videoFile {
-    display: none;
-}
-
-.file-input-label {
-    display: flex;
-    flex-direction: column;
-    align-items: center;
-    padding: 3rem;
-    border: 2px dashed var(--border-color);
-    border-radius: 0.5rem;
-    cursor: pointer;
-    transition: all 0.3s;
-}
-
-.file-input-label:hover {
-    border-color: var(--primary-color);
-    background-color: #f9fafb;
-}
-
-.file-input-label.has-file {
-    border-color: var(--success-color);
-    background-color: #f0fdf4;
-}
-
-.upload-icon {
-    width: 48px;
-    height: 48px;
-    fill: var(--text-secondary);
-    margin-bottom: 1rem;
-}
-
-.file-info {
-    margin-top: 1rem;
-    text-align: center;
-    color: var(--text-secondary);
-}
-
-.options-grid {
-    display: grid;
-    grid-template-columns: 1fr 1fr;
-    gap: 1.5rem;
-    margin-bottom: 2rem;
-}
-
-.form-group {
-    display: flex;
-    flex-direction: column;
-}
-
-.form-group label {
-    font-weight: 500;
-    margin-bottom: 0.5rem;
-    color: var(--text-primary);
-}
-
-select {
-    padding: 0.75rem;
-    border: 1px solid var(--border-color);
-    border-radius: 0.375rem;
-    background-color: white;
-    font-size: 1rem;
-    transition: border-color 0.3s;
-}
-
-select:focus {
-    outline: none;
-    border-color: var(--primary-color);
-    box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
-}
-
-.submit-btn {
-    width: 100%;
-    padding: 1rem;
-    background-color: var(--primary-color);
-    color: white;
-    border: none;
-    border-radius: 0.5rem;
-    font-size: 1.125rem;
-    font-weight: 600;
-    cursor: pointer;
-    transition: background-color 0.3s;
-}
-
-.submit-btn:hover:not(:disabled) {
-    background-color: var(--primary-hover);
-}
-
-.submit-btn:disabled {
-    background-color: var(--text-secondary);
-    cursor: not-allowed;
-}
-
-.result-section {
-    margin-top: 2rem;
-    display: none;
-}
-
-.result-card {
-    background: var(--card-bg);
-    border-radius: 1rem;
-    padding: 2rem;
-    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
-}
-
-.status-message {
-    display: flex;
-    align-items: center;
-    margin-bottom: 1.5rem;
-    padding: 1rem;
-    border-radius: 0.5rem;
-}
-
-.status-message.success {
-    background-color: #f0fdf4;
-    color: var(--success-color);
-}
-
-.status-message.error {
-    background-color: #fef2f2;
-    color: var(--error-color);
-}
-
-.status-message.loading {
-    background-color: #fefce8;
-    color: var(--warning-color);
-}
-
-.spinner {
-    display: inline-block;
-    width: 20px;
-    height: 20px;
-    border: 3px solid rgba(0, 0, 0, 0.1);
-    border-radius: 50%;
-    border-top-color: currentColor;
-    animation: spin 1s ease-in-out infinite;
-    margin-right: 0.75rem;
-}
-
-@keyframes spin {
-    to { transform: rotate(360deg); }
-}
-
-audio {
-    width: 100%;
-    margin: 1rem 0;
-}
-
-.download-btn {
-    display: inline-flex;
-    align-items: center;
-    padding: 0.75rem 1.5rem;
-    background-color: var(--success-color);
-    color: white;
-    text-decoration: none;
-    border-radius: 0.375rem;
-    font-weight: 500;
-    transition: background-color 0.3s;
-}
-
-.download-btn:hover {
-    background-color: #059669;
-}
-
-footer {
-    text-align: center;
-    margin-top: 4rem;
-    color: var(--text-secondary);
-}
-
-footer a {
-    color: var(--primary-color);
-    text-decoration: none;
-}
-
-footer a:hover {
-    text-decoration: underline;
-}
-
-/* Responsive */
-@media (max-width: 640px) {
-    .container {
-        padding: 1rem;
-    }
-    
-    header h1 {
-        font-size: 2rem;
-    }
-    
-    .options-grid {
-        grid-template-columns: 1fr;
-    }

interfaces/web/templates/index.html

@@ -1,69 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Video to Audio Extractor</title>
-    <link rel="stylesheet" href="/static/style.css">
-</head>
-<body>
-    <div class="container">
-        <header>
-            <h1>🎵 Video to Audio Extractor</h1>
-            <p>Convert your videos to high-quality audio files</p>
-        </header>
-        
-        <main>
-            <div class="upload-section">
-                <form id="extractionForm">
-                    <div class="file-input-wrapper">
-                        <input type="file" id="videoFile" accept="video/*" required>
-                        <label for="videoFile" class="file-input-label">
-                            <svg class="upload-icon" viewBox="0 0 24 24">
-                                <path d="M9 16h6v-6h4l-7-7-7 7h4v6zm-4 2h14v2H5v-2z"/>
-                            </svg>
-                            <span>Choose video file or drag and drop</span>
-                        </label>
-                        <div class="file-info" id="fileInfo"></div>
-                    </div>
-                    
-                    <div class="options-grid">
-                        <div class="form-group">
-                            <label for="outputFormat">Output Format</label>
-                            <select id="outputFormat" required>
-                                <option value="mp3" selected>MP3 - Most Compatible</option>
-                                <option value="aac">AAC - Better Quality</option>
-                                <option value="wav">WAV - Uncompressed</option>
-                                <option value="flac">FLAC - Lossless</option>
-                                <option value="m4a">M4A - Apple Format</option>
-                                <option value="ogg">OGG - Open Format</option>
-                            </select>
-                        </div>
-                        
-                        <div class="form-group">
-                            <label for="quality">Quality</label>
-                            <select id="quality" required>
-                                <option value="high">High - Best Quality</option>
-                                <option value="medium" selected>Medium - Balanced</option>
-                                <option value="low">Low - Smaller Size</option>
-                            </select>
-                        </div>
-                    </div>
-                    
-                    <button type="submit" class="submit-btn" id="submitBtn">
-                        Extract Audio
-                    </button>
-                </form>
-            </div>
-            
-            <div class="result-section" id="resultSection"></div>
-        </main>
-        
-        <footer>
-            <p>Powered by FFmpeg | <a href="/api/v1/info">API Documentation</a></p>
-        </footer>
-    </div>
-    
-    <script src="/static/script.js"></script>
-</body>
-</html>

requirements.txt

@@ -10,8 +10,5 @@ pydantic-settings==2.1.0
 aiofiles==23.2.1
 ffmpeg-python==0.2.0
 
-# Web Interface
-jinja2==3.1.2
-
 # Utilities
 python-dotenv==1.0.0