From c63c48eea257d720d158816b704c1792121e7ca3 Mon Sep 17 00:00:00 2001 From: lekss361 Date: Wed, 16 Sep 2026 17:16:25 +0000 Subject: [PATCH] =?UTF-8?q?=D0=9D=D0=B5=20=D0=B2=D1=8B=D0=B4=D0=B0=D0=B2?= =?UTF-8?q?=D0=B0=D1=82=D1=8C=20=D1=86=D0=B5=D0=BD=D1=83,=20=D0=BA=D0=BE?= =?UTF-8?q?=D0=B3=D0=B4=D0=B0=20=D1=80=D1=8F=D0=B4=D0=BE=D0=BC=20=D0=BD?= =?UTF-8?q?=D0=B5=D1=82=20=D0=BD=D0=B8=20=D0=BE=D0=B4=D0=BD=D0=BE=D0=B3?= =?UTF-8?q?=D0=BE=20=D0=B0=D0=BD=D0=B0=D0=BB=D0=BE=D0=B3=D0=B0=20(#3537)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- tradein-mvp/backend/app/core/config.py | 19 ++ tradein-mvp/backend/app/services/estimator.py | 47 +++++ .../tests/test_estimator_requires_analogs.py | 173 ++++++++++++++++++ 3 files changed, 239 insertions(+) create mode 100644 tradein-mvp/backend/tests/test_estimator_requires_analogs.py diff --git a/tradein-mvp/backend/app/core/config.py b/tradein-mvp/backend/app/core/config.py index 594ebe58..520b4bb9 100644 --- a/tradein-mvp/backend/app/core/config.py +++ b/tradein-mvp/backend/app/core/config.py @@ -389,6 +389,25 @@ class Settings(BaseSettings): estimate_imv_blend_weight: float = 0.5 # вес якоря в blend: median*(1-w)+A*w estimate_imv_blend_threshold: float = 1.15 # якорь должен быть > медианы ×1.15 + # #estimate-zero-analogs (прод-дефект, 2026-09-16): цена обязана опираться на + # данные ЭТОГО адреса, а не на среднее по городу. + # Репро: «Красногорск, Янтарная» отдавал 236 766 ₽/м², не имея рядом ни одного + # объявления. Число приходило из ДКП-коридора Росреестра, а тот при тонкой + # улице (n < DKP_CORRIDOR_CITY_WIDE_MIN_N = 3) расширяется до всего города и + # помечает себя scope="city_wide". Проверено на проде: у Янтарной ОДНА сделка, + # по Красногорску 4770 с медианой 200 676 ₽/м² — пользователю показали среднюю + # цену города как оценку его квартиры. Доля таких ответов 3.8% по ЕКБ, 4.8% по + # 77/50, то есть дефект продукта, а не регионального покрытия. + # Флаг делает две вещи, обе откатываются одним переключателем: + # 1) общегородской коридор больше не может стать headline (уличный — может: + # Нижний Тагил с 12 сделками по улице это настоящий сигнал, ради него + # #oblast-D и делали, иначе туда протекал екатеринбургский asking вшестеро + # выше); + # 2) если headline так и не появился, ответ уходит честной карточкой + # «недостаточно данных», а не нулями. + # False ⇒ прежнее поведение целиком, без релиза. + estimate_require_local_evidence: bool = True + # ── #651/#652 v2: same-building anchor (validated, 55 golden cases) ────────── # Радиусная медиана размывает премию дома/ЖК → премиум ~2.5x недооценка, # комфорт −15-25%. v2 берёт PRIMARY якорь из комплов ТОГО ЖЕ ДОМА (Tier A), diff --git a/tradein-mvp/backend/app/services/estimator.py b/tradein-mvp/backend/app/services/estimator.py index d450269d..e3f96093 100644 --- a/tradein-mvp/backend/app/services/estimator.py +++ b/tradein-mvp/backend/app/services/estimator.py @@ -4181,12 +4181,22 @@ def _price_from_inputs( # anchor is None: anchor_tier = None` в anchor-блоке выше), т.е. два условия # стали эквивалентны. Гард оставлен на `anchor is None` НАМЕРЕННО — это # по-прежнему прямая проверка факта «якорь дал headline», а не производный флаг. + # #estimate-zero-analogs (2026-09-16): коридор годится в HEADLINE только пока + # он про ЭТОТ адрес. _fetch_dkp_corridor при тонкой улице (n < + # DKP_CORRIDOR_CITY_WIDE_MIN_N = 3) расширяется до всего города и помечает + # себя scope="city_wide" — такая медиана описывает город, а не квартиру, и + # выдавать её как оценку нельзя. Прод-репро: «Красногорск, Янтарная» вернул + # 236 766 ₽/м² при ОДНОЙ сделке на улице; по городу 4770 сделок с медианой + # 200 676 ₽/м² — пользователю показали среднюю цену Красногорска. Уличный + # коридор (Нижний Тагил, 12 сделок) — настоящий сигнал и остаётся headline: + # без него туда протекал екатеринбургский asking вшестеро выше (#oblast-D). if ( median_ppm2 <= 0 and anchor is None and dkp_raw is not None and dkp_raw.get("count", 0) >= DEALS_HEADLINE_FALLBACK_MIN_N and dkp_raw.get("median_ppm2", 0) > 0 + and not (settings.estimate_require_local_evidence and dkp_raw.get("scope") == "city_wide") ): median_ppm2 = float(dkp_raw["median_ppm2"]) median_price = int(median_ppm2 * area_m2) @@ -5540,6 +5550,43 @@ async def estimate_quality( sources_used=sources_used, ) + # #estimate-zero-analogs (2026-09-16): честный отказ вместо пустой карточки. + # Отбор, КОМУ вообще позволено дать цену без листинговых аналогов, сделан + # выше — уличный ДКП-коридор может, общегородской нет. Здесь остаётся + # оформление: если после всей цепочки headline так и не появился, ответ не + # должен уезжать наружу нулями. Условие median_price <= 0 намеренно + # совпадает с computed-полем AggregatedEstimate.insufficient_data, по + # которому фронт уже рисует карточку «недостаточно данных» — один признак, + # а не два расходящихся. + # + # Механизм переиспользует существующий паттерн _empty_estimate + # (median/range/ppm2 = 0, confidence='low', analogs/deals пустые), но, в + # отличие от него (вызывается ТОЛЬКО при неудачном geocode), здесь geo и + # house-match уже есть и сохраняются — фронту есть что показать рядом с + # причиной отказа. + if settings.estimate_require_local_evidence and n_analogs == 0 and median_price <= 0: + logger.info( + "estimate_require_local_evidence: suppressing point price (n_analogs=0," + " median_price<=0) addr=%r median_price_was=%s", + geo.full_address, + median_price, + ) + median_price = 0 + median_ppm2 = 0.0 + range_low = 0 + range_high = 0 + expected_sold_price = None + expected_sold_per_m2 = None + expected_sold_range_low = None + expected_sold_range_high = None + market_percentile = None + api_analog_tier = None + explanation = ( + "Недостаточно данных для точной оценки по этому адресу — рядом нет " + "сопоставимых объявлений и сделок. Попробуйте уточнить адрес или " + "обратиться к специалисту." + ) + # #2002 #4: manual-review routing — производный ФЛАГ на основе уже # вычисленных premium_building / confidence / range (asking-IQR). НЕ влияет # на median/expected_sold/ranges — только метаданные для UI/маршрутизации. diff --git a/tradein-mvp/backend/tests/test_estimator_requires_analogs.py b/tradein-mvp/backend/tests/test_estimator_requires_analogs.py new file mode 100644 index 00000000..61ecb52b --- /dev/null +++ b/tradein-mvp/backend/tests/test_estimator_requires_analogs.py @@ -0,0 +1,173 @@ +"""Tests for #estimate-zero-analogs: honest refusal instead of a point price +when n_analogs == 0 and the engine itself already trusts the number no more +than "почти нет сигнала" (reliability == 'very_low'). + +Repro this guards against (prod, 2026-09-16): "Красногорск, Янтарная" returned +a confident 236 766 руб/м² with n_analogs=0 — 3.8% of ЕКБ estimates and 4.8% of +region 77/50 estimates hit this shape. + +Same isolation harness as test_estimator_expected_sold.py: `estimate_quality` +with every I/O dependency stubbed (no DB, no network). +""" + +from __future__ import annotations + +import os +from typing import Any +from unittest.mock import AsyncMock, MagicMock, patch + +import anyio + +# Settings requires DATABASE_URL at init time. Set dummy DSN before any app import. +os.environ.setdefault("DATABASE_URL", "postgresql+psycopg://test:test@localhost/test_db") + + +def _make_fake_geo(): + from app.services.geocoder import GeocodeResult + + return GeocodeResult( + lat=55.831, + lon=37.330, + full_address="Московская обл., Красногорск, ул. Янтарная, 5", + provider="nominatim", + ) + + +def _make_payload(): + from app.schemas.trade_in import TradeInEstimateInput + + return TradeInEstimateInput( + address="Красногорск, ул. Янтарная, 5", + area_m2=40.0, + rooms=1, + floor=4, + total_floors=16, + ) + + +def _run_estimate( + *, + require_analogs: bool, + dkp_raw: dict[str, Any] | None = None, +): + """estimate_quality: пустой радиус (listings=[]), нет anchor — только + опциональный ДКП-коридор (`dkp_raw`) через `_fetch_dkp_corridor`.""" + from app.services.estimator import estimate_quality + + db = MagicMock() + payload = _make_payload() + + async def _run(): + with ( + patch( + "app.services.estimator.settings.estimate_require_local_evidence", require_analogs + ), + patch("app.services.estimator.geocode", new=AsyncMock(return_value=_make_fake_geo())), + patch("app.services.estimator.dadata_clean_address", new=AsyncMock(return_value=None)), + patch("app.services.estimator.match_house_readonly", return_value=None), + patch("app.services.estimator.get_house_metadata", new=AsyncMock(return_value=None)), + # Ничего не нашли в радиусе — listings_clean=[] → median_price=0 до фолбэков. + patch("app.services.estimator._fetch_analogs", return_value=([], False, None)), + patch("app.services.estimator._fetch_deals", return_value=[]), + patch("app.services.estimator._fetch_dkp_corridor", return_value=dkp_raw), + # Ни same-building, ни micro-radius anchor. + patch("app.services.estimator._fetch_anchor_comps", return_value=([], None)), + patch("app.services.estimator._fetch_house_imv_anchor", return_value=None), + patch( + "app.services.estimator._get_or_fetch_imv_cached", new=AsyncMock(return_value=None) + ), + patch( + "app.services.estimator._get_or_fetch_yandex_valuation_cached", + new=AsyncMock(return_value=None), + ), + patch( + "app.services.estimator.estimate_via_cian_valuation", + new=AsyncMock(return_value=None), + ), + patch("app.services.estimator._get_asking_sold_ratio", return_value=(None, None)), + ): + return await estimate_quality(payload, db) + + return anyio.run(_run) + + +def test_true_zero_data_suppresses_price_when_flag_on() -> None: + """Ни listings, ни anchor, ни ДКП-коридора вообще → n_analogs=0, + reliability='very_low' изначально (без ДКП-фолбэка median остаётся 0 + и без флага) — но проверяем именно flag=True ветку на honest-explanation.""" + est = _run_estimate(require_analogs=True, dkp_raw=None) + + assert est.n_analogs == 0 + assert est.median_price_rub == 0 + assert est.median_price_per_m2 == 0 + assert est.range_low_rub == 0 + assert est.range_high_rub == 0 + assert est.expected_sold_price_rub is None + assert est.confidence_explanation is not None + assert "Недостаточно данных" in est.confidence_explanation + + +def test_city_wide_corridor_never_becomes_headline() -> None: + """Прод-репро «Красногорск, Янтарная»: у улицы одна сделка, поэтому коридор + расширился до всего города (scope='city_wide', 4770 сделок, медиана + 200 676 ₽/м²) и выдал её как оценку конкретной квартиры. Средняя цена + города — не оценка адреса, поэтому цены быть не должно.""" + dkp_raw = { + "count": 4770, + "median_ppm2": 200_676.0, + "low_ppm2": 150_000.0, + "high_ppm2": 260_000.0, + "period_months": 12, + "scope": "city_wide", + } + est = _run_estimate(require_analogs=True, dkp_raw=dkp_raw) + + assert est.n_analogs == 0 + assert est.median_price_rub == 0, "медиана по городу не может быть ценой квартиры" + assert est.median_price_per_m2 == 0 + assert est.range_low_rub == 0 + assert est.range_high_rub == 0 + assert est.expected_sold_price_rub is None + assert est.expected_sold_range_low_rub is None + assert est.expected_sold_range_high_rub is None + assert est.insufficient_data is True + assert "Недостаточно данных" in (est.confidence_explanation or "") + # Адрес/гео — НЕ ценовые поля — сохраняются, чтобы фронт показал адрес. + assert est.target_address is not None + + +def test_street_scoped_corridor_still_headlines() -> None: + """Обратная сторона того же правила: уличный коридор — настоящий сигнал и + цену даёт. Это защита #oblast-D (Нижний Тагил), без которой туда протекал + екатеринбургский asking вшестеро выше.""" + dkp_raw = { + "count": 12, + "median_ppm2": 85_911.0, + "low_ppm2": 70_000.0, + "high_ppm2": 100_000.0, + "period_months": 12, + "scope": "street", + } + est = _run_estimate(require_analogs=True, dkp_raw=dkp_raw) + + assert est.n_analogs == 0 + assert est.median_price_per_m2 == 85_911, "уличный коридор обязан остаться headline" + assert est.insufficient_data is False + + +def test_city_wide_corridor_kept_when_flag_off() -> None: + """Флаг False → прежнее поведение целиком: общегородской коридор снова + становится headline. Откат без релиза.""" + dkp_raw = { + "count": 4770, + "median_ppm2": 200_676.0, + "low_ppm2": 150_000.0, + "high_ppm2": 260_000.0, + "period_months": 12, + "scope": "city_wide", + } + est = _run_estimate(require_analogs=False, dkp_raw=dkp_raw) + + assert est.n_analogs == 0 + assert est.median_price_rub > 0, "flag=False должен возвращать прежнее поведение" + assert est.median_price_per_m2 == 200_676