sonda/migrations/sqlite/0013_images.sql
tgiachi 7bdbc9e160 fix(images): limit parallel builds, no stale saves, safer files
- At most two covers are built at the same time: a page of albums asked for at once
  could decode dozens of large pictures together.
- A change to an album's files marks its record stale and moves a generation instead
  of deleting the row. A build that started before the change is not saved over it
  and starts again, so a "no cover" found too early cannot win for a day.
- A cover that was found is checked again after a week, so a picture replaced in a
  folder is noticed.
- For CD1/Disc 2 folders the picture in the folder above is used. Folder pictures
  are read one at a time, and the pixel count is computed in 64 bits.
- Stored files are synced before they get their name, an empty one counts as
  missing, and old temporary files from a crash are removed.
- Files without track or disc numbers sort the same on both databases.
- storage.data_dir defaults next to the SQLite database, so a service started from
  another folder does not need a writable working directory.
- Tests: a listener who leaves, a change during a build, the build limit, a named
  pipe, an embedded picture of a file outside the library that exists, builds that
  really overlap.
2026-11-11 21:03:26 +01:00

21 lines
1.1 KiB
SQL

-- What is known about the picture of an album (and, later, an artist). The picture
-- itself is a file in the data folder; this row says whether one was found, where it
-- came from, and when the files were last searched, so a search that found nothing
-- is not repeated at every request.
--
-- Nothing points at the albums table on purpose. When a file of an album changes, the
-- code that saves it marks the row 'stale' and bumps gen; a build that started before
-- the change is not saved over it.
CREATE TABLE images (
kind TEXT NOT NULL, -- 'album'
owner_id INTEGER NOT NULL,
status TEXT NOT NULL CHECK (status IN ('ok', 'none', 'stale')),
source TEXT NOT NULL DEFAULT '', -- 'embedded', 'folder'
etag TEXT NOT NULL DEFAULT '',
width INTEGER NOT NULL DEFAULT 0, -- of the original
height INTEGER NOT NULL DEFAULT 0,
checked_at INTEGER NOT NULL, -- unix seconds
gen INTEGER NOT NULL DEFAULT 0, -- counts the changes of the owner's files since the record was made
PRIMARY KEY (kind, owner_id)
);