diff --git a/backend/tests/skip_allowlist.txt b/backend/tests/skip_allowlist.txt index d1c28220..0c08811c 100644 --- a/backend/tests/skip_allowlist.txt +++ b/backend/tests/skip_allowlist.txt @@ -165,3 +165,14 @@ tests/sql/test_2986_permits_source_key.py::test_old_key_collapses_permit_and_its tests/sql/test_2986_permits_source_key.py::test_after_migration_both_documents_survive tests/sql/test_2986_permits_source_key.py::test_cross_schema_duplicate_still_merges tests/sql/test_2986_permits_source_key.py::test_migration_allows_the_izmeneniya_group + +# #2998 — горизонт партиций rosreestr_deals. Четыре DB-теста поднимают rosreestr_deals из +# 01_schema в СХЕМЕ-ПЕСОЧНИЦЕ (герметично, прод не трогают), применяют миграцию 193 и +# читают горизонт из pg_inherits: до 193 красно по значению (01-схема кончается на 2026q1), +# после — партиция есть на публикуемый квартал + на следующий; 193 идемпотентна. +# В CI ИДУТ (postgres-сервис, #2745); записи нужны для машины без БД. Календарный +# test_calendar_helper_matches_known_publication базы НЕ требует и в список НЕ входит. +tests/sql/test_2998_rosreestr_partition_horizon.py::test_schema_01_alone_is_red_for_the_publishable_quarter +tests/sql/test_2998_rosreestr_partition_horizon.py::test_migration_193_is_idempotent_and_closes_the_gap +tests/sql/test_2998_rosreestr_partition_horizon.py::test_partition_exists_for_every_publishable_quarter +tests/sql/test_2998_rosreestr_partition_horizon.py::test_partition_exists_one_quarter_ahead diff --git a/backend/tests/sql/test_2998_rosreestr_partition_horizon.py b/backend/tests/sql/test_2998_rosreestr_partition_horizon.py new file mode 100644 index 00000000..1275c420 --- /dev/null +++ b/backend/tests/sql/test_2998_rosreestr_partition_horizon.py @@ -0,0 +1,193 @@ +"""У rosreestr_deals есть партиция под каждый квартал, который Росреестр уже мог +опубликовать (#2998). + +Таблица партиционирована по period_start_date, и партиции создавались списком в +01_schema_rosreestr_deals.sql — «2024 Q3 — 2026 Q1». Дальше этого горизонта таблица +ничего не знала, и никакой механизм новые партиции не создаёт. Q2 2026 вышел 10.07, +poll заметил его 14.08, а загрузка 21.08 упала: + + ERROR: no partition of relation "rosreestr_deals" found for row + DETAIL: Partition key of the failing row contains (period_start_date) = (2026-04-01). + +То есть даже оператор, запустив 02_load_all_quarters.sh по подсказке poll, получил +бы отказ. Миграция 193 добавляет Q2–Q4 2026; этот тест следит, чтобы горизонт не +отставал снова: партиция обязана существовать на ПОСЛЕДНИЙ квартал, который по +календарю уже мог быть опубликован (публикация отстаёт от конца квартала ~на 10 +дней: Q2 2026 вышел 10.07), плюс на следующий — чтобы предупреждение приходило за +квартал до отказа, а не в день публикации. + +Герметично, как соседние DB-тесты: в своей СХЕМЕ-песочнице поднимается +rosreestr_deals из 01_schema (без индексов), применяется миграция 193, горизонт +читается из pg_inherits по этой схеме. Прод не трогается; в CI идёт на +postgres-сервисе. Без БД — skip с причиной. + +Красная сторона воспроизводима, а не предполагается: до миграции 193 горизонт +01-схемы кончается на 2026q1, и головная проверка краснеет по значению +(«нет партиции на квартал 2026-04-01»). +""" + +from __future__ import annotations + +import os + +os.environ.setdefault("DATABASE_URL", "postgresql+psycopg://test:test@localhost:5432/test") + +import re +import uuid +from datetime import date, timedelta +from pathlib import Path + +import pytest +from sqlalchemy import create_engine, text + +_SQL_DIR = Path(__file__).resolve().parents[3] / "data" / "sql" +_SCHEMA_01 = _SQL_DIR / "01_schema_rosreestr_deals.sql" +_MIGRATION = _SQL_DIR / "193_partitions_rosreestr_2026_q2_q4.sql" + +# Публикация квартала отстаёт от его конца; берём запас, чтобы не требовать партицию +# раньше, чем данные вообще могут появиться. Q2 2026 (конец 30.06) опубликован 10.07. +_PUBLICATION_LAG_DAYS = 20 + + +def _dsn() -> str: + raw = os.environ.get("TEST_DATABASE_URL") or os.environ.get( + "DATABASE_URL", "postgresql+psycopg://gendesign@localhost:15432/gendesign" + ) + return raw.replace("postgresql://", "postgresql+psycopg://", 1) + + +def _quarter_start(d: date) -> date: + return date(d.year, 3 * ((d.month - 1) // 3) + 1, 1) + + +def _next_quarter(q: date) -> date: + return date(q.year + (q.month == 10), 1 if q.month == 10 else q.month + 3, 1) + + +def _latest_publishable_quarter(today: date) -> date: + """Начало последнего квартала, чей дамп по календарю уже мог выйти.""" + q = _quarter_start(today) + prev_q = _quarter_start(q - timedelta(days=1)) + if (today - q).days >= _PUBLICATION_LAG_DAYS: + return prev_q + return _quarter_start(prev_q - timedelta(days=1)) + + +def _schema_01_without_indexes() -> str: + """01_schema без CREATE INDEX: индексы тесту не нужны, а часть их — по колонкам, + которых в песочнице проверять нечего. Партиции и сама таблица — целиком.""" + sql = _SCHEMA_01.read_text(encoding="utf-8") + return re.sub(r"CREATE INDEX[^;]*;", "", sql, flags=re.S) + + +def _partition_starts(conn, schema: str) -> set[date]: + rows = conn.execute( + text( + """ + SELECT pg_get_expr(c.relpartbound, c.oid) AS bound + FROM pg_inherits i + JOIN pg_class c ON c.oid = i.inhrelid + JOIN pg_class p ON p.oid = i.inhparent + JOIN pg_namespace n ON n.oid = p.relnamespace + WHERE p.relname = 'rosreestr_deals' AND n.nspname = :schema + """ + ), + {"schema": schema}, + ).scalars() + out: set[date] = set() + for b in rows: + frm = b.split("FROM ('", 1)[1].split("'", 1)[0] + out.add(date.fromisoformat(frm)) + return out + + +@pytest.fixture(scope="module") +def sandbox(): + """Схема-песочница с rosreestr_deals из 01_schema. Удаляется в конце модуля.""" + try: + eng = create_engine(_dsn(), future=True) + conn = eng.connect() + conn.execute(text("SELECT 1")) + conn.rollback() # SELECT 1 авто-открыл транзакцию — закрыть, иначе begin() падает + except Exception as e: # pragma: no cover - среда без БД + pytest.skip(f"нет Postgres для проверки партиций: {e}") + schema = f"t2998_{uuid.uuid4().hex[:10]}" + with conn.begin(): + conn.execute(text(f"CREATE SCHEMA {schema}")) + conn.execute(text(f"SET LOCAL search_path TO {schema}")) + conn.execute(text(_schema_01_without_indexes())) + try: + yield conn, schema + finally: + conn.rollback() + with conn.begin(): + conn.execute(text(f"DROP SCHEMA {schema} CASCADE")) + conn.close() + + +def _apply_193(conn, schema: str) -> None: + conn.rollback() # предыдущие SELECT авто-открыли транзакцию + with conn.begin(): + conn.execute(text(f"SET LOCAL search_path TO {schema}")) + conn.execute(text(_MIGRATION.read_text(encoding="utf-8"))) + + +def test_schema_01_alone_is_red_for_the_publishable_quarter(sandbox) -> None: + """Красная сторона: ДО миграции 193 партиции на публикуемый квартал нет. + + Это ровно состояние origin/main на 21.08.2026, когда загрузка Q2 упала. + Проверка по значению: горизонт 01-схемы кончается на 2026q1. + """ + conn, schema = sandbox + have = _partition_starts(conn, schema) + assert have, "песочница пуста — 01_schema не применилась" + assert max(have) == date( + 2026, 1, 1 + ), f"горизонт 01-схемы ожидался 2026q1, есть {sorted(have)[-2:]}" + need = date(2026, 4, 1) # публикуемый квартал на дату инцидента + assert need not in have, "красная сторона не состоялась: 01-схема уже знает Q2 2026" + + +def test_migration_193_is_idempotent_and_closes_the_gap(sandbox) -> None: + """Миграция применяется дважды без ошибки и добавляет Q2–Q4 2026.""" + conn, schema = sandbox + _apply_193(conn, schema) + _apply_193(conn, schema) + have = _partition_starts(conn, schema) + assert {date(2026, 4, 1), date(2026, 7, 1), date(2026, 10, 1)} <= have, sorted(have)[-4:] + + +def test_partition_exists_for_every_publishable_quarter(sandbox) -> None: + """Головной сторож горизонта: на каждый уже-публикуемый квартал есть партиция. + + Сегодня это Q2 2026 (после 193 — есть). Когда календарь дойдёт до квартала, + которого миграции ещё не создали, тест покраснеет по значению — и это его работа. + """ + conn, schema = sandbox + _apply_193(conn, schema) + have = _partition_starts(conn, schema) + need = _latest_publishable_quarter(date.today()) + assert need in have, ( + f"нет партиции на квартал {need} — загрузка опубликованного дампа упадёт с " + f"«no partition of relation rosreestr_deals found for row»; есть: {sorted(have)[-3:]}" + ) + + +def test_partition_exists_one_quarter_ahead(sandbox) -> None: + """Контроль горизонта: партиция на СЛЕДУЮЩИЙ квартал тоже есть — предупреждение + должно приходить за квартал до отказа, а не в день публикации.""" + conn, schema = sandbox + _apply_193(conn, schema) + have = _partition_starts(conn, schema) + need = _next_quarter(_latest_publishable_quarter(date.today())) + assert need in have, ( + f"нет партиции на следующий квартал {need} — запаса нет, следующая публикация " + f"снова упрётся в отсутствие партиции; есть: {sorted(have)[-3:]}" + ) + + +def test_calendar_helper_matches_known_publication() -> None: + """Контроль калибровки (без БД): 21.08.2026 → Q2 2026; 05.07 → ещё Q1; 25.07 → Q2.""" + assert _latest_publishable_quarter(date(2026, 8, 21)) == date(2026, 4, 1) + assert _latest_publishable_quarter(date(2026, 7, 5)) == date(2026, 1, 1) + assert _latest_publishable_quarter(date(2026, 7, 25)) == date(2026, 4, 1) diff --git a/data/sql/02_load_all_quarters.sh b/data/sql/02_load_all_quarters.sh index 69326c0c..51f63383 100644 --- a/data/sql/02_load_all_quarters.sh +++ b/data/sql/02_load_all_quarters.sh @@ -1,5 +1,5 @@ #!/usr/bin/env bash -# Loads all 7 quarters of dataset_СДЕЛКИ into rosreestr_deals via staging. +# Loads quarters of dataset_СДЕЛКИ into rosreestr_deals via staging (see JOBS below). # Q3 2024 uses ';' separator, all later quarters use '~'. # # Usage: @@ -42,6 +42,12 @@ declare -a JOBS=( "2025Q3:2025-07-01:dataset_СДЕЛКИ_r-r_01-92_y_2025_q_3.csv:~" "2025Q4:2025-10-01:dataset_СДЕЛКИ_r-r_01-92_y_2025_q_4.csv:~" "2026Q1:2026-01-01:dataset_СДЕЛКИ_r-r_01-92_y_2026_q_1.csv:~" + # #2998: партиции под Q2–Q4 2026 — миграция 193. Загрузчик скипает квартал, для + # которого нет CSV в data/raw/, поэтому строки на ещё не опубликованные кварталы + # безопасны: они ждут файла, а не падают. + "2026Q2:2026-04-01:dataset_СДЕЛКИ_r-r_01-92_y_2026_q_2.csv:~" + "2026Q3:2026-07-01:dataset_СДЕЛКИ_r-r_01-92_y_2026_q_3.csv:~" + "2026Q4:2026-10-01:dataset_СДЕЛКИ_r-r_01-92_y_2026_q_4.csv:~" ) # Возможные имена zip-ов в data/raw/ (можно класть как есть, скрипт распакует). @@ -82,7 +88,12 @@ resolve_csv() { for job in "${JOBS[@]}"; do IFS=':' read -r SRC_Q PERIOD FILE_CANDIDATES SEP <<< "$job" - FILE=$(resolve_csv "$FILE_CANDIDATES" "$SRC_Q") + # `|| true` обязателен (#2998): resolve_csv сигналит «файла нет» кодом 1, а скрипт + # идёт под `set -e` — без этого первый же квартал без CSV в data/raw/ молча ронял + # ВЕСЬ прогон до строки SKIP, и до реально лежащего файла (например, одного Q2 на + # VPS) загрузчик не доходил никогда. Проверено на проде 21.08: с одним Q2-файлом в + # каталоге скрипт завершался с rc=0, не напечатав ни одной строки. + FILE=$(resolve_csv "$FILE_CANDIDATES" "$SRC_Q" || true) if [[ -z "$FILE" ]]; then echo "=== $SRC_Q SKIP — нет CSV в data/raw/ (искал: $FILE_CANDIDATES; sdelki_${SRC_Q,,}.csv.zip)" continue diff --git a/data/sql/193_partitions_rosreestr_2026_q2_q4.sql b/data/sql/193_partitions_rosreestr_2026_q2_q4.sql new file mode 100644 index 00000000..d0a26ef8 --- /dev/null +++ b/data/sql/193_partitions_rosreestr_2026_q2_q4.sql @@ -0,0 +1,29 @@ +-- Партиции rosreestr_deals на Q2–Q4 2026 (#2998). +-- +-- Почему это понадобилось. Схема 01_schema_rosreestr_deals.sql создавала партиции +-- списком «2024 Q3 — 2026 Q1» — дальше этого горизонта таблица ничего не знала, и +-- никакой механизм новые партиции не создаёт. Q2 2026 опубликован Росреестром +-- 10.07, poll заметил его 14.08, а загрузка упёрлась бы в +-- ERROR: no partition of relation "rosreestr_deals" found for row +-- DETAIL: Partition key of the failing row contains (period_start_date) = (2026-04-01) +-- — ровно это и случилось при первой попытке загрузить 21.08. То есть даже оператор, +-- запустив 02_load_all_quarters.sh по подсказке poll, получил бы отказ. +-- +-- Создаём с запасом на три квартала вперёд, чтобы каждый новый квартал не начинался +-- с этой же ошибки. Q1 2027 и далее — следующая такая же миграция (или автосоздание, +-- если до него дойдут руки; пока его нет нигде — проверено grep'ом по app/ и data/sql/). +-- +-- Индексы НЕ перечисляем: партиции наследуют четыре индекса родителя автоматически +-- (проверено по rosreestr_deals_2026q1: pkey(id, period_start_date), doc_type partial, +-- realestate_type_code, (region_code, quarter_cad_number)). +-- +-- Range FROM inclusive, TO exclusive — [start_q, start_next_q). Идемпотентно. + +SET LOCAL lock_timeout = '5s'; + +CREATE TABLE IF NOT EXISTS rosreestr_deals_2026q2 PARTITION OF rosreestr_deals + FOR VALUES FROM ('2026-04-01') TO ('2026-07-01'); +CREATE TABLE IF NOT EXISTS rosreestr_deals_2026q3 PARTITION OF rosreestr_deals + FOR VALUES FROM ('2026-07-01') TO ('2026-10-01'); +CREATE TABLE IF NOT EXISTS rosreestr_deals_2026q4 PARTITION OF rosreestr_deals + FOR VALUES FROM ('2026-10-01') TO ('2027-01-01');