fix comments
Skeleton contracts / contracts (pull_request) Canceled after 0s

This commit is contained in:
2026-10-23 22:32:15 +03:00
parent 5c193f24f7
commit c4ffc8dcf3
8 changed files with 327 additions and 15 deletions
+13 -4
View File
@@ -52,9 +52,10 @@ make student-test BASE_URL=http://127.0.0.1:8080 PYTHON="python3 -X utf8"
```
Инструкция проверена целиком на копии репозитория без игнорируемых Git файлов:
сборка `--no-cache` 1 м 35 с, `up -d` 19 с, готовность через 1 с, `make check` и
`make validate` — PASS, `make test` — PASS, `make test-persistence` — PASS,
`make student-test` — 79 тестов OK за 28.5 с. Транскрипт — `evidence/12-clean-clone.txt`.
сборка `--no-cache` 1 м 35 с в первом прогоне и 2 м 49 с в повторном, `up -d` 8–19 с,
готовность через 1 с, `make check` и `make validate` — PASS, `make test` — PASS,
`make test-persistence` — PASS, `make student-test` — 82 теста OK за 30.9 с.
Транскрипт — `evidence/12-clean-clone.txt` (первый прогон и повторный на итоговом дереве).
Три оговорки для Windows, все проверены на практике:
@@ -205,6 +206,14 @@ Basic-креденшелами получил бы приглашение пов
Неверный пароль и несуществующий пользователь отвечают одинаково, и время ответа
выравнивается проверочным хешем, чтобы отказ не выдавал существование имени.
Валидация на границе отвергает две категории строк, которые не должны доходить до
базы: пароль из одних пробельных символов (это пустое значение обязательного поля,
а не секрет) и U+0000 в сохраняемых строках — PostgreSQL `text` его не хранит.
Обе дают 400 `invalid_request`. 503 `unavailable` закреплён только за отказами
соединения и пула (`OperationalError`, `InterfaceError`, `DisconnectionError`,
таймаут пула, ошибки Valkey): `DataError` — ошибка данных клиента — в это семейство
не входит, поэтому сбой значения не маскируется под аварию зависимости.
### Таймауты и поведение при отказе зависимостей
| Параметр | Значение | Зачем именно столько |
@@ -319,7 +328,7 @@ Docker 28.0.1 (WSL2), контейнеры ограничены 2 CPU и 512 М
| Автоматическая проверка неверного пароля | `test_auth` | одинаковый 401 для неверного пароля и неизвестного пользователя | `evidence/03-student-tests.txt` |
| Автоматическая проверка недоступности Redis/БД | `ALLOW_OUTAGE=1 … -p test_dependency_outage.py` | все маршруты: 503 `unavailable` за 1.0–1.5 с, ни одного 401 и ни одного 200; `/health/live` остаётся 200 | `evidence/05-valkey-outage.txt`, `evidence/06-postgres-outage.txt` |
| Приложение не принимает запрос анонимного пользователя как доверенный | те же прогоны | при недоступной зависимости доступа нет ни у кого: 503, а не «пустим как анонима» | `evidence/05-valkey-outage.txt`, `evidence/06-postgres-outage.txt` |
| PR собирается из чистого clone | копия без игнорируемых файлов → `up -d --build` → `make check`/`validate`/`test`/`test-persistence`/`student-test` | сборка с нуля 1 м 35 с, миграции на пустом томе, все проверки PASS, 79 тестов OK | `evidence/12-clean-clone.txt` |
| PR собирается из чистого clone | копия без игнорируемых файлов → `up -d --build` → `make check`/`validate`/`test`/`test-persistence`/`student-test` | сборка с нуля 1 м 35 с и 2 м 49 с в двух прогонах, миграции на пустом томе, все проверки PASS, 82 теста OK | `evidence/12-clean-clone.txt` |
## Эксперименты и отказы
+10 -4
View File
@@ -1,5 +1,5 @@
== 03: собственные проверки (student-tests) ==
date: 2026-10-11T19:32:33Z (UTC)
date: 2026-10-23T19:19:36Z (UTC)
host: Windows 10 Pro 19045, Git Bash (MSYS), python3 3.11.9; стенд поднят docker compose
Что показывает: проверки поверх публичного контракта — пароли и границы их длины,
@@ -52,6 +52,10 @@ test_password_length_bounds (test_auth.Registration.test_password_length_bounds)
11 и 129 кодовых точек отклоняются; 12 и 128 принимаются. ... ok
test_password_may_contain_a_colon (test_auth.Registration.test_password_may_contain_a_colon)
Basic разделяет только по первому двоеточию, остальное принадлежит паролю. ... ok
test_surrounding_spaces_are_part_of_the_password (test_auth.Registration.test_surrounding_spaces_are_part_of_the_password)
Пароль не обрезается: пробелы по краям значат то же, что и любые другие символы. ... ok
test_whitespace_only_password_is_refused (test_auth.Registration.test_whitespace_only_password_is_refused)
Двенадцать пробелов — пустое значение обязательного поля, а не пароль. ... ok
test_a_valid_chat_is_created_whole (test_chat_atomicity.ChatCreation.test_a_valid_chat_is_created_whole) ... ok
test_creator_must_be_a_member (test_chat_atomicity.ChatCreation.test_creator_must_be_a_member) ... ok
test_duplicate_members_are_refused (test_chat_atomicity.ChatCreation.test_duplicate_members_are_refused) ... ok
@@ -62,7 +66,7 @@ test_liveness_stays_green_throughout (test_dependency_outage.DependencyOutage.te
Отказ зависимости не должен выглядеть для супервизора смертью процесса. ... skipped 'задайте ALLOW_OUTAGE=1 для запуска: этот модуль останавливает контейнеры'
test_postgres_outage (test_dependency_outage.DependencyOutage.test_postgres_outage) ... skipped 'задайте ALLOW_OUTAGE=1 для запуска: этот модуль останавливает контейнеры'
test_valkey_outage (test_dependency_outage.DependencyOutage.test_valkey_outage) ... skipped 'задайте ALLOW_OUTAGE=1 для запуска: этот модуль останавливает контейнеры'
api пересоздан с SESSION_TTL_SECONDS=3, готов через 3.72s
api пересоздан с SESSION_TTL_SECONDS=3, готов через 3.73s
test_a_token_issued_before_the_change_still_works (test_expiry.ShortLivedSessions.test_a_token_issued_before_the_change_still_works)
Пересоздание API не выдаёт новые сессии и не продлевает старые. ... у токена, выданного до переключения, осталось 3596s из исходных 3600s
ok
@@ -73,7 +77,7 @@ test_expiry_does_not_need_a_cleanup_job (test_expiry.ShortLivedSessions.test_exp
ok
test_the_short_ttl_is_the_one_in_force (test_expiry.ShortLivedSessions.test_the_short_ttl_is_the_one_in_force) ... expires_at через 3.00s, ключ в Valkey живёт 3s: сроком владеет хранилище, а не процесс
ok
api пересоздан с SESSION_TTL_SECONDS=3600, готов через 3.80s
api пересоздан с SESSION_TTL_SECONDS=3600, готов через 3.78s
test_error_envelope_carries_a_request_id (test_health.Probes.test_error_envelope_carries_a_request_id) ... ok
test_every_probe_gets_its_own_request_id (test_health.Probes.test_every_probe_gets_its_own_request_id) ... ok
test_liveness (test_health.Probes.test_liveness) ... ok
@@ -114,6 +118,8 @@ test_broken_json_is_refused_without_echoing_it (test_validation.RequestBodies.te
test_display_name_and_title_limits (test_validation.RequestBodies.test_display_name_and_title_limits) ... ok
test_message_text_limits (test_validation.RequestBodies.test_message_text_limits) ... ok
test_missing_required_fields (test_validation.RequestBodies.test_missing_required_fields) ... ok
test_nul_is_refused_before_it_reaches_the_store (test_validation.RequestBodies.test_nul_is_refused_before_it_reaches_the_store)
U+0000 не хранится в `text`: это 400, а не ложная недоступность базы. ... ok
test_sender_id_cannot_be_injected (test_validation.RequestBodies.test_sender_id_cannot_be_injected) ... ok
test_the_password_never_appears_in_an_error (test_validation.RequestBodies.test_the_password_never_appears_in_an_error) ... ok
test_unknown_json_field_is_refused (test_validation.RequestBodies.test_unknown_json_field_is_refused) ... ok
@@ -122,6 +128,6 @@ test_unknown_route (test_validation.Routing.test_unknown_route) ... ok
test_wrong_method (test_validation.Routing.test_wrong_method) ... ok
----------------------------------------------------------------------
Ran 79 tests in 29.377s
Ran 82 tests in 30.188s
OK (skipped=3)
+213
View File
@@ -564,3 +564,216 @@ $ cd /c/Users/denis/Desktop/HighLoad/mtusi2026lab2 && docker compose start #
основной стенд: готов через 2 с
Копия после прогона удалена: C:/Users/denis/AppData/Local/Temp/lab2-clean-clone
== 12б: повторный прогон из чистого clone после исправления валидации ==
date: 2026-10-23T19:25:46Z (UTC)
host: Windows 10 Pro 19045, x64, Git Bash; Docker 28.0.1 (Docker Desktop, WSL2)
Зачем: после транскрипта выше добавлены три регрессионных теста — пароль только из
пробельных символов и U+0000 в сохраняемых строках дают 400 invalid_request, — а
503 unavailable сужен до отказов соединения и пула. Ниже тот же сценарий целиком
на итоговом дереве: снова копия без игнорируемых Git файлов, сборка без кэша,
пустой том и все проверки. Инфраструктура и последовательность команд не менялись.
$ docker compose stop # в основном репозитории: освобождаем порт 8080 и имя проекта
Container mtusi2026lab2-api-1 Stopping
Container mtusi2026lab2-api-1 Stopped
Container mtusi2026lab2-migrate-1 Stopping
Container mtusi2026lab2-valkey-1 Stopping
Container mtusi2026lab2-migrate-1 Stopped
Container mtusi2026lab2-postgres-1 Stopping
Container mtusi2026lab2-postgres-1 Stopped
Container mtusi2026lab2-valkey-1 Stopped
$ mkdir -p /c/Users/denis/AppData/Local/Temp/lab2-clean-clone && tar -c --exclude=.git --exclude=.venv --exclude=secrets \
--exclude=.env --exclude=__pycache__ --exclude="*.pyc" . | tar -x -C /c/Users/denis/AppData/Local/Temp/lab2-clean-clone
скопировано: 98 файлов
$ cd /c/Users/denis/AppData/Local/Temp/lab2-clean-clone
$ cp .env.example .env && sh scripts/bootstrap-secrets.sh
create secrets/postgres_password
create secrets/cursor_secret
create secrets/cache_url
create secrets/database_url
done: /c/Users/denis/AppData/Local/Temp/lab2-clean-clone/secrets
next: docker compose up -d --build
$ docker compose --env-file .env config --quiet # валидность до сборки
config: OK
$ time docker compose --env-file .env build --no-cache
#27 [api] resolving provenance for metadata file
#27 DONE 0.0s
api Built
migrate Built
real 2m49.033s
user 0m0.030s
sys 0m0.076s
$ time docker compose --env-file .env up -d
$ time docker compose --env-file .env up -d
Network lab2-clean-clone_backend Creating
Network lab2-clean-clone_backend Created
Volume "lab2-clean-clone_pgdata" Creating
Volume "lab2-clean-clone_pgdata" Created
Volume "lab2-clean-clone_valkeydata" Creating
Volume "lab2-clean-clone_valkeydata" Created
Container lab2-clean-clone-postgres-1 Creating
Container lab2-clean-clone-valkey-1 Creating
Container lab2-clean-clone-postgres-1 Created
Container lab2-clean-clone-migrate-1 Creating
Container lab2-clean-clone-valkey-1 Created
Container lab2-clean-clone-migrate-1 Created
Container lab2-clean-clone-api-1 Creating
Container lab2-clean-clone-api-1 Created
Container lab2-clean-clone-postgres-1 Starting
Container lab2-clean-clone-valkey-1 Starting
Container lab2-clean-clone-valkey-1 Started
Container lab2-clean-clone-postgres-1 Started
Container lab2-clean-clone-postgres-1 Waiting
Container lab2-clean-clone-postgres-1 Healthy
Container lab2-clean-clone-migrate-1 Starting
Container lab2-clean-clone-migrate-1 Started
Container lab2-clean-clone-valkey-1 Waiting
Container lab2-clean-clone-migrate-1 Waiting
Container lab2-clean-clone-postgres-1 Waiting
Container lab2-clean-clone-valkey-1 Healthy
Container lab2-clean-clone-postgres-1 Healthy
Container lab2-clean-clone-migrate-1 Exited
Container lab2-clean-clone-api-1 Starting
Container lab2-clean-clone-api-1 Started
real 0m7.912s
user 0m0.000s
sys 0m0.106s
Ожидание готовности: опрос GET /health/ready раз в секунду
готов через 1 с
$ curl -s http://127.0.0.1:8080/health/ready
{"status":"ok"}
$ docker compose --env-file .env ps --all
lab2-clean-clone-api-1 mtusi-messenger-lab2:2.0.0 "python -m messenger" api 8 seconds ago Up 1 second (health: starting) 127.0.0.1:8080->8080/tcp
lab2-clean-clone-migrate-1 mtusi-messenger-lab2:2.0.0 "alembic upgrade head" migrate 8 seconds ago Exited (0) 1 second ago
lab2-clean-clone-postgres-1 postgres:16.15-bookworm@sha256:0ea6700a3b4f0ae6ce746519073558aed4d88a79d8d07622a9a644946c7319c4 "docker-entrypoint.s…" postgres 9 seconds ago Up 8 seconds (healthy) 5432/tcp
lab2-clean-clone-valkey-1 valkey/valkey:8.0.11-trixie@sha256:4436c94fc34ce4af0354b9379d433a1f258998fb955f995c89822f98c14a8cab "tini -- docker-entr…" valkey 9 seconds ago Up 8 seconds (healthy) 6379/tcp
$ python3 -m venv .venv && .venv/Scripts/python.exe -m pip install --quiet -r requirements-dev.txt
sys 0m0.015s
Python 3.11.9
$ make check
python3 scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
$ make validate PYTHON=.venv/Scripts/python.exe
.venv/Scripts/python.exe scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
$ make test BASE_URL=http://127.0.0.1:8080
python3 tests/smoke.py --base-url "http://127.0.0.1:8080"
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
$ make test-persistence ACTION_SCRIPT=scripts/restart.cmd BASE_URL=http://127.0.0.1:8080
python3 tests/resilience.py --mode persistence --action-script "scripts/restart.cmd" --base-url "http://127.0.0.1:8080"
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
$ sh scripts/restart.sh # тот же хук из POSIX-оболочки
lab2-clean-clone-api-1 mtusi-messenger-lab2:2.0.0 "python -m messenger" api 59 seconds ago Up Less than a second (health: starting) 127.0.0.1:8080->8080/tcp
lab2-clean-clone-postgres-1 postgres:16.15-bookworm@sha256:0ea6700a3b4f0ae6ce746519073558aed4d88a79d8d07622a9a644946c7319c4 "docker-entrypoint.s…" postgres About a minute ago Up Less than a second (health: starting) 5432/tcp
lab2-clean-clone-valkey-1 valkey/valkey:8.0.11-trixie@sha256:4436c94fc34ce4af0354b9379d433a1f258998fb955f995c89822f98c14a8cab "tini -- docker-entr…" valkey About a minute ago Up Less than a second (health: starting) 6379/tcp
running services: api postgres valkey
restart complete
$ time make student-test BASE_URL=http://127.0.0.1:8080 PYTHON="python3 -X utf8"
----------------------------------------------------------------------
Ran 82 tests in 30.852s
OK (skipped=3)
real 0m31.300s
user 0m0.015s
sys 0m0.000s
Полный построчный вывод этих же 82 тестов — в доказательстве 03 (тот же запуск
на итоговом дереве; здесь только итог, чтобы не дублировать 130 строк).
$ docker compose --env-file .env stop # безопасная остановка: тома остаются
Container lab2-clean-clone-valkey-1 Stopping
Container lab2-clean-clone-migrate-1 Stopping
Container lab2-clean-clone-migrate-1 Stopped
Container lab2-clean-clone-postgres-1 Stopping
Container lab2-clean-clone-postgres-1 Stopped
Container lab2-clean-clone-valkey-1 Stopped
$ docker volume ls --filter name=lab2-clean-clone --format "{{.Name}}"
lab2-clean-clone_pgdata
lab2-clean-clone_valkeydata
$ docker compose --env-file .env start # данные на месте, стенд снова жив
$ docker compose --env-file .env start
Container lab2-clean-clone-valkey-1 Starting
Container lab2-clean-clone-postgres-1 Starting
Container lab2-clean-clone-valkey-1 Started
Container lab2-clean-clone-postgres-1 Started
Container lab2-clean-clone-postgres-1 Waiting
Container lab2-clean-clone-postgres-1 Healthy
Container lab2-clean-clone-migrate-1 Starting
Container lab2-clean-clone-migrate-1 Started
Container lab2-clean-clone-migrate-1 Waiting
Container lab2-clean-clone-postgres-1 Waiting
Container lab2-clean-clone-valkey-1 Waiting
Container lab2-clean-clone-valkey-1 Healthy
Container lab2-clean-clone-postgres-1 Healthy
Container lab2-clean-clone-migrate-1 Exited
Container lab2-clean-clone-api-1 Starting
Container lab2-clean-clone-api-1 Started
$ docker compose --env-file .env ps --all
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
lab2-clean-clone-api-1 mtusi-messenger-lab2:2.0.0 "python -m messenger" api 27 seconds ago Up Less than a second (health: starting) 127.0.0.1:8080->8080/tcp
lab2-clean-clone-migrate-1 mtusi-messenger-lab2:2.0.0 "alembic upgrade head" migrate About a minute ago Exited (0) Less than a second ago
lab2-clean-clone-postgres-1 postgres:16.15-bookworm@sha256:0ea6700a3b4f0ae6ce746519073558aed4d88a79d8d07622a9a644946c7319c4 "docker-entrypoint.s…" postgres About a minute ago Up 7 seconds (healthy) 5432/tcp
lab2-clean-clone-valkey-1 valkey/valkey:8.0.11-trixie@sha256:4436c94fc34ce4af0354b9379d433a1f258998fb955f995c89822f98c14a8cab "tini -- docker-entr…" valkey About a minute ago Up 7 seconds (healthy) 6379/tcp
$ docker compose --env-file .env down # удаляет контейнеры, но не тома
$ docker compose --env-file .env down
Container lab2-clean-clone-api-1 Stopping
Container lab2-clean-clone-api-1 Stopped
Container lab2-clean-clone-api-1 Removing
Container lab2-clean-clone-api-1 Removed
Container lab2-clean-clone-valkey-1 Stopping
Container lab2-clean-clone-migrate-1 Stopping
Container lab2-clean-clone-migrate-1 Stopped
Container lab2-clean-clone-migrate-1 Removing
Container lab2-clean-clone-migrate-1 Removed
Container lab2-clean-clone-postgres-1 Stopping
Container lab2-clean-clone-valkey-1 Stopped
Container lab2-clean-clone-valkey-1 Removing
Container lab2-clean-clone-postgres-1 Stopped
Container lab2-clean-clone-postgres-1 Removing
Container lab2-clean-clone-valkey-1 Removed
Container lab2-clean-clone-postgres-1 Removed
Network lab2-clean-clone_backend Removing
Network lab2-clean-clone_backend Removed
$ docker compose --env-file .env down -v # намеренное удаление учебных данных
$ docker compose --env-file .env down -v
Volume lab2-clean-clone_valkeydata Removing
Volume lab2-clean-clone_pgdata Removing
Volume lab2-clean-clone_valkeydata Removed
Volume lab2-clean-clone_pgdata Removed
$ docker volume ls --filter name=lab2-clean-clone --format "{{.Name}}"
(пусто)
$ cd /c/Users/denis/Desktop/HighLoad/mtusi2026lab2 && docker compose start # возвращаем основной стенд
$ docker compose ps --format "{{.Service}} {{.State}} {{.Health}}"
api running healthy
postgres running healthy
valkey running healthy
$ curl -s http://127.0.0.1:8080/health/ready
{"status":"ok"}
+31 -2
View File
@@ -9,7 +9,8 @@ from fastapi import FastAPI, Request
from fastapi.exceptions import RequestValidationError
from fastapi.responses import JSONResponse
from redis.exceptions import RedisError
from sqlalchemy.exc import SQLAlchemyError
from sqlalchemy.exc import DataError, DisconnectionError, InterfaceError, OperationalError
from sqlalchemy.exc import TimeoutError as PoolTimeoutError
from starlette.exceptions import HTTPException as StarletteHTTPException
from .context import REQUEST_ID, request_context
@@ -24,8 +25,20 @@ FALLBACK_MESSAGES: Mapping[int, str] = {
# Отказ критичной зависимости (PostgreSQL или Valkey): наружу 503 без деталей,
# подробности остаются в логе. Для клиента «сессии недоступны» и «база недоступна»
# выглядят одинаково — и это правильно, различать их он не должен.
DEPENDENCY_ERRORS = (SQLAlchemyError, RedisError, OSError)
#
# Здесь только отказы соединения и исчерпание пула. Более широкий SQLAlchemyError
# сюда не годится: он включает DataError, и тогда значение, которое PostgreSQL
# не может принять, выглядело бы как недоступность базы.
DEPENDENCY_ERRORS = (
OperationalError,
InterfaceError,
DisconnectionError,
PoolTimeoutError,
RedisError,
OSError,
)
DEPENDENCY_MESSAGE = "Сервис временно недоступен: критичная зависимость не отвечает"
DATA_ERROR_MESSAGE = "Значение поля не может быть сохранено"
def request_id_of(request: Request) -> str:
@@ -112,6 +125,22 @@ def register_error_handlers(app: FastAPI, logger: logging.Logger) -> None:
)
return error_response(request, 503, UNAVAILABLE, DEPENDENCY_MESSAGE)
@app.exception_handler(DataError)
async def handle_data_error(request: Request, exc: DataError) -> JSONResponse:
"""Данные клиента, которые СУБД не в состоянии сохранить, — это 400.
На границе такие значения уже отсекаются; обработчик оставлен страховкой,
чтобы ошибка данных никогда не выдавалась за отказ зависимости.
"""
log(
logger,
logging.WARNING,
"invalid_stored_value",
request_id=request_id_of(request),
error=type(exc).__name__,
)
return error_response(request, 400, INVALID_REQUEST, DATA_ERROR_MESSAGE)
for error_type in DEPENDENCY_ERRORS:
app.add_exception_handler(error_type, handle_dependency_failure)
+26 -2
View File
@@ -20,10 +20,23 @@ MAX_LIMIT = 100
DEFAULT_LIMIT = 50
def _visible(value: str, *, field: str, maximum: int) -> str:
"""Проверяет длину в code points и запрещает строки только из пробельных символов."""
def _require_content(value: str, *, field: str) -> str:
"""Обязательная строка не может быть пустой или состоять из пробельных символов."""
if not value.strip():
raise ValueError(f"{field} must not be empty or contain only whitespace")
return value
def _visible(value: str, *, field: str, maximum: int) -> str:
"""Проверяет строку, которую предстоит сохранить в PostgreSQL.
U+0000 отвергается на границе: тип `text` его не хранит, и без этой проверки
ошибка данных клиента дошла бы до обработчика ошибок базы, где выглядела бы
отказом зависимости.
"""
_require_content(value, field=field)
if "\u0000" in value:
raise ValueError(f"{field} must not contain U+0000")
if len(value) > maximum:
raise ValueError(f"{field} must be at most {maximum} Unicode code points")
return value
@@ -71,6 +84,17 @@ class CreateUser(BaseModel):
def _check_display_name(cls, value: str) -> str:
return _visible(value, field="display_name", maximum=MAX_DISPLAY_NAME)
@field_validator("password")
@classmethod
def _check_password(cls, value: str) -> str:
"""Пароль из одних пробелов — пустое значение, а не секрет.
Пробелы внутри и по краям допустимы и не обрезаются: при входе пароль
сверяется целиком. U+0000 здесь не проверяется: в PostgreSQL попадает
только хэш, а не сам пароль.
"""
return _require_content(value, field="password")
class Session(BaseModel):
"""Выданная сессия: токен показывается клиенту один раз и в логи не попадает."""
+3 -3
View File
@@ -35,7 +35,7 @@ python3 -u -X utf8 student-tests/valkey_crash.py
| --- | --- | --- |
| `harness.py` | Обвязка: клиент публичного `tests/client.py`, регистрация и вход, `psql` и `valkey-cli` внутри контейнеров, ожидание готовности. Не тест. | — |
| `run_all.py` | Запуск всего каталога, включая `--pattern` для одного модуля. Включает построчный вывод. Не тест. | — |
| `test_auth.py` | Пароль обязателен и ограничен 12..128 символами; границы 11/12/128/129; кириллица и 128 эмодзи (доказательство, что KDF не режет по 72 байтам); `:` в пароле не ломает Basic; неверный пароль и неизвестный пользователь неразличимы; Basic на бизнес-маршруте → 401 **с Bearer**-челленджем; `X-User-Id` не даёт доступа. | 14 |
| `test_auth.py` | Пароль обязателен и ограничен 12..128 символами; границы 11/12/128/129; пароль из одних пробелов отклоняется, а пробелы по краям не обрезаются; кириллица и 128 эмодзи (доказательство, что KDF не режет по 72 байтам); `:` в пароле не ломает Basic; неверный пароль и неизвестный пользователь неразличимы; Basic на бизнес-маршруте → 401 **с Bearer**-челленджем; `X-User-Id` не даёт доступа. | 16 |
| `test_sessions.py` | Форма ответа `Session`; у одного пользователя несколько независимых сессий; отзыв одной не трогает другую; logout → 204 без тела; повтор logout → 401; 16 входов подряд дают 16 разных токенов. | 10 |
| `test_expiry.py` | Реальный срок жизни при `SESSION_TTL_SECONDS=3`: токен, выданный до смены TTL, продолжает работать после пересоздания контейнера; после истечения отвергается и на бизнес-маршруте, и на logout; ключ исчезает из Valkey сам; `expires_at` в ответе согласован с TTL ключа. Стенд возвращается к прежнему TTL. | 4 |
| `test_dependency_outage.py` | Остановка Valkey и остановка PostgreSQL: бизнес-маршруты и `/health/ready` отвечают 503 `unavailable` быстрее 2 с, `/health/live` остаётся 200, анонимом никто не становится; после старта тот же токен снова работает, данные на месте. Только при `ALLOW_OUTAGE=1`. | 3 |
@@ -43,14 +43,14 @@ python3 -u -X utf8 student-tests/valkey_crash.py
| `test_chat_atomicity.py` | Создание чата — одна транзакция: неизвестный участник, дубликат в списке и отсутствие создателя дают 400, и чата после этого нет. | 6 |
| `test_pagination.py` | Keyset-пагинация: каждая запись ровно один раз, порядок из контракта, `has_more`/`next_cursor`, лимиты 1 и 100, страница за концом истории, чужой курсор. | 9 |
| `test_access.py` | Чужой чат и несуществующий чат отвечают одинаково (404, никогда 403); участник видит историю, посторонний — нет. | 9 |
| `test_validation.py` | Некорректные запросы: всегда конверт `{"error":{...}}`, никогда 422 или трейсбек; лишние поля запрещены; битый JSON; пустые строки и слишком длинные значения. | 15 |
| `test_validation.py` | Некорректные запросы: всегда конверт `{"error":{...}}`, никогда 422 или трейсбек; лишние поля запрещены; битый JSON; пустые строки и слишком длинные значения; U+0000 в сохраняемых строках → 400, а не 503. | 16 |
| `test_health.py` | Что отвечают пробы здоровья, что им нужно для 200 и чего они не делают (live не зависит от зависимостей). | 6 |
| `verify_stack.py` | Инфраструктура работающего стенда: uid 10001 и PID 1 не от root, порты PG и Valkey не публикуются, секреты файлами и без утечки в `compose config`, AOF и `everysec`, схема, индексы и CHECK-ограничения, идемпотентность миграций, отсутствие секретов в логах, лимиты и `restart`. Не unittest — печатает проверки и возвращает код. | 52 проверки |
| `valkey_crash.py` | Падение, а не остановка: `kill -9` процессу valkey-server внутри контейнера (политика `restart` поднимает его сама, AOF возвращает сессию) и `docker compose kill` снаружи (контейнер не поднимается — нужен оператор). Заодно измеряет окно потери около секунды при `appendfsync everysec`. Управляет контейнерами, поэтому запускается явно. | 11 проверок |
| `seed_messages.py` | Засев данных для экспериментов: ≥10 000 сообщений, пары с одинаковым `created_at` для проверки ничьей по `id`, чаты разной длины. | — |
| `explain_queries.py` | Планы запросов: индекс на истории, отказ планировщика от него без индекса, цена `OFFSET` против keyset, индекс «моих чатов». Пишет PASS/FAIL по каждой проверке. | 20 проверок |
Всего 79 тестов unittest: 76 идут всегда, 3 (отказ зависимостей) — только с
Всего 82 теста unittest: 79 идут всегда, 3 (отказ зависимостей) — только с
`ALLOW_OUTAGE=1`.
## Покрытие критериев уровня 4
+13
View File
@@ -52,6 +52,19 @@ class Registration(unittest.TestCase):
session = harness.login(self.api, payload["username"], secret)
self.assertEqual(session["user"]["username"], payload["username"])
def test_whitespace_only_password_is_refused(self):
"""Двенадцать пробелов — пустое значение обязательного поля, а не пароль."""
response = self.api.call("POST", "/api/v1/users", [400], body=self.body(" " * 12, "blank"))
self.assertEqual(response["json"]["error"]["code"], "invalid_request")
def test_surrounding_spaces_are_part_of_the_password(self):
"""Пароль не обрезается: пробелы по краям значат то же, что и любые другие символы."""
secret = " " + "a" * 10 + " "
payload = self.body(secret, "spaced")
self.api.call("POST", "/api/v1/users", 201, body=payload)
self.assertEqual(harness.login(self.api, payload["username"], secret)["token_type"],
"Bearer")
def test_password_is_checked_to_the_last_byte(self):
"""Пароль длиннее 72 байт не усекается KDF.
+18
View File
@@ -69,6 +69,24 @@ class RequestBodies(unittest.TestCase):
with self.subTest(path=path, length=len(str(body))):
self.assert_invalid(self.api.call("POST", path, [400], actor=self.alice, body=body))
def test_nul_is_refused_before_it_reaches_the_store(self):
"""U+0000 не хранится в `text`: это 400, а не ложная недоступность базы."""
nul = "x\u0000y"
self.assert_invalid(self.api.call(
"POST", "/api/v1/users", [400],
body={"username": harness.unique("nul"), "display_name": nul,
"password": harness.fresh_password()},
))
self.assert_invalid(self.api.call(
"POST", "/api/v1/chats", [400], actor=self.alice,
body={"title": nul, "member_ids": [self.alice["id"]]},
))
chat = harness.chat(self.api, self.alice, [], title="NUL в сообщении")
self.assert_invalid(self.api.call(
"POST", "/api/v1/chats/" + chat["id"] + "/messages", [400],
actor=self.alice, body={"text": nul},
))
def test_message_text_limits(self):
chat = harness.chat(self.api, self.alice, [], title="Лимиты текста")
for text in ("x" * 4001, " ", ""):