How metabrainz/musicbrainz-server works
MusicBrainz Server is the web frontend for a community-maintained music metadata database. A browser request enters the clustered Node server, is dispatched to a page or domain route, reads or updates PostgreSQL-backed metadata, and returns a shared React-rendered layout. Major domain stages include catalog browsing, identifiers and relationships, community editing, account management, administration, reporting, and statistics. The graph uses sampled entry, layout, home, statistics, ISRC, and table code; several route-to-database links reflect the README’s documented frontend/database boundary rather than inspected handler implementations.
Main entry points: server.mjs Node Server · index.js Shared Layout · entity Entity Pages · Index.js Database Statistics
Components 22
Runtime Entry
- Node Server
root/server.mjs
Web Presentation
- Shared Layout
root/layout/index.js - UI Components
root/components - Home Page
root/main/index.js
Music Catalog
- Entity Pages
root/entity - Artist Catalog
root/artist - Release Catalog
root/release - Recording Catalog
root/recording - Identifier Lookup
root/isrc/Index.js - Entity Relationships
root/relationship
Community Contribution
- Edit Workflow
root/edit - Annotations
root/annotation - User Accounts
root/account - OAuth Access
root/oauth2
Operations And Insights
- Administration
root/admin - Quality Reports
root/report - Database Statistics
root/statistics/Index.js - User Collections
root/collection - CD Identification
root/cdstub - Disc ID Matching
root/cdtoc
Other components
- Browser User
- MusicBrainz Database
Connections 31
- Browser User → Node Server: sends requests
- Node Server → Home Page: dispatches
- Node Server → Entity Pages: dispatches
- Node Server → Edit Workflow: dispatches
- Node Server → User Accounts: dispatches
- Node Server → Database Statistics: dispatches
- Node Server → Administration: dispatches
- Home Page → Shared Layout: renders
- Entity Pages → Shared Layout: renders
- Artist Catalog → Shared Layout: renders
- Release Catalog → Shared Layout: renders
- Recording Catalog → Shared Layout: renders
- Identifier Lookup → Shared Layout: renders
- Database Statistics → Shared Layout: renders
- Shared Layout → UI Components: renders
- Entity Pages → MusicBrainz Database: reads metadata
- Artist Catalog → MusicBrainz Database: reads metadata
- Release Catalog → MusicBrainz Database: reads metadata
- Recording Catalog → MusicBrainz Database: reads metadata
- Identifier Lookup → MusicBrainz Database: reads identifiers
- Entity Relationships → MusicBrainz Database: reads and writes
- Edit Workflow → MusicBrainz Database: writes edits
- Annotations → MusicBrainz Database: writes annotations
- User Accounts → MusicBrainz Database: reads and writes
- OAuth Access → User Accounts: authorizes access
- Administration → MusicBrainz Database: writes administration
- Quality Reports → MusicBrainz Database: reads metadata
- Database Statistics → MusicBrainz Database: reads counts
- User Collections → MusicBrainz Database: reads and writes
- CD Identification → MusicBrainz Database: reads releases
- Disc ID Matching → MusicBrainz Database: matches disc IDs