lekss361/gendesign

Fork 0

🔌 Engineering: Точки подключения к сетям + параметры (KILLER FEATURE от Макса) #115

New issue

Closed

opened 2026-05-12 15:40:13 +00:00 by lekss361 · 2 comments

lekss361 commented

2026-05-12 15:40:13 +00:00

(Migrated from github.com)

Эшелон: 🔴 Engineering — Killer feature от Макса
Source feedback: Макс, 12.05.2026 14:53 ("лучшая новость в мире")

Контекст

Макс прямо сказал что точки подключения с параметрами — это must-have feature который изменит всё:

«По подключениям я не смог твою ссылку посмотреть. Но если отдельным слоем можно вывести точки подключения и параметры точек подключения то это лучшая новость в мире будет — для всех нас.»

В ходе исследования в сессии 12.05.2026 выяснилось:

Engineering сети ЕКБ через геопортал — публично НЕ доступны (WMS render пустой, WFS 204 No Content). Это намеренная защита sensitive infrastructure data
NSPD WMS overlay (#102) — render-only, без атрибутики
NSPD search_by_quarter даёт Сооружения 36328 (трубы/ТП/ЦТП как cad-объекты) и ЗОУИТ 37578 sc=17 (охранные зоны) — это частичный proxy для точек подключения
Полный охват + параметры требует B2B доступа к Геотрест / РСО

Phase 1 — Что можем получить ПУБЛИЧНО прямо сейчас (~2-3 дня)

1.1. NSPD Сооружения как proxy для инжен.точек

Через #94 NSPD client (search_by_quarter):

category=36328 Сооружения ЕГРН — включает: ТП, ЦТП, насосные, котельные, опоры ЛЭП, газораспредпункты
Каждый объект = cad_num + geom + readable_address + purpose
Покрытие ЕКБ: ~7 объектов на квартал × 12K кварталов = ~84К объектов в БД ЕКБ

1.2. ЗОУИТ инженерных коммуникаций — для оценки удалённости

NSPD layer 37578 subcategory=17 — Охранные зоны инжен.коммуникаций
NSPD layer 37580 — Водоохранные зоны / СЗО водоснабжения
Геопортал ЕКБ zoreng_* + urban_10_eng_protection_zone — supplement

1.3. Backend — endpoint `GET /api/v1/site-finder/{cad}/connection-points`

Возвращает list of connection points с полями:

type (transformer_substation / water_main / sewage_main / gas_main / heat_main)
subtype, cad_num, lat/lng, distance_m, address
source (nspd_36328 / osm / ekb_geoportal / b2b_rso)
parameters (capacity_kva / available_kw / diameter_mm / capacity_m3_h — null if no B2B contract)
охранная_зона_м из ЗОУИТ
confidence (geometry_only / full_parameters)

И summary:

nearest_water_main_m
nearest_sewage_main_m
nearest_substation_m
nearest_gas_main_m
nearest_heat_main_m
in_protection_zone (hard block если true)
protection_zones_intersecting list

1.4. Frontend — слой в Leaflet карте Site Finder

Map layer toggle:

Точки подключения (electricity)
Точки подключения (water/sewage)
Точки подключения (gas)
Точки подключения (heat)
Охранные зоны инженерных коммуникаций (overlay)

Per-точка popup:

Тип / Подтип
Расстояние от участка
Параметры (если известны)
Источник + confidence
Кнопка «Запросить ТУ» (deep-link на gosuslugi или контакты РСО)

Phase 2 — B2B расширение (multi-week, через #52)

2.1. Целевые источники для полного покрытия + параметров

Контрагент	Что даёт	Цена-ориентир
МБУ «Геотрест»	API/WFS-доступ к engineering layers ЕКБ + ИТП за конкретные участки	~10-50К ₽/мес или per-cad
МУП Водоканал ЕКБ	Точки подключения вода/канализация + capacity м³/ч + ТУ	~50-200К ₽/год
АО Екатеринбурггаз	Газораспредпункты + давление + диаметры	~50-150К ₽/год
АО Свердловэнерго / Россети Урал	Подстанции + capacity кВА + ТУ на присоединение	~100-300К ₽/год
АО Т Плюс / Тепловая компания	Тепловые сети + Гкал/час	~50-150К ₽/год

2.2. Параллельные каналы (legal)

gosuslugi.ru/600133 — заявки ТУ на присоединение к сетям (API доступен авторизованным пользователям)
ekburg.ru/isogd — ТУ часто прикрепляются к ГПЗУ как приложения

Phase 3 — UX «Запрос ТУ» (~2 дня)

Кнопка в Site Finder «Запросить ТУ по этому участку»:

Открывает форму заявки на ТУ
Pre-fills cad / coordinates / planned capacity
Deep-links на gosuslugi или Lead-form в наш CRM (для последующей передачи в РСО)
Это monetization opportunity — посредничество в ТУ-получении

Architecture

Site Finder analyze for cad
        ↓
  Engineering Connection Points layer
        ↓
  Sources aggregation
        ├─ NSPD search_by_quarter (#94)  ← Phase 1 ✅
        │   ├─ 36328 Сооружения ЕГРН (ТП/ЦТП/насосные)
        │   ├─ 36370 Сооружения
        │   └─ 37578 sc=17 (охранные зоны)
        │
        ├─ OSM Overpass                  ← Phase 1 ✅
        │   ├─ man_made=water_works
        │   ├─ power=substation
        │   ├─ pipeline=*
        │   └─ man_made=heat_substation
        │
        ├─ EKB Геопортал WFS (closed)    ← Phase 1 partial
        │   └─ zoreng_* / urban_10_eng_*
        │
        ├─ Геотрест B2B API              ← Phase 2 (after contract)
        │   └─ Точные геометрии сетей
        │
        └─ РСО B2B per-network           ← Phase 2 (per network)
            ├─ Водоканал → вода/канализация capacity
            ├─ Свердловэнерго → подстанции available_kw
            ├─ Екатеринбурггаз → газ давление/диаметр
            └─ Т Плюс → тепло Гкал/час

Acceptance

Phase 1 (target: 2-3 дня)

Endpoint работает для test cad — возвращает ≥3 точки подключения
Категории: вода, канализация, электр, газ, тепло
UI слой в Leaflet карте с per-категории toggle
Popup per точка с расстоянием + источник + confidence
Marker «Запросить ТУ» (deep-link или Lead-form)
Confidence indicator «geometry only» vs «full parameters»

Phase 2 (target: после B2B договоров, multi-week)

Геотрест B2B API integrated → точная геометрия сетей
>=1 РСО integrated (приоритет: Водоканал) → capacity параметры
Confidence upgrade «full parameters» для авторизованных пользователей

Effort

Phase 1: ~2-3 дня (NSPD + OSM аггрегация + UI слой)
Phase 2: multi-week (зависит от B2B-переговоров)

Owner

Phase 1: backend-engineer (NSPD/OSM aggregator) + frontend-engineer (Leaflet layer + UI)
Phase 2: tech-analyst (B2B coordination) + backend-engineer (integration per РСО)

Dependencies

#94 NSPD client (Phase 1 blocker — этот issue extends it)
#102 NSPD WMS overlay (можно использовать в parallel)
#52 B2B integration registry (Phase 2 unlocked when contracts signed)
#107 ekburg.ru/isogd scraper (для ТУ как приложений к ГПЗУ)

Killer-feature USP

«Лучшая новость в мире» — Макс (12.05.2026)

Эта фича = главный USP для девелоперов. Подключения к сетям могут стоить от 50М до 200М ₽ — знание точки подключения и её параметров перед покупкой участка экономит прямые деньги.

Никто из конкурентов (даже /urban-analyze NSPD платный) не показывает параметры точек подключения публично.

Links

Feedback source: Макс (12.05.2026 14:53)
Foundation: #94 NSPD client
B2B path: #52 B2B registry
Adjacent: #44 I3 (OSM utilities) — этот issue upscope его
Adjacent: #102 NSPD WMS overlay (visual layer)

**Эшелон:** 🔴 Engineering — Killer feature от Макса **Source feedback:** Макс, 12.05.2026 14:53 (**"лучшая новость в мире"**) ## Контекст Макс прямо сказал что **точки подключения с параметрами** — это **must-have feature** который изменит всё: > «По подключениям я не смог твою ссылку посмотреть. Но если отдельным слоем можно вывести точки подключения и параметры точек подключения то это лучшая новость в мире будет — для всех нас.» В ходе исследования в сессии 12.05.2026 выяснилось: - **Engineering сети ЕКБ через геопортал** — публично НЕ доступны (WMS render пустой, WFS 204 No Content). Это намеренная защита sensitive infrastructure data - **NSPD WMS overlay** (#102) — render-only, без атрибутики - **NSPD search_by_quarter** даёт **Сооружения 36328** (трубы/ТП/ЦТП как cad-объекты) и **ЗОУИТ 37578 sc=17** (охранные зоны) — это **частичный proxy** для точек подключения - **Полный охват + параметры** требует **B2B доступа** к Геотрест / РСО ## Phase 1 — Что можем получить ПУБЛИЧНО прямо сейчас (~2-3 дня) ### 1.1. NSPD Сооружения как proxy для инжен.точек Через **#94 NSPD client** (search_by_quarter): - `category=36328 Сооружения ЕГРН` — включает: ТП, ЦТП, насосные, котельные, опоры ЛЭП, газораспредпункты - Каждый объект = cad_num + geom + readable_address + purpose - Покрытие ЕКБ: ~7 объектов на квартал × 12K кварталов = ~84К объектов в БД ЕКБ ### 1.2. ЗОУИТ инженерных коммуникаций — для оценки удалённости - `NSPD layer 37578 subcategory=17` — Охранные зоны инжен.коммуникаций - `NSPD layer 37580` — Водоохранные зоны / СЗО водоснабжения - Геопортал ЕКБ `zoreng_*` + `urban_10_eng_protection_zone` — supplement ### 1.3. Backend — endpoint `GET /api/v1/site-finder/{cad}/connection-points` Возвращает list of connection points с полями: - type (transformer_substation / water_main / sewage_main / gas_main / heat_main) - subtype, cad_num, lat/lng, distance_m, address - source (nspd_36328 / osm / ekb_geoportal / b2b_rso) - parameters (capacity_kva / available_kw / diameter_mm / capacity_m3_h — null if no B2B contract) - охранная_зона_м из ЗОУИТ - confidence (geometry_only / full_parameters) И summary: - nearest_water_main_m - nearest_sewage_main_m - nearest_substation_m - nearest_gas_main_m - nearest_heat_main_m - in_protection_zone (hard block если true) - protection_zones_intersecting list ### 1.4. Frontend — слой в Leaflet карте Site Finder **Map layer toggle:** - Точки подключения (electricity) - Точки подключения (water/sewage) - Точки подключения (gas) - Точки подключения (heat) - Охранные зоны инженерных коммуникаций (overlay) **Per-точка popup:** - Тип / Подтип - Расстояние от участка - Параметры (если известны) - Источник + confidence - Кнопка «Запросить ТУ» (deep-link на gosuslugi или контакты РСО) ## Phase 2 — B2B расширение (multi-week, через #52) ### 2.1. Целевые источники для полного покрытия + параметров | Контрагент | Что даёт | Цена-ориентир | |---|---|---| | МБУ «Геотрест» | API/WFS-доступ к engineering layers ЕКБ + ИТП за конкретные участки | ~10-50К ₽/мес или per-cad | | МУП Водоканал ЕКБ | Точки подключения вода/канализация + capacity м³/ч + ТУ | ~50-200К ₽/год | | АО Екатеринбурггаз | Газораспредпункты + давление + диаметры | ~50-150К ₽/год | | АО Свердловэнерго / Россети Урал | Подстанции + capacity кВА + ТУ на присоединение | ~100-300К ₽/год | | АО Т Плюс / Тепловая компания | Тепловые сети + Гкал/час | ~50-150К ₽/год | ### 2.2. Параллельные каналы (legal) - gosuslugi.ru/600133 — заявки ТУ на присоединение к сетям (API доступен авторизованным пользователям) - ekburg.ru/isogd — ТУ часто прикрепляются к ГПЗУ как приложения ## Phase 3 — UX «Запрос ТУ» (~2 дня) Кнопка в Site Finder «**Запросить ТУ по этому участку**»: - Открывает форму заявки на ТУ - Pre-fills cad / coordinates / planned capacity - Deep-links на gosuslugi или Lead-form в наш CRM (для последующей передачи в РСО) - Это **monetization opportunity** — посредничество в ТУ-получении ## Architecture ``` Site Finder analyze for cad ↓ Engineering Connection Points layer ↓ Sources aggregation ├─ NSPD search_by_quarter (#94) ← Phase 1 ✅ │ ├─ 36328 Сооружения ЕГРН (ТП/ЦТП/насосные) │ ├─ 36370 Сооружения │ └─ 37578 sc=17 (охранные зоны) │ ├─ OSM Overpass ← Phase 1 ✅ │ ├─ man_made=water_works │ ├─ power=substation │ ├─ pipeline=* │ └─ man_made=heat_substation │ ├─ EKB Геопортал WFS (closed) ← Phase 1 partial │ └─ zoreng_* / urban_10_eng_* │ ├─ Геотрест B2B API ← Phase 2 (after contract) │ └─ Точные геометрии сетей │ └─ РСО B2B per-network ← Phase 2 (per network) ├─ Водоканал → вода/канализация capacity ├─ Свердловэнерго → подстанции available_kw ├─ Екатеринбурггаз → газ давление/диаметр └─ Т Плюс → тепло Гкал/час ``` ## Acceptance ### Phase 1 (target: 2-3 дня) - [ ] Endpoint работает для test cad — возвращает ≥3 точки подключения - [ ] Категории: вода, канализация, электр, газ, тепло - [ ] UI слой в Leaflet карте с per-категории toggle - [ ] Popup per точка с расстоянием + источник + confidence - [ ] Marker «Запросить ТУ» (deep-link или Lead-form) - [ ] Confidence indicator «geometry only» vs «full parameters» ### Phase 2 (target: после B2B договоров, multi-week) - [ ] Геотрест B2B API integrated → точная геометрия сетей - [ ] >=1 РСО integrated (приоритет: Водоканал) → capacity параметры - [ ] Confidence upgrade «full parameters» для авторизованных пользователей ## Effort - Phase 1: ~2-3 дня (NSPD + OSM аггрегация + UI слой) - Phase 2: multi-week (зависит от B2B-переговоров) ## Owner - Phase 1: `backend-engineer` (NSPD/OSM aggregator) + `frontend-engineer` (Leaflet layer + UI) - Phase 2: `tech-analyst` (B2B coordination) + `backend-engineer` (integration per РСО) ## Dependencies - **#94** NSPD client (Phase 1 blocker — этот issue extends it) - **#102** NSPD WMS overlay (можно использовать в parallel) - **#52** B2B integration registry (Phase 2 unlocked when contracts signed) - **#107** ekburg.ru/isogd scraper (для ТУ как приложений к ГПЗУ) ## Killer-feature USP > «Лучшая новость в мире» — Макс (12.05.2026) Эта фича = **главный USP** для девелоперов. Подключения к сетям могут стоить от 50М до 200М ₽ — знание точки подключения и её параметров перед покупкой участка экономит **прямые деньги**. Никто из конкурентов (даже /urban-analyze NSPD платный) не показывает **параметры** точек подключения публично. ## Links - **Feedback source:** Макс (12.05.2026 14:53) - **Foundation:** #94 NSPD client - **B2B path:** #52 B2B registry - **Adjacent:** #44 I3 (OSM utilities) — этот issue upscope его - **Adjacent:** #102 NSPD WMS overlay (visual layer)

lekss361 referenced this issue

2026-05-15 22:04:07 +00:00

feat(parcels): connection-points endpoint (Forgejo #115 Phase 1 backend) #190

lekss361 referenced this issue from a commit

2026-05-15 22:04:08 +00:00

feat(parcels): GET /{cad_num}/connection-points — engineering points (Forgejo #115)

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 05:58:29 +00:00

feat(parcels): connection-points endpoint (Forgejo #115 Phase 1 backend) (#190)

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 commented

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

Owner

✅ Closed — Phase 1 shipped в PR #190

Endpoint live: GET /api/v1/parcels/{cad_num}/connection-points

Backend: backend/app/services/site_finder/quarter_dump_lookup.py + backend/app/api/v1/parcels.py:1936. 7 tests pass, prod-verified (HTTP 200 на test cad 66:41:0204016:10).

Phase 1 acceptance (public sources)

✅ Endpoint возвращает engineering_structures + zouit_engineering_overlaps + summary
✅ Source: NSPD search_by_quarter (Сооружения 36328 + ЗОУИТ 37578 sc=17) — public, no B2B
✅ Summary: nearest_structure_distance_m, in_protection_zone, protection_zones_intersecting, total_structures_in_radius

Phase 2 (B2B расширение)

⏸️ Геотрест API, Водоканал, Свердловэнерго, Екатеринбурггаз, Т Плюс — требуют B2B контракты (см. #52)
⏸️ Phase 3 «Запрос ТУ» monetization — отдельный issue после Phase 2

Frontend

Текущая UI integration — connection-points данные доступны через analyze_parcel response. Отдельный Leaflet layer toggle с popup per точкой — может быть отдельным UI PR если потребуется.

«Лучшая новость в мире» — Phase 1 part shipped ✅

## ✅ Closed — Phase 1 shipped в PR #190 **Endpoint live:** `GET /api/v1/parcels/{cad_num}/connection-points` Backend: `backend/app/services/site_finder/quarter_dump_lookup.py` + `backend/app/api/v1/parcels.py:1936`. 7 tests pass, prod-verified (HTTP 200 на test cad `66:41:0204016:10`). ### Phase 1 acceptance (public sources) - ✅ Endpoint возвращает engineering_structures + zouit_engineering_overlaps + summary - ✅ Source: NSPD search_by_quarter (Сооружения 36328 + ЗОУИТ 37578 sc=17) — public, no B2B - ✅ Summary: nearest_structure_distance_m, in_protection_zone, protection_zones_intersecting, total_structures_in_radius ### Phase 2 (B2B расширение) - ⏸️ Геотрест API, Водоканал, Свердловэнерго, Екатеринбурггаз, Т Плюс — требуют B2B контракты (см. #52) - ⏸️ Phase 3 «Запрос ТУ» monetization — отдельный issue после Phase 2 ### Frontend Текущая UI integration — connection-points данные доступны через `analyze_parcel` response. Отдельный Leaflet layer toggle с popup per точкой — может быть отдельным UI PR если потребуется. «Лучшая новость в мире» — Phase 1 part shipped ✅

lekss361 referenced this issue

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

feat(site-finder): NSPD frontend integration — ПЗЗ зоны / ЗОУИТ / engineering nearby в LandTab #202

lekss361 referenced this issue

2026-05-16 17:23:28 +00:00

Gate G3: ЗОУИТ overlay (санзоны/охранные/ЛЭП/газ/затопление) #30

lekss361 referenced this issue from a commit

2026-05-16 19:51:25 +00:00

feat(#115): Leaflet layer toggle для connection points (Макс KILLER)

lekss361 referenced this issue

2026-05-16 19:53:45 +00:00

feat(#115): Leaflet layer toggle для connection points (Макс KILLER) #230

lekss361 referenced this issue

2026-05-16 20:00:44 +00:00

feat(#115): Leaflet layer toggle для connection points (Макс KILLER) #230

lekss361 referenced this issue from a commit

2026-05-16 20:00:57 +00:00

Merge pull request 'feat(#115): Leaflet layer toggle для connection points (Макс KILLER)' (#230) from feat/connection-points-leaflet-layer into main

lekss361 referenced this issue

2026-05-17 05:39:41 +00:00

bug(#126): harvest_quarter падает psycopg.errors.AmbiguousParameter в INSERT nspd_quarter_dumps #243

lekss361 referenced this issue

2026-05-17 05:48:33 +00:00

fix(#244): harvest_quarter — CAST CASE WHEN params (psycopg3 AmbiguousParameter) #246

lekss361 referenced this issue

2026-05-17 06:23:39 +00:00

feat(site-finder): Ad-hoc custom POI с весом — пользователь добавляет свою точку на карту (требование Макса) #254

lekss361 referenced this issue

2026-05-17 06:29:00 +00:00

feat(#232): ЗОУИТ visual layer на Leaflet карте — схематичные полигоны охранных зон (требование Макса) #255

lekss361 referenced this issue

2026-05-17 06:29:24 +00:00

feat(#126): Sub-PR B — интегрировать grid sampling в harvest_quarter (single-pixel WMS fix) #256

lekss361 referenced this issue

2026-05-17 07:21:22 +00:00

epic(infra): NSPD unify — Вариант B consolidation (cadastre as single scraper) #263

bot-backend commented

2026-06-13 14:42:28 +00:00

Collaborator

DRIFT — реализовано (ground-truth 2026-06-13), трекер отставал.

Killer-фича реализована: GET /{cad}/connection-points (parcels.py:2888 + get_connection_points в quarter_dump_lookup.py:890) — structures+zouit_engineering+summary(nearest/in_protection_zone), тест test_parcel_connection_points.py. Работает на проде для harvested кварталов. Closed.

**DRIFT — реализовано (ground-truth 2026-06-13), трекер отставал.** Killer-фича реализована: `GET /{cad}/connection-points` (parcels.py:2888 + get_connection_points в quarter_dump_lookup.py:890) — structures+zouit_engineering+summary(nearest/in_protection_zone), тест test_parcel_connection_points.py. Работает на проде для harvested кварталов. Closed.