rails_error_dashboard 0.14.3 → 0.15.0

data/config/locales/zh-CN.yml

@@ -60,6 +60,8 @@ zh-CN:
       llm: LLM
       n_plus_one: N+1 查询
       deprecations: Deprecations
+      missing_translations: "翻译"
+      boot_errors: "启动错误"
       swallowed: 被吞异常
       diagnostic_dumps: 诊断
       storms: 风暴
@@ -85,6 +87,10 @@ zh-CN:
         body_html: 你正在使用默认凭据（gandalf/youshallnotpass）。请设置环境变量 <code>ERROR_DASHBOARD_USER</code>
           和 <code>ERROR_DASHBOARD_PASSWORD</code>，或在初始化文件中配置 <code>authenticate_with</code>。
         dismiss: 本次会话内不再提示
+      solid_queue:
+        label: "Solid Queue 不会运行 RED 的任务。"
+        body_html: "在修复 <code>config/queue.yml</code> 之前，后台捕获的错误和通知会一直在队列中等待。运行 <code>bin/rails error_dashboard:verify</code> 查看修复方法，然后重启应用。"
+        guide: "RED 对 Solid Queue 的要求"
       storm:
         active_title: 错误风暴进行中
         recent_title: 近期触发过风暴保护
@@ -749,6 +755,53 @@ zh-CN:
         column_ratio: 比例
         view_unrescued: 查看未被捕获、已进入 error_log 的 %{exception} 错误
         footer_tip: 被吞异常先被抛出，随后被静默捕获，可能掩盖真正的缺陷。
+      missing_translations_page:
+        title: "缺失的翻译"
+        empty_title: "未记录到缺失的翻译"
+        empty_body: "最近 %{days} 天内未记录到缺失的翻译键。"
+        how_title: "缺失翻译的跟踪方式:"
+        how_enabled_html: "必须启用跟踪（%{option}）"
+        how_hooked: "RED 会包装 I18n.exception_handler，并把调用交给应用原有的处理器；I18n 配置的其他部分不会改变"
+        how_recorded: "每一次到达处理器的查找——无论来自 I18n.t 还是视图助手 t()——都会按语言区域和键计数，并记录首次观测到的调用位置"
+        how_not_seen: "提供了 :default 的查找永远不会缺失；使用 raise_on_missing_translations 的查找会在任何处理器运行前抛出异常，因此两者都不会在此计数"
+        how_buffered: "缺失在内存中计数，并在请求或任务结束时写入，因此显示会有短暂延迟"
+        missing_keys: "缺失的键"
+        total_misses: "缺失总数"
+        locales_affected: "受影响的语言区域"
+        all_title: "缺失的翻译键"
+        column_key: "键"
+        column_locale: "语言区域"
+        column_source: "首次出现于"
+        column_misses: "缺失次数"
+        column_first_seen: "首次出现"
+        overflow_notice: "由于跟踪器的缓冲区（每线程 %{limit} 个键）已满，有 %{count} 次缺失无法归到具体的键。"
+        footer_tip: "把该键加入语言文件，或传入 :default。用户实际遇到的键排在最前。"
+        docs: "Rails i18n 指南"
+
+      boot_errors_page:
+        title: "启动错误"
+        empty_title: "未记录到启动错误"
+        empty_body: "最近 %{days} 天内没有进程在启动时崩溃。"
+        how_title: "启动错误的捕获方式:"
+        how_enabled_html: "必须启用崩溃捕获（%{option}）"
+        how_hooked: "RED 在你的 initializer 运行之后、Rails 预加载之前注册 at_exit 钩子，因此即使应用从未完成启动，启动期间的崩溃也会被捕获"
+        how_captured_html: "文件定义了错误常量导致的 %{zeitwerk}、模型中的 %{syntax}、抛出异常的 initializer：任何在处理请求之前就终止进程的问题"
+        how_imported: "此时还没有数据库，所以崩溃先写入磁盘，并在下一次成功启动时导入"
+        how_never: "被 SIGKILL 或段错误终止的进程，任何工具的 at_exit 都看不到"
+        unresolved: "未解决"
+        boot_crashes: "启动崩溃"
+        failed_boots: "失败的启动"
+        all_title: "按错误分组的启动崩溃"
+        column_error: "错误"
+        column_file: "文件"
+        column_constant: "常量"
+        column_boots: "启动次数"
+        column_first_seen: "首次出现"
+        column_status: "状态"
+        status_open: "未处理"
+        status_resolved: "已解决"
+        footer_tip: "启动崩溃意味着进程从未处理过请求。请在下次部署前修复；该行会像其他错误一样被标记为已解决。"
+
       rack_attack_page:
         title: 限流事件
         missing_title: 尚未安装 Rack Attack
@@ -963,7 +1016,7 @@ zh-CN:
         unable_to_detect: 无法检测
         no_user_model: 未检测到 User 模型
         unable_to_query_count: 无法查询数量
-        manual_cleanup_required: 需要手动清理
+        retention_enforced_by_job: "由 RetentionCleanupJob 在您的调度器运行它时删除"
         keep_forever: 永久保留
         no_automatic_deletion: 不自动删除
         run_command: 执行：
@@ -971,7 +1024,7 @@ zh-CN:
       options:
         enable_middleware: 捕获未处理的异常
         enable_error_subscriber: 订阅 Rails 错误事件
-        retention_days: 仅手动清理（执行：rails error_dashboard:cleanup_resolved DAYS=90）
+        retention_days: "删除这么多天内未再出现的错误。由 RetentionCleanupJob 执行，gem 本身不会安排它运行"
         max_backtrace_lines: 堆栈跟踪深度上限
         sampling_rate: 错误捕获的采样比例
         application_name: 本应用的名称（未设置时自动检测）
@@ -985,7 +1038,7 @@ zh-CN:
         total_users_for_impact: 用于计算影响百分比（未设置时自动检测）
         async_logging: 在后台任务中处理
         async_adapter: 任务队列适配器
-        enable_rate_limiting: 对 API 请求限流
+        enable_rate_limiting: "按 IP 和路径限制仪表盘请求"
         rate_limit_per_minute: 每个 IP 每分钟的请求数
         enable_slack_notifications: 实时通知
         slack_webhook_url: Slack webhook 地址
@@ -994,10 +1047,15 @@ zh-CN:
         notification_email_from: 发件人地址
         enable_discord_notifications: 通过 Discord webhook 通知
         discord_webhook_url: Discord webhook 地址
+        enable_telegram_notifications: "Telegram Bot API 通知"
+        telegram_bot_token: "来自 @BotFather 的机器人令牌（设置环境变量 TELEGRAM_BOT_TOKEN）"
+        telegram_chat_id: "机器人发送消息的聊天、群组或频道"
+        telegram_api_base_url: "Bot API 服务器（仅在使用代理或自建服务器时更改）"
         enable_pagerduty_notifications: 严重错误升级
         pagerduty_integration_key: PagerDuty API 密钥
         enable_webhook_notifications: 通用 webhook 地址
         webhook_urls: 自定义 webhook 地址
+        webhook_signing_secret: 使用 HMAC-SHA256 签名发出的 webhook（设置环境变量 WEBHOOK_SIGNING_SECRET）
         enable_scheduled_digests: 每日/每周摘要邮件。可通过 SolidQueue、Sidekiq 或 cron 调度
         digest_frequency: 摘要邮件的发送频率
         digest_recipients: 邮件地址（默认使用通知收件人）
@@ -1015,7 +1073,7 @@ zh-CN:
         source_code_context_lines: 目标行前后显示的行数
         enable_git_blame: 显示 git blame 信息
         source_code_cache_ttl: 源代码缓存时长
-        only_show_app_code_source: 出于安全考虑隐藏 gems/stdlib
+        only_show_app_code_source: "在源码查看器中隐藏 gem 和 vendor 代码"
         git_branch_strategy: 分支解析策略
         enable_breadcrumbs: 记录请求的活动轨迹
         breadcrumb_buffer_size: 每个请求最多记录的 breadcrumbs 数
@@ -1039,6 +1097,7 @@ zh-CN:
         enable_diagnostic_dump: 按需生成系统状态快照
         enable_crash_capture: 用 at_exit 钩子捕获未处理的崩溃
         enable_coverage_tracking: 诊断模式 — 在面板中启用后，可在源码视图中看到已执行的行（Ruby 3.2+）
+        enable_missing_translation_tracking: "按语言区域和键统计应用的 I18n 缺失（包装 I18n.exception_handler）"
         enable_rack_attack_tracking: 将 throttle/blocklist 事件记录到独立数据表
         enable_actioncable_tracking: 将 WebSocket 频道事件记录为 breadcrumbs
         enable_activestorage_tracking: 将上传/下载/删除记录为 breadcrumbs
@@ -1084,6 +1143,8 @@ zh-CN:
         breadcrumbs: Breadcrumbs
         system_health: 系统状态
         swallowed_exceptions: 被吞异常检测
+        missing_translations: "缺失翻译跟踪"
+        boot_errors: "启动错误捕获"
         rack_attack: Rack Attack 跟踪
         actioncable: ActionCable 跟踪
         activestorage: ActiveStorage 跟踪
@@ -1446,6 +1507,13 @@ zh-CN:
           guide_link: ActionCable 指南
       activestorage:
         title: ActiveStorage 状态
+        probe:
+          title: "服务可达性"
+          reachable: "可达"
+          unreachable: "不可达"
+          service: "服务：%{name}"
+          latency: "往返 %{ms} ms"
+          how: "加载本页时对一个永远不会存储的键做一次存在性检查。GET /health 执行同样的探测。"
         empty:
           title: 未找到 ActiveStorage 事件
           message: 最近 %{days} 天的错误 breadcrumbs 中未检测到 ActiveStorage 的服务操作。

data/config/routes.rb

@@ -7,6 +7,10 @@ RailsErrorDashboard::Engine.routes.draw do
   # Settings page
   get "settings", to: "errors#settings", as: :settings
 
+  # Health check (JSON): error database, queue, storm breaker, gem version.
+  # 200 when the dashboard can do its job, 503 when the error DB is unreachable.
+  get "health", to: "health#show", as: :health
+
   # Per-user dashboard language, persisted in the session (P5-T1).
   # POST only: changing it is a state change, and a GET would let any link or
   # prefetch alter the user's language.
@@ -41,6 +45,8 @@ RailsErrorDashboard::Engine.routes.draw do
       get :database_health_summary
       get :swallowed_exceptions
       get :rack_attack_summary
+      get :missing_translations
+      get :boot_errors
       get :actioncable_health_summary
       get :activestorage_health_summary
       get :llm_health_summary

data/db/migrate/20251223000000_create_rails_error_dashboard_complete_schema.rb

@@ -26,7 +26,7 @@ class CreateRailsErrorDashboardCompleteSchema < ActiveRecord::Migration[7.0]
       t.string :error_type, null: false
       t.text :message, null: false
       t.text :backtrace
-      t.integer :user_id
+      t.column :user_id, user_id_type
       t.text :request_url
       t.text :request_params
       t.text :user_agent
@@ -157,7 +157,7 @@ class CreateRailsErrorDashboardCompleteSchema < ActiveRecord::Migration[7.0]
     create_table :rails_error_dashboard_error_occurrences do |t|
       t.bigint :error_log_id, null: false
       t.datetime :occurred_at, null: false
-      t.integer :user_id
+      t.column :user_id, user_id_type
       t.string :request_id
       t.string :session_id
       t.timestamps
@@ -275,4 +275,12 @@ class CreateRailsErrorDashboardCompleteSchema < ActiveRecord::Migration[7.0]
     drop_table :rails_error_dashboard_error_logs, if_exists: true
     drop_table :rails_error_dashboard_applications, if_exists: true
   end
+
+  private
+
+  # Same type as the app's primary keys, as ActiveStorage does for record_id.
+  def user_id_type
+    config = Rails.configuration.generators
+    config.options[config.orm][:primary_key_type] || :integer
+  end
 end

data/db/migrate/20251225074653_remove_environment_from_error_logs.rb

@@ -3,6 +3,15 @@ class RemoveEnvironmentFromErrorLogs < ActiveRecord::Migration[7.0]
     # Skip if squashed migration ran (column never existed) or already removed
     return unless column_exists?(:rails_error_dashboard_error_logs, :environment)
 
+    # Only the v0.1.x column is removed: it was NOT NULL. The column
+    # AddEnvironmentToErrorLogs adds back (0.11.0) is nullable and holds real
+    # data. This migration replays over it whenever RED's migrations run
+    # against tables that already exist (an app joining a shared error
+    # database runs its own renumbered copy of every migration), and dropping
+    # it there wiped every error's environment.
+    environment = columns(:rails_error_dashboard_error_logs).find { |column| column.name == "environment" }
+    return if environment.nil? || environment.null
+
     # Remove composite index first
     remove_index :rails_error_dashboard_error_logs,
                  name: 'index_error_logs_on_environment_and_occurred_at',

data/db/migrate/20261010000001_create_missing_translations.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# One row per (locale, key, application) the host app failed to translate.
+#
+# A missing translation is not an error: Rails renders "translation missing"
+# (or the humanized key) and the request succeeds, so it never reaches
+# error_logs and nothing in the dashboard would otherwise show it. The
+# tracker counts misses in memory and upserts them here at the end of the
+# request or job that produced them -- a loop rendering a missing key a
+# thousand times is one UPDATE, not a thousand INSERTs.
+class CreateMissingTranslations < ActiveRecord::Migration[7.0]
+  def change
+    # Guard against the squashed schema migration having already created this
+    # table -- without it, every later migration is silently cancelled.
+    return if table_exists?(:rails_error_dashboard_missing_translations)
+
+    create_table :rails_error_dashboard_missing_translations do |t|
+      # BCP 47 tags ("pt-BR", "zh-Hans-CN", "en-US-x-twain") fit in 35.
+      t.string   :locale,          null: false, limit: 35
+      # The full dotted key as I18n normalised it ("users.show.greeting").
+      # Capped at 191 so the unique upsert index stays inside MySQL's
+      # 3072-byte utf8mb4 limit: (35 + 191) * 4 + application_id. The tracker
+      # truncates before the value reaches the index.
+      t.string   :translation_key, null: false, limit: 191
+      # First host call site seen for this key ("app/views/users/show.html.erb:12").
+      # First-write-wins; not part of the row's identity.
+      t.string   :source,          limit: 250
+      t.bigint   :miss_count,      null: false, default: 0
+      t.datetime :first_seen_at,   null: false
+      t.datetime :last_seen_at,    null: false
+      # Nullable: a miss recorded before application scoping, or with no
+      # application_name configured, applies to the whole install.
+      t.bigint   :application_id
+      t.timestamps
+    end
+
+    # Named explicitly: an auto-generated name would exceed PostgreSQL's
+    # 63-character limit and fail during the HOST app's deploy.
+    add_index :rails_error_dashboard_missing_translations,
+              [ :locale, :translation_key, :application_id ],
+              unique: true,
+              name: "index_red_missing_translations_upsert_key"
+
+    # The dashboard reads "misses seen in the last N days" and retention
+    # prunes by the same column.
+    add_index :rails_error_dashboard_missing_translations,
+              :last_seen_at,
+              name: "index_red_missing_translations_on_last_seen_at"
+  end
+end

data/lib/generators/rails_error_dashboard/install/install_generator.rb

@@ -12,6 +12,7 @@ module RailsErrorDashboard
       class_option :slack, type: :boolean, default: false, desc: "Enable Slack notifications"
       class_option :email, type: :boolean, default: false, desc: "Enable email notifications"
       class_option :discord, type: :boolean, default: false, desc: "Enable Discord notifications"
+      class_option :telegram, type: :boolean, default: false, desc: "Enable Telegram notifications"
       class_option :pagerduty, type: :boolean, default: false, desc: "Enable PagerDuty notifications"
       class_option :webhooks, type: :boolean, default: false, desc: "Enable webhook notifications"
       # Performance options
@@ -58,7 +59,7 @@ module RailsErrorDashboard
 
         if quick_mode?
           @selected_features = build_quick_defaults
-          say "  Using sensible defaults (analytics ON, notifications OFF, breadcrumbs OFF)", :green
+          say "  Using sensible defaults (analytics, breadcrumbs ON, system health ON, 50% sampling; notifications OFF)", :green
           return
         end
 
@@ -71,13 +72,13 @@ module RailsErrorDashboard
         @selected_features = {}
 
         # =====================================================================
-        # QUESTION 1: Notifications (gated — one y/N opens 5 sub-questions)
+        # QUESTION 1: Notifications (gated — one y/N opens 6 sub-questions)
         # =====================================================================
-        notification_keys = %i[slack email discord pagerduty webhooks]
+        notification_keys = %i[slack email discord telegram pagerduty webhooks]
         any_notification_cli_flag = notification_keys.any? { |k| options[k] }
 
         say "[1/3] Notifications [background/dashboard only — zero request overhead]", :cyan
-        say "    Alert your team via Slack, email, Discord, PagerDuty, or webhooks.", :white
+        say "    Alert your team via Slack, email, Discord, Telegram, PagerDuty, or webhooks.", :white
 
         if any_notification_cli_flag
           # Individual CLI flags passed — respect them, skip the gate prompt
@@ -90,6 +91,7 @@ module RailsErrorDashboard
               { key: :slack,      name: "Slack",     hint: "SLACK_WEBHOOK_URL" },
               { key: :email,      name: "Email",     hint: "ERROR_NOTIFICATION_EMAILS" },
               { key: :discord,    name: "Discord",   hint: "DISCORD_WEBHOOK_URL" },
+              { key: :telegram,   name: "Telegram",  hint: "TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID" },
               { key: :pagerduty,  name: "PagerDuty", hint: "PAGERDUTY_INTEGRATION_KEY" },
               { key: :webhooks,   name: "Webhooks",  hint: "WEBHOOK_URLS" }
             ]
@@ -131,7 +133,10 @@ module RailsErrorDashboard
         advanced_keys = %i[async_logging error_sampling breadcrumbs system_health
                            source_code_integration git_blame swallowed_exceptions
                            crash_capture diagnostic_dump]
-        any_advanced_cli_flag = advanced_keys.any? { |k| options[k] }
+        # A flag the user passed, not an option left at its default: async_logging
+        # defaults to true, so "is any of these set?" was always yes and this
+        # question was never asked.
+        any_advanced_cli_flag = advanced_keys.any? { |k| options[k] != self.class.class_options[k]&.default }
 
         say "\n[3/3] Advanced Options (performance tuning & diagnostics)", :cyan
         say "    Async logging, error sampling, breadcrumbs, system health,", :white
@@ -169,8 +174,10 @@ module RailsErrorDashboard
             advanced_features.each do |f|
               say "\n    #{f[:name]}", :cyan
               say "    #{f[:desc]}", :white
-              r = ask("    Enable? (y/N):", :yellow, limited_to: [ "y", "Y", "n", "N", "" ])
-              @selected_features[f[:key]] = r.downcase == "y"
+              # Async logging is on unless declined, as it is without this question.
+              default_on = f[:key] == :async_logging
+              r = ask("    Enable? (#{default_on ? 'Y/n' : 'y/N'}):", :yellow, limited_to: [ "y", "Y", "n", "N", "" ])
+              @selected_features[f[:key]] = default_on ? r.downcase != "n" : r.downcase == "y"
               if @selected_features[f[:key]] && f[:key] == :swallowed_exceptions && RUBY_VERSION < "3.3"
                 say "    ⚠ Requires Ruby 3.3+ (you have #{RUBY_VERSION}) — will activate after upgrade", :yellow
               end
@@ -289,11 +296,14 @@ module RailsErrorDashboard
         @enable_slack = @selected_features&.dig(:slack) || options[:slack]
         @enable_email = @selected_features&.dig(:email) || options[:email]
         @enable_discord = @selected_features&.dig(:discord) || options[:discord]
+        @enable_telegram = @selected_features&.dig(:telegram) || options[:telegram]
         @enable_pagerduty = @selected_features&.dig(:pagerduty) || options[:pagerduty]
         @enable_webhooks = @selected_features&.dig(:webhooks) || options[:webhooks]
 
         # Performance
-        @enable_async_logging = @selected_features&.dig(:async_logging) || options[:async_logging]
+        # An answer, when there was one, wins: `answer || default` turned a "no"
+        # into the default's "yes".
+        @enable_async_logging = @selected_features&.key?(:async_logging) ? @selected_features[:async_logging] : options[:async_logging]
         @enable_error_sampling = @selected_features&.dig(:error_sampling) || options[:error_sampling]
 
         # Database mode (set by select_database_mode or CLI flags)
@@ -410,6 +420,7 @@ module RailsErrorDashboard
         notification_features << "Slack" if @enable_slack
         notification_features << "Email" if @enable_email
         notification_features << "Discord" if @enable_discord
+        notification_features << "Telegram" if @enable_telegram
         notification_features << "PagerDuty" if @enable_pagerduty
         notification_features << "Webhooks" if @enable_webhooks
 
@@ -474,6 +485,7 @@ module RailsErrorDashboard
         say "  → Set SLACK_WEBHOOK_URL in .env", :yellow if @enable_slack
         say "  → Set ERROR_NOTIFICATION_EMAILS in .env", :yellow if @enable_email
         say "  → Set DISCORD_WEBHOOK_URL in .env", :yellow if @enable_discord
+        say "  → Set TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID in .env", :yellow if @enable_telegram
         say "  → Set PAGERDUTY_INTEGRATION_KEY in .env", :yellow if @enable_pagerduty
         say "  → Set WEBHOOK_URLS in .env", :yellow if @enable_webhooks
         if @enable_async_logging
@@ -493,12 +505,12 @@ module RailsErrorDashboard
         say "Next Steps:", :cyan
         if @enable_separate_database
           say "  1. Add the database.yml entry shown above"
-          say "  2. Run: rails db:create:error_dashboard"
+          say "  2. Run: rails db:create:#{@database_name}"
           if @enable_multi_app
             say "  3. Run migrations (only needed on the FIRST app):"
-            say "     rails db:migrate:error_dashboard"
+            say "     rails db:migrate:#{@database_name}"
           else
-            say "  3. Run: rails db:migrate:error_dashboard"
+            say "  3. Run: rails db:migrate:#{@database_name}"
           end
           say "  4. Before deploying: set ERROR_DASHBOARD_USER and ERROR_DASHBOARD_PASSWORD there"
           say "  5. Restart your Rails server"
@@ -562,7 +574,7 @@ module RailsErrorDashboard
           system_health: true,     # ~1ms per error — GC, memory, threads at exact error moment
           error_sampling: true,    # 50% sampling on non-critical errors — halves storage, still shows patterns
           # OFF — require credentials, config, or niche use case
-          slack: false, email: false, discord: false, pagerduty: false, webhooks: false,
+          slack: false, email: false, discord: false, telegram: false, pagerduty: false, webhooks: false,
           source_code_integration: false,
           git_blame: false,
           swallowed_exceptions: false,
@@ -595,33 +607,23 @@ module RailsErrorDashboard
           say "  # Separate error database", :white
         end
 
-        say "\n  development:", :cyan
-        say "    primary:", :white
-        say "      <<: *default", :white
-        say "      database: #{app_name_snake}_development", :white
-        say "    error_dashboard:", :white
-        say "      <<: *default", :white
-        if @enable_multi_app
-          shared_db_base = @shared_db_name || "shared_errors"
-          say "      database: #{shared_db_base}_development", :white
-        else
-          say "      database: #{app_name_snake}_errors_development", :white
-        end
-        say "      migrations_paths: db/error_dashboard_migrate", :white
-
-        say "\n  production:", :cyan
-        say "    primary:", :white
-        say "      <<: *default", :white
-        say "      database: #{app_name_snake}_production", :white
-        say "    error_dashboard:", :white
-        say "      <<: *default", :white
-        if @enable_multi_app
-          shared_db_base = @shared_db_name || "shared_errors"
-          say "      database: #{shared_db_base}_production", :white
-        else
-          say "      database: #{app_name_snake}_errors_production", :white
+        # Every environment the app boots in needs the entry, test included:
+        # without it RED falls back to the main database and records nothing.
+        %w[development test production].each do |env|
+          say "\n  #{env}:", :cyan
+          say "    primary:", :white
+          say "      <<: *default", :white
+          say "      database: #{app_name_snake}_#{env}", :white
+          say "    #{@database_name}:", :white
+          say "      <<: *default", :white
+          if @enable_multi_app
+            shared_db_base = @shared_db_name || "shared_errors"
+            say "      database: #{shared_db_base}_#{env}", :white
+          else
+            say "      database: #{app_name_snake}_errors_#{env}", :white
+          end
+          say "      migrations_paths: db/error_dashboard_migrate", :white
         end
-        say "      migrations_paths: db/error_dashboard_migrate", :white
         say "\n"
 
         if @enable_multi_app

data/lib/generators/rails_error_dashboard/install/templates/initializer.rb

@@ -127,6 +127,21 @@ RailsErrorDashboard.configure do |config|
   config.enable_discord_notifications = false
   # config.discord_webhook_url = ENV["DISCORD_WEBHOOK_URL"]
 
+<% end -%>
+<% if @enable_telegram -%>
+  # Telegram Notifications - ENABLED
+  config.enable_telegram_notifications = true
+  config.telegram_bot_token = ENV["TELEGRAM_BOT_TOKEN"]
+  config.telegram_chat_id = ENV["TELEGRAM_CHAT_ID"]
+  # To disable: Set config.enable_telegram_notifications = false
+
+<% else -%>
+  # Telegram Notifications - DISABLED
+  # To enable: Set config.enable_telegram_notifications = true and configure a bot token and chat id
+  config.enable_telegram_notifications = false
+  # config.telegram_bot_token = ENV["TELEGRAM_BOT_TOKEN"]
+  # config.telegram_chat_id = ENV["TELEGRAM_CHAT_ID"]
+
 <% end -%>
 <% if @enable_pagerduty -%>
   # PagerDuty Integration - ENABLED (critical errors only)
@@ -145,6 +160,9 @@ RailsErrorDashboard.configure do |config|
   # Generic Webhook Notifications - ENABLED
   config.enable_webhook_notifications = true
   config.webhook_urls = ENV.fetch("WEBHOOK_URLS", "").split(",").map(&:strip).reject(&:empty?)
+  # Sign every webhook (HMAC-SHA256 over timestamp + body) so receivers can
+  # verify it came from this app. Generate with: ruby -rsecurerandom -e 'puts SecureRandom.hex(32)'
+  # config.webhook_signing_secret = ENV["WEBHOOK_SIGNING_SECRET"]
   # To disable: Set config.enable_webhook_notifications = false
 
 <% else -%>
@@ -152,6 +170,7 @@ RailsErrorDashboard.configure do |config|
   # To enable: Set config.enable_webhook_notifications = true and configure webhook URLs
   config.enable_webhook_notifications = false
   # config.webhook_urls = ENV.fetch("WEBHOOK_URLS", "").split(",").map(&:strip).reject(&:empty?)
+  # config.webhook_signing_secret = ENV["WEBHOOK_SIGNING_SECRET"]  # HMAC-SHA256 signature headers
 
 <% end -%>
   # Dashboard base URL (used in notification links)
@@ -186,7 +205,8 @@ RailsErrorDashboard.configure do |config|
 <% if @enable_error_sampling -%>
   # Error Sampling - ENABLED
   # Samples non-critical errors to reduce storage volume.
-  # Critical and high severity errors are ALWAYS logged at 100% regardless of this setting.
+  # Critical errors are always logged, regardless of this setting. So is the first
+  # occurrence of each error in each process.
   # 0.5 = log 50% of non-critical occurrences — halves storage while keeping
   # occurrence counts meaningful and error patterns visible.
   # Tune lower (e.g. 0.1) if one error is flooding the DB; set to 1.0 to log everything.
@@ -244,7 +264,7 @@ RailsErrorDashboard.configure do |config|
   # Automatically detect when error rates exceed normal patterns
   config.enable_baseline_alerts = true
   config.baseline_alert_threshold_std_devs = 2.0  # Alert when > 2 std devs above baseline
-  config.baseline_alert_severities = [ :critical, :high ]
+  config.baseline_alert_severities = [ :critical, :high ]  # Only errors of these severities alert
   config.baseline_alert_cooldown_minutes = 120  # 2 hours between alerts
   # To disable: Set config.enable_baseline_alerts = false
 
@@ -253,7 +273,7 @@ RailsErrorDashboard.configure do |config|
   # To enable: Set config.enable_baseline_alerts = true
   config.enable_baseline_alerts = false
   # config.baseline_alert_threshold_std_devs = 2.0
-  # config.baseline_alert_severities = [ :critical, :high ]
+  # config.baseline_alert_severities = [ :critical, :high ]  # Only errors of these severities alert
   # config.baseline_alert_cooldown_minutes = 120
 
 <% end -%>
@@ -407,6 +427,14 @@ RailsErrorDashboard.configure do |config|
   # config.swallowed_exception_threshold = 0.95
 
 <% end -%>
+  # Missing-Translation Tracking - DISABLED
+  # Counts every I18n key your app looked up and did not have, by locale, with
+  # the first call site, on its own dashboard page (/errors/missing_translations).
+  # Wraps I18n.exception_handler and delegates to the handler you already had —
+  # the one place RED touches global I18n state, which is why it is opt-in.
+  # To enable: Set config.enable_missing_translation_tracking = true
+  config.enable_missing_translation_tracking = false
+
 <% if @enable_diagnostic_dump -%>
   # Diagnostic Dump - ENABLED
   # On-demand system state snapshot via rake task or dashboard button

data/lib/generators/rails_error_dashboard/uninstall/uninstall_generator.rb

@@ -236,13 +236,22 @@ module RailsErrorDashboard
         say "Remaining manual steps:", :cyan
         say "\n"
 
-        say "1. Remove from Gemfile:", :yellow
+        unless options[:keep_data]
+          say "1. Regenerate the schema file:", :yellow
+          say "   Run: bin/rails db:schema:dump (otherwise db:schema:load recreates the tables)"
+          say "\n"
+
+          say "2. Separate database only: remove its entry from config/database.yml", :yellow
+          say "\n"
+        end
+
+        say "#{options[:keep_data] ? 1 : 3}. Remove from Gemfile:", :yellow
         say "   Open: Gemfile"
         say "   Remove: gem 'rails_error_dashboard'"
         say "   Run: bundle install"
         say "\n"
 
-        say "2. Restart your application:", :yellow
+        say "#{options[:keep_data] ? 2 : 4}. Restart your application:", :yellow
         say "   Run: rails restart"
         say "   Or: kill and restart your server process"
         say "\n"

data/lib/rails_error_dashboard/commands/assign_error.rb

@@ -29,10 +29,33 @@ module RailsErrorDashboard
         error.update!(
           assigned_to: assignee.truncate(MAX_ASSIGNEE_LENGTH, omission: ""),
           assigned_at: Time.current,
-          status: "in_progress" # Auto-transition to in_progress when assigned
+          **status_attributes(error)
         )
+        # The stat cards are cached; a reopened error must show up at once.
+        Services::AnalyticsCacheManager.clear if error.saved_change_to_resolved?
+
         { success: true, error: error }
       end
+
+      private
+
+      # Assigning means someone is working on it, so the error moves to
+      # in_progress. Doing that to a resolved error used to leave
+      # resolved: true and resolved_at behind: a row that was in_progress to
+      # the eye, resolved to the scopes, and matched by neither the unresolved
+      # nor the resolved lookup, so its next recurrence opened a new row.
+      # Assigning a resolved error reopens it. wont_fix is sticky (H-6): the
+      # assignee is recorded and the status stays.
+      def status_attributes(error)
+        return {} if error.status == "wont_fix"
+
+        attrs = { status: "in_progress" }
+        if error.resolved? || error.status == "resolved"
+          attrs[:resolved] = false
+          attrs[:resolved_at] = nil
+        end
+        attrs
+      end
     end
   end
 end

data/lib/rails_error_dashboard/commands/batch_resolve_errors.rb

@@ -44,11 +44,19 @@ module RailsErrorDashboard
           end
         end
 
-        # Dispatch plugin event for batch resolved errors
         Services::AnalyticsCacheManager.clear if resolved_count.positive?
 
+        # Dispatch plugin event for batch resolved errors
         PluginRegistry.dispatch(:on_errors_batch_resolved, resolved_errors) if resolved_errors.any?
 
+        # Each error resolved here is as resolved as one resolved on its own
+        # page: the host's error_resolved callbacks (the issue tracker closes
+        # the linked issue from one) and the instrumentation event fire per
+        # error. Only the plugin event is batch-shaped, by design.
+        resolved_errors.each do |error|
+          Services::ResolutionCallbacks.call(error, resolved_by: @resolved_by_name)
+        end
+
         {
           success: failed_ids.empty?,
           count: resolved_count,