gendesign/backend/app/services/forecasting
Light1YT 81df075ccc feat(forecasting): §9.4 demand-normalization coefficient (#951f, advisory)
Add demand_normalization.py: norm = clamp(exp(beta·(rate_future −
rate_window_avg)), 0.5, 1.2). Discounts a sales pace observed under one rate
regime when projecting into a different (higher-rate) future — ТЗ §9.4: don't
carry a low-rate boom pace forward into high rates.

- beta reused from §9.6 rate_sensitivity (PR3, shrunk slope on Δln, gated <0);
  rate_window_avg = mean key_rate over the §9.6 window (PR2 macro_series).
- Honesty gate: β None / §9.6 confidence='low' / no rate window → norm=1.0,
  applied=False, confidence='low' (no naive boom, no fabricated discount).
  applied=False is distinct from a trustworthy coefficient==1.0 (regimes match).
  confidence never exceeds §9.6's.
- Pure normalization_factor() + frozen DemandNormalization + as_dict().
- 26 unit tests, no live DB (mocked PR2/PR3). ADVISORY: not wired into endpoints.

Completes the deterministic §9.4/§9.5/§9.6 forecasting engine (PR2/PR1/PR3/PR4/PR5).
PR6 follow-up: OverflowError guard on exported normalization_factor (unreachable
via orchestrator today, β bounded).
2026-06-03 11:28:10 +05:00
..
__init__.py feat(forecasting): §9.4 demand-normalization coefficient (#951f, advisory) 2026-06-03 11:28:10 +05:00
demand_normalization.py feat(forecasting): §9.4 demand-normalization coefficient (#951f, advisory) 2026-06-03 11:28:10 +05:00
macro_coefficient.py feat(forecasting): §9.5 macro coefficient (#951e, advisory) (#1010) 2026-06-03 06:20:04 +00:00
macro_series.py feat(forecasting): monthly macro series + regime classifier (#951b) (#1007) 2026-06-03 05:37:43 +00:00
rate_sensitivity.py feat(forecasting): §9.6 key-rate sensitivity module (#951d, advisory) (#1009) 2026-06-03 06:06:16 +00:00
sales_series.py feat(forecasting): monthly sales series builder for §9.6 (#951c) (#1008) 2026-06-03 05:52:33 +00:00