tradein-mvp/backend/data/sql/134_listings_geom_geography_gist.sql

@@ -0,0 +1,42 @@
+-- 134_listings_geom_geography_gist.sql
+-- GIST expression-индекс на (geom::geography) — ускоряет radius-фильтр эстиматора.
+--
+-- WHY (#1189 — EXPLAIN-решение об индексе):
+--   Эстиматор тянет аналоги через `ST_DWithin(geom::geography, point, radius)`
+--   (Tier W/H/S radius-путь). Существующий `listings_geom_idx` = `gist(geom)` —
+--   на geometry, а предикат кастует в geography, поэтому планировщик НЕ может
+--   использовать его для пространственного условия: ST_DWithin падает в Filter, а
+--   geom-индекс отрабатывает только `geom IS NOT NULL` (скан ~54.5k строк).
+--   Прод-EXPLAIN (2026-06-26, ЕКБ-точка r=1500, 2-комн 45-65м²):
+--     было  — BitmapAnd(geom IS NOT NULL=54531) + Filter ST_DWithin → 180 мс, read 3961.
+--     стало — Index Scan по (geom::geography) && _st_expand(point,1500) → ~38 мс
+--             (~4.7× быстрее, тронуто ~5k строк вместо 54.5k). Замерено dry-run'ом
+--             (BEGIN; CREATE INDEX; EXPLAIN ANALYZE; ROLLBACK) на реальном проде.
+--
+-- WHAT:
+--   GIST-индекс по выражению (geom::geography). Согласован с тем, как эстиматор
+--   уже пишет предикат — без правок кода: тот же `ST_DWithin(geom::geography, ...)`
+--   начинает использовать индекс как Index Cond.
+--
+-- SAFETY:
+--   - НЕ деструктивно: только добавление индекса, данные не трогаются.
+--   - IF NOT EXISTS → идемпотентно при повторном прогоне (no-op).
+--   - Сборка GIST по ~54.5k non-null geom строк — быстро (~1-2с), кратковременный
+--     ACCESS EXCLUSIVE lock на время сборки. CONCURRENTLY не используем: файл обёрнут
+--     в BEGIN/COMMIT (CREATE INDEX CONCURRENTLY в транзакции нельзя), а на таком
+--     объёме обычная сборка дёшева. NB: раннер деплоя (deploy.yml) гонит файл через
+--     psql -v ON_ERROR_STOP=on БЕЗ --single-transaction, т.е. транзакцию открывает
+--     сам файл — как 133/104 и house-rule (Schema_Migrations_vs_Alembic.md #4).
+--   - listings_geom_idx (gist(geom)) ОСТАВЛЯЕМ — он нужен другим geometry-путям.
+--
+-- DEPENDENCIES:
+--   - listings.geom geometry(Point,4326) -- 011_listings_alter.sql / PostGIS
+--
+-- Deploy order: after 133_listings_uq_source_source_id.sql.
+
+BEGIN;
+
+CREATE INDEX IF NOT EXISTS listings_geom_geog_idx
+    ON listings USING gist ((geom::geography));
+
+COMMIT;