How 12mv2/harmony works
Main System Components
a. Frontend Layer (React Application)
• Located in /src/components and /src/pages
• Components for audio recording, playback, and user authentication
• Connection to backend via API calls
b. Backend Server Layer (Node.js/Express)
• Located in /src/server
• Controllers, routes, and middleware
• Connection to both database and ML service
c. ML Service Layer (Python)
• Located in /ml_service
• OpenMusicLM model architecture
• Audio processing pipeline
Detailed Component Breakdown
• AudioRecorder
• AudioPlayer
• UserVoice
• Authentication pages (Login/Register)
• Studio page
• API Router
• Controllers (Audio & Auth)
• Middleware
• Database connection
• File storage system
• FastAPI service
• Model components (CLAP, HuBERT, EnCodec)
• Input/Output processors
• User interaction flow (recording → processing → playback)
• API requests between frontend and backend
• File transfers for audio processing
• Database operations
• ML service communication
Integration Points
Integration points with external services:
• Supabase database connection
• File storage system
• Authentication service
Technical Stack Indicators
Technology labels:
• Frontend: React, TypeScript, Tailwind CSS
• Backend: Node.js, Express
• ML Service: Python, FastAPI, OpenMusicLM
• Database: Supabase
• Testing: Jest
Specific Implementation Details
• Audio processing pipeline
• ML model architecture
• Data persistence flow
• Authentication flow
[Client Layer]
• ↕ HTTP/WebSocket
[Backend Layer]
• ↕ HTTP/REST
[ML Service Layer]
• ↕
[Database/Storage Layer]
Additional Elements
Include:
• Version information
• System requirements
• Key dependencies