Generative: Анализ лучших планировок конкурентов → ТЗ на проектирование (Phase 2 после #112)

lekss361 commented

2026-05-12 15:37:26 +00:00

(Migrated from github.com)

Эшелон: 🟣 Generative — «Что строить» / Phase 2 от Макса
Source feedback: Макс, 12.05.2026 14:01

Контекст

После закрытия #112 (Активные конкуренты) — Макс хочет Phase 2:

«Следующий этап: Анализ наиболее эффективных планировок у конкурентов для формирования технического задания на проектирование.»

То есть — узнать какие планировки у конкурентов продаются быстрее всего, и из этого сформировать ТЗ на собственное проектирование.

Это уникальный USP: «Build what already sells in this district».

Что сделать

1. Source data — где брать планировки конкурентов

Источник	Что даёт	Status
`domrf_kn_flat_records`	per-flat planning data (size, rooms, layout signature)	✅ возможно есть
DOM.РФ kn-API per object	детальная квартирография ЖК	возможно надо доскачать
Объектив API	quartirography с layout-метаданными	через B2B (#52)
rosreestr_deals	реальные продажи per-flat (cad_num квартиры → площадь, дата сделки, цена)	✅
PRINZIP CRM	если есть API	через B2B (#52)
NSPD 38489 Помещения	per-flat кадастр + площадь	✅ #94 search_by_quarter

2. Layout signature — как классифицировать "планировку"

Layout = композиция признаков:

room_count: 0 (studio) / 1 / 2 / 3 / 4+
size_m2_bin: 0-25 / 25-40 / 40-60 / 60-80 / 80-100 / 100+ (ARN-buckets от НСПД)
layout_type: "евро" / "классика" / "панорама" / "two-side" / etc — extract из PD-метаданных
balcony_count: 0 / 1 / 2+
layout_signature = hash из вышесказанного

3. Backend — `POST /api/v1/site-finder/{cad}/best-layouts`

Request:

{
  "radius_m": 1000,
  "time_window": "last_2_quarters",
  "filter_competitors": [...],   // from #112 selection
  "min_velocity_per_layout": 0.5  // экземпляров/мес минимум для inclusion в TOP
}

Response:

{
  "top_layouts": [
    {
      "rank": 1,
      "rooms": 1,
      "size_bin": "40-60",
      "layout_type": "евро",
      "balconies": 1,
      "competitor_obj_ids": ["domrf_111", "domrf_222"],  // у кого встречается
      "total_sold_in_window": 67,
      "velocity_per_month": 8.4,
      "avg_price_m2": 148000,
      "avg_size_m2": 48.2,
      "ttl_sold_pct_of_supply": 89,   // 89% этого layout раскупили
      "sample_layouts_pdf_links": ["url1", "url2"]
    },
    ...
  ],
  "recommendation_for_tz": {
    "min_studio_pct": 0,
    "1_room_pct": 35,           // ТЗ: рекомендуется 35% — 1Б "евро"
    "2_room_pct": 40,
    "3_room_pct": 20,
    "4plus_pct": 5,
    "rationale_text": "В радиусе 1км за последние 2 квартала..."
  }
}

4. ТЗ на проектирование — exportable

Кнопка «Сформировать ТЗ на проектирование»:

PDF с unit-mix recommendations
Per-room target distribution
Reference planировки (links на ПД конкурентов где возможно)
Avg price/m² benchmark
Ready для тендера на проектирование

Используется наш WeasyPrint (уже в стеке).

5. Cross-link с Generative Design (B1-1..B1-4)

После #112 + этого issue — Generative Design берёт recommendation_for_tz как input для архитектурной генерации:

В сценарии «Жилой комплекс по нашему ТЗ» сразу подставляются Макс's data-driven targets
Архитектор сразу видит «Брусника продаёт 1Б-евро 67 шт/квартал → надо строить 250 единиц 1Б-евро»

Acceptance

Endpoint работает для test cad — возвращает топ-10 layouts с velocity > 0.5/мес
PDF ТЗ генерируется и читается
Reference layouts конкурентов (если есть PDF на kn.dom.rf) — ссылки
Backward-compat: recommend_mix.algorithm может использовать этот endpoint как source

Effort

~5-6 дней

Layout signature extractor (2 дня)
Endpoint + materialized view (1.5 дня)
PDF ТЗ template (1.5 дня)
UI integration (1 день)

Owner

backend-engineer (signature + endpoint) + database-expert (materialized view) + frontend-engineer (PDF + UI integration)

Dependencies

#112 (активные конкуренты) — этот issue depends on #112
DOM.РФ kn_flat_records должны иметь size + room_count (verify в схеме)
B2B Объектив (#52) — для better layout metadata (опционально)

Links

Feedback source: Макс (12.05.2026 14:01)
Phase 1: #112 Активные конкуренты
Foundation для: B1-1 Generative Design (#54 family)

**Эшелон:** 🟣 Generative — «Что строить» / Phase 2 от Макса **Source feedback:** Макс, 12.05.2026 14:01 ## Контекст После закрытия #112 (Активные конкуренты) — Макс хочет **Phase 2**: > «Следующий этап: Анализ наиболее эффективных планировок у конкурентов для формирования технического задания на проектирование.» То есть — **узнать какие планировки у конкурентов продаются быстрее всего**, и из этого **сформировать ТЗ на собственное проектирование**. Это **уникальный USP**: «Build what already sells in this district». ## Что сделать ### 1. Source data — где брать планировки конкурентов | Источник | Что даёт | Status | |---|---|---| | **`domrf_kn_flat_records`** | per-flat planning data (size, rooms, layout signature) | ✅ возможно есть | | **DOM.РФ kn-API per object** | детальная квартирография ЖК | возможно надо доскачать | | **Объектив API** | quartirography с layout-метаданными | через B2B (#52) | | **rosreestr_deals** | реальные продажи per-flat (cad_num квартиры → площадь, дата сделки, цена) | ✅ | | **PRINZIP CRM** | если есть API | через B2B (#52) | | **NSPD 38489 Помещения** | per-flat кадастр + площадь | ✅ #94 search_by_quarter | ### 2. Layout signature — как классифицировать "планировку" Layout = композиция признаков: - **room_count**: 0 (studio) / 1 / 2 / 3 / 4+ - **size_m2_bin**: 0-25 / 25-40 / 40-60 / 60-80 / 80-100 / 100+ (ARN-buckets от НСПД) - **layout_type**: "евро" / "классика" / "панорама" / "two-side" / etc — extract из PD-метаданных - **balcony_count**: 0 / 1 / 2+ - **layout_signature** = hash из вышесказанного ### 3. Backend — `POST /api/v1/site-finder/{cad}/best-layouts` **Request:** ```json { "radius_m": 1000, "time_window": "last_2_quarters", "filter_competitors": [...], // from #112 selection "min_velocity_per_layout": 0.5 // экземпляров/мес минимум для inclusion в TOP } ``` **Response:** ```json { "top_layouts": [ { "rank": 1, "rooms": 1, "size_bin": "40-60", "layout_type": "евро", "balconies": 1, "competitor_obj_ids": ["domrf_111", "domrf_222"], // у кого встречается "total_sold_in_window": 67, "velocity_per_month": 8.4, "avg_price_m2": 148000, "avg_size_m2": 48.2, "ttl_sold_pct_of_supply": 89, // 89% этого layout раскупили "sample_layouts_pdf_links": ["url1", "url2"] }, ... ], "recommendation_for_tz": { "min_studio_pct": 0, "1_room_pct": 35, // ТЗ: рекомендуется 35% — 1Б "евро" "2_room_pct": 40, "3_room_pct": 20, "4plus_pct": 5, "rationale_text": "В радиусе 1км за последние 2 квартала..." } } ``` ### 4. ТЗ на проектирование — exportable **Кнопка «Сформировать ТЗ на проектирование»:** - PDF с unit-mix recommendations - Per-room target distribution - Reference planировки (links на ПД конкурентов где возможно) - Avg price/m² benchmark - **Ready для тендера** на проектирование Используется наш `WeasyPrint` (уже в стеке). ### 5. Cross-link с Generative Design (B1-1..B1-4) После #112 + этого issue — Generative Design берёт **`recommendation_for_tz` как input** для архитектурной генерации: - В сценарии «Жилой комплекс по нашему ТЗ» сразу подставляются Макс's data-driven targets - Архитектор сразу видит «Брусника продаёт 1Б-евро 67 шт/квартал → надо строить 250 единиц 1Б-евро» ## Acceptance - [ ] Endpoint работает для test cad — возвращает топ-10 layouts с velocity > 0.5/мес - [ ] PDF ТЗ генерируется и читается - [ ] Reference layouts конкурентов (если есть PDF на kn.dom.rf) — ссылки - [ ] Backward-compat: recommend_mix.algorithm может использовать этот endpoint как source ## Effort ~5-6 дней - Layout signature extractor (2 дня) - Endpoint + materialized view (1.5 дня) - PDF ТЗ template (1.5 дня) - UI integration (1 день) ## Owner `backend-engineer` (signature + endpoint) + `database-expert` (materialized view) + `frontend-engineer` (PDF + UI integration) ## Dependencies - **#112** (активные конкуренты) — этот issue **depends on** #112 - DOM.РФ kn_flat_records должны иметь size + room_count (verify в схеме) - B2B Объектив (#52) — для better layout metadata (опционально) ## Links - **Feedback source:** Макс (12.05.2026 14:01) - **Phase 1:** #112 Активные конкуренты - **Foundation для:** B1-1 Generative Design (#54 family)

lekss361 referenced this issue

2026-05-15 22:16:34 +00:00

feat(parcels): competitors endpoint (Forgejo #112 Phase 1 backend) #191

lekss361 referenced this issue from a commit

2026-05-16 07:49:21 +00:00

feat(parcels): layout signature schemas + extractor (#113 PR A)

lekss361 referenced this issue

2026-05-16 07:49:46 +00:00

feat(parcels): layout signature schemas + extractor (#113 PR A) #193

lekss361 referenced this issue

2026-05-16 07:52:28 +00:00

feat(parcels): layout signature schemas + extractor (#113 PR A) #193

lekss361 referenced this issue from a commit

2026-05-16 07:52:36 +00:00

feat(parcels): layout signature schemas + extractor (#113 PR A) (#193)

lekss361 referenced this issue from a commit

2026-05-16 08:00:15 +00:00

feat(analytics): mv_layout_velocity MV + refresh helper (#113 PR B)

lekss361 referenced this issue

2026-05-16 08:00:39 +00:00

feat(analytics): mv_layout_velocity MV + refresh helper (#113 PR B) #194

lekss361 referenced this issue from a commit

2026-05-16 08:18:36 +00:00

fix(analytics): address review-bot PR B fixes (#113)

lekss361 referenced this issue from a commit

2026-05-16 08:27:00 +00:00

feat(analytics): mv_layout_velocity MV + refresh helper (#113 PR B) (#194)

lekss361 referenced this issue from a commit

2026-05-16 08:42:25 +00:00

feat(parcels): best-layouts endpoint + service (#113 PR C)

lekss361 referenced this issue

2026-05-16 08:43:07 +00:00

feat(parcels): best-layouts endpoint + service (#113 PR C) #196

lekss361 referenced this issue

2026-05-16 08:48:03 +00:00

feat(parcels): best-layouts endpoint + service (#113 PR C) #196

lekss361 referenced this issue from a commit

2026-05-16 08:52:12 +00:00

fix(best-layouts): replace non-existent geom_3857 with on-the-fly geography (#113 PR C)

lekss361 referenced this issue from a commit

2026-05-16 09:01:14 +00:00

fix(best-layouts): address review-bot minor items (#113 PR C)

lekss361 referenced this issue

2026-05-16 09:01:37 +00:00

test-infra: add real-DB integration test gate for site_finder services #197

lekss361 referenced this issue from a commit

2026-05-16 09:10:07 +00:00

feat(parcels): best-layouts endpoint + service (#113 PR C) (#196)

lekss361 referenced this issue from a commit

2026-05-16 09:36:53 +00:00

feat(layouts): PDF ТЗ endpoint + BestLayoutsBlock UI (#113 PR D)

lekss361 referenced this issue from a pull request that will close it,

2026-05-16 09:37:19 +00:00

feat(layouts): PDF ТЗ endpoint + BestLayoutsBlock UI (#113 PR D) #198

lekss361 referenced this issue from a commit

2026-05-16 09:39:55 +00:00

feat(layouts): PDF ТЗ endpoint + BestLayoutsBlock UI (#113 PR D)

lekss361 referenced this issue from a pull request that will close it,

2026-05-16 09:40:16 +00:00

feat(layouts): PDF ТЗ endpoint + BestLayoutsBlock UI (#113 PR D) #199

lekss361 referenced this issue

2026-05-16 09:45:38 +00:00

feat(layouts): PDF ТЗ endpoint + BestLayoutsBlock UI (#113 PR D) #199

lekss361 referenced this issue from a commit

2026-05-16 09:50:19 +00:00

fix(layouts): address review-bot minor items (#113 PR D)

lekss361 closed this issue

2026-05-16 09:53:06 +00:00

lekss361 referenced this issue from a commit

2026-05-16 09:53:06 +00:00

feat(layouts): PDF ТЗ endpoint + BestLayoutsBlock UI (#113 PR D) (#199)

lekss361 commented

2026-05-16 10:01:06 +00:00

Owner

✅ Closed — Phase 2.1 shipped

Implemented in 4 sub-PRs:

Sub-PR	Scope	LOC	Status
#193 (A)	Pydantic schemas + `layout_signature.py` helpers	236	✅ merged + deployed
#194 (B)	`data/sql/94_mv_layout_velocity.sql` materialized view	114	✅ merged + qa: 459 rows
#196 (C)	`POST /api/v1/parcels/{cad_num}/best-layouts` endpoint + service	985	✅ merged + qa: 5 layouts, pct=100, abs_units=300
#199 (D)	`POST /best-layouts/pdf` (WeasyPrint) + `BestLayoutsBlock.tsx` UI	1190	✅ merged + qa: PDF 18.8KB, UI rendered, button works

Phase 2.1 limitation: layout_type (евро/классика/панорама) + balcony_count отсутствуют в domrf_kn_flats. Signature = room_bucket × area_bin = 30 классов.

Phase 2.2 (future): B2B Объектив (#52) добавит layout_type → расширенная сигнатура.

Test cad для verify на проде: 66:41:0603016:194 (Верх-Исетский, MV coverage 33%).

Related follow-up: #197 — test-infra integration test gate для site_finder services (защита от schema-drift bugs).

## ✅ Closed — Phase 2.1 shipped **Implemented in 4 sub-PRs:** | Sub-PR | Scope | LOC | Status | |---|---|---|---| | #193 (A) | Pydantic schemas + `layout_signature.py` helpers | 236 | ✅ merged + deployed | | #194 (B) | `data/sql/94_mv_layout_velocity.sql` materialized view | 114 | ✅ merged + qa: 459 rows | | #196 (C) | `POST /api/v1/parcels/{cad_num}/best-layouts` endpoint + service | 985 | ✅ merged + qa: 5 layouts, pct=100, abs_units=300 | | #199 (D) | `POST /best-layouts/pdf` (WeasyPrint) + `BestLayoutsBlock.tsx` UI | 1190 | ✅ merged + qa: PDF 18.8KB, UI rendered, button works | **Phase 2.1 limitation:** `layout_type` (евро/классика/панорама) + `balcony_count` отсутствуют в `domrf_kn_flats`. Signature = `room_bucket × area_bin` = 30 классов. **Phase 2.2 (future):** B2B Объектив (#52) добавит layout_type → расширенная сигнатура. **Test cad для verify** на проде: `66:41:0603016:194` (Верх-Исетский, MV coverage 33%). **Related follow-up:** #197 — test-infra integration test gate для site_finder services (защита от schema-drift bugs).

lekss361 referenced this issue

2026-05-16 10:03:26 +00:00

Demand: Активные конкуренты — анализ продаж ЖК в радиусе 1км за квартал (cad → топ конкурентов) #112

lekss361 referenced this issue

2026-05-16 10:21:40 +00:00

data: backfill objective_complex_mapping (114→~2000 EKB ЖК) для повышения mv_layout_velocity coverage #203

lekss361 referenced this issue

2026-05-16 10:48:21 +00:00

feat(site-finder): inline POI weights pass-through в /analyze (#201 Phase 1) #206

lekss361 referenced this issue

2026-05-16 17:31:01 +00:00

UX X3: PDF export «Site Analysis Report» (WeasyPrint) #49