gendesign/backend/app/services/forecasting/__init__.py
Light1YT 78b667b018 feat(forecasting): §9.7 what-to-build ranker + §7.9 MAI proxy (#981, 952-B)
EPIC 8 advisory deliverables over the #980 demand/supply engine, deterministic,
no LLM, no new SQL:
- what_to_build.rank_segments: runs compute_demand_supply_forecast across a
  class×room_bucket[×price] grid (default 3×5×1=15) per district/cad_num/horizon,
  drops deficit_index=None cells, ranks deficit_index DESC (tie-break confidence
  DESC then stable segment key). +deficit=build-signal, −=затоварка.
- affordability.compute_affordability: §7.9 MAI degraded payment-burden proxy via
  subsidized weighted rate (_current_mortgage_rate) + annuity on 50m²/240mo.
  payment_to_income always None (#946 no income), rate_kind always
  subsidized_weighted (market ~20% absent), confidence always low.
- Pure _rank_key / _annuity (rate≤0 → principal/months guard) unit-tested.
62 new tests; 368 forecasting tests green. Advisory + un-wired.
2026-06-03 12:07:12 +05:00

120 lines
4.2 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""Forecasting services — детерминированный форсайт-слой Site Finder v2.
#951 (Site Finder v2 / «GG-форсайт», EPIC 7 «Чувствительность к ключевой ставке»).
Этот пакет — фундамент data-independent логики прогноза: monthly макро-ряды,
классификатор режима ставки, лаговые помощники. Всё ДЕТЕРМИНИРОВАННО, БЕЗ LLM.
Слои (по PR):
• macro_series (#951b) — monthly макро-ряд + классификатор режима ставки (X-ось §9.6).
• sales_series (#951c) — monthly ряд продаж по сегменту (Y-ось §9.6).
• rate_sensitivity (#951d) — §9.6 чувствительность продаж к key_rate (CORE, ADVISORY).
• macro_coefficient (#951e) — §9.5 макро-коэффициент (композитный множитель, ADVISORY).
• demand_normalization (#951f) — §9.4 нормализация спроса под смену режима ставки (ADVISORY).
• demand_supply_forecast (#952a) — §9.8 центральный движок: спрос (§9.4×§9.5) vs
предложение (§9.3) по горизонтам → баланс/индекс дефицита (СБОРКА, ADVISORY).
• what_to_build (#981/952-B) — §9.7 ранкер сетки сегментов по deficit_index
(прогон #980 per-cell → DESC «что строить»; СБОРКА, ADVISORY).
• affordability (#981/952-B) — §7.9 MAI: ДЕГРАДИРОВАННЫЙ прокси платёжной
нагрузки (субсид. ставка, дохода нет → low-confidence; СБОРКА, ADVISORY).
Источники данных:
• макро — таблица macro_indicator через reader site_finder/macro.py (reuse).
• продажи — objective_corpus_room_month / objective_lots (см. sales_series).
"""
from __future__ import annotations
from app.services.forecasting.affordability import (
MortgageAffordabilityIndex,
compute_affordability,
)
from app.services.forecasting.demand_normalization import (
DemandNormalization,
compute_demand_normalization,
normalization_factor,
)
from app.services.forecasting.demand_supply_forecast import (
DemandSupplyForecast,
compute_demand_supply_forecast,
hold_last_rate,
)
from app.services.forecasting.macro_coefficient import (
MacroCoefficient,
assemble_coefficient,
compute_macro_coefficient,
f_issuance,
f_mortgage_rate,
f_overdue,
f_rate,
renormalize_contributions,
segment_steepness,
)
from app.services.forecasting.macro_series import (
MonthlyMacro,
classify_regime,
get_monthly_macro,
is_confounded_window,
macro_at_lag,
)
from app.services.forecasting.rate_sensitivity import (
RateSensitivity,
best_lag,
compute_rate_sensitivity,
ols_slope_r2,
shrink,
)
from app.services.forecasting.sales_series import (
SalesSeries,
SegmentSpec,
build_sales_series,
fill_month_grid,
log_diff,
price_bucket_of,
room_area_bucket_of,
)
from app.services.forecasting.what_to_build import (
RankedSegment,
WhatToBuildRanking,
rank_segments,
)
__all__ = [
"DemandNormalization",
"DemandSupplyForecast",
"MacroCoefficient",
"MonthlyMacro",
"MortgageAffordabilityIndex",
"RankedSegment",
"RateSensitivity",
"SalesSeries",
"SegmentSpec",
"WhatToBuildRanking",
"assemble_coefficient",
"best_lag",
"build_sales_series",
"classify_regime",
"compute_affordability",
"compute_demand_normalization",
"compute_demand_supply_forecast",
"compute_macro_coefficient",
"compute_rate_sensitivity",
"f_issuance",
"f_mortgage_rate",
"f_overdue",
"f_rate",
"fill_month_grid",
"get_monthly_macro",
"hold_last_rate",
"is_confounded_window",
"log_diff",
"macro_at_lag",
"normalization_factor",
"ols_slope_r2",
"price_bucket_of",
"rank_segments",
"renormalize_contributions",
"room_area_bucket_of",
"segment_steepness",
"shrink",
]