From 7fc911c332aefe33285ea9e7811c37abd9bb20a6 Mon Sep 17 00:00:00 2001 From: Artyom Date: Thu, 5 Nov 2026 21:41:47 +0300 Subject: [PATCH] Document SQLAlchemy migration checks and remaining evidence work --- AGENTS.md | 3 +- .../design.md | 47 ++++++++++++++----- .../proposal.md | 5 +- .../specs/lab2-persistent-storage/spec.md | 10 ++++ .../tasks.md | 43 ++++++++++++----- openspec/config.yaml | 6 +-- 6 files changed, 85 insertions(+), 29 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 77a367f0..035ec38d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -52,7 +52,8 @@ make down # остановка без удаления д ## Правила работы с репозиторием - Не менять и не ослаблять `contracts/`, `tests/`, `README.md`, `COURSE.md`, рубрику. Расхождение оформляется вопросом преподавателю. -- Код — `src/messenger/`, миграции — `src/messenger/migrations/NNNN_*.sql`, конфигурация LB и нагрузки — `infra/`, хуки и обвязка стенда — `scripts/`, собственные тесты — `student-tests/`, обезличенные доказательства — `evidence/` (индекс — `evidence/README.md`, первая строка каждого файла — дата и коммит прогона). +- Код — `src/messenger/`, миграции — `alembic/versions/*.py`, конфигурация LB и нагрузки — `infra/`, хуки и обвязка стенда — `scripts/`, собственные тесты — `student-tests/`, обезличенные доказательства — `evidence/` (индекс — `evidence/README.md`, первая строка каждого файла — дата и коммит прогона). +- PostgreSQL — SQLAlchemy 2.0 async (`async_sessionmaker`, `DeclarativeBase`); asyncpg только драйвер. ORM/Core остаются в инфраструктуре, домен — dataclass, pydantic — на HTTP-границе. Миграции — только `alembic upgrade head` в one-shot сервисе `migrate`. Старую схему принимает `alembic/legacy.py` после проверки журнала и каталога PostgreSQL; безусловный `stamp` запрещён. Старый журнал сохраняется, volumes не удаляются. - Без комментариев в коде; отступы — пробелы (`[tool.ruff.format]`); Python 3.14 без `from __future__ import annotations` и `TYPE_CHECKING`. - Порты реплик API наружу не публикуются: только LB. Нет `container_name`, `hostname` и общего `INSTANCE_ID` у сервиса `api`. - `REPORT.md`: команды из чистого clone, архитектура, таблица «критерий → команда → наблюдение → файл», таблица отказов, трек 1, ответы на вопросы защиты. PASS без команды не доказательство; для отказов — какой контейнер реально остановлен (`docker ps -a`). Цифры в отчёте берутся только из файлов `evidence/`. diff --git a/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/design.md b/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/design.md index 5e9bd156..d777f549 100644 --- a/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/design.md +++ b/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/design.md @@ -6,7 +6,8 @@ получаем — единый декларативный слой запросов (`select`, `join`, `with_for_update`, `returning`), типизированные ORM-модели сущностей, переносимый пул и механизм сессий, индустриальный мигратор с журналом ревизий и autogenerate на будущее; платим — лишним слоем трансляции (SQL компилируется в asyncpg-протокол через greenlet), меньшей -прозрачностью низкоуровневых параметров соединения и четырьмя точечными `text()` там, где декларативно не выражается. +прозрачностью низкоуровневых параметров соединения и проверкой старой схемы через PostgreSQL-каталог; +запросы приложения полностью выражены ORM/Core. Зоны, порты и наблюдаемое поведение API не меняются — меняется только транспорт SQL за портами. ## Порты, адаптеры, сборка @@ -28,9 +29,9 @@ ORM-модели сущностей, переносимый пул и механ Типы колонок заданы явно там, где это важно для asyncpg: `DateTime(timezone=True)` у всех `timestamptz`, `LargeBinary` у `bytea`, `SmallInteger` у `position`. Зоны не импортируют модели друг друга: перекрёстный внешний -ключ `chat_members.user_id → users.id` объявлен только в миграции, а не в ORM, — связь зон остаётся ограничением -целостности схемы, и ни одна зона не получает тип другой зоны; цена связи уже была заплачена на уровне SQL и здесь -не растёт. +ключ `chat_members.user_id → users.id` объявлен строковым `ForeignKey("users.id")`, без импорта модели identity. +Модели описывают также CHECK, UNIQUE и индексы, чтобы autogenerate не предлагал удалить существующие ограничения. +Связь зон остаётся ограничением схемы: SQL одной зоны не читает таблицы другой. ## Пул, сессии, транзакции, отказ @@ -59,11 +60,13 @@ db_acquire_timeout_seconds`, `pool_recycle = 60`. `session()` — контекс `order_by`, `limit`, keyset через `tuple_(created_at, id) > tuple_(…)` — row comparison, как раньше), квитанция ключа (`select(...).join(MessageRow)`). -Точечно в `text()` остаётся одна команда отправки сообщения: CTE-цепочка с `FOR UPDATE OF c` (блокировка строки чата -перед квитанцией ключа — прежний порядок блокировок), частичным `ON CONFLICT … DO UPDATE … WHERE created_at <= …` -и `RETURNING` из двух CTE. Декларативно это выражается развязкой на несколько операторов и теряет атомарность -одного оператора, поэтому остаётся SQL-текстом с именованными bind-параметрами (без склейки значений). Индексы и -планы не меняются: `messages_history_idx (chat_id, created_at, id)` обслуживает историю и `ORDER BY` сообщения, +Отправка сообщения также выражена Core: `select(...).with_for_update(of=chats)` → +`insert(...).from_select(...).on_conflict_do_update(where=...)` → INSERT сообщения → UPDATE времени чата. +Все четыре CTE остаются в одном операторе через `cte()` / `add_cte()`. Блокировка чата предшествует блокировке +квитанции ключа; истёкший ключ заменяется, действующий читается следующим SELECT с новым snapshot READ COMMITTED. +`text()` нужен только для чтения специфического каталога PostgreSQL при принятии старой схемы. +Индексы остаются прежними; планы и производительность необходимо измерить заново: +`messages_history_idx (chat_id, created_at, id)` обслуживает историю и `ORDER BY` сообщения, `chat_members_user_idx (user_id, chat_created_at, chat_id)` — каталог и keyset, PK `idempotency_keys (chat_id, user_id, key)` — вставку-конфликт, `users_username_key` — регистрацию; `EXPLAIN` на новом коде перегенерируется в evidence и сравнивается с прежним. @@ -71,14 +74,24 @@ evidence и сравнивается с прежним. ## Миграции: Alembic - Каталог `alembic/` с async `env.py`, `alembic.ini` в корне; ревизии `0001_init`, `0002_idempotency_keys` - воспроизводят прежние SQL-файлы дословно (те же таблицы, ограничения, индексы), `transaction_per_migration` — + сгенерированы из metadata операциями Alembic и выверены против прежнего DDL (те же таблицы, ограничения, + индексы); `transaction_per_migration` — каждая ревизия в своей транзакции, как раньше. Итоговая схема идентична прежней — проверяется свежим стендом (`evidence/schema.txt`, `\d+`). -- Журнал — штатная таблица `alembic_version` вместо `schema_migrations`; контрольных сумм Alembic не хранит, поэтому - сценарий «изменённая миграция» из capability `lab2-persistent-storage` уходит; порядок и однократность +- Журнал новых запусков — штатная таблица `alembic_version`; Alembic не хранит контрольные суммы. + Для старого `schema_migrations` проверяются известные SHA-256 и непрерывный префикс ревизий. + Сценарий изменённой Alembic-ревизии заменён проверкой отсутствующей ревизии; порядок и однократность (`transaction_per_migration`, один одноразовый процесс) сохраняются. - Сериализация одновременных запусков — прежний session-level advisory lock `20260002`, выполняется в `env.py` на отдельном соединении (session-level переживает commit), снимается в `finally`. +- Переход существующей БД: `legacy.py` сверяет журнал и структуру схемы (`pg_catalog`: колонки, типы, collation, постоянство таблиц, + NULL/default, PK/UNIQUE/CHECK/FK, валидность ограничений и индексов, триггеры/RLS) с эталоном, создаваемым + историческими ревизиями в отдельной проверочной схеме внутри откатываемого SAVEPOINT. Только после совпадения + вызывается `MigrationContext.stamp` проверенной ревизией. Затем обычный upgrade применяет недостающие ревизии. + Неизвестная/изменённая/неполная история и расхождение схемы прерывают переход без stamp и изменения данных. + Без журнала непустая схема также отклоняется. Старый журнал сохраняется для аудита и возврата старого образа. + Обратный `downgrade` запрещён, так как удалял бы пользовательские таблицы; откат приложения сохраняет схему. + Старые SQL-файлы остаются только неизменяемыми fixtures для тестирования перехода, не runner-ом приложения. - One-shot сервис `migrate` в compose выполняет `alembic upgrade head`; образ приложения несёт `alembic.ini` и `alembic/` (правки `Dockerfile`); сервис по-прежнему non-root, одноразовый, до старта реплик. Повторный запуск — no-op. `scripts/rolling-update.sh` не меняется: миграции применяются один раз перед заменой первой реплики. @@ -106,3 +119,13 @@ Evidence, зависящее от поведения SQL: схема и мигр (failover, persistence, faults, retry), серии трека 1 и планы запросов — на новом коде; расхождения (новые top-операторы SQLAlchemy, разница в RPS/латентности, таблица версий) фиксируются в `REPORT.md` и `evidence/README.md`. + +## Проверки этапа и оставшаяся работа + +Зафиксированные версии: SQLAlchemy 2.0.45, Alembic 1.16.5. API сверено через Context7: +[SQLAlchemy CTE/asyncio](https://github.com/sqlalchemy/sqlalchemy/tree/rel_2_0_45/doc/build), +[Alembic async cookbook](https://github.com/sqlalchemy/alembic/blob/rel_1_16_5/docs/build/cookbook.rst). +Миграционные тесты проверяют свежую БД, переход с 0001/0002 с сохранением каждой строки, повреждения схемы, +неизвестную ревизию, повторный и конкурентный запуск. Пул проверяется на rollback, таймаутах и отмене запроса. +Полный стенд уровней 3/4, evidence и измерения трека 1 выполняются следующими этапами; прежние цифры +не подтверждают производительность SQLAlchemy. Change остаётся активным до этих прогонов и обновления отчёта. diff --git a/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/proposal.md b/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/proposal.md index c2d93749..7bb05dd4 100644 --- a/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/proposal.md +++ b/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/proposal.md @@ -15,13 +15,14 @@ chunked-лимит) сохраняются. Уровни «3» и «4» держ ограниченное время. - ORM-модели сущностей зон: `identity` (`users`, `sessions`) и `messaging` (`chats`, `chat_members`, `messages`, `idempotency_keys`); запросы — ORM/Core API (`select`, `join`, `with_for_update`, `returning`, `tuple_`, `on_conflict_do_nothing`); - `sqlalchemy.text()` — точечно, где декларативно нельзя: одна команда отправки сообщения (CTE c `FOR UPDATE OF` и - частичным `ON CONFLICT … WHERE`) и advisory lock мигратора. + отправка сообщения также остаётся одной Core-командой из CTE с `FOR UPDATE OF` и `ON CONFLICT … WHERE`. + `sqlalchemy.text()` используется только для специфического каталога PostgreSQL при переходе старой схемы. - pydantic-схемы остаются на границе API, ORM-модели — внутри адаптеров; порты (`IdentityUnitOfWork`, `ChatRepository`, `MessageLog`, каталоги) и сборка в `ioc.py` не меняются. - Собственный runner `messenger/migrate.py` и `messenger/migrations/*.sql` удаляются. Миграции — Alembic: async `env.py`, каталог `alembic/`, журнал `alembic_version`, advisory lock сохранён; one-shot сервис `migrate` в compose выполняет `alembic upgrade head`. Итоговая схема идентична прежней (те же таблицы, ограничения, индексы). + Существующая БД принимается только после проверки старого журнала и фактической схемы; данные и журнал сохраняются. - Версии SQLAlchemy/Alembic закреплены в `pyproject.toml` (`uv lock`). - Evidence, зависящее от поведения SQL (схема и миграции, отказы, нагрузки трека 1), перегенерировано на новом коде; расхождения описаны в `REPORT.md` и `evidence/README.md`. diff --git a/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/specs/lab2-persistent-storage/spec.md b/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/specs/lab2-persistent-storage/spec.md index 73ddb2e7..6a853aae 100644 --- a/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/specs/lab2-persistent-storage/spec.md +++ b/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/specs/lab2-persistent-storage/spec.md @@ -33,3 +33,13 @@ - **WHEN** два процесса миграций запускаются одновременно на одной БД - **THEN** advisory lock пропускает их по одному, и журнал содержит каждую ревизию один раз + +#### Scenario: Принятие существующей схемы + +- **WHEN** БД содержит схему прежнего SQL-мигратора и известный непрерывный журнал `schema_migrations` +- **THEN** переход сверяет контрольные суммы и фактическую схему с указанными ревизиями, сохраняет все строки и старый журнал, устанавливает проверенную ревизию Alembic и применяет только недостающие ревизии + +#### Scenario: Несогласованная старая схема + +- **WHEN** старый журнал неизвестен, изменён или неполон либо фактическая схема расходится с ним +- **THEN** процесс завершается ошибкой без установки версии Alembic и изменения пользовательских данных diff --git a/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/tasks.md b/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/tasks.md index 7ac85089..2307ed40 100644 --- a/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/tasks.md +++ b/openspec/changes/2026-11-05-adopt-sqlalchemy-alembic/tasks.md @@ -1,25 +1,25 @@ ## 1. Зависимости и платформа -- [ ] 1.1 Закрепить `sqlalchemy>=2.0` и `alembic>=1.16` в `pyproject.toml`, прогнать `uv lock`; обновить per-file-ignores ruff (уходят `messenger/migrate.py` и миграции в `AGENTS.md`) -- [ ] 1.2 `shared/infrastructure/postgres.py`: `Base(DeclarativeBase)`, `Database` на `create_async_engine(postgresql+asyncpg)` + `async_sessionmaker`, прежние серверные настройки/таймауты/размер пула; `PostgresUnitOfWork` на `AsyncSession`; отображение соединительных отказов в `Unavailable` (503), `IntegrityError` проходит мимо -- [ ] 1.3 Проверка группы: `make lint`, `make student-test` (частично, до миграции адаптеров — падение ожидаемо), затем повторно после 2.x +- [x] 1.1 Закрепить `sqlalchemy==2.0.45` и `alembic==1.16.5` в `pyproject.toml`, прогнать `uv lock`; обновить per-file-ignores ruff (уходят `messenger/migrate.py` и миграции в `AGENTS.md`) +- [x] 1.2 `shared/infrastructure/postgres.py`: `Base(DeclarativeBase)`, `Database` на `create_async_engine(postgresql+asyncpg)` + `async_sessionmaker`, прежние серверные настройки/таймауты/размер пула; `PostgresUnitOfWork` на `AsyncSession`; отображение соединительных отказов в `Unavailable` (503), `IntegrityError` проходит мимо +- [x] 1.3 Проверка группы: `make lint`, `make student-test` (частично, до миграции адаптеров — падение ожидаемо), затем повторно после 2.x ## 2. Адаптеры зон -- [ ] 2.1 `identity/infrastructure/postgres.py`: ORM-модели `UserRow`, `SessionRow`; запросы через `select`/`pg_insert(...).on_conflict_do_nothing(...).returning(...)`/`delete`; порты и сборка не меняются -- [ ] 2.2 `messaging/infrastructure/postgres.py`: ORM-модели `ChatRow`, `ChatMemberRow`, `MessageRow`, `IdempotencyKeyRow`; каталоги и история декларативно (`func.array`, keyset `tuple_`), участники — executemany, `IntegrityError` FK → `InvalidChatData`; отправка сообщения остаётся одним оператором `text()` с прежним `FOR UPDATE OF` и порядком блокировок -- [ ] 2.3 Проверка группы: `make lint`, `make student-test` — все собственные тесты зелёные, поведение идемпотентности/гонок/503 не изменилось +- [x] 2.1 `identity/infrastructure/postgres.py`: ORM-модели `UserRow`, `SessionRow`; запросы через `select`/`pg_insert(...).on_conflict_do_nothing(...).returning(...)`/`delete`; порты и сборка не меняются +- [x] 2.2 `messaging/infrastructure/postgres.py`: ORM-модели `ChatRow`, `ChatMemberRow`, `MessageRow`, `IdempotencyKeyRow`; каталоги и история декларативно (`func.array`, keyset `tuple_`), участники — executemany, `IntegrityError` FK → `InvalidChatData`; отправка сообщения остаётся одним оператором Core CTE с прежним `FOR UPDATE OF` и порядком блокировок +- [x] 2.3 Проверка группы: `make lint`, `make student-test` — все собственные тесты зелёные, поведение идемпотентности/гонок/503 не изменилось ## 3. Миграции Alembic -- [ ] 3.1 `alembic.ini` + `alembic/env.py` (async, DSN из `PlatformSettings`, advisory lock `20260002` на отдельном соединении, `transaction_per_migration`), ревизии `0001_init`, `0002_idempotency_keys` с дословным DDL прежних SQL-файлов; удалить `src/messenger/migrations/` и старый `messenger/migrate.py` -- [ ] 3.2 `Dockerfile` несёт `alembic.ini` и `alembic/`; compose-сервис `migrate` выполняет `alembic upgrade head`; `scripts/evidence-storage.sh` смотрит `alembic_version` -- [ ] 3.3 `student-tests/conftest.py` применяет миграции Alembic программно; `test_migrations.py` переписан под Alembic (порядок ревизий, повторный запуск — no-op, FK-сценарии схемы); `test_pool.py` под новый API `Database` -- [ ] 3.4 Проверка группы: `make check`, `make lint`, `make student-test`; свежая БД — схема `\d+` идентична прежней +- [x] 3.1 `alembic.ini` + `alembic/env.py` (async, DSN из `PlatformSettings`, advisory lock `20260002` на отдельном соединении, `transaction_per_migration`), ревизии `0001_init`, `0002_idempotency_keys` с эквивалентным DDL прежних SQL-файлов и проверяемым переходом старого журнала без потери данных; удалить `src/messenger/migrations/` и старый `messenger/migrate.py` +- [x] 3.2 `Dockerfile` несёт `alembic.ini` и `alembic/`; compose-сервис `migrate` выполняет `alembic upgrade head`; `scripts/evidence-storage.sh` смотрит `alembic_version` +- [x] 3.3 `student-tests/conftest.py` применяет миграции Alembic программно; `test_migrations.py` переписан под Alembic (порядок ревизий, повторный запуск — no-op, FK-сценарии схемы, сохранение данных 0001/0002, повреждённая схема, конкурентные процессы); `test_pool.py` под новый API `Database` +- [x] 3.4 Проверка группы: `make check`, `make lint`, `make student-test`; свежая БД — сравнение metadata/Alembic и каталога PostgreSQL с прежней схемой ## 4. Контекст и стенд -- [ ] 4.1 `AGENTS.md` и `openspec/config.yaml`: стек — SQLAlchemy 2.x async + Alembic (asyncpg — драйвер), описание `migrate`; правило «SQL только параметризованный» сохранено +- [x] 4.1 `AGENTS.md` и `openspec/config.yaml`: стек — SQLAlchemy 2.x async + Alembic (asyncpg — драйвер), описание `migrate`; правило «SQL только параметризованный» сохранено - [ ] 4.2 Стенд из чистого состояния: `make up` (миграции один раз), `make test`, `make lb-check`, `make retry-check`, `make test-failover ACTION_SCRIPT=scripts/stop-one.sh`, `make test-persistence ACTION_SCRIPT=scripts/restart.sh`, `make test-faults`, `make restore`; `make level4` под нагрузкой - [ ] 4.3 `evidence-storage.sh` прогон: `evidence/{schema,migrations,kdf,secrets}.txt` на новом коде; свежие `smoke.txt`, `student-tests.txt`, `checks.txt` @@ -28,3 +28,24 @@ - [ ] 5.1 `make track1` на новом коде: снимок хоста, серии A/B, до/после, контроль, графики; расхождения против прежних серий описать - [ ] 5.2 `REPORT.md` и `evidence/README.md`: новый SQL-слой, таблица версий `alembic_version`, расхождения измерений, номера коммитов прогонов - [ ] 5.3 Проверка группы: `make check`, `make validate`, `make lint`, `make student-test`, `openspec validate --all --strict`; числа отчёта сверены с файлами `evidence/` + +## Результат этапа sqlalchemy-alembic — 2026-11-05 + +Код проверен на `66c614426c9265a03843a9dc39678ac1cd3c1e99`. Выполнено 11 из 16 задач change; задачи 4.2–5.3 +остаются для последовательных этапов стенда, evidence и трека. Архивация не выполнялась. + +- `make check`, `make validate`, `make lint` — PASS; lint включает `alembic/`. +- `make student-test` — 270 passed, 12 deselected (штатный маркер `stack`), 29.84 с. + Включены 22 теста миграций: свежая БД, старая схема 0001/0002 с сохранением всех строк, + повреждённый журнал/структура/collation/UNLOGGED, rollback неудачной ревизии, повтор и два процесса. +- `uv lock --check` — PASS; SQLAlchemy 2.0.45, Alembic 1.16.5. +- `openspec validate --all --strict` — 15 passed, 0 failed. +- `LB_HTTP_PORT=18083 LB_STATS_PORT=23083 docker compose build api` — PASS. + `alembic history` внутри образа видит обе ревизии. Два `alembic upgrade head` из образа + против отдельного PostgreSQL на tmpfs завершились с 0002_idempotency_keys. +- Начальные `ruff`/`ty` и `student-test` не проходили: исправлены аннотации SQLAlchemy, + проверка ORM-таблиц вместо только SQL-строк, локальная HTTPX-проба с системным прокси + и негативная UNLOGGED-fixture (изменяется листовая таблица sessions, без блокировки FK). + Итоговые проверки выше выполнены после исправлений. +- Одноразовые тестовые контейнеры остановлены; существующие volumes и другие лабораторные + не изменялись. Публикаций и отправок Telegram не было. diff --git a/openspec/config.yaml b/openspec/config.yaml index 4f2bbbb1..21afddc2 100644 --- a/openspec/config.yaml +++ b/openspec/config.yaml @@ -29,7 +29,7 @@ context: | Python 3.14 (аннотации вычисляются лениво по PEP 649, `TYPE_CHECKING` и `from __future__ import annotations` не используются), FastAPI, gunicorn с несколькими `UvicornWorker` (пакет `uvicorn-worker`), dishka (DI), pydantic v2 + pydantic-settings, structlog, - asyncpg (параметризованный SQL без ORM), redis-py (`redis.asyncio`) для Valkey, argon2-cffi, + SQLAlchemy 2.0 async (ORM/Core за портами, asyncpg только драйвер), Alembic, redis-py (`redis.asyncio`) для Valkey, argon2-cffi, pytest + pytest-asyncio + httpx. Зависимости — uv и `uv.lock`; ruff и ty обязательны на `src/`, `student-tests/` и Python-обвязке стенда; `scripts/*.py` держат синтаксис Python 3.9 и stdlib. @@ -48,7 +48,7 @@ context: | (`openspec/notes/architecture-patterns-python.md`), развёрнутый N одинаковыми репликами: main.py сборка приложения: собирает вклады зон в один процесс - migrate.py одноразовая точка входа: применяет SQL-миграции под advisory lock + alembic/ ревизии и async env.py: alembic upgrade head под advisory lock gunicorn_conf.py конфигурация процесса: воркеры, окно вывода из ротации по SIGTERM (DrainingServer, MessengerWorker; флаг вывода — shared/infrastructure/readiness) identity/ пользователи, пароли и сессии: ошибки, события, команды, значения, порты, @@ -137,7 +137,7 @@ operations: - "Логирование — только через порт `Logger`; второй логгер в приложении не заводится, сообщения сервера и библиотек идут через тот же поток." - "Код приложения — в `src/`, конфигурация LB и нагрузки — в `infra/`, собственные тесты — в `student-tests/`, обезличенные доказательства — в `evidence/`." - "Перед коммитом прогоняй `make lint`, `make student-test` и `make check`." - - "SQL только параметризованный (`$1`, `$2`); значения из запроса никогда не склеиваются в текст запроса." + - "SQL только параметризованный (bind-параметры SQLAlchemy); значения из запроса никогда не склеиваются в текст запроса." - "Реплика не хранит в памяти процесса ничего, от чего зависит корректность ответа другой реплики: сессии, ключи идемпотентности и курсоры проверяются через общее хранилище или общий секрет." - "Ошибка зависимости (PostgreSQL, Valkey) превращается в `503 unavailable` за ограниченное время; отказ кэша обходится и никогда не превращается в анонимный доступ." - "Схема меняется только новым файлом миграции; применённую миграцию не редактируют; миграция совместима с работающей предыдущей версией."