diff --git a/.forgejo/workflows/ci.yml b/.forgejo/workflows/ci.yml index 66b80da9..baf5c736 100644 --- a/.forgejo/workflows/ci.yml +++ b/.forgejo/workflows/ci.yml @@ -82,6 +82,22 @@ jobs: python3 scripts/check-caddy-snippet-mounts.py --selftest python3 scripts/check-caddy-snippet-mounts.py + - name: "Guard: сервисы МЕРЫ не ссылаются на двоящееся имя" + # ПТИЦА и МЕРА — разные compose-проекты, но оба назвали сервисы + # `backend`/`postgres`/`frontend` и оба сидят в общей сети + # gendesign_shared. Docker отдаёт на такое имя ДВА адреса, клиент + # берёт любой. + # + # 30.08.2026 это уронило публичный лендинг: BACKEND_URL вёл в бэкенд + # ПТИЦЫ, тот отвечал 401, и страница про точность рендерилась БЕЗ + # ленты сделок, без строк сверки и без подписи разброса — то есть без + # единого доказательства. Отказ тихий: fetch не бросает, приходит + # валидный чужой ответ; а из-за двоения часть перегенераций попадала + # в правильный адрес, и поломка выглядела случайной. + run: | + python3 scripts/check-compose-ambiguous-hosts.py --selftest + python3 scripts/check-compose-ambiguous-hosts.py + - name: "Guard: Caddyfile синтаксически валиден" # Тем же шагом-соседом и по той же причине, что два гейта рядом: бежит # на КАЖДОМ PR, стоит секунды, падение блокирует merge. diff --git a/caddy/sites/apps.caddy b/caddy/sites/apps.caddy index 8010c04b..085146a4 100644 --- a/caddy/sites/apps.caddy +++ b/caddy/sites/apps.caddy @@ -347,7 +347,7 @@ meraocenka.ru { # `trailingSlash: false` ответил бы на такой путь 308-редиректом на вариант # без слэша — то есть на ДЛИННЫЙ адрес, который handle ниже отправит 301 на # «/», и запрос закольцуется. - @meraPages path /estimate /oferta /refund /privacy /articles /articles/kak-ocenit-kvartiru /docs + @meraPages path /estimate /oferta /refund /privacy /articles /articles/kak-ocenit-kvartiru /docs /business handle @meraPages { rewrite * /trade-in/mera-public{path} reverse_proxy tradein-frontend:3000 { @@ -361,7 +361,7 @@ meraocenka.ru { # голый 404 (так было и до этого PR, с момента #2615). Заодно это # замыкает цепочку для длинных адресов со слэшем: они приходят на короткий # со слэшем и здесь нормализуются. - @meraShortSlash path_regexp shortslash ^/(estimate|oferta|refund|privacy|articles|articles/kak-ocenit-kvartiru|docs)/$ + @meraShortSlash path_regexp shortslash ^/(estimate|oferta|refund|privacy|articles|articles/kak-ocenit-kvartiru|docs|business)/$ handle @meraShortSlash { redir * /{re.shortslash.1} permanent } @@ -446,7 +446,7 @@ meraocenka.ru { # порядок директив внутри `handle` определяет Caddy, и без неё `redir` # выполняется РАНЬШЕ `uri`, отдавая Location, равный исходному адресу # (бесконечный цикл; поймано на локальном стенде). - @meraLongPages path /trade-in/mera-public/estimate /trade-in/mera-public/estimate/ /trade-in/mera-public/oferta /trade-in/mera-public/oferta/ /trade-in/mera-public/refund /trade-in/mera-public/refund/ /trade-in/mera-public/privacy /trade-in/mera-public/privacy/ /trade-in/mera-public/articles /trade-in/mera-public/articles/ /trade-in/mera-public/articles/kak-ocenit-kvartiru /trade-in/mera-public/articles/kak-ocenit-kvartiru/ /trade-in/mera-public/docs /trade-in/mera-public/docs/ + @meraLongPages path /trade-in/mera-public/estimate /trade-in/mera-public/estimate/ /trade-in/mera-public/oferta /trade-in/mera-public/oferta/ /trade-in/mera-public/refund /trade-in/mera-public/refund/ /trade-in/mera-public/privacy /trade-in/mera-public/privacy/ /trade-in/mera-public/articles /trade-in/mera-public/articles/ /trade-in/mera-public/articles/kak-ocenit-kvartiru /trade-in/mera-public/articles/kak-ocenit-kvartiru/ /trade-in/mera-public/docs /trade-in/mera-public/docs/ /trade-in/mera-public/business /trade-in/mera-public/business/ handle @meraLongPages { route { uri strip_prefix /trade-in/mera-public diff --git a/scripts/check-compose-ambiguous-hosts.py b/scripts/check-compose-ambiguous-hosts.py new file mode 100755 index 00000000..669a55ff --- /dev/null +++ b/scripts/check-compose-ambiguous-hosts.py @@ -0,0 +1,162 @@ +#!/usr/bin/env python3 +"""Гейт: сервисы МЕРЫ не ссылаются друг на друга именем, которое двоится (#3282). + +ПОЧЕМУ. ПТИЦА и МЕРА — разные compose-проекты, но оба назвали свои сервисы +`backend`, `postgres`, `frontend`, и оба подключены к общей сети +`gendesign_shared`. Docker отдаёт ОБА адреса на такое имя, клиент берёт любой: + + изнутри tradein-frontend: + backend → 172.18.0.6 (МЕРА) + 172.18.0.9 (ПТИЦА) + tradein-backend → 172.18.0.6 + +30.08.2026 это уронило публичный лендинг. `BACKEND_URL=http://backend:8000` +уводил серверный рендер в бэкенд ПТИЦЫ, тот отвечал `401 no authenticated +user`, и страница рендерилась БЕЗ витрины: без ленты сделок, без строк сверки +«прогноз против факта» и без подписи разброса. Страница про точность — без +единого доказательства. + +Отказ был ТИХИЙ вдвойне. Во-первых, `fetch` не бросает: приходит валидный HTTP- +ответ, просто чужой. Во-вторых, имя двоится, поэтому часть перегенераций +попадала в правильный адрес — утром страница отдавалась с данными, к обеду без +них, и выглядело это как случайная поломка, а не как ошибка конфигурации. + +У DSN та же болезнь и худшая цена: `@postgres:5432/tradein` мог уйти в базу +ПТИЦЫ. Там спасало лишь несовпадение кредов — то есть отказ вместо тихого +чтения не тех данных. На такую защиту полагаться нельзя: она держится на том, +что у чужой базы нет пользователя с нашим паролем. + +ЧТО ДЕЛАЕТ. Берёт имена сервисов ОБОИХ compose, находит пересечение (это и есть +двоящиеся имена) и проверяет, что в compose МЕРЫ нет ссылок на них как на хост +— ни `http://<имя>:порт`, ни `@<имя>:порт` в DSN. Лечение всегда одно: +подставить `container_name` (`tradein-backend`, `tradein-postgres`), он +однозначен по построению. + +ЧЕГО НЕ ЛОВИТ. Ссылки, собираемые в рантайме из кусков, и имена, попадающие в +контейнер иным путём (`.env` на хосте, секреты CI). Гейт читает только оба +compose-файла. +""" + +from __future__ import annotations + +import argparse +import re +import sys +from pathlib import Path + +REPO = Path(__file__).resolve().parent.parent +MERA_COMPOSE = REPO / "tradein-mvp" / "docker-compose.prod.yml" +PTICA_COMPOSE = REPO / "docker-compose.prod.yml" + +# Имя сервиса верхнего уровня: ровно два пробела, затем имя и двоеточие. +_SERVICE_RE = re.compile(r"^ ([a-z][a-z0-9_-]*):\s*$", re.M) +# Ссылка на хост: `//имя:порт` (URL) либо `@имя:порт` (DSN). +_HOST_RE = re.compile(r"(?://|@)([a-z][a-z0-9_-]*):\d+") + + +def service_names(text: str) -> set[str]: + """Имена сервисов верхнего уровня. Тома и сети сюда не попадают: они + объявляются в своих секциях с тем же отступом, поэтому список заведомо шире + нужного — и это безопасная сторона, лишнее имя даст лишнюю проверку, а не + пропуск.""" + return set(_SERVICE_RE.findall(text)) + + +def violations(mera: str, ptica: str) -> list[str]: + ambiguous = service_names(mera) & service_names(ptica) + if not ambiguous: + return [] + found: list[str] = [] + for num, line in enumerate(mera.splitlines(), 1): + stripped = line.strip() + if stripped.startswith("#"): + continue + for host in _HOST_RE.findall(line): + if host in ambiguous: + found.append(f"{MERA_COMPOSE.name}:{num}: хост «{host}» двоится → {stripped[:90]}") + return found + + +def selftest() -> int: + """Гейт обязан уметь краснеть — иначе зелёный ничего не значит.""" + ptica = "services:\n backend:\n image: x\n postgres:\n image: y\n" + + # У фикстуры МЕРЫ обязан быть сервис с ИМЕНЕМ ИЗ ПТИЦЫ — иначе пересечение + # пусто, проверять нечего, и «не поймал» означало бы «нечего было ловить». + # На этом селфтест и провалился в первой редакции. + bad = ( + "services:\n backend:\n image: x\n" + " frontend:\n environment:\n URL: \"http://backend:8000\"\n" + ) + if not violations(bad, ptica): + print("СЕЛФТЕСТ ПРОВАЛЕН: двоящийся хост в URL не пойман", file=sys.stderr) + return 1 + + bad_dsn = ( + "services:\n postgres:\n image: y\n" + " backend:\n environment:\n DSN: \"pg://u:p@postgres:5432/db\"\n" + ) + if not violations(bad_dsn, ptica): + print("СЕЛФТЕСТ ПРОВАЛЕН: двоящийся хост в DSN не пойман", file=sys.stderr) + return 1 + + ok = ( + "services:\n backend:\n image: x\n" + " frontend:\n environment:\n URL: \"http://tradein-backend:8000\"\n" + ) + if violations(ok, ptica): + print("СЕЛФТЕСТ ПРОВАЛЕН: однозначное имя признано нарушением", file=sys.stderr) + return 1 + + # Закомментированная строка — не конфигурация. + commented = ( + "services:\n backend:\n image: x\n" + " frontend:\n environment:\n # URL: \"http://backend:8000\"\n" + ) + if violations(commented, ptica): + print("СЕЛФТЕСТ ПРОВАЛЕН: комментарий принят за ссылку", file=sys.stderr) + return 1 + + print("селфтест пройден: гейт краснеет на URL и на DSN, молчит на однозначном имени") + return 0 + + +def main() -> int: + ap = argparse.ArgumentParser(description=__doc__) + ap.add_argument("--selftest", action="store_true", help="проверить, что гейт умеет краснеть") + args = ap.parse_args() + + if args.selftest: + return selftest() + + for path in (MERA_COMPOSE, PTICA_COMPOSE): + if not path.exists(): + print(f"НЕ НАЙДЕН: {path}", file=sys.stderr) + return 1 + + mera = MERA_COMPOSE.read_text(encoding="utf-8") + ptica = PTICA_COMPOSE.read_text(encoding="utf-8") + + shared = service_names(mera) & service_names(ptica) + if not shared: + print("пересекающихся имён сервисов нет — проверять нечего") + return 0 + + found = violations(mera, ptica) + if not found: + print(f"ok: двоятся имена {sorted(shared)}, но ссылок на них как на хост нет") + return 0 + + print("Ссылка на ДВОЯЩЕЕСЯ имя сервиса:\n", file=sys.stderr) + for line in found: + print(f" {line}", file=sys.stderr) + print( + "\nОба продукта делят сеть gendesign_shared, поэтому такое имя резолвится\n" + "в два адреса и клиент берёт любой. Подставьте container_name\n" + "(tradein-backend, tradein-postgres) — он однозначен.", + file=sys.stderr, + ) + return 1 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/scripts/smoke-mera-perimeter.sh b/scripts/smoke-mera-perimeter.sh index 52357c7b..478adcda 100644 --- a/scripts/smoke-mera-perimeter.sh +++ b/scripts/smoke-mera-perimeter.sh @@ -90,6 +90,11 @@ check "meraocenka.ru/privacy — public 200" "$BASE_MERA/privacy" 200 # лэндинга. Отвалится handle — кнопки «Проверить» станут ссылками в 404. check "meraocenka.ru/estimate — public 200" "$BASE_MERA/estimate" 200 +# 1d2. Страница «МЕРА для бизнеса» — короткий адрес, на который ведут пункт +# шапки и подвала. До 31.08.2026 они вели в закрытый контур и приводили +# человека на форму входа; отвалится handle — вернётся 404 вместо неё. +check "meraocenka.ru/business — public 200" "$BASE_MERA/business" 200 + # 1e. Длинные адреса поддерева отдают 301 на короткие: у страницы один # канонический адрес, а старые ссылки и закладки продолжают работать. # ГОЛЫЙ /trade-in/mera-public — регресс на баг 15.08.2026: прежний матчер diff --git a/tradein-mvp/backend/app/tasks/landing_showcase_deals.py b/tradein-mvp/backend/app/tasks/landing_showcase_deals.py index ec69b54a..881f3728 100644 --- a/tradein-mvp/backend/app/tasks/landing_showcase_deals.py +++ b/tradein-mvp/backend/app/tasks/landing_showcase_deals.py @@ -30,8 +30,8 @@ самой сделки. Отбраковываем только то, чего в данных НЕТ (нет прогноза, нет квартала, нет площади) — «число некрасивое» причиной не является. -Полнота — сколько из полей, которые видит посетитель (район, этаж, этажность), -у строки заполнено. Свежесть — порядок квартала сделки. +Полнота — сколько из полей, которые видит посетитель (район, этаж, этажность, +схема улицы), у строки заполнено. Свежесть — порядок квартала сделки. ЧЕСТНОСТЬ ВИТРИНЫ (нарушение любого пункта = витрина врёт) ---------------------------------------------------------- @@ -69,7 +69,10 @@ нет ни координат окна, ни констант проекции: точку дома по ней нельзя поставить даже случайно. Название сматчилось с OSM у 550 из 654 названий — 92.3% сделок; остальным `street_scheme` = NULL, и это штатно: фронт - показывает район. Наличие схемы НА ОТБОР НЕ ВЛИЯЕТ (см. `_schemes_for`). + показывает район. Наличие схемы ВХОДИТ В ПОЛНОТУ (см. `completeness`): + строка, которой нечем нарисовать карту, полнее строки с картой быть не + может. Это признак «поле заполнено», как район и этаж, а не величина + ошибки, — правило отбора выше не нарушено. * СЧЁТЧИКИ ЕДУТ НА ФРОНТ, А НЕ ТОЛЬКО В ЛОГ. «Мы показываем 20 отличных строк» неотличимо от «столько и было», пока рядом не написано, сколько сделок рассмотрено и сколько годных строк не поместилось. Поэтому итог @@ -97,7 +100,7 @@ from typing import Any from sqlalchemy import text from sqlalchemy.orm import Session -from app.services.street_scheme import build_street_scheme, load_street_index +from app.services.street_scheme import StreetIndex, build_street_scheme, load_street_index logger = logging.getLogger(__name__) @@ -158,15 +161,26 @@ class ShowcaseRow: # None штатно: у части сделок координаты нет, подставлять туда нечего. lat: float | None = None lon: float | None = None + # Есть ли чем нарисовать схему улицы (название сделки нашлось в OSM). + # Саму схему строим только для показанных строк — см. `_schemes_for`. + has_street: bool = False def completeness(row: ShowcaseRow) -> int: - """Сколько ВИДИМЫХ посетителю полей заполнено (0..3). + """Сколько ВИДИМЫХ посетителю полей заполнено (0..4). - Считаем район/этаж/этажность: комнаты и площадь есть у всех кандидатов по - построению выборки, поэтому в оценке полноты они бесполезны. + Считаем район/этаж/этажность и схему улицы: комнаты и площадь есть у всех + кандидатов по построению выборки, поэтому в оценке полноты они бесполезны. + + СХЕМА УЛИЦЫ — ТАКОЕ ЖЕ ВИДИМОЕ ПОЛЕ, как район. Строка без улицы рисует на + фронте полигон РАЙОНА вместо схемы улиц, то есть этого поля у неё просто + нет, и полнее строки с картой она быть не может. Это признак наличия + данных, а не величина ошибки: строка с большим отклонением, но со схемой, + показывается как есть. """ - return sum(x is not None for x in (row.district, row.floor, row.total_floors)) + return int(row.has_street) + sum( + x is not None for x in (row.district, row.floor, row.total_floors) + ) def _sort_key(row: ShowcaseRow) -> tuple[int, date, int]: @@ -197,6 +211,7 @@ def build_row( n_analogs: int, lat: float | None = None, lon: float | None = None, + has_street: bool = False, ) -> ShowcaseRow | None: """Кандидат → строка витрины, либо None если считать не из чего. @@ -251,6 +266,7 @@ def build_row( n_analogs=n_analogs, lat=lat, lon=lon, + has_street=has_street, ) @@ -320,19 +336,27 @@ _INSERT_SQL = text( ) -def _schemes_for(db: Session, chosen: list[ShowcaseRow], addresses: dict[int, str | None]) -> dict: +def _schemes_for( + db: Session, + index: StreetIndex, + chosen: list[ShowcaseRow], + addresses: dict[int, str | None], +) -> dict: """Схемы улиц ТОЛЬКО для показанных строк: id сделки → схема. Считаем после отбора, а не до: схема — это два пространственных запроса на сделку, и на двухстах кандидатах ради двадцати показанных это четыреста лишних запросов в чужую базу. - НА ОТБОР НАЛИЧИЕ СХЕМЫ НЕ ВЛИЯЕТ — и это то же правило, что запрещает отбор - по величине ошибки. Ранжируй мы строки со сматчившейся улицей выше, витрина - показывала бы не работу оценщика, а те 92% адресов, которые удобно легли на - OSM. Схема — украшение строки, а не причина её показать. + НА ОТБОР ВЛИЯЕТ НЕ ЭТОТ ШАГ, А ПОЛНОТА (`completeness`), куда наличие улицы + входит наравне с районом и этажом. До 2026-08-31 здесь было записано + обратное — «схема на отбор не влияет», — и первой строкой витрины и первым + раундом игры стояла единственная из двадцати сделка БЕЗ улицы: у неё вместо + схемы улиц рисовался полигон района. Отсутствие видимого поля не может + делать строку самой полной. Запрет отбора по ВЕЛИЧИНЕ ОШИБКИ этим не + затронут: строка с большим отклонением, но со схемой, стоит в витрине как + есть. """ - index = load_street_index(db) out = {} for row in chosen: scheme = build_street_scheme(db, index, addresses.get(row.deal_id)) @@ -377,6 +401,10 @@ def refresh_landing_showcase_deals( logger.info("витрина: загружено %d ДКП-сделок (city=%s, since=%s)", len(deals), city, since) districts = _fetch_districts(db, [d.id for d in deals]) + # Индекс улиц нужен ДО отбора: сматчился ли адрес с OSM — это признак + # полноты строки. Поиск по индексу идёт в памяти, запрос ровно один на + # прогон, дорогие пространственные запросы остались в `_schemes_for`. + street_index = load_street_index(db) candidates: list[ShowcaseRow] = [] n_priced = 0 @@ -408,6 +436,7 @@ def refresh_landing_showcase_deals( # тип этого не поймает: обе величины float. lat=deal.lat, lon=deal.lon, + has_street=street_index.lookup(deal.address) is not None, ) if row is None: n_incomplete += 1 @@ -415,7 +444,7 @@ def refresh_landing_showcase_deals( candidates.append(row) chosen = select_rows(candidates, limit) - schemes = _schemes_for(db, chosen, {d.id: d.address for d in deals}) + schemes = _schemes_for(db, street_index, chosen, {d.id: d.address for d in deals}) db.execute(_DELETE_SQL) db.execute(_DELETE_RUNS_SQL) diff --git a/tradein-mvp/backend/scripts/backtest_estimator.py b/tradein-mvp/backend/scripts/backtest_estimator.py index b2e39d47..41a5b555 100644 --- a/tradein-mvp/backend/scripts/backtest_estimator.py +++ b/tradein-mvp/backend/scripts/backtest_estimator.py @@ -1129,6 +1129,88 @@ _SAMPLE_SQL = text( """ ) +# ── ВЫБОРКА ВРАЗБРОС (--spread scattered) ──────────────────────────────────── +# +# ЗАЧЕМ. `ORDER BY id DESC` выше — это последние ВСТАВЛЕННЫЕ строки, а Росреестр +# грузится пачками по домам: соседние id это один дом и одна улица. Замер на +# проде 31.08.2026 по Екатеринбургу, выборка 200: +# +# последние 200 по id : 38 разных улиц, до 22 сделок с ОДНОЙ улицы +# случайные 200 : 129 разных улиц, максимум 6 с одной +# +# То есть заголовочная точность и вся витрина лэндинга считались по выборке +# втрое беднее случайной. Ошибка при этом не «шумит», а СМЕЩЕНА: пара новостроек +# ведёт себя иначе, чем город. +# +# ПОЧЕМУ НЕ СТАЛО УМОЛЧАНИЕМ. Замороженный регресс-гейт сравнивает прогоны между +# собой и требует от дефолтного пути побайтово того же SQL (см. докстринг +# `_sample_sql`). Менять умолчание значило бы обнулить сравнимость всей истории +# замеров. Режим выбирается явно. +# +# ПОЧЕМУ md5, А НЕ random(). `random()` даёт разную выборку на каждом прогоне — +# два замера подряд отличались бы и из-за правки, и из-за выборки, и разделить +# эти вклады было бы нечем. md5(id || seed) — псевдослучайный, но +# ВОСПРОИЗВОДИМЫЙ порядок: тот же seed → та же выборка. +_SAMPLE_SQL_SCATTERED = text( + """ + SELECT + id, + ST_X(geom::geometry) AS lon, + ST_Y(geom::geometry) AS lat, + rooms, + price_per_m2 AS sold_ppm2, + price_rub, + deal_date, + area_m2, + address, + floor, + total_floors, + year_built, + house_type + FROM deals + WHERE source = 'rosreestr' + AND geom IS NOT NULL + AND price_per_m2 BETWEEN CAST(:ppm2_min AS numeric) AND CAST(:ppm2_max AS numeric) + AND rooms IS NOT NULL + AND area_m2 IS NOT NULL + AND area_m2 > 0 + AND deal_date >= CAST(:since AS date) + ORDER BY md5(CAST(id AS text) || CAST(:seed AS text)) + LIMIT CAST(:sample AS integer) + """ +) + +_SAMPLE_SQL_SCATTERED_CITY = text( + """ + SELECT + id, + ST_X(geom::geometry) AS lon, + ST_Y(geom::geometry) AS lat, + rooms, + price_per_m2 AS sold_ppm2, + price_rub, + deal_date, + area_m2, + address, + floor, + total_floors, + year_built, + house_type + FROM deals + WHERE source = 'rosreestr' + AND geom IS NOT NULL + AND price_per_m2 BETWEEN CAST(:ppm2_min AS numeric) AND CAST(:ppm2_max AS numeric) + AND rooms IS NOT NULL + AND area_m2 IS NOT NULL + AND area_m2 > 0 + AND deal_date >= CAST(:since AS date) + AND city = CAST(:city AS text) + ORDER BY md5(CAST(id AS text) || CAST(:seed AS text)) + LIMIT CAST(:sample AS integer) + """ +) + + # Per-deal candidate active listings. rooms matched within :rooms_lo..:rooms_hi # (exact when tolerance=0). Returns raw price_per_m2 values — _filter_outliers # is applied in Python for byte-for-byte fidelity with the estimator. @@ -1163,7 +1245,7 @@ _CITY_PPM2_BAND_SQL = text( ) -def _sample_sql(city: str | None) -> Any: +def _sample_sql(city: str | None, scattered: bool = False) -> Any: """ДКП deal-sample SELECT — optionally scoped to one ``deals.city`` (oblast D). ``city is None`` (default) returns the SAME ``_SAMPLE_SQL`` object used @@ -1177,6 +1259,8 @@ def _sample_sql(city: str | None) -> Any: Russian name as stored in ``deals.city`` (e.g. ``'Нижний Тагил'``), not a slug — see the ``--city`` CLI help for the naming decision. """ + if scattered: + return _SAMPLE_SQL_SCATTERED_CITY if city is not None else _SAMPLE_SQL_SCATTERED if city is None: return _SAMPLE_SQL return text( @@ -1235,7 +1319,13 @@ def _resolve_city_ppm2_band(db: Session, city: str | None) -> tuple[float, float def _load_sample( - db: Session, *, sample: int, since: str, city: str | None = None + db: Session, + *, + sample: int, + since: str, + city: str | None = None, + scattered: bool = False, + seed: str = "mera", ) -> list[DealSample]: """Run the held-out ДКП deal sampling SELECT → list[DealSample]. @@ -1259,7 +1349,9 @@ def _load_sample( } if city is not None: params["city"] = city - rows = db.execute(_sample_sql(city), params).mappings().all() + if scattered: + params["seed"] = seed + rows = db.execute(_sample_sql(city, scattered), params).mappings().all() out: list[DealSample] = [] for r in rows: if r["lon"] is None or r["lat"] is None or r["sold_ppm2"] is None: @@ -2025,6 +2117,8 @@ def run_backtest( rooms_tolerance: int, holdout_split: bool = False, city: str | None = None, + scattered: bool = False, + seed: str = "mera", ) -> dict[str, Any]: """Drive the full read-only backtest and return a metrics dict. @@ -2044,7 +2138,7 @@ def run_backtest( ``deals.city`` value — see ``_load_sample``. Default None is unscoped (byte-identical to the pre-oblast-D behaviour). """ - deals = _load_sample(db, sample=sample, since=since, city=city) + deals = _load_sample(db, sample=sample, since=since, city=city, scattered=scattered, seed=seed) logger.info("loaded sample: %d ДКП deals (since=%s, city=%s)", len(deals), since, city) matched_rows: list[tuple[float, float, int]] = [] @@ -2118,6 +2212,8 @@ def run_backtest_full( dump_fixture: str | None = None, resolve_house_id: bool = False, city: str | None = None, + scattered: bool = False, + seed: str = "mera", ) -> dict[str, Any]: """Drive the FULL-spine read-only backtest and return a metrics dict (#1966). @@ -2150,7 +2246,7 @@ def run_backtest_full( ``_fetch_dkp_corridor`` (oblast C2 parity fix) — see its docstring. """ est = _import_estimator_full() - deals = _load_sample(db, sample=sample, since=since, city=city) + deals = _load_sample(db, sample=sample, since=since, city=city, scattered=scattered, seed=seed) logger.info( "loaded sample: %d ДКП deals (since=%s, city=%s) [full spine]", len(deals), since, city ) @@ -2318,6 +2414,24 @@ def _parse_args(argv: list[str] | None = None) -> argparse.Namespace: default="2025-06-01", help="Only deals with deal_date >= this ISO date (default 2025-06-01).", ) + p.add_argument( + "--spread", + choices=("recent", "scattered"), + default="recent", + help="Как берётся выборка сделок. 'recent' (умолчание) — ORDER BY id DESC, " + "т.е. последние ВСТАВЛЕННЫЕ строки: Росреестр грузится пачками по домам, " + "поэтому такая выборка садится на несколько улиц (замер 31.08.2026 по ЕКБ: " + "38 улиц, до 22 сделок с одной). 'scattered' — воспроизводимый " + "псевдослучайный порядок по md5(id||seed): 129 улиц, максимум 6 с одной. " + "Умолчание оставлено 'recent' ради сравнимости с историей замеров — " + "замороженный регресс-гейт требует от дефолтного пути того же SQL.", + ) + p.add_argument( + "--seed", + default="mera", + help="Соль для --spread scattered. Тот же seed даёт ТУ ЖЕ выборку: два " + "прогона подряд отличаются только правкой, а не составом выборки.", + ) p.add_argument( "--city", default=None, @@ -2458,6 +2572,8 @@ def main(argv: list[str] | None = None) -> int: dump_fixture=args.dump_fixture, resolve_house_id=args.resolve_house_id, city=args.city, + scattered=(args.spread == "scattered"), + seed=args.seed, ) else: metrics = run_backtest( @@ -2468,6 +2584,8 @@ def main(argv: list[str] | None = None) -> int: rooms_tolerance=args.rooms_tolerance, holdout_split=args.holdout_split, city=args.city, + scattered=(args.spread == "scattered"), + seed=args.seed, ) finally: db.close() diff --git a/tradein-mvp/backend/tests/test_backtest_sampling_spread.py b/tradein-mvp/backend/tests/test_backtest_sampling_spread.py new file mode 100644 index 00000000..b4cbeea0 --- /dev/null +++ b/tradein-mvp/backend/tests/test_backtest_sampling_spread.py @@ -0,0 +1,88 @@ +"""Выборка бэктеста: режим «вразброс» и неприкосновенность умолчания. + +ЗАЧЕМ. `ORDER BY id DESC` берёт последние ВСТАВЛЕННЫЕ строки, а Росреестр +грузится пачками по домам: соседние id — это один дом и одна улица. Замер на +проде 31.08.2026 по Екатеринбургу, выборка 200: + + последние 200 по id : 38 разных улиц, до 22 сделок с ОДНОЙ улицы + случайные 200 : 129 разных улиц, максимум 6 с одной + +Выборка втрое беднее случайной — а на ней стояла витрина лэндинга (20 строк с +ЧЕТЫРЁХ улиц, 16 из них с двух). + +ЧТО ЭТОТ ТЕСТ ДЕРЖИТ. Две вещи, и вторая не менее важна первой: + +1. Режим «вразброс» действительно меняет порядок и воспроизводим по seed. +2. УМОЛЧАНИЕ НЕ ТРОНУТО — дефолтный путь обязан отдавать ТОТ ЖЕ объект SQL. + Замороженный регресс-гейт сравнивает прогоны между собой; сменить умолчание + значило бы молча обнулить сравнимость всей истории замеров. +""" + +from __future__ import annotations + +import re + +from scripts.backtest_estimator import ( + _SAMPLE_SQL, + _SAMPLE_SQL_SCATTERED, + _SAMPLE_SQL_SCATTERED_CITY, + _sample_sql, +) + + +def _sql(obj) -> str: + return str(obj.text if hasattr(obj, "text") else obj) + + +class TestУмолчаниеНеТронуто: + def test_дефолтный_путь_отдаёт_тот_же_объект(self): + # Именно identity, а не равенство текста: докстринг `_sample_sql` + # обещает побайтовую неизменность, и «текст совпал» это обещание не + # проверяет — объект мог быть пересобран с другими bind-параметрами. + assert _sample_sql(None) is _SAMPLE_SQL + assert _sample_sql(None, scattered=False) is _SAMPLE_SQL + + def test_умолчание_сортирует_по_id_и_не_знает_про_seed(self): + sql = _sql(_SAMPLE_SQL) + assert "ORDER BY id DESC" in sql + assert ":seed" not in sql, "в умолчание протёк параметр режима вразброс" + + +class TestРежимВразброс: + def test_выбирается_явно_и_меняет_порядок(self): + assert _sample_sql(None, scattered=True) is _SAMPLE_SQL_SCATTERED + assert _sample_sql("Екатеринбург", scattered=True) is _SAMPLE_SQL_SCATTERED_CITY + + def test_порядок_воспроизводим_а_не_случаен(self): + # random() дал бы разную выборку на каждом прогоне, и два замера + # подряд отличались бы и из-за правки, и из-за состава выборки — + # разделить вклады было бы нечем. + for obj in (_SAMPLE_SQL_SCATTERED, _SAMPLE_SQL_SCATTERED_CITY): + sql = _sql(obj) + assert "md5(" in sql, "порядок обязан считаться от id и seed" + assert ":seed" in sql + assert re.search(r"\brandom\s*\(", sql) is None, ( + "random() делает выборку неповторимой между прогонами" + ) + assert "ORDER BY id DESC" not in sql + + def test_городской_вариант_фильтрует_город_а_общий_нет(self): + assert "city = CAST(:city AS text)" in _sql(_SAMPLE_SQL_SCATTERED_CITY) + assert "city = CAST(:city AS text)" not in _sql(_SAMPLE_SQL_SCATTERED) + + def test_оба_режима_отбирают_по_одним_и_тем_же_условиям(self): + # Иначе разница между режимами объяснялась бы не порядком, а другим + # набором сделок — и сравнение двух прогонов ничего бы не значило. + общие = [ + "source = 'rosreestr'", + "geom IS NOT NULL", + "price_per_m2 BETWEEN", + "rooms IS NOT NULL", + "area_m2 > 0", + "deal_date >= CAST(:since AS date)", + ] + база = _sql(_SAMPLE_SQL) + вразброс = _sql(_SAMPLE_SQL_SCATTERED) + for условие in общие: + assert условие in база, условие + assert условие in вразброс, условие diff --git a/tradein-mvp/backend/tests/test_landing_showcase_deals.py b/tradein-mvp/backend/tests/test_landing_showcase_deals.py index 702e42f7..80bd3920 100644 --- a/tradein-mvp/backend/tests/test_landing_showcase_deals.py +++ b/tradein-mvp/backend/tests/test_landing_showcase_deals.py @@ -31,6 +31,7 @@ def _row( total_floors: int | None = 9, deal_date: date = date(2026, 1, 1), err_pct: float = 10.0, + has_street: bool = True, ) -> ShowcaseRow: return ShowcaseRow( deal_id=deal_id, @@ -45,6 +46,7 @@ def _row( fact_rub=5_500_000, err_pct=err_pct, n_analogs=40, + has_street=has_street, ) @@ -72,6 +74,31 @@ def test_selection_prefers_fresher_quarter_at_equal_completeness() -> None: assert [r.deal_id for r in select_rows([older, fresher], limit=1)] == [2] +def test_selection_prefers_row_with_street_scheme() -> None: + """Строка без улицы не может быть самой полной: ей нечем нарисовать карту. + + Так дефект и выглядел в проде: первой строкой витрины и первым раундом игры + «Проверьте себя» стояла единственная из двадцати сделка БЕЗ улицы, и вместо + схемы улиц у неё рисовался полигон РАЙОНА. + + Всё остальное здесь одинаково, а id подобраны так, что без учёта улицы + выиграл бы разрыв ключа по id. Ломать так: убрать `row.has_street` из + `completeness` — тест покраснеет ПО ЗНАЧЕНИЮ, порядком [9, 8]. + + Вторая сторона проверки — строка без улицы ОСТАЁТСЯ в витрине: она не + первая, но и не выброшена. Прятать промахи по-прежнему нельзя. + """ + no_street = _row(9, has_street=False, err_pct=75.7) + with_street = _row(8, err_pct=3.0) + + chosen = select_rows([no_street, with_street], limit=2) + + assert [r.deal_id for r in chosen] == [8, 9], ( + "строка, которой нечем нарисовать карту, оказалась полнее строки со " + "схемой улиц — витрина открывается полигоном района" + ) + + def test_selection_is_deterministic_on_full_ties() -> None: """Полные совпадения ключа разводятся id — иначе витрина «мерцает».""" rows = [_row(7), _row(9), _row(8)] diff --git a/tradein-mvp/docker-compose.prod.yml b/tradein-mvp/docker-compose.prod.yml index 9e229983..d7ef9bb6 100644 --- a/tradein-mvp/docker-compose.prod.yml +++ b/tradein-mvp/docker-compose.prod.yml @@ -294,7 +294,7 @@ services: # Деградация источника в None — существующее состояние ответа (так же # ведёт себя таймаут), контракт API не меняется. ESTIMATE_EXTERNAL_SOURCES_BACKGROUND: "true" - DATABASE_URL: "postgresql+psycopg://${TRADEIN_POSTGRES_USER:-tradein}:${TRADEIN_POSTGRES_PASSWORD}@postgres:5432/tradein" + DATABASE_URL: "postgresql+psycopg://${TRADEIN_POSTGRES_USER:-tradein}:${TRADEIN_POSTGRES_PASSWORD}@tradein-postgres:5432/tradein" PUBLIC_URL: "https://gendsgn.ru/trade-in" CORS_ORIGINS: '["https://gendsgn.ru"]' ENVIRONMENT: "production" @@ -373,7 +373,7 @@ services: - path: ./backend/.env.runtime required: false environment: - DATABASE_URL: "postgresql+psycopg://${TRADEIN_POSTGRES_USER:-tradein}:${TRADEIN_POSTGRES_PASSWORD}@postgres:5432/tradein" + DATABASE_URL: "postgresql+psycopg://${TRADEIN_POSTGRES_USER:-tradein}:${TRADEIN_POSTGRES_PASSWORD}@tradein-postgres:5432/tradein" ENVIRONMENT: "production" GLITCHTIP_DSN: "${GLITCHTIP_DSN:-}" GENDESIGN_FDW_PASSWORD: "${GENDESIGN_FDW_PASSWORD:-}" @@ -432,7 +432,7 @@ services: - path: ./backend/.env.runtime required: false environment: - DATABASE_URL: "postgresql+psycopg://${TRADEIN_POSTGRES_USER:-tradein}:${TRADEIN_POSTGRES_PASSWORD}@postgres:5432/tradein" + DATABASE_URL: "postgresql+psycopg://${TRADEIN_POSTGRES_USER:-tradein}:${TRADEIN_POSTGRES_PASSWORD}@tradein-postgres:5432/tradein" ENVIRONMENT: "production" GLITCHTIP_DSN: "${GLITCHTIP_DSN:-}" # Этот процесс — не scheduler_main; false на всякий случай, если общий @@ -468,7 +468,15 @@ services: # только свой hostname-интерфейс и недоступен как tradein-frontend:3000. # Принудительно 0.0.0.0 чтобы Caddy достучался. HOSTNAME: "0.0.0.0" - BACKEND_URL: "http://backend:8000" # internal SSR + # ИМЯ ОБЯЗАНО БЫТЬ ОДНОЗНАЧНЫМ. Оба продукта назвали свой сервис + # `backend`, и оба подключены к общей сети gendesign_shared — + # изнутри фронта `backend` резолвится в ДВА адреса (tradein 172.18.0.6 + # и ПТИЦА 172.18.0.9), клиент берёт любой. Попав в ПТИЦУ, SSR получает + # 401 и рендерит лендинг БЕЗ витрины — без ленты, строк сверки и + # подписи разброса, то есть страница про точность без доказательств. + # Отказ тихий: fetch не бросает, приходит валидный 401. + # `tradein-backend` — container_name, он однозначен. + BACKEND_URL: "http://tradein-backend:8000" # internal SSR depends_on: [backend] restart: unless-stopped networks: diff --git a/tradein-mvp/frontend/src/app/mera-public/__tests__/backtest-freshness.test.ts b/tradein-mvp/frontend/src/app/mera-public/__tests__/backtest-freshness.test.ts index 905ed0cf..70c90626 100644 --- a/tradein-mvp/frontend/src/app/mera-public/__tests__/backtest-freshness.test.ts +++ b/tradein-mvp/frontend/src/app/mera-public/__tests__/backtest-freshness.test.ts @@ -19,6 +19,9 @@ * квартал), значит чаще чем раз в квартал замеру обновляться не от чего. * Срок = квартал плюс запас на загрузку следующей пачки. */ +import { readFileSync } from "node:fs"; +import { join } from "node:path"; + import { describe, expect, it } from "vitest"; import { @@ -78,3 +81,55 @@ describe("свежесть ручного замера бэктеста", () => expect(BACKTEST_MEASURED_LABEL).toContain(BACKTEST_MEASURED_ON.slice(0, 4)); }); }); + +/** + * Разброс пересборок и происхождение величин. + * + * ЗАЧЕМ. 31.08.2026 три представительные пересборки одной и той же сверки дали + * попадание 82,8-86,0 % и расхождение 14,7-15,7 %. Опубликованные до этого + * 88 % лежали ВЫШЕ всего диапазона — значение получалось только на + * кластеризованной выборке (`ORDER BY id DESC`, 20 строк на четыре улицы). + * Точечное число без диапазона обещает точность, которой у замера нет, поэтому + * оговорка про разброс — не украшение, а часть величины: снимут её — красное. + * + * ВТОРАЯ ПОЛОВИНА — откуда число берёт компонент. Прежние 88 % пережили бы + * правку `landing-facts.ts`, будь они вписаны в разметку; здесь проверяется, + * что в витринных компонентах нет самих значений, а есть ссылки на факты. + */ +const V3 = join(__dirname, "..", "_components", "v3"); +const SPREAD_RANGES = ["14,7-15,7", "82,8-86,0"]; + +function caveatsText(): string { + return [...BACKTEST.priceError.caveats, ...BACKTEST.coverage.caveats].join(" "); +} + +describe("разброс пересборок назван, а величины не вписаны в компонент", () => { + it.each(SPREAD_RANGES)("оговорка называет диапазон пересборок %s", (range) => { + expect( + caveatsText(), + [ + `в оговорках priceError/coverage нет диапазона ${range}.`, + "Точечное значение разового замера гуляет при пересборке выборки —", + "без диапазона витрина обещает точность, которой у замера нет.", + ].join(" "), + ).toContain(range); + }); + + it("проверка диапазона краснеет на тексте без него — иначе она зелёная по построению", () => { + const withoutRange = "Попадание достигнуто шириной коридора, а не точностью точки."; + for (const range of SPREAD_RANGES) { + expect(withoutRange).not.toContain(range); + } + }); + + it.each(["AccuracyV3.tsx", "HeroV3.tsx"])("%s берёт величины из landing-facts, а не из своей разметки", (file) => { + const src = readFileSync(join(V3, file), "utf8"); + for (const value of [BACKTEST.priceError.text, BACKTEST.coverage.text]) { + expect( + src, + `${file}: величина ${value} вписана в компонент — правка landing-facts её не догонит`, + ).not.toContain(value); + } + expect(src, `${file}: величина берётся не из BACKTEST`).toContain("BACKTEST."); + }); +}); diff --git a/tradein-mvp/frontend/src/app/mera-public/__tests__/backtest-window-labels.test.tsx b/tradein-mvp/frontend/src/app/mera-public/__tests__/backtest-window-labels.test.tsx new file mode 100644 index 00000000..27235f9f --- /dev/null +++ b/tradein-mvp/frontend/src/app/mera-public/__tests__/backtest-window-labels.test.tsx @@ -0,0 +1,68 @@ +/** + * Подписи бэктеста обязаны описывать ТО окно, по которому числа посчитаны. + * + * 31.08.2026 числа перевели на представительную выборку (медиана трёх + * пересборок), но подписи остались от прежнего прогона: «сделки II квартала + * 2026 года» и знаменатель 5 954 (только этот квартал). Замер показал, что + * пересборка покрывает ЧЕТЫРЕ квартала и II квартал 2026 — лишь 24 % её + * сделок. Доля выборки при старом знаменателе выходила 5,5 % вместо 1,3 %, + * то есть вчетверо льстила. + * + * Отдельно: плитка «уверенность низкая» показывалась БЕЗ своей оговорки — + * `AccuracyV3` собирал оговорки только двух величин из трёх. + */ +import { render, screen } from "@testing-library/react"; +import { describe, expect, it } from "vitest"; + +import { AccuracyV3 } from "../_components/v3/AccuracyV3"; +import { + BACKTEST, + BACKTEST_PERIOD_LABEL, + BACKTEST_POPULATION, + BACKTEST_SHARE_LABEL, +} from "../landing-facts"; + +describe("подписи окна бэктеста", () => { + it("окно названо целиком, а не одним кварталом из четырёх", () => { + // Прежняя подпись называла II квартал 2026 — в представительной выборке + // это 24 % сделок, а не все. + expect(BACKTEST_PERIOD_LABEL).not.toMatch(/^сделки II квартала/u); + expect(BACKTEST_PERIOD_LABEL).toMatch(/четыре квартала/u); + }); + + it("знаменатель — того же окна, что и выборка", () => { + // 5 954 — только II квартал 2026; окно целиком — 24 333 (замер 31.08.2026). + expect(BACKTEST_POPULATION).toBe(24_333); + }); + + it("доля выборки выводится и получается около 1,3 %, а не 5,5 %", () => { + const share = (BACKTEST.priceError.sampleN / BACKTEST_POPULATION) * 100; + expect(share).toBeGreaterThan(1.0); + expect(share).toBeLessThan(2.0); + expect(BACKTEST_SHARE_LABEL).toBe("1,3 %"); + }); + + it("уверенность посчитана на том же прогоне, что и остальные числа", () => { + // «325 из 327» было из прогона 29.08 и под общей подписью «замер 31.08» + // приписывало старому числу новую дату. + expect(BACKTEST.confidenceLow.text).not.toMatch(/327/u); + }); +}); + +describe("оговорки в интерфейсе", () => { + it("на экране есть оговорки ВСЕХ ТРЁХ величин блока", () => { + render(); + for (const набор of [ + BACKTEST.priceError.caveats, + BACKTEST.coverage.caveats, + BACKTEST.confidenceLow.caveats, + ]) { + for (const line of набор) { + expect( + screen.queryByText(line), + `оговорка не выводится: ${line.slice(0, 48)}…`, + ).not.toBeNull(); + } + } + }); +}); diff --git a/tradein-mvp/frontend/src/app/mera-public/__tests__/landing-numbers-gate.test.ts b/tradein-mvp/frontend/src/app/mera-public/__tests__/landing-numbers-gate.test.ts index 369ba1a0..328fbf4d 100644 --- a/tradein-mvp/frontend/src/app/mera-public/__tests__/landing-numbers-gate.test.ts +++ b/tradein-mvp/frontend/src/app/mera-public/__tests__/landing-numbers-gate.test.ts @@ -79,8 +79,57 @@ const V3_DIR = "_components/v3"; const GENERATED = ["ekb-districts.ts"]; const GENERATED_MARK = "СГЕНЕРИРОВАН"; +/** + * ПОДСТРАНИЦЫ ПЕРИМЕТРА тоже под гейтом, а не только корень и v3-секции. + * + * 31.08.2026 завели `/business`, и ревьюер заметил, что новая ПУБЛИЧНАЯ + * страница чисел ничем не сторожится: сканер знал ровно два места — корневой + * `page.tsx` и каталог `_components/v3`. Чисел там тогда не было, но правило + * держалось на том, что автор о нём помнил. + * + * Каталоги перечисляются ОБХОДОМ, а не списком: список — снимок, и следующую + * страницу в него снова забудут вписать. Обход находит её сам. + */ +/** + * ЮРИДИЧЕСКИЕ СТРАНИЦЫ ПОД ЭТОТ ГЕЙТ НЕ ПОПАДАЮТ — и это не послабление. + * + * Гейт ищет ФОРМУ величины: «14,5 %», «42 700», «150 ₽». Тексты оферты, + * политики и возврата состоят из ссылок на законы, и по форме они те же самые: + * + * Закон РФ от 07.02.1992 № 2300-1 «О защите прав потребителей» + * Федеральный закон от 27.07.2006 № 152-ФЗ + * ст. 18.1 152-ФЗ + * + * Отличить номер закона от замера рынка регулярным выражением нельзя, а + * подгонять под них исключения по одному значило бы дырявить сам сканер. + * Правило, которое гейт защищает, к этим страницам и не относится: там числа + * ЦИТИРУЮТСЯ из нормативных актов, а не утверждаются о рынке. + * + * Список ЯВНЫЙ и короткий: молчаливое расширение (например «все страницы с + * длинным текстом») однажды укроет и маркетинговую. + */ +const LEGAL_PAGES = new Set(["oferta", "privacy", "refund", "docs"]); + +const PAGE_DIRS = readdirSync(ROOT, { withFileTypes: true }) + .filter( + (e) => + e.isDirectory() && + e.name !== "__tests__" && + e.name !== "_components" && + !LEGAL_PAGES.has(e.name), + ) + .map((e) => e.name) + .sort(); + +const SUBPAGES = PAGE_DIRS.flatMap((dir) => + readdirSync(join(ROOT, dir)) + .filter((name) => /^page\.tsx?$/u.test(name)) + .map((name) => `${dir}/${name}`), +); + const V3_SOURCES = [ LANDING_ROOT, + ...SUBPAGES, ...readdirSync(join(ROOT, V3_DIR)) .filter((name) => /\.tsx?$/u.test(name) && !GENERATED.includes(name)) .sort() diff --git a/tradein-mvp/frontend/src/app/mera-public/__tests__/landing-v3-render.test.tsx b/tradein-mvp/frontend/src/app/mera-public/__tests__/landing-v3-render.test.tsx index 4a3c7aca..59c4fcc0 100644 --- a/tradein-mvp/frontend/src/app/mera-public/__tests__/landing-v3-render.test.tsx +++ b/tradein-mvp/frontend/src/app/mera-public/__tests__/landing-v3-render.test.tsx @@ -13,6 +13,7 @@ import { AccuracyV3 } from "../_components/v3/AccuracyV3"; import { DealsTickerV3 } from "../_components/v3/DealsTickerV3"; import { CostOfErrorV3 } from "../_components/v3/CostOfErrorV3"; import { HeroV3 } from "../_components/v3/HeroV3"; +import { BACKTEST } from "../landing-facts"; import type { LandingStat, ShowcaseResponse } from "../public-api"; const stat = (value: number, sample_n: number | null, note: string): LandingStat => ({ @@ -77,9 +78,9 @@ const SHOWCASE: ShowcaseResponse = { describe("витрина лэндинга v3 без данных", () => { it("«Точность»: с данными показывает величины вместе с выборкой и коридором", () => { render(); - expect(screen.getByText("14,5 %")).toBeTruthy(); + expect(screen.getByText(BACKTEST.priceError.text)).toBeTruthy(); expect(screen.getByText(/коридор шириной ±37 %/)).toBeTruthy(); - expect(screen.getByText("325 из 327")).toBeTruthy(); + expect(screen.getByText(BACKTEST.confidenceLow.text)).toBeTruthy(); expect(screen.getByText(/по 25 943 объявлениям/)).toBeTruthy(); // Подпись витрины: сколько рассмотрено и по какому правилу отсеяно. expect(screen.getByText(/рассмотрено сделок: 4 000/)).toBeTruthy(); @@ -92,7 +93,7 @@ describe("витрина лэндинга v3 без данных", () => { expect(container.querySelector('[role="table"]')).toBeNull(); expect(container.textContent).not.toMatch(/[—-]\s*дн\./); // Бэктест не зависит от ручки — он остаётся вместе со своими оговорками. - expect(screen.getByText("14,5 %")).toBeTruthy(); + expect(screen.getByText(BACKTEST.priceError.text)).toBeTruthy(); }); it("«Цена ошибки»: у двух величин РАЗНЫЕ выборки, и обе подписаны", () => { diff --git a/tradein-mvp/frontend/src/app/mera-public/__tests__/sticky-cta-hero.test.tsx b/tradein-mvp/frontend/src/app/mera-public/__tests__/sticky-cta-hero.test.tsx new file mode 100644 index 00000000..e14c8459 --- /dev/null +++ b/tradein-mvp/frontend/src/app/mera-public/__tests__/sticky-cta-hero.test.tsx @@ -0,0 +1,92 @@ +/** + * Липкая панель не должна лежать поверх первого экрана. + * + * Владелец увидел на проде, что полоса накрывает абзац «Мы называем реальную + * цену вашей квартиры». `.barSpacer` это не лечит и не может: он добавляет + * высоту в КОНЕЦ документа, а `.barRoot` — `fixed`, то есть накрывает нижние + * ~67px вьюпорта при любой прокрутке, включая самый верх страницы. + * + * Проверяется ПОВЕДЕНИЕ, а не наличие класса в файле: наблюдателю скармливается + * пересечение и проверяется, что панель убралась, затем обратное. + */ +import { render, screen } from "@testing-library/react"; +import { act } from "react"; +import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; + +import { StickyCtaV3 } from "../_components/v3/StickyCtaV3"; + +let срабатывание: ((entries: { isIntersecting: boolean }[]) => void) | null = null; + +beforeEach(() => { + срабатывание = null; + vi.stubGlobal( + "IntersectionObserver", + class { + constructor(cb: (entries: { isIntersecting: boolean }[]) => void) { + срабатывание = cb; + } + observe() {} + disconnect() {} + }, + ); +}); + +afterEach(() => { + vi.unstubAllGlobals(); +}); + +/** + * Корень панели ищем ПО КОНТЕЙНЕРУ, а не через getByRole: когда панель убрана, + * на ней стоит aria-hidden, и роль «ссылка» из дерева доступности пропадает — + * это и есть желаемое поведение, но локатор по роли на нём слепнет. + */ +function корень(c: HTMLElement): HTMLElement { + const link = c.querySelector('a[href*="estimate"]'); + if (!link?.parentElement) throw new Error("панель не отрендерилась"); + return link.parentElement; +} + +const скрыта = (c: HTMLElement) => /barHidden/u.test(корень(c).className); + +describe("липкая панель против первого экрана", () => { + it("без секции героя панель остаётся видимой, а не пропадает", () => { + // Наблюдать нечего — поведение обязано остаться сегодняшним. + const { container } = render(); + expect(скрыта(container)).toBe(false); + }); + + it("герой в кадре — панель убрана и недоступна с клавиатуры", () => { + const hero = document.createElement("section"); + hero.id = "check"; + document.body.appendChild(hero); + const { container } = render(); + + expect(скрыта(container), "до срабатывания панель видима").toBe(false); + + act(() => срабатывание!([{ isIntersecting: true }])); + expect(скрыта(container)).toBe(true); + expect(корень(container).getAttribute("aria-hidden")).toBe("true"); + + // Убранная панель обязана уйти и из дерева доступности — иначе Tab + // уводит в кнопку, которой на экране нет. + expect(screen.queryByRole("link", { name: /Проверить квартиру/u })).toBeNull(); + + hero.remove(); + }); + + it("герой ушёл — панель возвращается", () => { + const hero = document.createElement("section"); + hero.id = "check"; + document.body.appendChild(hero); + const { container } = render(); + + act(() => срабатывание!([{ isIntersecting: true }])); + expect(скрыта(container)).toBe(true); + + act(() => срабатывание!([{ isIntersecting: false }])); + expect(скрыта(container), "панель не вернулась — призыв потерян навсегда").toBe(false); + expect(screen.getByRole("link", { name: /Проверить квартиру/u })).toBeTruthy(); + + hero.remove(); + }); +}); diff --git a/tradein-mvp/frontend/src/app/mera-public/_components/InnerHeader.tsx b/tradein-mvp/frontend/src/app/mera-public/_components/InnerHeader.tsx index be973f8f..89a5a042 100644 --- a/tradein-mvp/frontend/src/app/mera-public/_components/InnerHeader.tsx +++ b/tradein-mvp/frontend/src/app/mera-public/_components/InnerHeader.tsx @@ -1,4 +1,3 @@ -import { B2B_URL } from "../content"; import styles from "../landing-v3.module.css"; import { PublicLink } from "./PublicLink"; @@ -57,9 +56,9 @@ export function InnerHeader() { diff --git a/tradein-mvp/frontend/src/app/mera-public/_components/v3/AccuracyV3.tsx b/tradein-mvp/frontend/src/app/mera-public/_components/v3/AccuracyV3.tsx index 2be7c7d8..418fff0b 100644 --- a/tradein-mvp/frontend/src/app/mera-public/_components/v3/AccuracyV3.tsx +++ b/tradein-mvp/frontend/src/app/mera-public/_components/v3/AccuracyV3.tsx @@ -114,9 +114,14 @@ export function AccuracyV3({ }); } + // Оговорки ВСЕХ ТРЁХ величин блока, а не двух. `confidenceLow` показывается + // отдельной плиткой, но её оговорка сюда не попадала — то есть на экране + // стояло «400 из 400 — уверенность низкая» без единого слова о том, почему. + // Плитка без своей оговорки — ровно то, что этот блок и не должен делать. const caveats = [ ...BACKTEST.priceError.caveats, ...BACKTEST.coverage.caveats, + ...BACKTEST.confidenceLow.caveats, ]; const deals = showcase?.deals ?? []; diff --git a/tradein-mvp/frontend/src/app/mera-public/_components/v3/FooterV3.tsx b/tradein-mvp/frontend/src/app/mera-public/_components/v3/FooterV3.tsx index 9a313872..be82a909 100644 --- a/tradein-mvp/frontend/src/app/mera-public/_components/v3/FooterV3.tsx +++ b/tradein-mvp/frontend/src/app/mera-public/_components/v3/FooterV3.tsx @@ -21,16 +21,20 @@ * а добавляет одну точку входа с тарифами и порядком возврата. * * ССЫЛКИ — КОРОТКИЕ (15.08.2026). «Проверить квартиру» ведёт на `/estimate` — - * отдельный экран проверки, а не на якорь формы в герое. «МЕРА для бизнеса» - * стала абсолютной: относительный `/` на публичном домене вёл на сам лэндинг, - * то есть пункт не работал. Все переходы — обычным `` через `PublicLink`, - * потому что `next/link` подставляет basePath (см. его шапку). + * отдельный экран проверки, а не на якорь формы в герое. Все переходы — + * обычным `` через `PublicLink`, потому что `next/link` подставляет + * basePath (см. его шапку). + * + * «МЕРА ДЛЯ БИЗНЕСА» ВЕДЁТ НА `/business`, А НЕ НА `B2B_URL` (31.08.2026). + * Абсолютный адрес B2B-контура заканчивался формой входа `/trade-in/login` — + * посетителю публичного сайта предлагали залогиниться в аккаунт, которого у + * него нет. Теперь пункт ведёт на публичную страницу связи, а ссылка на вход + * живёт внутри неё, второстепенной. */ import { safeUrl } from "@/lib/safeUrl"; import { - B2B_URL, LEGAL_ENTITY, REGION_NAME, SUPPORT_EMAIL, @@ -70,9 +74,9 @@ export function FooterV3() { Статьи - + МЕРА для бизнеса - + diff --git a/tradein-mvp/frontend/src/app/mera-public/_components/v3/HeaderV3.tsx b/tradein-mvp/frontend/src/app/mera-public/_components/v3/HeaderV3.tsx index 88d71e80..1b932173 100644 --- a/tradein-mvp/frontend/src/app/mera-public/_components/v3/HeaderV3.tsx +++ b/tradein-mvp/frontend/src/app/mera-public/_components/v3/HeaderV3.tsx @@ -49,7 +49,6 @@ * был `CityPicker`). */ -import { B2B_URL } from "../../content"; import styles from "../../landing-v3.module.css"; import { PublicLink } from "../PublicLink"; @@ -87,9 +86,9 @@ export function HeaderV3() {
- + Для бизнеса - + Проверить квартиру diff --git a/tradein-mvp/frontend/src/app/mera-public/_components/v3/StickyCtaV3.tsx b/tradein-mvp/frontend/src/app/mera-public/_components/v3/StickyCtaV3.tsx index 21f1be7d..87e8dc4e 100644 --- a/tradein-mvp/frontend/src/app/mera-public/_components/v3/StickyCtaV3.tsx +++ b/tradein-mvp/frontend/src/app/mera-public/_components/v3/StickyCtaV3.tsx @@ -1,3 +1,5 @@ +"use client"; + /** * StickyCtaV3 — липкая нижняя CTA-панель (макет ~ строки 518-521). * @@ -32,17 +34,64 @@ * чаще всего. В тексте панели по той же причине нет и «срока продажи»: * платный отчёт отдаёт медиану экспозиции похожих объявлений, а не прогноз * срока (`_estimate_days_on_market`, см. HeroV3). + * + * ПАНЕЛЬ ПРЯЧЕТСЯ, ПОКА ГЕРОЙ В КАДРЕ (31.08.2026). Владелец увидел на первом + * экране, что полоса лежит поверх абзаца «Мы называем реальную цену вашей + * квартиры». `.barSpacer` это НЕ лечит и не может: он добавляет высоту в + * КОНЕЦ документа, а `.barRoot` — `fixed`, то есть накрывает нижние ~67px + * вьюпорта при ЛЮБОЙ прокрутке, включая `scrollTop = 0`. + * + * Пока герой виден, панель не нужна: прямо в нём стоит та же форма проверки, + * и панель дублирует призыв, закрывая текст. Уходит герой — панель появляется. + * + * ПО УМОЛЧАНИЮ ПАНЕЛЬ ВИДИМА, и это важно. Скрытие включает только клиентский + * наблюдатель; если скрипт не выполнился (ошибка, старый браузер, отключённый + * JS), поведение остаётся ровно сегодняшним — полоса на месте. Обратный + * порядок (по умолчанию скрыта, показывает скрипт) в тех же условиях убрал бы + * призыв со страницы совсем, то есть чинил бы вид ценой работы. + * + * Наблюдатель смотрит на `#check` — секцию героя (`HeroV3`). Если её на + * странице нет (компонент вставили в другую композицию), наблюдать нечего и + * панель просто остаётся видимой: снова сегодняшнее поведение, а не пустой + * экран. */ +import { useEffect, useState } from "react"; + import styles from "../../landing-v3.module.css"; import { PublicLink } from "../PublicLink"; +/** Секция героя: пока она в кадре, панель молчит. */ +const HERO_ID = "check"; + export function StickyCtaV3() { + const [heroVisible, setHeroVisible] = useState(false); + + useEffect(() => { + const hero = document.getElementById(HERO_ID); + if (!hero || typeof IntersectionObserver === "undefined") return; + + const io = new IntersectionObserver( + ([entry]) => setHeroVisible(entry.isIntersecting), + // Панель высотой ~67px снизу: считаем героя «в кадре», пока он заходит + // хотя бы на эту полосу — иначе она успевала бы мигнуть на его хвосте. + { rootMargin: "0px 0px -68px 0px" }, + ); + io.observe(hero); + return () => io.disconnect(); + }, []); + return ( <>