- carry the lab 2 solution over and plan lab 3 (PLAN.md, OpenSpec change instance-id-idempotency) - rename the compose project to mtusi-lab3 and the image to :lab3 - add X-Instance-Id to every response and instance_id to every log record ([app] instance_id, hostname by default) - require Idempotency-Key on POST messages: keys table in Postgres, key and message in one transaction, replay returns the same 201, another body gets 409, TTL from [idempotency] ttl_seconds - send the key from student-tests, k6 scenarios and the skill driver; add idempotency, X-Instance-Id, key race and fault tests Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.7 KiB
Proposal
Why
Уровень «4» требует обосновать индекс истории запросом и
EXPLAIN (ANALYZE, BUFFERS) на ≥10 000 сообщениях и показать, что
пагинация не просматривает всю историю на каждую страницу (README.md).
Наполнить такую историю и снять план должен нагрузочный стенд bench/,
но он перенесён из лабы 1 и на коде лабы 2 не работает:
run.pyподнимает только контейнер API, без PostgreSQL, Valkey и миграций;- сценарии k6 ходят с
X-User-Id, которого API больше не принимает; inproc.pyсобирает приложение над удалённымMemoryStore.
Трек «5» №2 (track2-query-plans, track2-backup-restore) тоже стоит
на этом стенде: сравнение индексов и стоимости записи — это метки
make bench, а метки лабы 1 сюда не переносились. Поэтому сначала
стенду нужны базовый замер на PostgreSQL и план запроса истории.
What Changes
-
Стенд на PostgreSQL.
make benchподнимает свой проект composemtusi-benchиз того жеdocker-compose.ymlс override:- PostgreSQL и Valkey с теми же пинами и конфигурацией, что у рабочего стенда, со своими лимитами CPU и памяти;
- миграции до наполнения;
- API с прежними лимитами (1 CPU, 2 ГБ без swap);
- без портов на хосте, без
.envиconfig.tomlрабочего стенда.
Каждый размер истории начинается со свежего стенда: новый volume Postgres, новые Valkey и API. Рабочий стенд, его база и кэш не затрагиваются.
-
Идентификация как в контракте. Сценарии k6 регистрируют пользователей с паролем, входят по Basic и шлют Bearer. Срок сессии стенда больше длительности размера.
-
Обслуживание БД перед замером. После наполнения —
VACUUM (ANALYZE)иCHECKPOINT: статистика планировщика и состояние таблицы одинаковы у всех меток. -
План запроса истории. На каждом размере стенд снимает
EXPLAIN (ANALYZE, BUFFERS)того запроса страницы истории, который выполняет само приложение (auto_explainв Postgres стенда), для первой, средней и последней страницы. Для сравнения снимается тот же запрос без использованного индекса, в транзакции, которая откатывается. Планы лежат в каталоге метки, сводка — вsummary.md. -
Метрики хранилища. Новые столбцы в конце таблиц: CPU контейнера Postgres на прогон и порцию наполнения. На размер — объём таблицы и индексов
messagesи байты на сообщение. В паспорт идут образы, версии, лимиты и настройки Postgres и Valkey, а также окружение API без секретов. Пароли стенда генерируются на прогон и никуда не пишутся. -
BREAKING (инструменты стенда): удаляются
bench/inproc.pyи цельmake bench_inproc. Разложение времени внутри процесса было инструментом трека 1 лабы 1. На PostgreSQL время запроса уходит в основном в БД, и его объясняет план запроса.make bench_abснимает только стенд. -
make bench_compareпроверяет методику по лимитам всех контейнеров, образам и настройкам Postgres и Valkey. Таблица памяти показывает байты на сообщение в БД. -
Матрица короче, чем на лабе 1: размеры 10k, 100k и 500k вместо 1M, порция наполнения 25 000 вместо 50 000. Полный прогон — около 30 минут вместо 45. 500k ≥ 100k трека 2 и ≥ 10k уровня 4.
-
Базовый замер
baselineполной матрицы на закоммиченном коде. По нему вREPORT.mdпишутся раздел экспериментов и строка уровня 4 «индекс истории и EXPLAIN».
Capabilities
New Capabilities
Нет.
Modified Capabilities
load-benchmark:- изменённые требования:
- стенд из API, PostgreSQL и Valkey с миграциями, лимитами и свежим volume на каждый размер;
- матрица: наибольший размер 500 000 вместо 1 000 000;
- идентификация Bearer в сценариях;
- обслуживание БД после наполнения;
- метрики Postgres;
- паспорт со сведениями о хранилищах;
- пометка прогона при падении хранилища;
- проверка методики в сравнении меток;
- прогоны «до/после» без разложения;
- базовый замер на PostgreSQL;
- новое требование: план запроса истории;
- удалено требование: «Разложение стоимости запроса».
- изменённые требования:
Impact
- Код стенда:
bench/run.py— стенд через compose, обслуживание БД, план, метрики, паспорт;- новый
bench/bench.compose.yml, новыйbench/bench.env; bench/k6/—lib.js,prepare.js, сценарии, новыйexplain.js;bench/compare.py,bench/ab.py;- удаляется
bench/inproc.py.
- Makefile: цели
bench*, удаляетсяbench_inproc. - Код приложения (
src/), миграции, контракт и тесты не меняются. - Документация:
.gitignore(строкиevidence/profile);.claude/rules/bench.md— раздел «Что доработать» закрывается, «Что не меняется между метками» пополняется параметрами хранилищ, раздел о диагностике удаляется;AGENTS.md— команды, карта кода, переходное состояние;REPORT.md— эксперименты, уровень 4, ограничения.
- Доказательства:
evidence/bench/baseline/, включаяexplain-<размер>.txt. - Время хоста: полная матрица на PostgreSQL — около 30 минут (оценка
по скоростям
make bench_quick). Запуск — только с согласия пользователя и после подготовки хоста (bench.md, «Результаты»).