-- 147_location_demand_comment.sql
-- #948 / #1167: demand_index перешёл с saturating-АБСОЛЮТНОЙ нормировки
-- (clamp01(unit_velocity / 50), фикс. константа) на CITY-RELATIVE: район /
-- max-скорость по городу за прогон refresh_locations (зеркало infra_index).
--
-- Причина: на live-прогоне ВСЕ 8 районов ЕКБ давали demand=1.0 (каждый продаёт
-- ≥50 кв/мес → индекс насыщался в 1.0 везде → ноль дискриминации). См. PR #1167.
--
-- Эта миграция ТОЛЬКО синхронизирует DB-комментарий столбца с новым кодом — старый
-- текст «насыщающее преобразование» теперь врёт (ровно класс «вводящего в
-- заблуждение комментария», который и спрятал баг). Idempotent: COMMENT ON
-- безопасен к повторному применению; никакого DDL над данными.
--
-- Deploy: auto-applied deploy.yml через _schema_migrations (ровно один раз по NN).
-- Требует таблицу `location` из 146 (147 > 146 лексикографически → применяется после).

COMMENT ON COLUMN location.demand_index IS
    'Индекс спроса 0..1: city-relative нормировка market_metrics.unit_velocity '
    '(скорость продаж района / max-скорость по городу за прогон refresh_locations). '
    'NULL при недостатке данных (никогда не фабрикуем 0).';