User Guide¶

Technical documentation for developers working with the Music Attribution Scaffold.

Architecture¶

The scaffold implements a 5-pipeline architecture where data flows from raw sources to a user-facing application:

graph LR
    subgraph ETL["ETL Pipeline"]
        MB[MusicBrainz] --> NR[NormalizedRecord]
        DC[Discogs] --> NR
        AC[AcoustID] --> NR
        FM[File Metadata] --> NR
        AI[Artist Input] --> NR
    end

    subgraph ER["Entity Resolution"]
        NR --> ID[Identifier Match]
        ID --> SS[String Similarity]
        SS --> EM[Embedding Match]
        EM --> RE[ResolvedEntity]
    end

    subgraph AE["Attribution Engine"]
        RE --> AG[Aggregation]
        AG --> CF[Conformal Calibration]
        CF --> AR[AttributionRecord]
    end

    subgraph API["API Layer"]
        AR --> REST[REST API]
        AR --> MCP[MCP Server]
        AR --> AGUI[AG-UI Endpoint]
    end

Sections¶