Album

The release container. Every Track belongs to exactly one Album — a single is just an Album with one track. The Album owns release metadata, copyright, AI disclosure, label affiliation, cover artwork and contributor credits.

1 Full schema

Album inherits from BaseModel (Id, CreatedAtUtc, UpdatedAtUtc) and is mapped to the albums table.

public class Album : BaseModel
{
    public required string Title { get; set; }

    public AlbumStatus Status { get; set; } = AlbumStatus.Draft;
    public DateTime? PublishedAtUtc { get; set; }

    public ICollection<Artist> Artists { get; set; } = [];
    public ICollection<Track>  Tracks  { get; set; } = [];

    // Editorial content
    public string? Description { get; set; }
    public string? EditorialNotes { get; set; }
    public string  DefaultLocale { get; set; } = "en";

    // Type / format
    public ReleaseType Type { get; set; } = ReleaseType.Single;

    // Dates
    public DateTime ReleaseDate { get; set; }
    public DateTimePrecision ReleaseDatePrecision { get; set; } = DateTimePrecision.Year;
    public DateTime? OriginalReleaseDate { get; set; }
    public bool IsReissue { get; set; }

    // Denormalized
    public int TotalTracks { get; set; }

    // Copyright
    public int?    PLineYear { get; set; }
    public string? PLineHolder { get; set; }
    public int?    CLineYear { get; set; }
    public string? CLineHolder { get; set; }

    // AI disclosure
    public bool AiGenerated { get; set; } = true;
    public AiDisclosureLevel AiDisclosure { get; set; } = AiDisclosureLevel.FullyAiGenerated;
    public string? AiToolUsed { get; set; }
    public string? HumanContributionDescription { get; set; }

    // Label
    public Guid?  LabelId { get; set; }
    public Label? Label { get; set; }

    // Identifiers
    public string? Upc { get; set; }
    public string? CatalogNumber { get; set; }

    // Cover meta
    public Guid? PrimaryCoverImageId { get; set; }
    public AlbumImage? PrimaryCoverImage { get; set; }
    public string? DominantColor { get; set; }
    public string? PaletteJson { get; set; }

    // Type-specific optionals
    public string? VenueName { get; set; }
    public DateTime? RecordedAtUtc { get; set; }
    public string? RelatedTitle { get; set; }
    public Guid?  OriginalReleaseId { get; set; }
    public Album? OriginalRelease { get; set; }

    // Additional navigations
    public ICollection<AlbumImage>       Images       { get; set; } = [];
    public ICollection<AlbumContributor> Contributors { get; set; } = [];
    public ICollection<Mood>             Moods        { get; set; } = [];
}

2 Identity & status

3 Editorial

4 Type & dates

5 Commercial & identifiers

Copyright fields here are the defaults for the album's tracks. A Track may override any of them via its *Override fields — see Track · Commercial.

6 AI disclosure

Beatix is an AI-music platform, so AI provenance is first-class metadata. By default a new album is treated as fully AI-generated.

7 Cover & artwork

The actual image files and their resized variants live in AlbumImage rows. The image generation and format strategy is documented in docs/image-format-strategy.md.

8 Type-specific fields

These optionals are only meaningful for certain ReleaseType values. They are nullable and ignored otherwise.

9 Enums

AlbumStatus

ReleaseType

DateTimePrecision

AiDisclosureLevel

10 AlbumContributor

A rich association between an Album and an Artist, carrying a credit role. This is album-level credits; track-level credits use the parallel TrackContributor.

11 AlbumImage

A single resized variant of an album's artwork. An album has one AlbumImage row per (Variant, Size) pair. AlbumImage implements the shared IImageVariantRecord interface.

12 Relationships