pg_reports 0.6.0 → 0.6.2

data/config/locales/uk.yml

@@ -244,6 +244,29 @@ uk:
           - "Висока активність UPDATE створює dead tuples — слідкуйте за vacuum."
           - "HOT updates (Heap Only Tuple) ефективніші за звичайні — індекси не оновлюються."
 
+      update_hotspots:
+        title: "Гарячі точки UPDATE"
+        what: "Таблиці, де ті самі рядки оновлюються багаторазово, або де індексовані колонки отримують hot-update."
+        how: "Рахує два співвідношення з pg_stat_user_tables: updates_per_row = n_tup_upd / n_live_tup (амплифікація запису на рядок) та hot_update_pct = n_tup_hot_upd / n_tup_upd (низьке значення = індексована колонка потрапляє в SET, що ламає HOT)."
+        nuances:
+          - "updates_per_row >> 1 означає, що окремі рядки переписуються багаторазово — типово для лічильників, статусів, last_seen_at, позицій."
+          - "Патерни рефакторингу для гарячих рядків: винести мінливу колонку в сусідню 1:1 'state'-таблицю; перейти на event/log-таблицю з періодичними згортками; буферизувати записи у фоні; debounce на стороні застосунку."
+          - "Низький hot_update_pct (наприклад, <50%) = оновлюється індексована колонка. Або видаліть індекс, або винесіть колонку в менш індексовану таблицю."
+          - "PostgreSQL не рахує UPDATE по колонках. Щоб знайти винну колонку, парсіть pg_stat_statements: імена колонок у SET зберігаються (нормалізуються лише літерали)."
+          - "Гарячі рядки + fillfactor за замовчуванням (100) вбивають HOT. ALTER TABLE ... SET (fillfactor=80) залишає місце для in-place UPDATE."
+          - "Високий n_dead_tup корелює з гарячими рядками — autovacuum має встигати, інакше bloat зростатиме швидко."
+
+      unused_tables:
+        title: "Невикористовувані таблиці"
+        what: "Таблиці з нулем seq_scan та нулем idx_scan з моменту останнього скидання статистики — код їх не читає."
+        how: "Фільтрує pg_stat_user_tables за seq_scan = 0 AND idx_scan = 0. Показує db_stats_since (pg_stat_database.stats_reset), щоб було зрозуміло, на якому вікні зроблено висновок."
+        nuances:
+          - "Переконайтеся, що db_stats_since покриває репрезентативний період — мінімум тиждень, краще повний звітний/біллінговий цикл. Нещодавній stats_reset, рестарт або оновлення PG обнуляють висновки."
+          - "Таблиці, які читаються лише репліками, НЕ рахуються на праймарі. Перевірте репліки окремо перед видаленням."
+          - "Таблиці, до яких звертаються лише COPY, pg_dump або logical replication, можуть виглядати unused — ці операції не інкрементять лічильники сканів."
+          - "FK на цю таблицю можуть тримати її 'у роботі' через каскади без прямих запитів."
+          - "Безпечна послідовність: перейменувати → почекати повний цикл → видалити. Або перемістити в окрему archive-схему."
+
       # === CONNECTIONS ===
       active_connections:
         title: "Active Connections"
@@ -410,6 +433,74 @@ uk:
           - "Низький cache hit: збільште shared_buffers (до 25% RAM), або проблема в запитах."
 
       # === SCHEMA ANALYSIS ===
+      unused_columns:
+        title: "Невикористовувані колонки"
+        what: "Колонки, які коли-небудь зберігали лише одне унікальне значення — сильна ознака, що застосунок їх більше не оновлює."
+        how: "Читає pg_stats.n_distinct = 1 (одне значення за вибіркою) та джойнить pg_attrdef для відображення default. Виключає первинні ключі та колонки унікальних індексів, щоб прибрати шум."
+        nuances:
+          - "n_distinct — оцінка за вибіркою. Зробіть ANALYZE перед тим, як довіряти результату. Застаріла статистика дає хибні спрацювання."
+          - "Таблиці менше ~1000 рядків виключені — на маленькій вибірці одне значення статистично безглузде."
+          - "Хибні спрацювання: feature flags, enum-колонки з одним released-значенням, колонки з дефолтом і одним валідним варіантом."
+          - "Справжні знахідки: колонки, у яких видалили Ruby/ORM-аксесор, але міграцію на drop column не написали; статуси, замінені іншим механізмом, але залишені в схемі."
+          - "PostgreSQL не відстежує запис по колонках, це евристика. Перед видаленням grep'ніть кодову базу за іменем колонки."
+          - "Дивіться також `always_null_columns` — той самий діагноз з іншого ракурсу."
+
+      always_null_columns:
+        title: "Колонки, завжди NULL"
+        what: "Nullable-колонки, де 100% рядків = NULL — застосунок перестав (або ніколи не починав) їх писати."
+        how: "Читає pg_stats.null_frac >= 0.999 (фактично всі NULL) та виключає колонки з NOT NULL. Джойнить pg_attrdef, щоб показати залишений default."
+        nuances:
+          - "null_frac — оцінка за вибіркою. Зробіть ANALYZE, якщо сумніваєтеся. Перевірте після репрезентативного вікна навантаження."
+          - "Колонка може бути NULL, тому що шлях запису рідко спрацьовує (premium-only поля, opt-in фічі). Перевіряйте перед видаленням."
+          - "Якщо null_pct = 100 І є не-NULL default — default не використовується, видаляйте разом із колонкою."
+          - "Деякі ORM серіалізують порожні рядки як '' замість NULL; цей звіт їх не зловить. Якщо потрібен такий сигнал — окремий звіт."
+          - "Порівняйте з `unused_columns` — він ловить колонки з одним значенням, цей — все-NULL. Разом покривають основні патерни мертвих колонок."
+
+      polymorphic_without_index:
+        title: "Polymorphic без індексу"
+        what: "Поліморфні `belongs_to`-асоціації, у яких пара `(*_type, *_id)` не покрита складеним індексом."
+        how: "Обходить `ActiveRecord::Base.descendants`, збирає `belongs_to`-рефлексії з `polymorphic: true` та перевіряє `pg_index` на наявність індексу, що покриває обидві колонки."
+        nuances:
+          - "PostgreSQL не зможе використати два одиночні індекси так само ефективно, як один складений для `WHERE x_type = ? AND x_id = ?` — це базовий патерн завантаження поліморфної асоціації."
+          - "Підказка `coverage` уточнює прогалину: \"neither indexed\" / \"only id indexed\" / \"only type indexed\" / \"type and id indexed separately\". Останні два — часткові рішення, не повні."
+          - "На маленьких таблицях нешкідливо; на великих (Comment, Note, Activity, AuditLog) кожен запит до асоціації перетворюється на seq scan."
+          - "Запропонована міграція використовує порядок `(type, id)` — у type зазвичай нижча cardinality, індекс звужується швидше."
+          - "Перед обходом моделей виконується `eager_load!`, щоб у dev результат був повним."
+
+      counter_cache_issues:
+        title: "Проблеми counter_cache"
+        what: "`belongs_to ..., counter_cache: ...` декларації, у яких цільова колонка відсутня в батьківській таблиці."
+        how: "Обходить усі моделі, знаходить `belongs_to` з опцією `counter_cache`, розв'язує ім'я очікуваної колонки (`<child_table>_count` для `counter_cache: true` або явний символ/рядок) та перевіряє колонки батька."
+        nuances:
+          - "Відсутня колонка = counter мовчки зламаний: записи нікуди не йдуть, `parent.<assoc>_count` повертає nil, будь-який код, що читає cached-значення, отримує stale або нуль."
+          - "Зворотний напрямок (колонка `*_count` без декларації `counter_cache`) навмисно не флагується — занадто багато false positives для вручну підтримуваних лічильників."
+          - "Батьківський клас розв'язується через `assoc.klass`; якщо клас відсутній або не завантажується — рядок пропускається."
+          - "Ім'я за замовчуванням для `counter_cache: true`: на батька додається колонка з іменем за таблицею **дочірньої** моделі в множині + `_count`. Приклад: `Comment belongs_to :user, counter_cache: true` → `users.comments_count`."
+          - "Перед обходом моделей виконується `eager_load!`, щоб у dev результат був повним."
+
+      soft_delete_without_scope:
+        title: "Soft delete без scope"
+        what: "Таблиці з колонкою `deleted_at` / `discarded_at` / `archived_at`, у моделі яких немає scope, що фільтрує soft-deleted рядки."
+        how: "Для кожної таблиці перевіряється наявність канонічних імен soft-delete колонок. Якщо є — знаходиться модель і перевіряється `acts_as_paranoid` (paranoia), `discard_column` (discard) або `default_scope`, чий згенерований SQL посилається на колонку."
+        nuances:
+          - "Без default scope будь-який звичайний `Model.where(...)` повертає soft-deleted рядки. Це тихо протікає у звіти, індекси, пошук, експорти."
+          - "Якщо команда свідомо відмовилася від default scope (надаючи перевагу явним `kept`/`with_deleted`), звіт дасть по рядку на кожну таку модель — це intentional, можна ігнорувати."
+          - "Метод детекції default_scope: будує `model.all.to_sql` та шукає ім'я колонки. Ловить `default_scope { where(deleted_at: nil) }` і еквіваленти, але пропускає scope з concerns, які ще не завантажені."
+          - "Таблиці без моделі рапортуються окремо зі статусом `no_model` — зазвичай означає, що таблиця використовується лише raw SQL і потребує ручного рев'ю."
+          - "Перед обходом моделей виконується `eager_load!`, щоб у dev результат був повним."
+
+      orphan_tables:
+        title: "Orphan-таблиці"
+        what: "Таблиці БД без відповідного Rails-класу моделі."
+        how: "Перелічує всі таблиці з `pg_class` (за винятком `schema_migrations` та `ar_internal_metadata`) і намагається знайти модель за звичайними naming conventions. Таблиці, що не знаходять моделі, потрапляють у звіт."
+        nuances:
+          - "Три класифікації: `join_table_candidate` (рівно дві `*_id` колонки і більше нічого — імовірно, легітимна HABTM-таблиця), `join_model_without_class` (кілька FK + додаткові поля — імовірно, мала бути моделлю join'а), `legacy` (усе інше)."
+          - "`join_table_candidate` зазвичай intentional — Rails не вимагає моделі для HABTM. Переглянути та ігнорувати."
+          - "`legacy` — найцікавіші рядки: таблиці, створені до того, як додали модель; перейменовані-але-не-видалені; створені повз Rails іншим сервісом; що належать видаленій фічі."
+          - "Звірте з `unused_tables` (категорія Таблиці) — таблиця одночасно orphan І з нулем читань = сильний кандидат на видалення."
+          - "False positives: namespaced-моделі (`Admin::User` → `admin_users`), STI-підкласи на одній базовій таблиці, моделі в engines, що не eager-loadяться."
+          - "Row count приблизний (n_live_tup з pg_stat_user_tables) — нещодавно записані таблиці можуть показувати 0 до наступного ANALYZE."
+
       missing_validations:
         title: "Відсутні валідації"
         what: "Унікальні індекси в базі даних без відповідних валідацій uniqueness в Rails-моделях."
@@ -447,3 +538,393 @@ uk:
       pool_saturation: "Пул з'єднань насичений. Ризик вичерпання з'єднань та помилок застосунку."
       high_connection_churn: "Висока оборотність з'єднань. Впровадьте connection pooling для зниження накладних витрат."
       too_many_short_connections: "Занадто багато короткоживучих з'єднань. Застосунок повинен перевикористовувати з'єднання через pooling."
+      unused_column: "Колонка має одне значення у всіх рядках. Ймовірно, не оновлювалася з моменту створення — кандидат на видалення."
+      always_null_column: "Колонка на 100% NULL. Застосунок більше не пише в це поле — кандидат на видалення."
+      hot_rows: "Ті самі рядки оновлюються багаторазово. Розгляньте розділення гарячих/холодних колонок, батчинг запису або event-log таблицю."
+      low_hot_update: "Низький відсоток HOT updates — оновлюються індексовані колонки. Видаліть індекс або винесіть колонку, щоб знизити write amplification."
+      unused_table: "Таблиця не читалася з моменту останнього скидання статистики. Кандидат на архівацію або видалення — спочатку перевірте вікно статистики."
+      polymorphic_no_index: "Поліморфна асоціація без складеного індексу (type, id). Зі зростанням таблиці запити будуть seq-scan'ити."
+      counter_cache_missing_column: "Колонка counter_cache відсутня в батьківській таблиці. Counter мовчки зламаний — записи нікуди не йдуть."
+      soft_delete_unprotected: "Soft-delete колонка без scope, що фільтрує її. Звичайні запити повертають видалені рядки."
+      orphan_table_legacy: "Таблиця без Rails-моделі. Скоріше за все, legacy — перевірте перед видаленням."
+
+    # UI strings shown in the dashboard chrome (buttons, modals, toasts, etc.)
+    ui:
+      branding:
+        title: "PgReports"
+        subtitle: "Дашборд аналізу PostgreSQL"
+        page_title: "PgReports — Дашборд"
+      navigation:
+        dashboard: "Дашборд"
+        back: "← Назад"
+      actions:
+        cancel: "Скасувати"
+        retry: "Повторити"
+        copy: "📋 Копіювати"
+        copy_query: "📋 Копіювати запит"
+        copy_code: "📋 Копіювати код"
+        copy_to_clipboard_title: "Скопіювати в буфер обміну"
+        copied_feedback: "✓ Скопійовано!"
+        clear_all: "Очистити все"
+        run_report: "▶ Запустити звіт"
+        export: "⬇ Експорт"
+        download_text: "📄 Текст (.txt)"
+        download_csv: "📊 CSV (.csv)"
+        download_json: "📋 JSON (.json)"
+        download: "📥 Завантажити"
+        copy_ai_prompt: "Копіювати промпт"
+        send_telegram: "📨 Telegram"
+        sending: "Надсилання..."
+        reset_statistics: "🗑️ Скинути статистику"
+        resetting: "Скидання..."
+        confirm_reset: "Так, скинути"
+        create_extension: "⚡ Створити розширення"
+        creating: "Створення..."
+        ide_settings_button_title: "Налаштування IDE"
+        explain_analyze: "📊 EXPLAIN ANALYZE"
+        execute_query: "▶ Виконати запит"
+        create_migration_file: "📁 Створити файл і відкрити в IDE"
+        start_monitoring: "▶ Запустити моніторинг"
+        stop_monitoring: "⏹ Зупинити моніторинг"
+        starting: "Запуск..."
+        stopping: "Зупинка..."
+        load_history: "📜 Завантажити історію (50)"
+        loading: "Завантаження..."
+        running: "Виконання..."
+        save_for_comparison: "📌 Зберегти для порівняння"
+        saved_marker: "📌 Збережено"
+      status:
+        pg_stat_ready: "pg_stat_statements готовий"
+        extension_installed: "Розширення встановлено, не передзавантажено"
+        preloaded: "Передзавантажено, розширення не створено"
+        not_configured: "Не налаштовано"
+        monitoring_unavailable: "Live-моніторинг недоступний"
+      modals:
+        enable_pg_stat_title: "Увімкнення pg_stat_statements"
+        enable_pg_stat_intro: "Щоб увімкнути pg_stat_statements, виконайте такі кроки:"
+        edit_postgresql_conf: "Відредагуйте postgresql.conf:"
+        restart_postgresql: "Перезапустіть PostgreSQL:"
+        create_extension_step: "Створіть розширення:"
+        enable_button_note: "Або натисніть кнопку «Створити розширення» після перезапуску."
+        reset_stats_title: "⚠️ Скидання статистики"
+        reset_stats_confirm: "Ви впевнені, що хочете скинути статистику pg_stat_statements?"
+        reset_stats_warning: "Ця дія очистить усю зібрану статистику запитів і не може бути скасована."
+        ide_settings_title: "⚙️ Налаштування IDE"
+        problem_detected_title: "⚠️ Виявлено проблему"
+        query_analyzer_title: "📊 Аналізатор запиту"
+        query_label: "Запит:"
+        parameters_label: "Параметри:"
+        migration_title: "🗑️ Міграція видалення індексу"
+        migration_subtitle: "Згенерована міграція для видалення індексу:"
+        migration_warning: "Створення міграції згенерує файл міграції у вашому проєкті. Запуск цієї міграції видалить індекс із БД, що може значно вплинути на продуктивність застосунку."
+        migration_warning_dev_only: "Цю операцію слід виконувати лише в локальному dev-середовищі."
+        query_execution_disabled_title: "⚠️ Виконання запитів вимкнено"
+        query_execution_disabled_intro: "Щоб увімкнути цю функцію, додайте до конфігурації:"
+      settings:
+        default_ide_label: "IDE за замовчуванням для посилань на джерела:"
+        ide_show_menu: "Показувати меню (за замовчуванням)"
+        ide_vscode_wsl: "VS Code (WSL)"
+        ide_vscode: "VS Code"
+        ide_rubymine: "RubyMine"
+        ide_intellij: "IntelliJ IDEA"
+        ide_cursor_wsl: "Cursor (WSL)"
+        ide_cursor: "Cursor"
+      monitoring:
+        live_title: "Live-моніторинг"
+        update_interval: "Оновлення кожні 5с"
+        toggle_title: "Перемкнути live-моніторинг"
+        query_monitor_title: "Монітор SQL-запитів"
+        session_label: "Сесія:"
+        queries_label: "Запитів:"
+        feed_empty: "Натисніть «Запустити моніторинг», щоб почати захоплення SQL-запитів"
+        feed_no_queries: "Запитів поки не захоплено..."
+        unknown_source: "Джерело невідоме"
+        expand_collapse_title: "Розгорнути / згорнути"
+      metrics:
+        connections_label: "З'єднання"
+        tps_label: "TPS"
+        tps_unit: "тр/с"
+        commit_label: "commit:"
+        rollback_label: "rollback:"
+        cache_hit_label: "Cache hit"
+        cache_hit_detail: "блоки heap із кешу"
+        long_queries_label: "Довгі запити"
+        queries_unit: "запитів"
+        long_running_threshold: "> 60с виконання"
+        blocked_label: "Заблоковано"
+        processes_unit: "процесів"
+        waiting_for_locks: "чекають блокувань"
+        percent_used_suffix: "% використано"
+      categories:
+        requires_pg_stat: "🔒 Потрібен pg_stat_statements"
+        reports_count_suffix: "звітів"
+      documentation:
+        toggle_title: "📖 Що показує цей звіт?"
+        what_section: "📋 Що"
+        why_section: "❓ Чому це важливо"
+        nuances_section: "⚠️ Нюанси"
+        thresholds_section: "📊 Пороги"
+        threshold_warning_label: "⚠️ Warning:"
+        threshold_critical_label: "🔴 Critical:"
+        threshold_inverted_note: "(менше — гірше)"
+      filters:
+        title: "🔍 Параметри фільтрації"
+        current_value: "зараз"
+      saved:
+        title: "📌 Збережено для порівняння"
+        saved_at_prefix: "▸ Збережено:"
+        click_to_expand: "Натисніть, щоб розгорнути"
+        confirm_clear_all: "Видалити всі збережені записи для цього звіту?"
+        remove_title: "Видалити"
+      results:
+        title: "Результати"
+        click_run_hint: "Натисніть «Запустити звіт», щоб отримати дані"
+        empty_message: "Проблем не знайдено. Усе добре!"
+        showing_first_of_total: "Показані перші %{count} з %{total} рядків"
+        no_rows_returned: "Рядків немає"
+        rows_label: "Рядків:"
+        execution_time_label: "Час виконання:"
+        null_placeholder: "<null>"
+      sections:
+        recommendation: "💡 Рекомендація"
+        detected_issues: "⚠️ Виявлені проблеми"
+        execution_plan: "📊 План виконання"
+        line_label: "Рядок"
+        current_label: "Поточне:"
+        threshold_label: "Поріг:"
+        threshold_inverted_long: "(інверсія: менші значення — гірше)"
+        warning_eq: "warning"
+        critical_eq: "critical"
+      levels:
+        critical: "🔴 Критично"
+        warning: "⚠️ Увага"
+      errors:
+        error_prefix: "Помилка:"
+        unable_fetch_metrics: "Не вдалося отримати статистику БД."
+        possible_causes: "Можливі причини:"
+        cause_permissions: "Недостатньо прав для доступу до БД"
+        cause_views: "Системні представлення статистики недоступні"
+        cause_connection: "Проблеми зі з'єднанням"
+        fetch_metrics_failed: "Не вдалося отримати live-метрики"
+        fetch_metrics_check_perms: "Не вдалося отримати статистику БД. Перевірте права доступу."
+        insufficient_database_perms: "Недостатньо прав для доступу до системних представлень статистики"
+        network_error_prefix: "Мережева помилка:"
+        copy_failed: "Не вдалося скопіювати"
+        run_report_first: "Спочатку запустіть звіт"
+        run_report_failed: "Не вдалося запустити звіт"
+        report_not_found: "Звіт не знайдено"
+        send_telegram_failed: "Не вдалося надіслати в Telegram"
+        reset_stats_failed: "Не вдалося скинути статистику"
+        start_monitoring_failed: "Не вдалося запустити моніторинг"
+        stop_monitoring_failed: "Не вдалося зупинити моніторинг"
+        load_history_failed: "Не вдалося завантажити історію:"
+        no_query_history: "Історію запитів не знайдено"
+        decode_query_failed: "Не вдалося декодувати запит"
+        explain_analyze_failed: "Не вдалося виконати EXPLAIN ANALYZE"
+        execute_query_failed: "Не вдалося виконати запит"
+        create_migration_failed: "Не вдалося створити міграцію"
+        explain_disabled_toast: "⚠️ EXPLAIN ANALYZE вимкнено. Увімкніть у конфігурації: config.allow_raw_query_execution = true"
+        execute_disabled_toast: "⚠️ Виконання запитів вимкнено. Увімкніть у конфігурації: config.allow_raw_query_execution = true"
+        query_monitoring_error: "Помилка моніторингу запитів"
+        query_hash_required: "Потрібен хеш запиту"
+        query_execution_disabled: "Виконання запитів із дашборду вимкнено. Увімкніть у конфігурації: 'config.allow_raw_query_execution = true'"
+        query_not_found_expired: "Запит не знайдено або термін дії минув. Оновіть сторінку."
+        security_violation_prefix: "Порушення безпеки:"
+        trigger_variables_not_allowed: "Не можна виконати EXPLAIN ANALYZE для запитів із тригерними змінними (NEW, OLD). Вони доступні лише в контексті тригерних функцій."
+        missing_parameter_values: "Вкажіть значення для всіх плейсхолдерів параметрів ($1, $2 тощо)"
+        migration_dev_only: "Створення міграцій дозволено лише в development-середовищі"
+        filename_code_required: "Ім'я файлу та код обов'язкові"
+        invalid_filename_format: "Невірний формат імені файлу міграції"
+        migrations_dir_not_found: "Каталог міграцій не знайдено"
+      success:
+        statistics_reset: "Статистику успішно скинуто"
+        report_generated: "Звіт успішно згенеровано"
+        ai_prompt_copied: "AI-промпт скопійовано в буфер обміну"
+        explain_copied: "Вивід EXPLAIN скопійовано в буфер обміну"
+        migration_copied: "Код міграції скопійовано в буфер обміну"
+        migration_created: "Міграцію успішно створено"
+        telegram_sent: "Звіт надіслано в Telegram"
+        queries_loaded: "Завантажено %{count} запитів з історії"
+        record_saved: "Запис збережено для порівняння"
+        record_removed: "Запис видалено"
+        record_removed_saved: "Запис видалено зі збережених"
+        all_saved_cleared: "Усі збережені записи очищено"
+
+    # Category names (shown on the dashboard grid)
+    categories:
+      queries: "Запити"
+      indexes: "Індекси"
+      tables: "Таблиці"
+      connections: "З'єднання"
+      system: "Система"
+      schema_analysis: "Аналіз схеми"
+
+    # Report names and short descriptions (shown on the dashboard listing)
+    reports:
+      slow_queries:
+        name: "Повільні запити"
+        description: "Запити з високим середнім часом виконання"
+      heavy_queries:
+        name: "Часті запити"
+        description: "Найчастіше викликані запити"
+      expensive_queries:
+        name: "Дорогі запити"
+        description: "Запити з найбільшим сумарним часом"
+      missing_index_queries:
+        name: "Без індексів"
+        description: "Запити, яким, можливо, потрібні індекси"
+      low_cache_hit_queries:
+        name: "Низький cache hit"
+        description: "Запити з поганою утилізацією кешу"
+      temp_file_queries:
+        name: "Скидання на диск"
+        description: "Запити, що скидають дані на диск"
+      all_queries:
+        name: "Усі запити"
+        description: "Повна статистика запитів"
+      unused_indexes:
+        name: "Невикористовувані індекси"
+        description: "Індекси, що рідко або ніколи не скануються"
+      duplicate_indexes:
+        name: "Дублікати індексів"
+        description: "Надлишкові індекси"
+      invalid_indexes:
+        name: "Невалідні індекси"
+        description: "Індекси, які не вдалося побудувати"
+      missing_indexes:
+        name: "Відсутні індекси"
+        description: "Таблиці, яким, можливо, потрібні індекси"
+      inefficient_indexes:
+        name: "Неефективні індекси"
+        description: "Індекси з високим read-to-fetch ratio"
+      index_usage:
+        name: "Використання індексів"
+        description: "Статистика сканування індексів"
+      bloated_indexes:
+        name: "Роздуті індекси"
+        description: "Індекси з високим bloat"
+      fk_without_indexes:
+        name: "FK без індексів"
+        description: "Зовнішні ключі без підтримуючого індексу"
+      index_correlation:
+        name: "Кореляція індексів"
+        description: "Індекси з низькою фізичною кореляцією"
+      index_sizes:
+        name: "Розміри індексів"
+        description: "Використання диска індексами"
+      table_sizes:
+        name: "Розміри таблиць"
+        description: "Використання диска таблицями"
+      bloated_tables:
+        name: "Роздуті таблиці"
+        description: "Таблиці з високою часткою dead tuples"
+      vacuum_needed:
+        name: "Потрібен VACUUM"
+        description: "Таблиці, яким потрібен VACUUM"
+      row_counts:
+        name: "Кількість рядків"
+        description: "Число рядків у таблицях"
+      cache_hit_ratios:
+        name: "Cache hit таблиць"
+        description: "Статистика кешу по таблицях"
+      seq_scans:
+        name: "Sequential scans"
+        description: "Таблиці з великою кількістю sequential scan"
+      tables_without_pk:
+        name: "Без первинного ключа"
+        description: "Таблиці без первинного ключа"
+      recently_modified:
+        name: "Нещодавно змінені"
+        description: "Таблиці з нещодавньою активністю"
+      update_hotspots:
+        name: "Гарячі точки UPDATE"
+        description: "Ті самі рядки або індексовані колонки часто оновлюються"
+      unused_tables:
+        name: "Невикористовувані таблиці"
+        description: "Таблиці, які не запитуються з моменту останнього скидання статистики"
+      active_connections:
+        name: "Активні з'єднання"
+        description: "Поточні підключення до БД"
+      connection_stats:
+        name: "Статистика з'єднань"
+        description: "З'єднання за станом"
+      long_running_queries:
+        name: "Довгі запити"
+        description: "Запити, що виконуються довго"
+      blocking_queries:
+        name: "Блокуючі запити"
+        description: "Запити, що блокують інші"
+      locks:
+        name: "Блокування"
+        description: "Поточні блокування в БД"
+      idle_connections:
+        name: "Idle з'єднання"
+        description: "З'єднання, що простоюють"
+      pool_usage:
+        name: "Використання пулу"
+        description: "Утилізація пулу з'єднань"
+      pool_wait_times:
+        name: "Час очікування"
+        description: "Аналіз очікування ресурсів"
+      pool_saturation:
+        name: "Насичення пулу"
+        description: "Попередження про здоров'я пулу"
+      connection_churn:
+        name: "Churn з'єднань"
+        description: "Аналіз життєвого циклу з'єднань"
+      database_sizes:
+        name: "Розміри баз даних"
+        description: "Розмір усіх баз"
+      settings:
+        name: "Налаштування"
+        description: "Конфігурація PostgreSQL"
+      extensions:
+        name: "Розширення"
+        description: "Встановлені розширення"
+      activity_overview:
+        name: "Огляд активності"
+        description: "Зведення поточної активності"
+      wraparound_risk:
+        name: "Ризик wraparound"
+        description: "Близькість до ліміту Transaction ID"
+      checkpoint_stats:
+        name: "Статистика checkpoint"
+        description: "Метрики чекпоінтів та bgwriter"
+      cache_stats:
+        name: "Статистика кешу"
+        description: "Статистика кешування БД"
+      missing_validations:
+        name: "Відсутні валідації"
+        description: "Унікальні індекси без валідацій моделі"
+      unused_columns:
+        name: "Невикористовувані колонки"
+        description: "Колонки, що мають лише одне значення"
+      always_null_columns:
+        name: "Завжди NULL"
+        description: "Nullable-колонки, що містять лише NULL"
+      polymorphic_without_index:
+        name: "Polymorphic без індексу"
+        description: "Поліморфні асоціації без складеного індексу"
+      counter_cache_issues:
+        name: "Проблеми counter_cache"
+        description: "counter_cache декларації без цільової колонки"
+      soft_delete_without_scope:
+        name: "Soft delete без scope"
+        description: "Soft-delete колонки без scope, що фільтрує їх"
+      orphan_tables:
+        name: "Orphan-таблиці"
+        description: "Таблиці БД без відповідної Rails-моделі"
+
+    # Filter parameter labels and descriptions
+    parameters:
+      limit:
+        label: "Ліміт"
+        description: "Максимальна кількість результатів"
+      min_calls:
+        label: "Мін. викликів"
+        description: "Мінімальна кількість викликів запиту"
+      min_duration_seconds:
+        label: "Мін. тривалість (сек)"
+        description: "Мінімальна тривалість запиту в секундах"
+      threshold_label: "%{field} — поріг"
+      threshold_description: "Перевизначити поріг для %{field}"

data/lib/pg_reports/annotation_parser.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
+require "cgi"
+
 module PgReports
   # Parses SQL query comments to extract source location and metadata
   # Supports:
   # - Marginalia format: /*application:myapp,controller:users,action:index*/
-  # - Rails QueryLogs: /*action='index',controller='users'*/
+  # - Rails QueryLogs: /*action='index',controller='users',source_location='app/foo.rb:42'*/
   #
   module AnnotationParser
     class << self
@@ -32,6 +34,16 @@ module PgReports
           end
         end
 
+        # Rails QueryLogs custom tag — Rails URL-encodes tag values (CGI.escape) to keep
+        # SQL comments safe, so "/" → "%2F" and ":" → "%3A". Decode then split into :file/:line.
+        if result[:source_location] && !result[:file]
+          decoded = CGI.unescape(result[:source_location].to_s)
+          if (match = decoded.match(%r{^(.+):(\d+)$}))
+            result[:file] = match[1]
+            result[:line] = match[2]
+          end
+        end
+
         result
       end
 

data/lib/pg_reports/compatibility.rb

@@ -5,9 +5,9 @@ module PgReports
   # Called once at boot (Ruby/Rails) and lazily on first DB access (PostgreSQL).
   module Compatibility
     # Keep in sync with gemspec constraints
-    MINIMUM_RUBY_VERSION     = "2.7"
-    MINIMUM_RAILS_VERSION    = "5.0"
-    MINIMUM_PG_VERSION       = 12_00_00  # server_version_num format
+    MINIMUM_RUBY_VERSION = "2.7"
+    MINIMUM_RAILS_VERSION = "5.0"
+    MINIMUM_PG_VERSION = 12_00_00  # server_version_num format
     MINIMUM_PG_VERSION_LABEL = "12"
 
     class << self