Track

The core entity representing a publishable audio recording. Every Track belongs to one Album and carries editorial, commercial and legal metadata, plus references to artists, genres, moods and the processing artifacts (HLS segments and jobs).

1 Full schema

The class inherits from BaseModel, which provides Id (Guid), CreatedAtUtc and UpdatedAtUtc. EF Core maps it to the tracks table in PostgreSQL.

public class Track : BaseModel
{
    // Identity
    public required string Title { get; set; }
    public required short Duration { get; set; }     // seconds

    public Guid AlbumId { get; set; }
    public Album Album { get; set; } = null!;

    public TrackStatus Status { get; set; } = TrackStatus.Queued;
    public DateTime? PublishedAtUtc { get; set; }
    public DateTime? DeletedAtUtc { get; set; }

    // Editorial
    public string? SortTitle { get; set; }
    public string? VersionQualifier { get; set; }
    public TrackVersionType VersionType { get; set; } = TrackVersionType.Original;
    public bool IsExplicit { get; set; }
    public ContentAdvisory ContentAdvisory { get; set; } = ContentAdvisory.NotRated;
    public Guid? CleanVersionOfTrackId { get; set; }
    public Track? CleanVersionOf { get; set; }
    public string? PrimaryLanguage { get; set; }
    public bool IsInstrumental { get; set; }
    public string? Lyrics { get; set; }

    // Commercial overrides (null = inherit from Album)
    public int?    PLineYearOverride { get; set; }
    public string? PLineHolderOverride { get; set; }
    public int?    CLineYearOverride { get; set; }
    public string? CLineHolderOverride { get; set; }
    public bool?   AiGeneratedOverride { get; set; }
    public string? Isrc { get; set; }

    // DMCA / legal
    public string?   TakedownReason { get; set; }
    public DateTime? TakedownAtUtc { get; set; }

    // Navigation (EF Core)
    public ICollection<Artist>            Artists      { get; set; } = [];
    public ICollection<TrackContributor> Contributors { get; set; } = [];
    public ICollection<Genre>             Genres       { get; set; } = [];
    public ICollection<Mood>              Moods        { get; set; } = [];
    public TrackAudioFeatures?           AudioFeatures{ get; set; }
    public ICollection<TrackSegment>      Segments     { get; set; } = [];
    public ICollection<TrackJob>          Jobs         { get; set; } = [];
}

2 Identity

3 Editorial

Metadata describing the version and content of the recording. Used by the catalog, search and display surfaces.

4 Commercial & identifiers

The *Override fields let a specific track diverge from its parent Album. When null, the value is inherited from the Album.

5 DMCA & legal

6 State machine (TrackStatus)

A track's lifecycle is driven by the TrackStatus enum. Valid transitions are exercised by the API and the Worker consumers.

7 Auxiliary enums

TrackVersionType

ContentAdvisory

8 Navigation properties

EF Core resolves these properties when they are pulled in via .Include(). By default they are not loaded (no lazy loading).

For the complete ER model, see Relationships.