pg_reports 0.5.4 → 0.6.1

data/config/locales/ru.yml

@@ -51,6 +51,16 @@ ru:
           - "Увеличение 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 @@ ru:
           - "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 @@ ru:
           - "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 @@ ru:
           - "Высокий 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 @@ ru:
           - "Высокая активность 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"
@@ -326,6 +401,28 @@ ru:
           - "Полезно для быстрой оценки состояния базы."
           - "Сравнивайте с 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: "Статистика кэширования базы данных."
@@ -336,6 +433,74 @@ ru:
           - "Низкий 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-моделях."
@@ -356,6 +521,13 @@ ru:
       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: "Долго выполняющийся запрос. Может блокировать другие операции."
@@ -366,3 +538,393 @@ ru:
       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}"