Идентичность на ULID: download_infohash, guarded-дедуп, миграция (ulid-identity)

Все сущности переехали с INTEGER AUTOINCREMENT на TEXT ULID (lowercase,
internal/ident — единая точка генерации и разбора; oklog/ulid). Инфохэши
загрузки — множество (download_infohash, v1/v2 гибридных торрентов): дедуп
и сопоставление в поллинге по любому из хешей, magnet-парсер отдаёт оба
хеша гибридной ссылки, усечённый v2-хеш v2-only раздач не хранится.

Инвариант «не более одной активной загрузки на infohash» вместо снятого
unique-индекса держат guarded-методы store в одной write-транзакции
(_txlock=immediate): CreateDownloadIfNoActive (приём/adopt, с доносом
недостающих хешей), ActivateIfNoOtherActive (retry/recovery/relink, отказ
до побочных эффектов), guarded AddInfohashes; SetDownloadState отклоняет
терминал→активное как механический бэкстоп.

Миграция 0006 — первая Go-миграция goose: пересоздание таблиц при
включённых FK, backfill ULID с timestamp из created_at (хронология id
сохранена), разнос infohash, удаление idempotency_key. BREAKING: формат id
в URL/логах/Telegram, REST-поля id (string) и infohashes (список).

Новая конвенция docs/conventions/database.md (без числовых PK), корреляция
в логах grep'ом по голому ULID, ER-схема обновлена. Спеки: новая capability
identity, MODIFIED в state-reconciliation; change заархивирован. Пройдены
ревью дизайна и кода (по 8 углов), все находки исправлены с
регрессионными тестами.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

This commit is contained in:

2026-07-02 21:25:00 +03:00

co-authored by

Claude Fable 5

parent b808ceff25

commit 37f2f6481a

53 changed files with 3640 additions and 1035 deletions

									
										go.mod
									
		+1
		
												View File
												
				@@ -7,6 +7,7 @@ require (

					github.com/go-telegram-bot-api/telegram-bot-api/v5 v5.5.1

					github.com/jmoiron/sqlx v1.4.0

					github.com/middelink/go-parse-torrent-name v0.0.0-20190301154245-3ff4efacd4c4

					github.com/oklog/ulid/v2 v2.1.1

					github.com/pelletier/go-toml/v2 v2.2.3

					github.com/pressly/goose/v3 v3.22.1

					modernc.org/sqlite v1.34.1