feat(22c): domrf_kn_flat_plans new table + parser stub #308

Merged

lekss361 merged 2 commits from fix/22c-flat-plans-v2 into main

2026-05-17 15:39:34 +00:00

Author	SHA1	Message	Date
lekss361	7e73505b50	fix(22c): rename migration 100 → 114 (collision avoid with merged 100_fix_mv_*)	2026-05-17 18:35:35 +03:00
lekss361	215441e4d8	feat(22c): domrf_kn_flat_plans new table + parser stub - data/sql/100_22c_flat_plans.sql: CREATE TABLE domrf_kn_flat_plans (ods_id PK, obj_id, plan_image_url, local_path, dimensions, snapshot_date) + index on obj_id. - backend/app/services/scrapers/flat_plans.py (NEW): * extract_flat_plans(raw_payload) — reserved stub; kn-API audit confirms plan images are NOT in portal/table payload, only in catalog SSR HTML. Function probes planImageUrl/layoutImageUrl/planUrl/layoutUrl/imageUrl for forward-compat if API ever adds the field. * upsert_flat_plans(db, obj_id, plans, snapshot_date) — UPSERT with COALESCE guard for local_path/downloaded_at/dimensions. * download_plan_image_stub() — NotImplementedError placeholder; real downloader is a future Celery task (#299 / 22d-track). Audit (obj_id=65136): plan_image absent from kn_object_place_66 payload (2.3 MB, checked planImage/planUrl/layoutImage/imageUrl — all FALSE). Source is catalog flat page SSR only. Wiring domrf_kn.py — separate PR. Issue #297 sub-task 22c.	2026-05-17 18:34:06 +03:00

Author

SHA1

Message

Date

lekss361

7e73505b50

fix(22c): rename migration 100 → 114 (collision avoid with merged 100_fix_mv_*)

2026-05-17 18:35:35 +03:00

lekss361

215441e4d8

feat(22c): domrf_kn_flat_plans new table + parser stub

- data/sql/100_22c_flat_plans.sql: CREATE TABLE domrf_kn_flat_plans
  (ods_id PK, obj_id, plan_image_url, local_path, dimensions, snapshot_date)
  + index on obj_id.

- backend/app/services/scrapers/flat_plans.py (NEW):
  * extract_flat_plans(raw_payload) — reserved stub; kn-API audit confirms
    plan images are NOT in portal/table payload, only in catalog SSR HTML.
    Function probes planImageUrl/layoutImageUrl/planUrl/layoutUrl/imageUrl
    for forward-compat if API ever adds the field.
  * upsert_flat_plans(db, obj_id, plans, snapshot_date) — UPSERT with
    COALESCE guard for local_path/downloaded_at/dimensions.
  * download_plan_image_stub() — NotImplementedError placeholder;
    real downloader is a future Celery task (#299 / 22d-track).

Audit (obj_id=65136): plan_image absent from kn_object_place_66 payload
(2.3 MB, checked planImage/planUrl/layoutImage/imageUrl — all FALSE).
Source is catalog flat page SSR only. Wiring domrf_kn.py — separate PR.

Issue #297 sub-task 22c.

2026-05-17 18:34:06 +03:00