Files
mtusi2026lab2/openspec/changes/track2-backup-restore/tasks.md
T
2026-10-02 07:45:26 +03:00

6.4 KiB
Raw Blame History

Tasks

Как строить — design.md (дальше «решение N»), что должно получиться — дельта specs/load-benchmark/spec.md. Правило слоя — bench.md. Замер для отчёта — с закоммиченного кода. Код приложения, миграции, контракт и student-tests/ не меняются. Рабочий стенд (mtusi-lab2) не трогать.

1. Профили и команды

  • 1.1 Поля Profile (restore, restore_jobs, restore_write_load, restore_write_vus), профили restore и restore_quick (решение 1), цели bench_restore и bench_restore_quick в Makefile. Проверка: make -n bench_restore bench_restore_quick печатает команды, uv run python -c с импортом run.py показывает у restore пустую concurrency и фон full.

2. Второе хранилище

  • 2.1 Stand.start_restore() и уборка в Stand.stop() (решение 3):

    • образ исходного контейнера, сеть и алиас;
    • пароль через --env без значения;
    • лимиты, volume и метка проекта.

    Проверка: на коротком прогоне docker inspect контейнера восстановления показывает лимиты 4 CPU / 3 ГБ и метку проекта, а ps хоста — docker run без пароля в аргументах. После прогона и после Ctrl+C посреди этапа нет контейнеров и volume mtusi-bench*.

3. Этап backup и восстановления

  • 3.1 after_backup.js и restore_check.js с фазами source, stale, restored (решения 2, 5). Итоги — в .work/, без токенов. Проверка: grep значений токенов из .work/ по каталогу метки пуст.

  • 3.2 Этап в run.py (решения 2–5):

    • ids_before и число строк;
    • запись в фоне, pg_dump после начала записи;
    • активность после backup;
    • восстановление со временем шагов;
    • сверка БД;
    • переключение API;
    • проверки HTTP до и после FLUSHALL.

    Расхождение — BenchError с размером. Проверка на коротком прогоне:

    • потерянные сообщения > 0 и только из чата записи и чата «после backup»;
    • mismatched = 0;
    • сессия «после backup» — 401, после FLUSHALL — 404;
    • временно испорченное ожидание числа строк (правка, не коммитить) — отказ с размером, оба хранилища убраны.
  • 3.3 meta.sizes[].restore и раздел «Backup и восстановление» в summary.md (решение 6). Проверка: раздел короткого прогона заполнен по всем размерам.

4. Проверка и коммит кода

  • 4.1 make lint без замечаний. make bench_quick --dry-run (make -n bench_quick) печатает команду: профили full и quick этап восстановления не включают.

  • 4.2 make bench_restore_quick целиком: код 0, сверка проходит на всех размерах, файла backup нет ни в каталоге метки, ни в .work/. Записать время прогона.

  • 4.3 .claude/rules/bench.md: этап восстановления в «Что не меняется» и новые исключения границы чёрного ящика (решение 7). AGENTS.md: команды bench_restore*, карта кода (after_backup.js, restore_check.js). Проверка: grep -n "bench_restore" AGENTS.md находит строки.

  • 4.4 Закоммитить (feat: add backup and restore stage to bench). Проверка: git status чистый.

  • 4.5 Защита от сна хоста (решение 9): caffeinate -isu в целях bench* Makefile, если команда есть; предупреждение host_warnings и host_state.slept_seconds в run.py при разнице реального и монотонного времени больше 5 с; строка в bench.md («Результаты»). Проверка: make -n bench_restore печатает caffeinate -isu; на коротком прогоне slept_seconds около 0 и предупреждения нет. Закоммитить (fix: keep the host awake during bench runs).

5. Замер и отчёт

  • 5.1 Записать в REPORT.md гипотезы R1–R5 (решение 8) до замера и закоммитить (docs: record track 2 backup and restore hypotheses).

  • 5.2 Подготовить хост и запустить make bench_restore. Проверка:

    • код 0, status: complete, dirty: false, без host_warnings;
    • сверка прошла на 10k, 100k и 500k.
  • 5.3 Закоммитить evidence/bench/restore/ (docs: add track 2 backup and restore evidence).

  • 5.4 REPORT.md, трек 2, часть 2:

    • процедура восстановления по шагам, включая FLUSHALL;
    • сверка;
    • время по размерам и RTO;
    • RPO и способы его сузить;
    • итог по R1–R5;
    • ограничения.

    Строка «Трек 5 №2, часть 2» в таблице доказательств и сценарий защиты (make bench_restore_quick). В разделе «Кэш Valkey» — ссылка на результат. В AGENTS.md закрыть «Переходное состояние» трека 2 и пункт FLUSHALL. Проверка: каждое число есть в summary.md или meta.json метки restore.

  • 5.5 Закоммитить отчёт (docs: report track 2 backup and restore). openspec validate track2-backup-restore --strict проходит, git status чистый.