lekss361/gendesign
1
0
Fork 0
Code Issues 57 Pull requests Projects Releases Packages Wiki Activity Actions

feat(site-finder): supply_layers v2 compute service (#950 EPIC6 step3+4) #1004

Merged
Light1YT merged 1 commit from feat/950c-supply-layers-service into main 2026-06-02 20:34:26 +00:00
Conversation 0 Commits 1 Files changed 2 +985
Light1YT commented 2026-06-02 20:34:24 +00:00
Owner
Copy link

Site Finder v2 / EPIC 6 — #950 Step 3+4. Детерминированный, без LLM, read-only compute. Часть #944.

Сервис supply_layers.py — считает 3 слоя склада предложения (§9.3) и возвращает SupplyLayerRow dataclasses (воркер #950 Step 5 UPSERT-ит их в supply_layers m.125). Зеркалит house-style market_metrics.py (frozen dataclass, _SQL consts, graceful-to-empty, pure helpers, CAST(:x AS type)).

  • L1 open: objective_lots available по district x class (objective/high).
  • L2 hidden (crux): SUM max(0, flat_count - free_flats) по district, mapping-free через domrf_kn_objects (free_flats m.124) — БЕЗ domrf<->objective join (обходит 2.5% маппинг). domrf_declared, medium/low по покрытию free_flats. NULL free_flats исключены (нет sold-колонки).
  • L3 future: domrf multiphase (ready_dt за горизонтом 12мес, ~нет выставленных) по dev_group_name (domrf_multiphase/low). graddoc_stub отложен на #956.

Latest-snapshot DISTINCT ON (obj_id) защищает от cross-snapshot double-count (domrf_kn_objects = UNIQUE(obj_id, snapshot_date)). Только whitelist source/confidence (m.125 CHECK). 45 unit-тестов, ruff clean. code-reviewer opus OK (все колонки существуют против реального schema; latest-snapshot фильтр верен; L1 зеркалит market_metrics; psycopg v3). Refs #950

**Site Finder v2 / EPIC 6 — #950 Step 3+4.** Детерминированный, без LLM, read-only compute. Часть #944. Сервис `supply_layers.py` — считает 3 слоя склада предложения (§9.3) и возвращает `SupplyLayerRow` dataclasses (воркер #950 Step 5 UPSERT-ит их в `supply_layers` m.125). Зеркалит house-style `market_metrics.py` (frozen dataclass, _SQL consts, graceful-to-empty, pure helpers, `CAST(:x AS type)`). - **L1 open:** `objective_lots` available по district x class (objective/high). - **L2 hidden (crux):** `SUM max(0, flat_count - free_flats)` по district, **mapping-free** через `domrf_kn_objects` (free_flats m.124) — БЕЗ domrf<->objective join (обходит 2.5% маппинг). domrf_declared, medium/low по покрытию free_flats. NULL free_flats исключены (нет sold-колонки). - **L3 future:** domrf multiphase (ready_dt за горизонтом 12мес, ~нет выставленных) по dev_group_name (domrf_multiphase/low). graddoc_stub отложен на #956. **Latest-snapshot `DISTINCT ON (obj_id)`** защищает от cross-snapshot double-count (domrf_kn_objects = UNIQUE(obj_id, snapshot_date)). Только whitelist source/confidence (m.125 CHECK). **45 unit-тестов**, ruff clean. code-reviewer opus OK (все колонки существуют против реального schema; latest-snapshot фильтр верен; L1 зеркалит market_metrics; psycopg v3). Refs #950
Light1YT added 1 commit 2026-06-02 20:34:25 +00:00 
Deterministic 3-layer склад предложения (ТЗ §9.3), read-only compute returning
SupplyLayerRow dataclasses for the #950 Step5 worker to UPSERT into supply_layers
(m.125). Mirrors market_metrics.py house style (frozen dataclass, _SQL consts,
graceful-to-empty, pure helpers, CAST(:x AS type)).

- L1 open: objective_lots available lots per district x class (objective/high)
- L2 hidden: SUM max(0, flat_count - free_flats) per district, mapping-free via
  domrf_kn_objects (free_flats m.124) - no domrf<->objective join (domrf_declared,
  medium/low by free_flats coverage). NULL free_flats excluded (no sold column).
- L3 future: domrf multiphase (ready_dt beyond 12mo horizon, ~no listed flats)
  grouped by dev_group_name (domrf_multiphase/low). graddoc_stub deferred to #956.

Latest-snapshot DISTINCT ON guards against cross-snapshot double-count
(domrf_kn_objects is UNIQUE(obj_id, snapshot_date)). Only whitelisted
source/confidence values (m.125 CHECK). 45 unit tests, ruff clean.
Light1YT merged commit 900802264a into main 2026-06-02 20:34:26 +00:00
Light1YT deleted branch feat/950c-supply-layers-service 2026-06-02 20:34:27 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
admin

Admin UI / internal tools / pipeline tracker

  
analytics

Аналитика данных / matching

  
auth

Authentication / authorization / multi-tenancy

  
automation

Автоматизация / cron / scheduler

  
bug

Something isn't working

  
business

Коммерческая воронка / пилоты / pipeline / реестр ПО

  
chore

Operational housekeeping

  
ci

Forgejo Actions / build pipeline

  
compliance

152-ФЗ / реестр ПО / legal / TOS

  
data

Data sources, parsers, ETL

  
data-moat

Уникальные данные — sales tracker, CRM aggregation

  
docs

README / runbooks / onboarding

  
duplicate

This issue or pull request already exists

  
dx

Developer experience / build speed

  
enhancement

New feature or request

  
Fable 5 ревью

Находки полного мульти-агентного ревью (Claude Fable 5, 2026-06-09)

  
feedback/max

Feedback from Max (Senior partner)

  
generative

Generative Design — concept generation engine

  
GG-форсайт

Новое ТЗ от Ген Геныча (июнь 2026): Site Finder v2 — ИИ-прогноз продуктовой стратегии девелопера. Актуальный приоритет.

  
needs-discussion

Pending team sync / decision

  
needs-human

Human review/decision required

  
observability

Monitoring / metrics / logs / Sentry / Uptime

  
pause-bots

Kill-switch — all autonomous bots pause

  
performance

Latency / throughput / DB query tuning

  
priority/p0

Critical / production-blocker

  
priority/p1

High priority

  
priority/p2

Normal priority

  
priority/p3

Низкий приоритет (follow-up, tech-debt)

  
scope/backend

Backend Python — FastAPI, Celery, scrapers

  
scope/db

DB migrations, indexes, SQL

  
scope/devops

docker-compose, Caddy, workflows

  
scope/frontend

Frontend — Next.js, React, TypeScript

  
scope/qa

Tests, smoke, Playwright

  
scrapers

Скрапперы (Avito/Cian/Yandex/Rosreestr)

  
security

Security audit / secrets / vulnerabilities

  
site-finder

Site Finder scoring quality & data layer

  
stage/1

Stage 1: Generative MVP (нед 2-7)

  
stage/2

Stage 2: Site Finder MVP (нед 8-12)

  
status/blocked

Blocked — needs human intervention

  
status/done

Closed, completed

  
status/needs-analysis

Raw/fuzzy task filed by human — auto-analyst подхватывает: code-archeology + декомпозиция в actionable scope/* + status/ready (или split на под-issues)

  
status/needs-fix

Reviewer/QA вернул worker на доработку — worker сам чинит свой PR (fixup), НЕ требует human (в отличие от status/blocked)

  
status/qa

PR merged, awaiting smoke test

  
status/ready

Ready for pickup by worker bot

  
status/review

PR open, awaiting code review

  
status/wip

Work in progress (worker claimed)

  
tech-debt

Технический долг

  
tradein

Trade-In MVP проект

  
ux

User experience / responsive / conversion

  
week ревью 1

Week review 1 — находки multi-agent аудита проекта (2026-06-14)

  
wontfix

This will not be worked on

  
вторичка

Trade-In Estimator — проект оценки вторичного жилья

  
ИРД

Исходно-разрешительная документация — слой ограничений участка для analyze-таблицы

No labels
admin
analytics
auth
automation
bug
business
chore
ci
compliance
data
data-moat
docs
duplicate
dx
enhancement
Fable 5 ревью
feedback/max
generative
GG-форсайт
needs-discussion
needs-human
observability
pause-bots
performance
priority/p0
priority/p1
priority/p2
priority/p3
scope/backend
scope/db
scope/devops
scope/frontend
scope/qa
scrapers
security
site-finder
stage/1
stage/2
status/blocked
status/done
status/needs-analysis
status/needs-fix
status/qa
status/ready
status/review
status/wip
tech-debt
tradein
ux
week ревью 1
wontfix
вторичка
ИРД
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
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#1004
No description provided.
Delete branch "feat/950c-supply-layers-service"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?