gendesign/backend/app/services/site_finder
Light1YT f8daf50f5f feat(site_finder): future-supply-pressure index (#950 Step 6)
Add backend/app/services/site_finder/future_supply.py — deterministic,
no-LLM §9.3 composite quantifying queued competing supply (hidden + future)
vs market absorption, computed on-the-fly (not stored).

- Reads VIEW v_supply_layers_latest (incl. non-derivable graddoc_stub/
  insider_manual L3 rows), not a layer recompute.
- Reuses market_metrics.compute_market_metrics for monthly absorption
  (available / months_of_supply == sold/mo; algebra verified).
- months_of_pressure = (hidden + future_by_horizon) / absorption/mo;
  index = linear-clamp saturation at 18mo (1.5x EKB cycle); confidence=MIN
  (thin L2/L3 honestly drags composite to low).
- L3 horizon-weighted (NULL expected_online_date -> neutral 0.5);
  open excluded from numerator (only hidden+future compete with a new object).
- Graceful: empty/thin/no-absorption -> index None + low, div-by-zero guarded.
- 54 unit tests (pure-helper math + mocked db/market_metrics).
2026-06-03 01:57:29 +05:00
..
__init__.py init 2026-04-25 13:45:19 +03:00
best_layouts.py fix(sf-21b): weighted AVG in _INLINE_VELOCITY_SQL (best_layouts.py) 2026-05-17 16:56:22 +03:00
cadastre_fetch.py feat(site-finder): auto-fetch cadastre geometry on-demand (#93) (#95) 2026-05-12 09:02:17 +03:00
competitors.py feat(site-finder): per-competitor relevance_weight (#949 PR B) (#1000) 2026-06-02 19:45:38 +00:00
custom_pois.py feat(#254): user_custom_pois — backend schema + CRUD + scoring integration 2026-05-17 09:34:33 +03:00
filters.py init 2026-04-25 13:45:19 +03:00
future_supply.py feat(site_finder): future-supply-pressure index (#950 Step 6) 2026-06-03 01:57:29 +05:00
gate_verdict.py feat(#29,#232): wire cad_parcels.permitted_use in analyze + cad_zouit fallback (G2+G3) 2026-05-17 08:17:22 +03:00
layout_signature.py fix(sf-08): add euro-1/euro-2 room_bucket for small-format rooms=2 flats 2026-05-17 14:38:48 +03:00
layout_velocity_refresh.py feat(analytics): mv_layout_velocity MV + refresh helper (#113 PR B) (#194) 2026-05-16 08:26:59 +00:00
macro.py feat(site-finder): macro_indicator table + backfill + reader (#945 PR A) (#963) 2026-06-02 18:41:28 +00:00
market_metrics.py feat(site_finder): market-metrics service (#949 PR A, §9.2) (#997) 2026-06-02 19:26:26 +00:00
noise_loader.py feat(site-finder): isochrones UI + networks VKH + OSM substations 2026-05-11 21:48:21 +03:00
parser.py init 2026-04-25 13:45:19 +03:00
poi_loader.py feat(site-finder): v3.1 — cad_parcels_geom, analyze fallback, POI lat/lon, OSM expand 2026-05-11 19:52:19 +03:00
poi_score.py feat(sf-b6): GET /parcels/{cad}/poi-score — weighted top-7 (#333) 2026-05-17 21:11:25 +00:00
pzz_loader.py fix(pzz_loader): replace bare db.rollback() with SAVEPOINT per-row (#124) 2026-05-14 23:29:23 +03:00
quarter_dump_lookup.py fix(#234): address re-review nits — Settings singleton + docstring sync 2026-05-17 09:31:43 +03:00
quarter_price_index_refresh.py feat(db): quarter_price_index FDW foreign table + monthly refresh (Refs #762) (#797) 2026-05-30 17:16:28 +00:00
quarter_price_refresh.py feat(analytics): mv_quarter_price_per_m2 MV + refresh helper (#33 D1 PR A) (#209) 2026-05-16 11:12:01 +00:00
scorer.py init 2026-04-25 13:45:19 +03:00
supply_layers.py feat(site-finder): supply_layers v2 compute service (#950 EPIC6 step3+4) (#1004) 2026-06-02 20:34:26 +00:00
velocity.py fix(sf-17): rosreestr velocity fallback via cad_quarter (~100% EKB coverage) 2026-05-17 16:50:19 +03:00
weight_profiles.py feat(#114): seed 3 default weight presets + include_system API param 2026-05-16 22:49:56 +03:00