pg_reports 0.6.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +29 -0
  3. data/README.md +122 -377
  4. data/app/controllers/pg_reports/dashboard_controller.rb +21 -21
  5. data/app/views/layouts/pg_reports/application.html.erb +65 -8
  6. data/app/views/pg_reports/dashboard/_show_modals.html.erb +22 -22
  7. data/app/views/pg_reports/dashboard/_show_scripts.html.erb +55 -57
  8. data/app/views/pg_reports/dashboard/_show_styles.html.erb +18 -0
  9. data/app/views/pg_reports/dashboard/index.html.erb +109 -106
  10. data/app/views/pg_reports/dashboard/show.html.erb +26 -26
  11. data/config/locales/en.yml +488 -0
  12. data/config/locales/ru.yml +481 -0
  13. data/config/locales/uk.yml +481 -0
  14. data/lib/pg_reports/compatibility.rb +3 -3
  15. data/lib/pg_reports/dashboard/reports_registry.rb +83 -12
  16. data/lib/pg_reports/definitions/schema_analysis/always_null_columns.yml +31 -0
  17. data/lib/pg_reports/definitions/schema_analysis/unused_columns.yml +32 -0
  18. data/lib/pg_reports/definitions/tables/unused_tables.yml +30 -0
  19. data/lib/pg_reports/definitions/tables/update_hotspots.yml +32 -0
  20. data/lib/pg_reports/module_generator.rb +2 -1
  21. data/lib/pg_reports/modules/schema_analysis.rb +261 -2
  22. data/lib/pg_reports/modules/system.rb +3 -3
  23. data/lib/pg_reports/query_monitor.rb +2 -6
  24. data/lib/pg_reports/report_definition.rb +20 -24
  25. data/lib/pg_reports/sql/schema_analysis/always_null_columns.sql +25 -0
  26. data/lib/pg_reports/sql/schema_analysis/unused_columns.sql +36 -0
  27. data/lib/pg_reports/sql/tables/unused_tables.sql +19 -0
  28. data/lib/pg_reports/sql/tables/update_hotspots.sql +26 -0
  29. data/lib/pg_reports/version.rb +1 -1
  30. metadata +9 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 4e7cfad6574b6b9134d0e1b4bb6ec4ad71b1c8ca9c4fc487acc7839f4ac70168
4
- data.tar.gz: 918940a09ac75506828c580bc7c64d0b7b8673ae11a9656c425dca69e715d50e
3
+ metadata.gz: 77275298b8ef6a1dba986e9b47849d1685e2d09cacdd64e3b086b20ab403574c
4
+ data.tar.gz: 893da425321112adf5d4f9944fb72028898c77119ec95ad92d27c21681a80a0e
5
5
  SHA512:
6
- metadata.gz: e8b00907aaaac1daf07c65ea1b37e9a70b9067f507be0d3f3b8e0863a0848600285dc63cc55a039e86fd5cfcc8af05ce785f58ea40a09677a6832dec0b39de7e
7
- data.tar.gz: 61d1c769f1e8c9d9eaeaf78f16ca393b782f0ee10ee1cd2d20f468c888d73d79a6c66270219d9938883681ae8a67318655e01ad201bd567b4e3daf056cfa10c3
6
+ metadata.gz: c99a83908899a5896734b7025b4b593dad0c0d4045b9578e1912ccb332aa9f29dcb0c1e79fe69a403f4a248e99a540fc1b0627af44d7ddc1c1c889c738c1ffa7
7
+ data.tar.gz: 4ff3fe8ae5a907dee4a6eb9186adb1e9819d49e62c84c7447c49999dd2c4f09d01cd962711461437f18f1853ba1c3ea9b226af5a822a373034f61f93521ef1f5
data/CHANGELOG.md CHANGED
@@ -7,6 +7,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.6.1] - 2026-04-24
11
+
12
+ ### Added
13
+
14
+ - **8 new reports** — 4 dead-schema/write-amplification reports plus 4 Rails-schema-consistency reports:
15
+ - `unused_columns` (Schema Analysis) — columns with `pg_stats.n_distinct = 1`, indicating no `UPDATE` has ever changed them since creation. Strong signal that the application code no longer references the column.
16
+ - `always_null_columns` (Schema Analysis) — nullable columns where ~100% of rows are NULL. Companion to `unused_columns` from a different angle.
17
+ - `update_hotspots` (Tables) — tables with high `updates_per_row` (same rows rewritten repeatedly) or low `hot_update_pct` (indexed columns being updated, defeating HOT). Includes refactor guidance: split hot/cold columns, event-log tables, write batching, fillfactor tuning.
18
+ - `unused_tables` (Tables) — tables with zero `seq_scan + idx_scan` since the last stats reset. Surfaces `db_stats_since` so you know how much history the verdict rests on.
19
+ - `polymorphic_without_index` (Schema Analysis) — polymorphic `belongs_to` associations whose `(*_type, *_id)` pair has no composite index. With table growth, association loads turn into seq scans.
20
+ - `counter_cache_issues` (Schema Analysis) — `belongs_to ..., counter_cache: ...` declarations whose target column is missing on the parent. Counter is silently broken — writes go nowhere, reads return nil/zero.
21
+ - `soft_delete_without_scope` (Schema Analysis) — tables with a `deleted_at` / `discarded_at` / `archived_at` column whose model has no scope filtering soft-deleted rows. Plain queries leak deleted data into reports, indexes, exports.
22
+ - `orphan_tables` (Schema Analysis) — DB tables with no corresponding Rails model class. Classified as `join_table_candidate` (likely legitimate HABTM), `join_model_without_class` (probably should be a model), or `legacy` (the interesting ones).
23
+ - New problem keys: `unused_column`, `always_null_column`, `hot_rows`, `low_hot_update`, `unused_table`, `polymorphic_no_index`, `counter_cache_missing_column`, `soft_delete_unprotected`, `orphan_table_legacy`.
24
+ - Full i18n for all new reports (en/ru/uk).
25
+ - **Full UI localization (en/ru/uk).** All dashboard chrome — buttons, modals, toasts, status badges, metric labels, filter labels, error messages, monitoring panels — now reads from a new `pg_reports.ui.*` locale namespace (183 keys per language). Plus three sibling namespaces resolved at access time from `Dashboard::ReportsRegistry` and `ReportDefinition#filter_parameters`:
26
+ - `pg_reports.categories.*` — the 6 dashboard category names (Queries / Indexes / Tables / Connections / System / Schema Analysis).
27
+ - `pg_reports.reports.<name>.{name, description}` — short name and one-line description for all 47 reports shown in the dashboard listing.
28
+ - `pg_reports.parameters.<name>.{label, description}` plus `threshold_label`/`threshold_description` templates for filter inputs.
29
+ Previously only the per-report long-form documentation was translated; the surrounding UI was hardcoded English regardless of `I18n.locale`.
30
+ - Added `window.PG_REPORTS_I18N` injected by the layout (`I18n.t('pg_reports.ui').to_json`) so client-side JS strings (toasts, dynamically rendered HTML, EXPLAIN output, IDE menu, query monitor feed) all respect the active locale.
31
+ - `<html lang>` now reflects `I18n.locale` instead of being hardcoded to `en`.
32
+ - Controller-level error/success messages (`reset_statistics`, `live_metrics`, `explain_analyze`, `execute_query`, `create_migration`, etc.) now use `I18n.t`.
33
+
34
+ ### Changed
35
+
36
+ - `module_generator` now camelizes multi-word module names (`schema_analysis` → `SchemaAnalysis`) so YAML-defined reports can live under multi-word modules. Previously only single-word modules worked via auto-generation.
37
+ - `NEW` badge moved off the seven 0.6.0 reports onto the four added in this version.
38
+
10
39
  ## [0.6.0] - 2026-04-11
11
40
 
12
41
  ### Added