How c4illin/convertx works
Main Components
a. Frontend Layer:
• Web Interface (React/TypeScript components in src/components)
• Static Assets (public directory)
• Client-side Scripts (public/script.js, public/results.js)
b. Backend Layer:
• Elysia Server (src/index.tsx)
• Authentication System (JWT-based)
• File Processing System
c. Converter Layer:
• Multiple Converter Services (src/converters/*)
• Format Normalization (src/helpers/normalizeFiletype.ts)
d. Storage Layer:
• File System Storage (/app/data volume)
• Database (for user management)
Client-Server Flow
• HTTP/HTTPS connections between client and server
• Authentication flow with JWT
• File upload/download paths
Converter Integration
• File routing to appropriate converters
• Parallel processing capabilities
• Result handling and delivery
┌─────────────────────────────────────────────────────────┐
• Client Layer │
• ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
• Web UI │ │ Static │ │ Browser │ │
• (React/TSX) │ │ Assets │ │ Scripts │ │
• ┘ └─────────────┘ └─────────────┘ │
• ┬───────────────────────────┘
┌─────────────────────────────▼───────────────────────────┐
• Server Layer │
• ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
• Elysia │ │ Auth │ │ File │ │
• Server │ │ System │ │ Handler │ │
• ┘ └─────────────┘ └─────────────┘ │
• ┬───────────────────────────┘
┌─────────────────────────────▼───────────────────────────┐
• Converter Layer │
• ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
• FFmpeg │ │ Pandoc │ │ Other │ │
• Converter │ │ Converter │ │ Converters │ │
• ┘ └─────────────┘ └─────────────┘ │
• ┬───────────────────────────┘
┌─────────────────────────────▼───────────────────────────┐
• Storage Layer │
• ┌─────────────┐ ┌─────────────┐ │
• File │ │ User DB │ │
• Storage │ │ │ │
• ┘ └─────────────┘ │
• ┘
Important Elements
• Docker container boundary
• Environment variable configuration points
• File format support for each converter
• Auto-deletion workflow
• Security boundaries
• Volume mounts
• Network interfaces