Files
ds-galo/openspec/changes/sqlite-metadata-backend/proposal.md
T
iu 176a8d8ced feat(metadata): SQLite backend, storage reconciliation and local defaults
- pluggable per-domain Repository interfaces; PostgreSQL and SQLite impls
- SQLite on modernc.org/sqlite (WAL, busy_timeout, foreign_keys, immediate tx)
- separate migrations/sqlite and db.MigrateSQLite; store.NewPostgres/NewSQLite
- cmd/reconcile compares object storage with the journal (report, then --delete)
- storage.Backend.List and photos.Repository.AllStorageKeys
- DB_BACKEND/SQLITE_PATH and STORAGE_BACKEND/FS_ROOT selectable; local defaults
  (sqlite ./galo.db, fs ./data)
- Makefile reconcile/reconcile-delete; docs and .env.example updated
2026-10-11 10:08:31 +03:00

2.5 KiB

Proposal

Why

Слой метаданных жёстко привязан к PostgreSQL: каждый store держит *pgxpool.Pool и пишет SQL диалекта Postgres. Инсталляциям без внешней БД нужен встроенный, самодостаточный режим на SQLite с паритетом поведения для одного экземпляра приложения.

What Changes

  • Ввести интерфейсы репозиториев по доменам (auth, albums, members, photos, social, notifications, sharelinks); существующие pgx-типы становятся одной из реализаций.
  • Добавить SQLite-реализации (~72 метода, включая жизненный цикл объектов, сборку мусора и очередь вариантов) на чистом Go (modernc.org/sqlite, CGO_ENABLED=0).
  • Добавить отдельный набор миграций для SQLite.
  • Ввести DB_BACKEND=postgres|sqlite и SQLITE_PATH; валидировать условно; настроить WAL, busy_timeout, foreign_keys.
  • Добавить фабрику сборки репозиториев по выбранному бэкенду.
  • Обеспечить единый контрактный набор тестов, прогоняемый на обоих бэкендах.

Capabilities

New Capabilities

  • metadata-backends: выбор и работа слоя метаданных — PostgreSQL и встроенная SQLite с паритетным поведением для одного экземпляра.

Modified Capabilities

Impact

  • backend/internal/*/store.go и backend/internal/photos/objects.go (интерфейсы + SQLite-реализации), internal/db, internal/app, cmd/server, config, migrations.
  • Тесты: общий контрактный набор для Postgres и SQLite.
  • .env.example, project.md.
  • Ограничение: один экземпляр приложения на один SQLite-файл (без горизонтального масштабирования); Postgres остаётся поведением по умолчанию.
  • Не затрагивает слой хранения.