[site-finder] EPIC 9: Рекомендательная модель: класс+квартирография+коммерция+УТП (horizon-aware, explainable) #953

Closed
opened 2026-06-02 16:32:10 +00:00 by Light1YT · 2 comments
Owner

Часть #944 (Site Finder v2 / ТЗ ГенГеныч).

Статус: EXTEND · Приоритет: P0 · ТЗ §10, 16

Scope

Расширить recommend_mix в полную §10: класс (§10.2), коммерция (§10.4), УТП-из-дефицитов (§10.5), квартирография horizon-aware (от прогноза EPIC8, не от рынка сейчас). Каждый вывод — структурная причина (§16: почему + отсеянные альтернативы + что изменит).

Зависимости: EPIC8
Уже есть (EXTEND): recommend_mix, schemas/recommend.py

**Часть #944 (Site Finder v2 / ТЗ ГенГеныч).** Статус: **EXTEND** · Приоритет: **P0** · ТЗ §10, 16 ## Scope Расширить recommend_mix в полную §10: класс (§10.2), коммерция (§10.4), УТП-из-дефицитов (§10.5), квартирография horizon-aware (от прогноза EPIC8, не от рынка сейчас). Каждый вывод — структурная причина (§16: почему + отсеянные альтернативы + что изменит). **Зависимости:** EPIC8 **Уже есть (EXTEND):** recommend_mix, schemas/recommend.py
Light1YT added the
analytics
GG-форсайт
site-finder
labels 2026-06-02 16:32:10 +00:00
Owner

📊 Ground-truth 2026-06-02 (ТЗ §10.3 + код)

Эталон-таблица квартирографии из ТЗ §10.3 — конкретный acceptance-образец для рекомендации (которого нет в теле эпика):

Тип Доля Ср. площадь Диапазон
Студии 5–10% 25 м² 22–29
20–25% 36 м² 32–40
Евро-2 25–35% 42 м² 38–48
15–20% 58 м² 52–64
Евро-3 15–20% 63 м² 58–70
5–10% 78 м² 72–90
4к+ 0–3% 100 м² 95–120

Это дефолт-якорь, который движок сдвигает horizon-aware от прогноза (#952) и дефицитов локации — а не выдаёт статикой. Выход §10.3 = тип / доля / мин / макс / ср.площадь / диапазон / причина / риск.

База уже есть для переиспользования: schemas/recommend.py + recommend-mix в analytics_queries.py (rule-based квартирография, success-driven flag). Net-new здесь: класс (§10.2), коммерция (§10.4), УТП-из-дефицитов (§10.5), horizon-awareness и причина-каждого-вывода §16.

## 📊 Ground-truth 2026-06-02 (ТЗ §10.3 + код) **Эталон-таблица квартирографии из ТЗ §10.3 — конкретный acceptance-образец для рекомендации** (которого нет в теле эпика): | Тип | Доля | Ср. площадь | Диапазон | |---|---|---|---| | Студии | 5–10% | 25 м² | 22–29 | | 1к | 20–25% | 36 м² | 32–40 | | Евро-2 | 25–35% | 42 м² | 38–48 | | 2к | 15–20% | 58 м² | 52–64 | | Евро-3 | 15–20% | 63 м² | 58–70 | | 3к | 5–10% | 78 м² | 72–90 | | 4к+ | 0–3% | 100 м² | 95–120 | Это дефолт-якорь, который движок **сдвигает horizon-aware** от прогноза (#952) и дефицитов локации — а не выдаёт статикой. Выход §10.3 = `тип / доля / мин / макс / ср.площадь / диапазон / причина / риск`. **База уже есть** для переиспользования: `schemas/recommend.py` + recommend-mix в `analytics_queries.py` (rule-based квартирография, success-driven flag). Net-new здесь: класс (§10.2), коммерция (§10.4), УТП-из-дефицитов (§10.5), horizon-awareness и причина-каждого-вывода §16.
lekss361 added this to the Site Finder v2 — Foresight (GG-форсайт) milestone 2026-06-02 19:02:55 +00:00
Collaborator

EPIC 9 — рекомендательная модель готова (advisory).

  • #982 (953-A): horizon-aware overlay (demand_supply/demand_only) — additive opt-in в recommend_mix, live-safe.
  • #983 (953-B): §10.2 класс / §10.4 коммерция (degraded) / §10.5 УТП + §16 структурные причины.

ADVISORY (под scope.forecast, дормантно — фронт не шлёт horizon_months). Прод-промоушн гейтится бэктестом #951 (#978).

✅ **EPIC 9 — рекомендательная модель готова (advisory).** - #982 (953-A): horizon-aware overlay (demand_supply/demand_only) — additive opt-in в recommend_mix, live-safe. - #983 (953-B): §10.2 класс / §10.4 коммерция (degraded) / §10.5 УТП + §16 структурные причины. ADVISORY (под scope.forecast, дормантно — фронт не шлёт horizon_months). Прод-промоушн гейтится бэктестом #951 (#978).
Sign in to join this conversation.
No project
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: lekss361/gendesign#953
No description provided.