pg_reports 0.5.4 → 0.6.1

data/config/locales/uk.yml

@@ -51,6 +51,16 @@ uk:
           - "Збільшення shared_buffers допомагає, але є межа ефективності (зазвичай 25% RAM)."
           - "Covering indexes (INCLUDE) дозволяють виконувати index-only scan без звернення до таблиці."
 
+      temp_file_queries:
+        title: "Temp File Queries"
+        what: "Запити, що скидають проміжні результати у тимчасові файли на диск."
+        how: "Аналізує temp_blks_written та temp_blks_read з pg_stat_statements. Тимчасові файли створюються, коли work_mem недостатній для сортування, хешування або матеріалізації."
+        nuances:
+          - "Запис у тимчасові файли на порядки повільніший за операції в пам'яті."
+          - "Збільшення work_mem може усунути тимчасові файли, але впливає на всі сесії — використовуйте SET LOCAL для конкретних запитів."
+          - "Часті причини: великі сортування (ORDER BY), hash join на великих таблицях, DISTINCT на багатьох рядках, складні CTE."
+          - "Розгляньте додавання індексів для усунення сортувань або переписування запитів для зменшення проміжних результатів."
+
       all_queries:
         title: "All Queries"
         what: "Повна статистика по всіх запитах з pg_stat_statements."
@@ -107,6 +117,17 @@ uk:
           - "idx_tup_read — рядки прочитані з індексу."
           - "idx_tup_fetch — рядки отримані з таблиці після index scan (для non-covering indexes)."
 
+      inefficient_indexes:
+        title: "Inefficient Indexes"
+        what: "Індекси, які використовуються, але сканують значно більше записів, ніж реально витягують."
+        how: "Порівнює idx_tup_read (записів прочитано з індексу) та idx_tup_fetch (рядків витягнуто з heap) з pg_stat_user_indexes. Високе співвідношення означає, що порядок колонок індексу не відповідає предикатам запиту, змушуючи PostgreSQL сканувати великі діапазони індексу."
+        nuances:
+          - "Співвідношення read/fetch >10 означає, що індекс читає в 10+ разів більше записів, ніж повертає — явна ознака неправильного порядку колонок."
+          - "Для складених індексів (a, b, c) запити, що фільтрують по (b) або (c) без (a), не можуть виконати точний seek і змушені сканувати широкі діапазони."
+          - "Рішення: створити цільовий індекс з колонками, що відповідають найбільш селективним WHERE-предикатам у першу чергу."
+          - "Використовуйте EXPLAIN ANALYZE для підтвердження, що index scan читає надлишкову кількість записів, перш ніж вносити зміни."
+          - "Index-only scans (де idx_tup_fetch = 0) виключені — вони вказують на ефективно працюючі covering indexes."
+
       bloated_indexes:
         title: "Bloated Indexes"
         what: "Індекси з високим рівнем bloat (роздування) через мертві кортежі."
@@ -117,6 +138,27 @@ uk:
           - "pg_repack дозволяє перебудувати індекси без блокувань."
           - "Bloat >30-50% — привід для дій."
 
+      fk_without_indexes:
+        title: "FK Without Indexes"
+        what: "Зовнішні ключі на дочірніх таблицях без підтримуючого індексу."
+        how: "Порівнює pg_constraint (зовнішні ключі) з pg_index для пошуку FK-колонок без відповідного ведучого індексу."
+        nuances:
+          - "Без індексу DELETE або UPDATE батьківської таблиці викликає sequential scan дочірньої таблиці."
+          - "На великих дочірніх таблицях це може спричинити серйозну конкуренцію блокувань та сповільнити каскадні операції."
+          - "Індекс повинен мати FK-колонку як ведучу (першу) для ефективності."
+          - "Маленькі таблиці (< 10K рядків) можуть не виграти від додавання індексу — PostgreSQL віддасть перевагу seq scan."
+
+      index_correlation:
+        title: "Index Correlation"
+        what: "Індекси, де фізичний порядок рядків погано відповідає порядку індексу."
+        how: "Читає pg_stats.correlation для ведучих колонок індексів. Кореляція близько 0 означає випадковий фізичний порядок відносно індексу, що спричиняє надлишковий random I/O при range scan."
+        nuances:
+          - "Кореляція від -1 до 1. Значення близько 0 — випадковий порядок; близько 1 або -1 — впорядкований."
+          - "Низька кореляція переважно впливає на range scan (BETWEEN, >, <) та ORDER BY — точкові пошуки зачіпаються менше."
+          - "CLUSTER table USING index фізично переупорядковує рядки, але блокує таблицю та не підтримується автоматично."
+          - "Для append-only таблиць з timestamp колонками кореляція природно висока — дій не потрібно."
+          - "Показані лише таблиці > 10MB з > 100 index scan для зниження шуму."
+
       index_sizes:
         title: "Index Sizes"
         what: "Розміри індексів на диску."
@@ -183,6 +225,16 @@ uk:
           - "Високий seq_tup_read/seq_scan = багато рядків за один scan = можливо норма."
           - "Низький seq_tup_read/seq_scan = багато scan маленьких об'ємів = можливо N+1."
 
+      tables_without_pk:
+        title: "Tables Without Primary Keys"
+        what: "Таблиці без первинного ключа."
+        how: "Перевіряє pg_index на відсутність indisprimary записів для користувацьких таблиць."
+        nuances:
+          - "Логічна реплікація потребує первинний ключ або REPLICA IDENTITY для ідентифікації рядків."
+          - "Без PK операції UPDATE та DELETE потребують іншого способу унікальної ідентифікації рядків, часто призводячи до повних сканів таблиці."
+          - "Join-таблиці (many-to-many) часто навмисно без PK — розгляньте додавання складеного PK."
+          - "Деякі ORM (наприклад, Rails) передбачають наявність 'id' первинного ключа — таблиці без нього можуть спричинити помилки фреймворку."
+
       recently_modified:
         title: "Recently Modified"
         what: "Таблиці з недавньою активністю INSERT/UPDATE/DELETE."
@@ -192,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"
@@ -249,6 +324,46 @@ uk:
           - "Занадто багато idle = застосунок не закриває з'єднання або пул занадто великий."
           - "idle_session_timeout (PostgreSQL 14+) може автоматично закривати idle з'єднання."
 
+      pool_usage:
+        title: "Використання пулу з'єднань"
+        what: "Поточне використання пулу з'єднань з показниками активних, idle та доступних з'єднань по базах даних."
+        how: "Аналіз станів з'єднань в pg_stat_activity та порівняння з лімітом max_connections."
+        nuances:
+          - "Утилізація вище 70% означає наближення до ліміту — розгляньте масштабування."
+          - "Idle in transaction з'єднання витрачають ресурси та блокують VACUUM."
+          - "max_connections — глобальне налаштування для всієї БД, а не для кожної бази окремо."
+          - "Connection pooler'и (PgBouncer/pgpool) дозволяють мати більше з'єднань на рівні застосунку."
+
+      pool_wait_times:
+        title: "Аналіз часу очікування"
+        what: "Запити, що очікують ресурсів (блокування, I/O, мережа)."
+        how: "Аналіз wait_event та wait_event_type з pg_stat_activity для не-idle з'єднань."
+        nuances:
+          - "ClientRead очікування = повільний клієнт не встигає споживати дані."
+          - "Lock очікування = конкуренція між конкурентними запитами."
+          - "IO очікування = проблеми продуктивності диска або недостатній кеш."
+          - "Очікування понад 60 секунд критичні та потребують негайного розслідування."
+
+      pool_saturation:
+        title: "Попередження про насичення пулу"
+        what: "Загальні метрики здоров'я пулу з'єднань з попередженнями про насичення та рекомендаціями."
+        how: "Розрахунок відсотків утилізації для total, active, idle та проблемних з'єднань."
+        nuances:
+          - "Постійна утилізація вище 70% = необхідність налаштування пулу або масштабування."
+          - "Висока кількість idle in transaction = проблеми обробки транзакцій застосунком."
+          - "superuser_reserved_connections зменшують доступну ємність пулу."
+          - "Відстежуйте тренди — різкі стрибки можуть вказувати на витоки з'єднань."
+
+      connection_churn:
+        title: "Аналіз оборотності з'єднань"
+        what: "Аналіз патернів життєвого циклу з'єднань для виявлення надлишкового churn (часте підключення/відключення)."
+        how: "Вивчення віку з'єднань для ідентифікації короткоживучих з'єднань та розрахунку churn rate по застосунках."
+        nuances:
+          - "З'єднання молодші 10 секунд = короткоживучі."
+          - "Churn rate вище 50% = відсутність або неправильне налаштування connection pooling."
+          - "Багато коротких з'єднань = збільшене навантаження на CPU та автентифікацію."
+          - "Веб-застосунки повинні підтримувати пул з'єднань, а не створювати з'єднання на кожен запит."
+
       # === SYSTEM ===
       database_sizes:
         title: "Database Sizes"
@@ -286,6 +401,28 @@ uk:
           - "Корисно для швидкої оцінки стану бази."
           - "Порівнюйте з baseline для виявлення аномалій."
 
+      wraparound_risk:
+        title: "Wraparound Risk"
+        what: "Близькість віку Transaction ID до ліміту wraparound у 2 мільярди."
+        how: "Читає age(datfrozenxid) з pg_database. Коли значення наближається до 2^31 (~2.1 млрд), PostgreSQL зупиниться для запобігання пошкодження даних."
+        nuances:
+          - "autovacuum_freeze_max_age (за замовчуванням 200M) автоматично запускає агресивний anti-wraparound VACUUM."
+          - "Якщо age перевищує freeze_max_age, anti-wraparound VACUUM вже повинен працювати — якщо ні, розслідуйте причину."
+          - "Довготривалі транзакції не дають VACUUM просунути frozen XID — моніторте idle-in-transaction."
+          - "В екстрених випадках запустіть VACUUM FREEZE на найбільших/найстаріших таблицях першими."
+          - "Pct > 50% — попередження; > 75% — критично, потребує негайних дій."
+
+      checkpoint_stats:
+        title: "Checkpoint Stats"
+        what: "Частота чекпоінтів та метрики продуктивності background writer."
+        how: "Дані з pg_stat_bgwriter показують кількість чекпоінтів, тайминги та розподіл запису буферів."
+        nuances:
+          - "checkpoints_timed = заплановані чекпоінти (нормально); checkpoints_req = вимушені чекпоінти (під навантаженням)."
+          - "Високий requested_pct означає, що WAL заповнюється до checkpoint_timeout — збільште max_wal_size."
+          - "buffers_backend > 0 означає, що бекенди самі пишуть брудні буфери — збільште shared_buffers або активність bgwriter."
+          - "bgwriter_stops (maxwritten_clean) > 0 означає, що bgwriter досяг ліміту за раунд — збільште bgwriter_lru_maxpages."
+          - "Статистика накопичується з моменту stats_reset — порівнюйте за періоди для осмисленого аналізу."
+
       cache_stats:
         title: "Cache Stats"
         what: "Статистика кешування бази даних."
@@ -296,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-моделях."
@@ -316,8 +521,410 @@ uk:
       low_cache_hit: "Низький cache hit ratio. Запит часто читає з диска замість кешу."
       high_seq_scan: "Багато sequential scan. Можливо не вистачає індексу."
       unused_index: "Індекс не використовується. Кандидат на видалення."
+      inefficient_index: "Індекс читає значно більше записів, ніж витягує. Ймовірно, порядок колонок складеного індексу не відповідає предикатам запиту."
+      fk_without_index: "FK-колонка без підтримуючого індексу. DELETE/UPDATE батьківської таблиці спричинить sequential scan."
+      low_correlation: "Низька фізична кореляція між індексом та порядком рядків. Range scan спричинить надлишковий random I/O."
+      temp_file_heavy: "Запит скидає дані у тимчасові файли на диск. Розгляньте збільшення work_mem або оптимізацію запиту."
+      missing_pk: "Таблиця без первинного ключа. Це ламає логічну реплікацію та може спричинити проблеми з ORM."
+      wraparound_risk: "Вік Transaction ID наближається до ліміту wraparound. Потрібен VACUUM FREEZE."
+      high_checkpoint_req: "Високий відсоток вимушених чекпоінтів. Розгляньте збільшення max_wal_size."
       high_bloat: "Високий bloat. Потрібен REINDEX або VACUUM."
       many_dead_tuples: "Багато мертвих рядків. Потрібен VACUUM."
       long_running: "Довго виконуваний запит. Може блокувати інші операції."
       blocking: "Блокує інші запити. Потребує уваги."
       idle_in_transaction: "Відкрита транзакція без активності. Блокує VACUUM та утримує локи."
+      high_pool_usage: "Висока утилізація пулу з'єднань. Збільште max_connections або впровадьте connection pooling."
+      long_wait_time: "Запит занадто довго очікує ресурсів. Перевірте конкуренцію блокувань або проблеми I/O."
+      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}"