How kagemomiji/airsonic-advanced works
Main Components Overview
The system should be divided into these primary components:
a. Core Application Layer:
• Spring Boot Application (Application.java)
• Configuration Management
• Security Framework
• Database Layer
b. Service Layer:
• Media Management Services
• Streaming Services
• User Management Services
• Playlist Management
• Podcast Services
• Transcoding Services
c. External Integrations:
• Last.fm Integration
• Sonos Integration
• Chromecast Support
• DLNA/UPnP Support
Detailed Component Breakdown
a. Web Interface:
• REST Controllers (SubsonicRESTController)
• WebSocket Controllers
• MVC Controllers
• Static Resources (CSS/JS/Images)
b. Media Processing:
• Scanner Service
• Transcoding Engine
• Cover Art Management
• Metadata Processing
c. Storage:
• File System Integration
• Database (Multiple DB Support)
• Cache Management
Data Flow Representation
Following interactions:
• Client requests → Web Layer → Service Layer → Storage Layer
• Media Scanning Flow
• Streaming Pipeline
• Authentication Flow
• WebSocket Communication
• Blue: Core Application Components
• Green: External Services
• Orange: Security Components
• Purple: Media Processing
• Gray: Storage Systems
• Rectangles: Services/Components
• Hexagons: External Systems
• Clouds: Third-party Services
Key Architectural Elements to Highlight
a. Modern Features:
• Websocket Communication
• Parallel Processing
• Caching Mechanism
• Security Implementation
b. Integration Points:
• External Authentication
• Media Players Support
• Scrobbling Services
• Streaming Protocols
Security Layer
Include:
• Authentication Flow
• Credential Management
• Session Handling
• REST API Security
This design should reflect Airsonic-Advanced's improvements over the original Airsonic, particularly in areas of performance, security, and modern web technologies.