* обновила отчет
Skeleton contracts / contracts (pull_request) Canceled after 0s

This commit is contained in:
vasyukova
2026-10-03 02:05:53 +03:00
parent d83dca8ed5
commit 8e99357f87
+6 -2
View File
@@ -60,7 +60,7 @@
### Проверки уровня 4 с остановкой зависимостей и TTL
Тесты уровня 4 разделены на два запуска: тяжёлые (гонка регистрации, EXPLAIN, недоступность Redis, недоступность PostgreSQL) выполняются при длинном TTL; expiry — при коротком TTL. Это сделано потому, что тест недоступности Redis использует заранее полученную рабочую сессию, и при `SESSION_TTL_SECONDS=5` она истекает быстрее, чем тест успевает остановить Redis.
Тесты уровня 4 разделены на два запуска: тяжёлые (гонка регистрации, rollback составной операции, EXPLAIN, недоступность Redis, недоступность PostgreSQL) выполняются при длинном TTL; expiry — при коротком TTL. Это сделано потому, что тест недоступности Redis использует заранее полученную рабочую сессию, и при `SESSION_TTL_SECONDS=5` она истекает быстрее, чем тест успевает остановить Redis.
Первый запуск (в .env SESSION_TTL_SECONDS=3600) — все тяжёлые тесты, включая Redis/Postgres down:
```
@@ -74,6 +74,7 @@ python student-tests/test_lab2_level4.py --base-url http://localhost:8080 --only
Наблюдения:
- гонка регистрации: из 8 одновременных POST один username — ровно одна 201 и семь 409, остальные ошибки (timeout/500/bad schema) проваливают тест; в БД ровно одна строка `users` с этим username;
- rollback составной операции: патч-скрипт запускается через `docker exec` внутри контейнера API, подменяет `psycopg.Cursor.executemany` так, чтобы INSERT в `chat_members` упал уже после успешного INSERT в `chats`; после падения ни строки `chats`, ни строк `chat_members` с этим title не остаётся, и через API чат не виден; ошибка до INSERT (неизвестный участник) rollback не доказывает, поэтому используется именно сбой `executemany`;
- EXPLAIN на 550 008 сообщениях: `Index Scan using idx_messages_chat_created`, без `Sort`, Execution Time ~0.06 мс;
- недоступность Redis: с действующим токеном `/health/ready` → 503 и запрос с этим токеном → 503; после восстановления Redis прежняя сессия снова работает (AOF);
- недоступность PostgreSQL: `/health/ready` → 503, запрос с действующим токеном → 503 в пределах таймаута, анонимный запрос не получает доступ; после восстановления БД прежняя сессия работает, ранее записанное сообщение сохранено; восстановление БД выполняется в `finally`, чтобы не оставить стенд остановленным при падении теста;
@@ -174,7 +175,7 @@ mtuci2026lab2/
│ ├── run_all.py
│ ├── test_negative.py
│ ├── test_concurrency.py
│ ├── test_lab2_level4.py * # гонка регистрации (реальные HTTP-коды + строка в БД), EXPLAIN, недоступность Redis (с действующим токеном), недоступность PostgreSQL (с восстановлением в finally), expiry; режимы --skip-expiry / --only-expiry
│ ├── test_lab2_level4.py * # гонка регистрации (реальные HTTP-коды + строка в БД), rollback составной операции create_chat (docker exec + patch executemany), EXPLAIN, недоступность Redis (с действующим токеном), недоступность PostgreSQL (с восстановлением в finally), expiry; режимы --skip-expiry / --only-expiry
│ ├── track2_seed.sql ** # сидирование >=100 000 сообщений
│ └── test_track2.py ** # Трек 2: EXPLAIN, стоимость записи, backup/restore, RPO
└── tests/ # публичные проверки, без изменений
@@ -229,6 +230,7 @@ mtuci2026lab2/
| Redis persistence, выдерживающее рестарт | `docker exec mtuci-redis redis-cli INFO persistence`; рестарт Redis | `aof_enabled:1`; сессии живы после рестарта | evidence/lab2/lab2_level4.txt | **4** |
| Параметризованные запросы, ограниченный пул, таймауты | `psycopg_pool.ConnectionPool(2..10, timeout=5)`, `statement_timeout=5000` | нет `psycopg.connect()` на запрос | src/app/storage/db.py | **4** |
| Гонка регистрации одинакового username | `python student-tests/test_lab2_level4.py --skip-expiry` (блок `test_concurrent_registration`) | ровно одна 201, остальные 409; остальные ошибки проваливают тест; в БД ровно одна строка `users` | evidence/lab2/lab2_level4.txt | **4** |
| Rollback составной операции create_chat | тот же скрипт, `test_chat_rollback` (docker exec + patch `psycopg.Cursor.executemany`) | ошибка на executemany ПОСЛЕ успешного INSERT в chats: ни строки chats, ни chat_members не осталось; через API чат не виден | evidence/lab2/lab2_level4.txt | **4** |
| Индекс истории обоснован EXPLAIN на ≥10 000 сообщениях | тот же скрипт, `test_explain` | `Index Scan using idx_messages_chat_created` | evidence/lab2/lab2_level4.txt | **4** |
| Keyset-пагинация без полного scan на страницу | `list_messages_page` в `postgres.py` | `WHERE (created_at, id) > (…, …)` + `LIMIT` | src/app/storage/postgres.py | **4** |
| Автопроверка expiry при коротком TTL | `SESSION_TTL_SECONDS=5`, `python student-tests/test_lab2_level4.py --only-expiry` | до TTL — 200, после — 401; повторный вход работает | evidence/lab2/lab2_level4.txt | **4** |
@@ -254,6 +256,7 @@ Hardware и версии:
| `docker compose restart api postgres redis` (`scripts/restart.bat`) | API, PostgreSQL и Redis перезапускаются, volumes не трогаются; прежний Bearer читает прежние данные | `PASS: persistence preserved confirmed data and existing session`; `event=startup` в логах, `StartedAt` изменился у всех 3-х | downtime ≈ 3–5 с; потери 0 |
| `docker compose stop postgres`, затем запрос | 503 `unavailable` (обработчик `psycopg.OperationalError`), БД-операции не идут | 503 `unavailable` на `/health/ready` и бизнес-запросах; после `start postgres` — 200, данные и сессия сохранены | downtime ≈ 3 с; потери 0 (том сохранён) |
| `docker compose stop redis`, затем запрос | 503 `unavailable`, анонимный доступ не открывается | `PASS: readiness 503 без Redis`; с действующим токеном 503, после `start redis` прежняя сессия снова работает | downtime ≈ 3 с; потери сессий 0 (AOF) |
| Падение `executemany` внутри `create_chat` после успешного INSERT в `chats` | Транзакция откатывается целиком | `PATCHED_FAILURE_OK`; ни строки `chats`, ни `chat_members` не осталось | потери 0 (откат) |
| Повторный `init_schema()` | Идемпотентно, без дублирования, таблицы уже существуют | ошибок нет, нет дублирования строк | — |
| SIGTERM (`docker stop -t 10`) | завершение ≤ 10 с | как в lab1: <1 с, `event=shutdown_complete` | — |
@@ -362,6 +365,7 @@ e320b42f-e328-446b-a748-b27425281864|1
- Keyset-пагинацию в SQL с индексом `idx_messages_chat_created`.
- Контрактные ответы, `X-Request-Id`, `WWW-Authenticate`, 503 при недоступности Redis/PostgreSQL.
- Конкурентную регистрацию одинакового username без дублей; тест проверяет фактические HTTP-коды и наличие одной строки в БД.
- Откат составной операции `create_chat` при падении `executemany` уже после INSERT в `chats`: отдельный тест запускает патч-скрипт внутри контейнера API, подменяет `psycopg.Cursor.executemany` и проверяет, что ни строки чата, ни членства не сохранилось.
- Остановку Redis и PostgreSQL: 503 на readiness и на запросы с действующим токеном, без анонимного доступа; восстановление зависимостей в `finally`, прежние данные и сессии сохранены.
Учебные упрощения: