diff --git a/tradein-mvp/backend/app/core/config.py b/tradein-mvp/backend/app/core/config.py index cebfed71..4c2258b3 100644 --- a/tradein-mvp/backend/app/core/config.py +++ b/tradein-mvp/backend/app/core/config.py @@ -389,19 +389,24 @@ 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 (prod defect, 2026-09-16): прод отдавал точечную цену - # без единого сопоставимого объявления-аналога (n_analogs=0) — юзер видит - # уверенное число, но за ним нет объявлений рядом с домом (только каскад - # #oblast-D deals-headline-fallback по ДКП-коридору Росреестра И при этом - # reliability уже честно 'very_low', т.е. сам движок не доверяет числу - # больше, чем "почти нет сигнала"). Same-building/IMV anchor сюда НЕ - # попадает: якорь всегда задаёт n_analogs=anchor['n']>=минимума компл'ов, - # поэтому n_analogs==0 у него в принципе не бывает — гейт его не трогает. - # ДКП-коридор с reliability='low' (thin-но-реальные объявления + сделки, - # #oblast-E) тоже НЕ гасится — это осознанно защищённый продуктовый кейс - # (см. estimate_quality reliability-блок). True ⇒ новое поведение (честный - # отказ вместо точечной цены); False ⇒ откат к прежнему без релиза. - estimate_require_analogs: bool = True + # #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 недооценка, diff --git a/tradein-mvp/backend/app/services/estimator.py b/tradein-mvp/backend/app/services/estimator.py index aaf0a4b4..5f4aff20 100644 --- a/tradein-mvp/backend/app/services/estimator.py +++ b/tradein-mvp/backend/app/services/estimator.py @@ -4181,12 +4181,24 @@ 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,30 +5552,24 @@ async def estimate_quality( sources_used=sources_used, ) - # #estimate-zero-analogs: честный отказ вместо точечной цены, когда нет ни - # одного сопоставимого аналога рядом. Гейт — n_analogs==0 AND reliability - # == 'very_low' (не просто n_analogs==0): same-building/IMV anchor никогда - # не даёт n_analogs==0 (anchor всегда задаёт n_analogs=anchor['n']>=min - # comps), поэтому гейт его не касается по построению. ДКП-коридор - # (#oblast-D) тоже может дать n_analogs==0 с ненулевой ценой — НО когда он - # опирается на реальные thin-listings + сделки (#oblast-E), reliability - # намеренно закреплена на 'low', а не 'very_low' (см. reliability-блок - # выше) — этот подтверждённый комбинированный сигнал НЕ гасим. Гасим - # только "n_analogs=0 и сам движок это уже оценивает как почти отсутствие - # сигнала" — чистый ДКП-only headline без единого объявления рядом и - # geocode-неудачи (_empty_estimate) — те же самые "insufficient data" - # состояния, просто с уже отработавшим геокодом/поиском дома. + # #estimate-zero-analogs (2026-09-16): честный отказ вместо пустой карточки. + # Отбор, КОМУ вообще позволено дать цену без листинговых аналогов, сделан + # выше — уличный ДКП-коридор может, общегородской нет. Здесь остаётся + # оформление: если после всей цепочки headline так и не появился, ответ не + # должен уезжать наружу нулями. Условие median_price <= 0 намеренно + # совпадает с computed-полем AggregatedEstimate.insufficient_data, по + # которому фронт уже рисует карточку «недостаточно данных» — один признак, + # а не два расходящихся. # - # Механизм переиспользует уже существующий в коде паттерн "оценку - # построить не удалось" (_empty_estimate: median/range/ppm2=0, - # confidence='low', analogs/deals пустые) — но, в отличие от - # _empty_estimate (вызывается ТОЛЬКО при неудачном geocode), здесь geo/ - # house-match уже есть и сохраняются в ответе, чтобы фронт мог показать - # осмысленный адрес + причину отказа, а не просто пустую карточку. - if settings.estimate_require_analogs and n_analogs == 0 and reliability == "very_low": + # Механизм переиспользует существующий паттерн _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_analogs: suppressing point price (n_analogs=0," - " reliability=very_low) addr=%r median_price_was=%s", + "estimate_require_local_evidence: suppressing point price (n_analogs=0," + " median_price<=0) addr=%r median_price_was=%s", geo.full_address, median_price, ) diff --git a/tradein-mvp/backend/tests/test_estimator_requires_analogs.py b/tradein-mvp/backend/tests/test_estimator_requires_analogs.py index ba77b80a..8beca395 100644 --- a/tradein-mvp/backend/tests/test_estimator_requires_analogs.py +++ b/tradein-mvp/backend/tests/test_estimator_requires_analogs.py @@ -59,7 +59,7 @@ def _run_estimate( async def _run(): with ( - patch("app.services.estimator.settings.estimate_require_analogs", require_analogs), + 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), @@ -105,45 +105,67 @@ def test_true_zero_data_suppresses_price_when_flag_on() -> None: assert "Недостаточно данных" in est.confidence_explanation -def test_dkp_only_headline_suppressed_when_flag_on() -> None: - """#oblast-D: n_analogs=0 (чисто ДКП-коридор, без единого объявления) - даёт ненулевую цену по mainline (reliability='very_low' по построению — - thin_listings-флаг не срабатывает, т.к. listings изначально пустые) — - с флагом=True цена должна быть подавлена.""" +def test_city_wide_corridor_never_becomes_headline() -> None: + """Прод-репро «Красногорск, Янтарная»: у улицы одна сделка, поэтому коридор + расширился до всего города (scope='city_wide', 4770 сделок, медиана + 200 676 ₽/м²) и выдал её как оценку конкретной квартиры. Средняя цена + города — не оценка адреса, поэтому цены быть не должно.""" dkp_raw = { - "count": 12, - "median_ppm2": 236_766.0, - "low_ppm2": 210_000.0, + "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_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_dkp_only_headline_kept_when_flag_off() -> None: - """Флаг False → старое поведение: ДКП-коридор по-прежнему headline'ит - цену при n_analogs=0 (откат без релиза).""" +def test_street_scoped_corridor_still_headlines() -> None: + """Обратная сторона того же правила: уличный коридор — настоящий сигнал и + цену даёт. Это защита #oblast-D (Нижний Тагил), без которой туда протекал + екатеринбургский asking вшестеро выше.""" dkp_raw = { "count": 12, - "median_ppm2": 236_766.0, - "low_ppm2": 210_000.0, + "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 должен сохранять старое (ДКП-headline) поведение" - assert est.median_price_per_m2 == 236_766 + assert est.median_price_rub > 0, "flag=False должен возвращать прежнее поведение" + assert est.median_price_per_m2 == 200_676