Files
mtusi2026lab2/openspec/changes/track2-backup-restore/proposal.md
T
2026-10-02 05:17:41 +03:00

5.3 KiB
Raw Blame History

Proposal

Why

Вторая часть трека «5» №2 (README.md):

  • backup → восстановление в новое хранилище → сверка количества и выбранных сообщений;
  • обсуждение времени восстановления и границ потери данных.

Первая часть (track2-query-plans) готова, а без второй трек не закончен. Есть и долг из membership-cache. Карточки чатов в Valkey не инвалидируются: по контракту чат не меняется. Восстановление базы из backup это допущение ломает. В кэше остаются карточки чатов, созданных после снятия backup, и сервис отвечает на них из кэша, хотя в базе их нет. Требование chat-cache «кэш MUST NOT содержать карточку, которой нет в PostgreSQL» нарушается. Процедура восстановления обязана очищать кэш, и это нужно показать, а не только записать.

What Changes

  • Этап «backup и восстановление» стенда make bench. Включается профилем. В конце каждого размера, на тех же данных (≥110 000 сообщений в чатах разного размера):
    • backup pg_dump в формате custom, во время непрерывной записи через HTTP;
    • активность после backup: новый пользователь со своей сессией, новый чат и сообщение в нём;
    • восстановление pg_restore в новое хранилище: новый контейнер PostgreSQL с новым volume, тот же образ и лимиты;
    • сверка в БД:
      • число строк каждой таблицы;
      • каждое восстановленное сообщение совпадает с исходным по контрольной сумме;
      • потерянные сообщения — только записанные после начала backup;
    • переключение API на восстановленную базу и сверка через HTTP:
      • выбранные страницы истории совпадают с исходными;
      • прежняя сессия действует, сессия после backup — 401;
    • граница кэша:
      • до FLUSHALL чат, созданный после backup, отдаётся из кэша;
      • после FLUSHALL — 404.
  • Метрики восстановления в сводке и паспорте:
    • время и размер backup;
    • время восстановления, ANALYZE и готовности API;
    • время от начала восстановления до готовности API (RTO);
    • число потерянных сообщений и что именно потеряно (RPO).
  • Команды make bench_restore (профиль restore: 10k / 100k / 500k, без матрицы прогонов) и make bench_restore_quick (самопроверка и сценарий защиты, ~2 мин).
  • Отчёт. Трек 2, часть 2:
    • гипотезы до замера, процедура восстановления, результаты метки restore;
    • время восстановления и границы потери данных;
    • ограничения: логический backup без архивации WAL, один хост.

Capabilities

New Capabilities

Нет.

Modified Capabilities

  • load-benchmark: новые требования — этап backup и восстановления с проверками и метриками, команды запуска, восстановление в отчёте.

Impact

  • Код стенда:
    • bench/run.py: профили restore и restore_quick, этап восстановления, второй контейнер PostgreSQL и его уборка, переключение API, сверка, сводка;
    • bench/k6/: after_backup.js (активность после backup), restore_check.js (проверки через HTTP);
    • Makefile: цели bench_restore, bench_restore_quick.
  • Код приложения (src/), миграции, контракт, тесты не меняются.
  • Документация: .claude/rules/bench.md (граница чёрного ящика: pg_dump, pg_restore, FLUSHALL стенда), AGENTS.md (команды, карта кода, переходное состояние), REPORT.md.
  • Доказательства: evidence/bench/restore/. Сам backup в результаты не попадает: в нём хэши паролей и токенов. Он живёт в .work/ и удаляется в конце прогона.
  • Время хоста: make bench_restore ~20 минут: наполнение 910 000 сообщений и три восстановления.