This commit is contained in:
@@ -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` |
|
||||
|
||||
## Эксперименты и отказы
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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"}
|
||||
|
||||
@@ -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
@@ -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):
|
||||
"""Выданная сессия: токен показывается клиенту один раз и в логи не попадает."""
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
@@ -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, " ", ""):
|
||||
|
||||
Reference in New Issue
Block a user