cloud/music_library
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update AGENTS.md with latest architecture and feature changes

Browse Source
This commit is contained in:
Claudio Ortolina
2025-10-12 22:06:45 +02:00
parent 61ee5693ab
commit 0e80bf8ba1
1 changed files with 8 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+8 -2
View File
@@ -17,6 +17,8 @@ Music Library is an Elixir/Phoenix application for managing a personal music col
- Assets management with image transformation and caching - Assets management with image transformation and caching
- Color extraction from album artwork - Color extraction from album artwork
- Some basic stats (top albums, top artists, collection insights) - Some basic stats (top albums, top artists, collection insights)
- Universal search across collection, wishlist, and artists
- Similar records discovery using AI-powered embeddings (using SQLite vector extension)
- All data stored in a single SQLite database for portability and ease of backup/restore - All data stored in a single SQLite database for portability and ease of backup/restore
## Development Setup ## Development Setup
@@ -143,6 +145,7 @@ Key tables and schemas:
- `artist_infos` table stores additional artist metadata (bio, images, etc.) - `artist_infos` table stores additional artist metadata (bio, images, etc.)
- `artist_records` view provides normalized artist-record relationships - `artist_records` view provides normalized artist-record relationships
- `records_search_index` virtual FTS5 table for efficient full-text searching - `records_search_index` virtual FTS5 table for efficient full-text searching
- `record_embeddings` table stores AI-generated embeddings for similarity search (uses sqlite-vec extension)
- `scrobble_rules` table for managing Last.fm scrobble data corrections - `scrobble_rules` table for managing Last.fm scrobble data corrections
- `online_store_templates` table for external store URL templates - `online_store_templates` table for external store URL templates
- `notes` table for custom record annotations - `notes` table for custom record annotations
@@ -157,10 +160,11 @@ Tables are synchronized with triggers, and multiple indices exist for performanc
The application follows standard Phoenix/Elixir structure: The application follows standard Phoenix/Elixir structure:
- `lib/music_library`: Core application logic - `lib/music_library`: Core application logic
- `records/`: Record and collection management (includes batch operations, search parsing) - `records/`: Record and collection management (includes batch operations, search parsing, embeddings, similarity)
- `artists/`: Artist data handling and artist info management - `artists/`: Artist data handling and artist info management
- `collection.ex`: Collection-specific functionality - `collection.ex`: Collection-specific functionality
- `wishlist.ex`: Wishlist-specific functionality - `wishlist.ex`: Wishlist-specific functionality
- `search.ex`: Universal search across collection, wishlist, and artists
- `scrobble_activity.ex`: Last.fm scrobble tracking and activity - `scrobble_activity.ex`: Last.fm scrobble tracking and activity
- `scrobble_rules/`: Rules for correcting scrobble data - `scrobble_rules/`: Rules for correcting scrobble data
- `barcode_scan/`: Barcode scanning features - `barcode_scan/`: Barcode scanning features
@@ -173,13 +177,14 @@ The application follows standard Phoenix/Elixir structure:
- `fetch_artist_image.ex`, `fetch_artist_info.ex`, `prune_artist_info.ex` - `fetch_artist_image.ex`, `fetch_artist_info.ex`, `prune_artist_info.ex`
- `record_refresh_music_brainz_data.ex`, `refresh_cover.ex` - `record_refresh_music_brainz_data.ex`, `refresh_cover.ex`
- `extract_colors.ex`, `populate_genres.ex` - `extract_colors.ex`, `populate_genres.ex`
- `generate_record_embedding.ex`: Generate AI embeddings for similarity search
- `apply_scrobble_rules.ex`, `prune_asset_cache.ex` - `apply_scrobble_rules.ex`, `prune_asset_cache.ex`
- External API integrations: - External API integrations:
- `lib/music_brainz`: MusicBrainz API client (primary metadata source) - `lib/music_brainz`: MusicBrainz API client (primary metadata source)
- `lib/discogs`: Discogs API client - `lib/discogs`: Discogs API client
- `lib/last_fm`: Last.fm API client (scrobbles, artist info) - `lib/last_fm`: Last.fm API client (scrobbles, artist info)
- `lib/open_ai`: OpenAI API client (genre population) - `lib/open_ai`: OpenAI API client (genre population, embeddings generation)
- `lib/music_library_web`: Web interface (Phoenix) - `lib/music_library_web`: Web interface (Phoenix)
- `live/`: LiveView implementations - `live/`: LiveView implementations
@@ -193,6 +198,7 @@ The application follows standard Phoenix/Elixir structure:
- `record_components.ex`, `artist_components.ex`, `scrobble_components.ex` - `record_components.ex`, `artist_components.ex`, `scrobble_components.ex`
- `search_components.ex`, `stats_components.ex`, `chart_components.ex` - `search_components.ex`, `stats_components.ex`, `chart_components.ex`
- `barcode_scanner.ex`, `notes.ex`, `pagination.ex` - `barcode_scanner.ex`, `notes.ex`, `pagination.ex`
- `record_form.ex`, `add_record.ex`, `release.ex`
- `controllers/`: Traditional Phoenix controllers - `controllers/`: Traditional Phoenix controllers
- `collection_controller.ex`: Collection export endpoints - `collection_controller.ex`: Collection export endpoints
- `asset_controller.ex`: Asset serving - `asset_controller.ex`: Asset serving