wip on autotagging

backend/database/sql/schemas/release_groups.sql

@@ -3,7 +3,18 @@ CREATE TABLE IF NOT EXISTS release_groups (
   name                   TEXT NOT NULL,
   cover_art_id           INTEGER,
   album_artist_credit_id INTEGER,
+  -- year is the *technical release year* of the album as it lives
+  -- in the user's library — typically the file's ID3 year tag,
+  -- which for remasters/reissues is the reissue year.
   year                   INTEGER,
+  -- original_year is the album's *first-release-date* year sourced
+  -- from MusicBrainz' release-group.first-release-date.  For a 2010
+  -- remaster of a 1973 album, year=2010 and original_year=1973.
+  -- Populated by autotag apply; NULL until the user accepts a
+  -- candidate (or for libraries that have never been autotagged).
+  -- Reads should COALESCE(original_year, year) to get the
+  -- preferred user-facing year.
+  original_year          INTEGER,
   total_tracks           INTEGER,
   total_discs            INTEGER,
   mbid                   TEXT,