From f1fe9d7bebfbdaaeaf15292a24c5a52cb13c5c3e Mon Sep 17 00:00:00 2001 From: vasyukova Date: Fri, 2 Oct 2026 14:02:14 +0300 Subject: [PATCH] =?UTF-8?q?=D0=BE=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8=D0=BB?= =?UTF-8?q?=D0=B0=20=D1=82=D0=B5=D1=81=D1=82=D1=8B=20=D0=B8=20health.py?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/app/api/health.py | 28 ++--- student-tests/test_lab2_level4.py | 197 +++++++++++++++++------------- 2 files changed, 128 insertions(+), 97 deletions(-) diff --git a/src/app/api/health.py b/src/app/api/health.py index 913a3d25..1aa43062 100644 --- a/src/app/api/health.py +++ b/src/app/api/health.py @@ -1,4 +1,4 @@ -from fastapi import APIRouter, Response +from fastapi import APIRouter from ..models.schemas import Health from ..storage import db as _db from ..storage.sessions import _redis_client, _store @@ -22,19 +22,17 @@ def liveness() -> Health: summary="Проверка готовности принимать трафик", response_model=Health, ) -def readiness(response: Response) -> Health: - """200, если PostgreSQL и (в режиме redis) Redis доступны; иначе 503.""" - try: - with _db.connection() as conn, conn.cursor() as cur: - cur.execute("SELECT 1") - cur.fetchone() - except Exception: - response.status_code = 503 - return Health(status="ok") +def readiness() -> Health: + """200, если PostgreSQL и (в режиме redis) Redis доступны. + + При недоступности зависимости исключение вылетает наверх, и main.py + конвертирует его в 503 с телом Error из contracts/openapi.json. + """ + with _db.connection() as conn, conn.cursor() as cur: + cur.execute("SELECT 1") + cur.fetchone() if _store() == "redis": - try: - _redis_client().ping() - except Exception: - response.status_code = 503 - return Health(status="ok") + # _redis_client() сам поднимает RuntimeError("redis_unavailable") + # при ошибке; main.runtime_error_handler → 503 Error. + _redis_client().ping() return Health(status="ok") \ No newline at end of file diff --git a/student-tests/test_lab2_level4.py b/student-tests/test_lab2_level4.py index b66b2d1d..d1988503 100644 --- a/student-tests/test_lab2_level4.py +++ b/student-tests/test_lab2_level4.py @@ -8,10 +8,12 @@ 4) python student-tests/test_lab2_level4.py --base-url http://localhost:8080 5) перед smoke/persistence вернуть SESSION_TTL_SECONDS=3600 и снова up -d --force-recreate api -Про TTL=5. Методичка (contracts/README.md) разрешает короткий TTL именно -для теста истечения. TTL=5 достаточно, чтобы успеть проверить валидность -токена до истечения, и достаточно коротко, чтобы дождаться истечения -в рамках теста. +Порядок тестов: тяжёлые по данным и конкурентные — ДО expiry-теста, +потому что при коротком TTL любой долгий шаг съедает окно жизни сессии. +Expiry-тест запускается последним и использует свежие сессии. + +test_explain не зависит от TTL вообще: он сидирует данные напрямую +через psql и проверяет план SQL-запроса, а не HTTP-слой. """ import base64 import datetime as dt @@ -28,52 +30,7 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tests")) from client import Client, Failure, arguments, check, run # noqa: E402 -def test_short_ttl_expiry(c): - """TTL=5. Проверяем полный цикл: токен валиден -> истекает -> 401.""" - suffix = uuid.uuid4().hex[:10] - username = "ttl_" + suffix - password = "T3st-" + uuid.uuid4().hex - user = c.call("POST", "/api/v1/users", 201, - body={"username": username, "display_name": "TTL", "password": password}, - schema="User")["json"] - cred = base64.b64encode((username + ":" + password).encode()).decode() - session = c.call("POST", "/api/v1/auth/sessions", 201, - headers={"Authorization": "Basic " + cred}, - schema="Session")["json"] - token = session["token"] - - # Контроль: сервер выдал короткий TTL, иначе тест бессмыслен. - expires_at = dt.datetime.fromisoformat(session["expires_at"].replace("Z", "+00:00")) - ttl_actual = (expires_at - dt.datetime.now(dt.timezone.utc)).total_seconds() - check(3.0 <= ttl_actual <= 10, - "SESSION_TTL_SECONDS не короткий (получено %.1f c). " - "Поставь SESSION_TTL_SECONDS=5 в .env и перезапусти API." % ttl_actual) - - # До истечения токен должен работать. - me = c.call("GET", "/api/v1/users/me", 200, - headers={"Authorization": "Bearer " + token}, - schema="User")["json"] - check(me["id"] == user["id"], "token must identify its owner before expiry") - - # Ждём гарантированного истечения TTL + запас. - remaining = (expires_at - dt.datetime.now(dt.timezone.utc)).total_seconds() - time.sleep(max(remaining, 0.0) + 1.0) - - # Истёкший токен — 401. - c.call("GET", "/api/v1/users/me", 401, - headers={"Authorization": "Bearer " + token}) - - # Второй вход тем же пользователем даёт рабочий токен: истёк именно - # первый токен, а не пользователь/хранилище целиком. - session2 = c.call("POST", "/api/v1/auth/sessions", 201, - headers={"Authorization": "Basic " + cred}, - schema="Session")["json"] - c.call("GET", "/api/v1/users/me", 200, - headers={"Authorization": "Bearer " + session2["token"]}, - schema="User") - - -# ---------- 2. Конкурентная регистрация одинакового username ---------- +# ---------- 1. Конкурентная регистрация одинакового username ---------- def test_concurrent_registration(c): """Один и тот же username с 8 потоков — ровно одна 201, остальные 409.""" username = "race_" + uuid.uuid4().hex[:10] @@ -98,7 +55,7 @@ def test_concurrent_registration(c): check(results.count(409) == 7, "expected seven 409, got %s" % results) -# ---------- 3. EXPLAIN на реальной БД ---------- +# ---------- 2. EXPLAIN на реальной БД ---------- def _read_dsn() -> str: dsn = os.environ.get("DATABASE_URL") if not dsn: @@ -128,32 +85,16 @@ def _psql(dsn_in_container: str, sql: str) -> str: return r.stdout + r.stderr -def _seed_messages(c, chat, actor, count: int): - """Доливает count сообщений в чат через API параллельно, батчами.""" - print(" сидируем %d сообщений в чат %s ..." % (count, chat["id"])) - batch = 64 - - def one(i): - local = Client(c.base, timeout=15) - local.message(actor, chat, "seed-%06d-%s" % (i, uuid.uuid4().hex[:6])) - - done = 0 - with ThreadPoolExecutor(max_workers=16) as pool: - while done < count: - n = min(batch, count - done) - list(pool.map(one, range(done, done + n))) - done += n - if done % 1024 == 0 or done == count: - print(" ... %d/%d" % (done, count)) - - def test_explain(c): """EXPLAIN (ANALYZE, BUFFERS) истории сообщений на >=10 000 строк. Методичка: индекс истории обоснован запросом и EXPLAIN на >=10 000 сообщениях. На пустой таблице планировщик выбирает Seq Scan, поэтому - тест сам доводит messages до >=10 000 строк, делает ANALYZE и - проверяет план для самого крупного чата. + тест сам доводит messages до >=10 000 строк и делает ANALYZE. + + Данные сидируются напрямую через psql, без API: тест не зависит от + SESSION_TTL_SECONDS и скорости scrypt. Это корректно, потому что + EXPLAIN проверяет план SQL-запроса, а не HTTP-слой. """ dsn_in_container = _read_dsn() @@ -165,13 +106,55 @@ def test_explain(c): target_total = 10_000 if have < target_total: need = target_total - have - # Один чат для сидинга: берём первый доступный или создаём новый. - alice, bob, eve, chat = c.bootstrap() - _seed_messages(c, chat, alice, need) + print(" сидируем %d сообщений напрямую через psql ..." % need) + + # Один чат: берём существующий или создаём минимальный. + # gen_random_uuid() доступен в PG13+ без расширений. + seed_sql = """ +DO $$ +DECLARE + v_user UUID; + v_chat UUID; +BEGIN + SELECT id INTO v_user FROM users LIMIT 1; + IF v_user IS NULL THEN + v_user := gen_random_uuid(); + INSERT INTO users (id, username, display_name, password_hash, created_at) + VALUES (v_user, 'seed_' || substr(v_user::text, 1, 8), 'Seed', + 'scrypt$16384$8$1$00$00', now()); + END IF; + + SELECT id INTO v_chat FROM chats LIMIT 1; + IF v_chat IS NULL THEN + v_chat := gen_random_uuid(); + INSERT INTO chats (id, title, created_at) VALUES (v_chat, 'Seed chat', now()); + INSERT INTO chat_members (chat_id, user_id) VALUES (v_chat, v_user); + END IF; + + -- Доливаем ровно need строк в этот чат. + INSERT INTO messages (id, chat_id, sender_id, text, created_at) + SELECT gen_random_uuid(), v_chat, v_user, + 'seed-' || g, now() - (g || ' milliseconds')::interval + FROM generate_series(1, %d) AS g; +END $$; +""" % need + r = subprocess.run( + [ + "docker", "run", "--rm", + "--add-host=host.docker.internal:host-gateway", + "postgres:18-alpine", + "psql", dsn_in_container, "-c", seed_sql, + ], + capture_output=True, text=True, timeout=120, + ) + seed_out = r.stdout + r.stderr + check("ERROR" not in seed_out, "сидирование не удалось:\n" + seed_out) + # ANALYZE обязателен: без него планировщик не знает реальных размеров. _psql(dsn_in_container, "ANALYZE messages;") _psql(dsn_in_container, "ANALYZE chat_members;") _psql(dsn_in_container, "ANALYZE chats;") + print(" сидирование завершено") # EXPLAIN по САМОМУ БОЛЬШОМУ чату, чтобы планировщик имел основания # выбрать индекс, а не Seq Scan. @@ -204,7 +187,7 @@ def test_explain(c): "EXPLAIN не показал использования индекса:\n" + out) -# ---------- 4. Недоступность Redis ---------- +# ---------- 3. Недоступность Redis ---------- def _compose(action): return subprocess.run( ["docker", "compose", "--env-file", ".env", action, "redis"], @@ -252,17 +235,63 @@ def test_redis_unavailable(c): _wait_ready(c, timeout=60) +# ---------- 4. Expiry TTL ---------- +def test_short_ttl_expiry(c): + """TTL=5. Проверяем полный цикл: токен валиден -> истекает -> 401. + + Идёт ПОСЛЕДНИМ: при коротком TTL любая долгая подготовка съедает + окно жизни сессии, поэтому соседние тесты работают раньше. + """ + suffix = uuid.uuid4().hex[:10] + username = "ttl_" + suffix + password = "T3st-" + uuid.uuid4().hex + user = c.call("POST", "/api/v1/users", 201, + body={"username": username, "display_name": "TTL", "password": password}, + schema="User")["json"] + cred = base64.b64encode((username + ":" + password).encode()).decode() + session = c.call("POST", "/api/v1/auth/sessions", 201, + headers={"Authorization": "Basic " + cred}, + schema="Session")["json"] + token = session["token"] + + # Контроль: сервер выдал короткий TTL, иначе тест бессмыслен. + expires_at = dt.datetime.fromisoformat(session["expires_at"].replace("Z", "+00:00")) + ttl_actual = (expires_at - dt.datetime.now(dt.timezone.utc)).total_seconds() + check(3.0 <= ttl_actual <= 10, + "SESSION_TTL_SECONDS не короткий (получено %.1f c). " + "Поставь SESSION_TTL_SECONDS=5 в .env и перезапусти API." % ttl_actual) + + # До истечения токен должен работать. + me = c.call("GET", "/api/v1/users/me", 200, + headers={"Authorization": "Bearer " + token}, + schema="User")["json"] + check(me["id"] == user["id"], "token must identify its owner before expiry") + + # Ждём гарантированного истечения TTL + запас. + remaining = (expires_at - dt.datetime.now(dt.timezone.utc)).total_seconds() + time.sleep(max(remaining, 0.0) + 1.0) + + # Истёкший токен — 401. + c.call("GET", "/api/v1/users/me", 401, + headers={"Authorization": "Bearer " + token}) + + # Второй вход тем же пользователем даёт рабочий токен: истёк именно + # первый токен, а не пользователь/хранилище целиком. + session2 = c.call("POST", "/api/v1/auth/sessions", 201, + headers={"Authorization": "Basic " + cred}, + schema="Session")["json"] + c.call("GET", "/api/v1/users/me", 200, + headers={"Authorization": "Bearer " + session2["token"]}, + schema="User") + + # ---------- main ---------- def main(): args = arguments("Lab2 level 4 checks") c = Client(args.base_url, args.ca_file) - # Expiry-тест запускается первым: при коротком TTL любая подготовка - # (bootstrap, конкурентная регистрация) съедает окно жизни сессии. - print("=== test_short_ttl_expiry ===") - test_short_ttl_expiry(c) - print("PASS: session valid before TTL, expires after TTL, 401 on expired token") - + # Порядок: сначала тяжёлые/долгие тесты, expiry — последним, + # потому что при коротком TTL он «сжигает» сессии. print("=== test_concurrent_registration ===") test_concurrent_registration(c) print("PASS: concurrent registration produces exactly one user") @@ -275,6 +304,10 @@ def main(): test_redis_unavailable(c) print("PASS: readiness 503 без Redis, затем восстановление") + print("=== test_short_ttl_expiry ===") + test_short_ttl_expiry(c) + print("PASS: session valid before TTL, expires after TTL, 401 on expired token") + print("PASS: all lab2 level-4 checks passed")