mat_views 0.2.0 → 0.3.0

data/app/models/concerns/mat_views_i18n.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+# Copyright Codevedas Inc. 2025-present
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+#
+# MatViewsI18n
+# ------------
+# Concern that adds convenient **class-level** helpers for model I18n:
+# - Humanized attribute names
+# - Humanized enum values
+# - Select-friendly enum option arrays
+# - Placeholders and hints for forms
+#
+# These helpers rely on Rails’ standard i18n model keys using the model’s
+# `model_name.i18n_key` (e.g. `MatViews::MatViewDefinition` → `mat_views/mat_view_definition`).
+#
+# ## Expected i18n structure (examples)
+#
+# ```yml
+# en-US:
+#   activerecord:
+#     attributes:
+#       mat_views/mat_view_definition:
+#         name: "View name"
+#         sql: "SQL"
+#     enums:
+#       mat_views/mat_view_definition:
+#         refresh_strategy:
+#           regular: "Regular"
+#           concurrent: "Concurrent"
+#           swap: "Swap"
+#     placeholders:
+#       mat_views/mat_view_definition:
+#         name: "e.g. monthly_sales_mv"
+#     hints:
+#       mat_views/mat_view_definition:
+#         sql: "Use a SELECT statement; no trailing semicolon."
+# ```
+#
+# ## Usage
+# ```ruby
+# MatViews::MatViewDefinition.human_name(:name)                # => "View name"
+# MatViews::MatViewDefinition.human_enum_name(:refresh_strategy, :regular)  # => "Regular"
+# MatViews::MatViewDefinition.human_enum_options(:refresh_strategy)
+# # => [["Regular","regular"], ["Concurrent","concurrent"], ["Swap","swap"]]
+# MatViews::MatViewDefinition.placeholder_for(:name)           # => "e.g. monthly_sales_mv"
+# MatViews::MatViewDefinition.hint_for(:sql)                   # => "Use a SELECT statement..."
+# ```
+#
+# @note Methods are added as **class methods** to the including model.
+#
+# @!method self.human_name(attribute)
+#   Humanized (translated) attribute label for this model.
+#   Falls back to `attribute.to_s.humanize` when missing.
+#   @param attribute [Symbol, String]
+#   @return [String]
+#
+# @!method self.human_enum_name(enum_name, enum_value)
+#   Humanized (translated) enum value label.
+#   Falls back to `enum_value.to_s.humanize` when missing.
+#   @param enum_name [Symbol, String] the enum definition name
+#   @param enum_value [Symbol, String, Integer] the value/key of the enum
+#   @return [String]
+#
+# @!method self.human_enum_options(enum_name)
+#   Options array suitable for Rails `options_for_select`.
+#   @param enum_name [Symbol, String]
+#   @return [Array<Array(String, String)>] each item is `[label, value]`
+#
+# @!method self.placeholder_for(attribute)
+#   Form placeholder for the given attribute.
+#   Returns empty string if not defined.
+#   @param attribute [Symbol, String]
+#   @return [String]
+#
+# @!method self.hint_for(attribute)
+#   Form hint/help text for the given attribute.
+#   Returns empty string if not defined.
+#   @param attribute [Symbol, String]
+#   @return [String]
+#
+module MatViewsI18n
+  extend ActiveSupport::Concern
+
+  class_methods do
+    # @return [String]
+    def human_name(attribute)
+      I18n.t(
+        "activerecord.attributes.#{model_name.i18n_key}.#{attribute}",
+        default: attribute.to_s.humanize
+      )
+    end
+
+    # human_enum_name(:refresh_strategy, :regular) → "Regular"
+    #
+    # @param enum_name [Symbol, String]
+    # @param enum_value [Symbol, String, Integer]
+    # @return [String]
+    def human_enum_name(enum_name, enum_value)
+      key = enum_value.to_s
+      I18n.t(
+        "activerecord.enums.#{model_name.i18n_key}.#{enum_name}.#{key}",
+        default: key.humanize
+      )
+    end
+
+    # human_enum_options(:refresh_strategy)
+    # → [["Regular","regular"], ["Concurrent","concurrent"], ["Swap","swap"]]
+    #
+    # @param enum_name [Symbol, String]
+    # @return [Array<Array(String, String)>]
+    def human_enum_options(enum_name)
+      public_send(enum_name.to_s.pluralize).keys.map do |val|
+        [human_enum_name(enum_name, val), val]
+      end
+    end
+
+    # @param attribute [Symbol, String]
+    # @return [String]
+    def placeholder_for(attribute)
+      I18n.t(
+        "activerecord.placeholders.#{model_name.i18n_key}.#{attribute}",
+        default: ''
+      )
+    end
+
+    # @param attribute [Symbol, String]
+    # @return [String]
+    def hint_for(attribute)
+      I18n.t(
+        "activerecord.hints.#{model_name.i18n_key}.#{attribute}",
+        default: ''
+      )
+    end
+  end
+end

data/app/models/mat_views/application_record.rb

@@ -30,5 +30,6 @@ module MatViews
     # @return [void]
     #
     self.abstract_class = true
+    include MatViewsI18n
   end
 end

data/app/models/mat_views/mat_view_definition.rb

@@ -9,9 +9,9 @@
 # Top-level namespace for the mat_views engine.
 module MatViews
   ##
-  # Represents a **materialized view definition** managed by the engine.
+  # Represents a **materialised view definition** managed by the engine.
   #
-  # A definition stores the canonical name and SQL for a materialized view and
+  # A definition stores the canonical name and SQL for a materialised view and
   # drives lifecycle operations (create, refresh, delete) via background jobs
   # and services. It also tracks operational history through associated
   # run models.
@@ -60,8 +60,7 @@ module MatViews
 
     ##
     # @!attribute name
-    #   @return [String] PostgreSQL identifier for the materialized view.
-    #
+    # validates :name that must be present, unique, and a valid identifier.
     validates :name,
               presence: true,
               uniqueness: true,
@@ -69,11 +68,17 @@ module MatViews
 
     ##
     # @!attribute sql
-    #   @return [String] SELECT statement used to materialize the view.
-    #
+    # validates :sql that must be present and begin with SELECT.
     validates :sql,
               presence: true,
-              format: { with: /\A\s*SELECT/i, message: 'must begin with a SELECT' }
+              format: { with: /\A\s*SELECT/i, message: :invalid }
+
+    ##
+    # @!attribute unique_index_columns
+    # validates :unique_index_columns to be non-empty when using `refresh_strategy=concurrent`.
+    validates :unique_index_columns,
+              length: { minimum: 1, message: :at_least_one },
+              if: -> { refresh_strategy == 'concurrent' }
 
     # ────────────────────────────────────────────────────────────────
     # Enums / configuration

data/app/models/mat_views/mat_view_run.rb

@@ -10,9 +10,9 @@
 module MatViews
   ##
   # ActiveRecord model that tracks the lifecycle of *runs* for
-  # materialized views.
+  # materialised views.
   #
-  # Each record corresponds to a single attempt to mutate a materialized view
+  # Each record corresponds to a single attempt to mutate a materialised view
   # from a {MatViews::MatViewDefinition}, storing its status, timing, and
   # any associated error or metadata.
   #
@@ -45,25 +45,23 @@ module MatViews
     #
     # @!attribute [r] status
     #   @return [Symbol] One of:
-    #     - `:pending` — queued but not yet started
-    #     - `:running` — currently executing
-    #     - `:success` — completed successfully
-    #     - `:failed` — encountered an error
+    #     - `:running` - currently executing
+    #     - `:success` - completed successfully
+    #     - `:failed` - encountered an error
     #
     enum :status, {
-      pending: 0,
-      running: 1,
-      success: 2,
-      failed: 3
+      running: 0,
+      success: 1,
+      failed: 2
     }, prefix: :status
 
     # Operation type of the run.
     #
     # @!attribute [r] operation
     #   @return [Symbol] One of:
-    #     - `:create` — initial creation of the materialized view
-    #     - `:refresh` — refreshing an existing view
-    #     - `:drop` — dropping the materialized view
+    #     - `:create` - initial creation of the materialised view
+    #     - `:refresh` - refreshing an existing view
+    #     - `:drop` - dropping the materialised view
     enum :operation, {
       create: 0,
       refresh: 1,

data/app/views/layouts/mat_views/_footer.html.erb

@@ -0,0 +1,41 @@
+<footer class="mv-footer">
+  <div class="mv-container mv-footer-row">
+    <div>
+      <%= mv_t("footer.tagline") %><br>
+      <%= mv_t("footer.copyright", year: Time.current.year, company: MatViews::Engine.company_name) %>
+    </div>
+    <div class="mv-text-right">
+      <%= mv_link_to MatViews::Engine.rubygems_uri, tooltip: mv_t("footer.tooltip.gem_version"), testid: 'GEM_LINK' do %>
+        <strong><%= MatViews::Engine.project_name %></strong>
+        <%= mv_t("footer.version", version: MatViews::Engine.project_version) %><br>
+      <% end %>
+      <%= mv_link_to mv_t("footer.project_homepage"), MatViews::Engine.project_homepage, tooltip: mv_t("footer.tooltip.project_homepage"), testid: "PROJECT_HOMEPAGE_LINK" %>
+      <%= mv_link_to mv_t("footer.open_issue"), MatViews::Engine.bug_tracker_uri, tooltip: mv_t("footer.tooltip.open_issue"), testid: "OPEN_ISSUE_LINK" %>
+      <%= mv_link_to mv_t("footer.documentation"), MatViews::Engine.documentation_uri, tooltip: mv_t("footer.tooltip.documentation"), testid: "DOCUMENTATION_LINK" %>
+      <br/>
+      <span class="text-rose-700"><%= mv_t("footer.need_help") %></span>
+      <%= mv_link_to mv_t("footer.support"), MatViews::Engine.support_uri, tooltip: mv_t("footer.tooltip.support"), testid: "SUPPORT_LINK" %>
+    </div>
+  </div>
+</footer>
+<div class="mv-drawer-root" aria-hidden="true">
+  <div data-drawer-target="overlay" class="mv-drawer-overlay" data-action="click->drawer#close"></div>
+  <aside data-drawer-target="panel" class="mv-drawer" role="dialog" aria-modal="true">
+    <div class="mv-drawer-head" aria-label="<%= mv_t('details') %>">
+      <h2 id="mv-drawer-title">
+        <%= mv_t("details") %>
+      </h2>
+      <div class='row-item'>
+        <%= mv_drawer_action_button(mv_t("refresh"), "refresh", mv_t("refresh_contents"), "left", testid: "DRAWER_REFRESH_LINK") { mv_icon(:refresh) } %>
+        <%= mv_drawer_action_button(mv_t("close"), "close", mv_t("close_window"), "left", testid: "DRAWER_CLOSE_LINK") { mv_icon(:x_circle) } %>
+      </div>
+    </div>
+    <div class="mv-drawer-body">
+      <turbo-frame id="mv-drawer" data-drawer-target="frame">
+        <div class="mv-card">
+          <div class="mv-card-b"><%= mv_t("loading") %></div>
+        </div>
+      </turbo-frame>
+    </div>
+  </aside>
+</div>

data/app/views/layouts/mat_views/_header.html.erb

@@ -0,0 +1,25 @@
+<header class="mv-header">
+  <div class="mv-container mv-header-row">
+    <div class="row-item">
+      <%= mv_link_to admin_root_path, class: "mv-brand", underline: false, testid: 'HEADER_LINK' do %>
+        <%= image_tag "mat_views/logo.svg", alt: mv_t("title"), class: "mv-logo" %>
+        <span><%= mv_t("title") %></span>
+      <% end %>
+    </div>
+    <div class='row-item'>
+      <% if user %>
+        <span>
+          <%= mv_t("header.signed_in_as", email: user.respond_to?(:email) ? user.email : user.to_s) %>
+        </span>
+      <% end %>
+      <%= mv_drawer_link(
+            admin_preferences_path(frame_id: "mv-drawer"),
+            mv_t("settings.title"),
+            variant: :ghost,
+            tooltip: mv_t("settings.title"),
+            tooltip_placement: "bottom",
+            testid: "PREFERENCES_LINK",
+          ) { mv_icon(:gear) } %>
+    </div>
+  </div>
+</header>

data/app/views/layouts/mat_views/admin.html.erb

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html lang="<%= I18n.locale %>" dir="<%= %i(ar he fa ur).include?(I18n.locale.to_sym) ? 'rtl' : 'ltr' %>" data-theme="<%= mat_views_data_theme || 'auto' %>">
+  <head>
+    <title><%= t("mat_views.title") %><%= content_for?(:page_title) ? " | #{content_for(:page_title)}" : "" %></title>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+    <meta charset="utf-8">
+    <meta name="description" content="<%= mv_t('project_description') %>">
+    <meta name="author" content="<%= mv_t('project_author') %>">
+    <meta name="keywords" content="<%= mv_t('project_tags') %>">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="color-scheme" content="<%= mat_views_data_theme || 'auto' %>">
+    <meta http-equiv="Content-Language" content="<%= I18n.locale %>">
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link
+      href="https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&family=Space+Grotesk:wght@300..700&family=Work+Sans:ital,wght@0,100..900;1,100..900&display=swap"
+      rel="stylesheet"
+    >
+    <%= favicon_link_tag "mat_views/favicon.svg", type: "image/svg+xml" %>
+    <%= favicon_link_tag "mat_views/favicon.ico", rel: "icon", sizes: "16x16 32x32 48x48" %>
+    <%= favicon_link_tag "mat_views/favicon-16x16.png", rel: "icon", type: "image/png", sizes: "16x16" %>
+    <%= favicon_link_tag "mat_views/favicon-32x32.png", rel: "icon", type: "image/png", sizes: "32x32" %>
+    <%= favicon_link_tag "mat_views/favicon-48x48.png", rel: "icon", type: "image/png", sizes: "48x48" %>
+    <%= favicon_link_tag "mat_views/apple-touch-icon.png", rel: "apple-touch-icon" %>
+    <%= favicon_link_tag "mat_views/mask-icon.svg", rel: "mask-icon", color: "#0F172A" %>
+    <%= favicon_link_tag "mat_views/android-chrome-192x192.png", rel: "icon", type: "image/png", sizes: "192x192" %>
+    <%= favicon_link_tag "mat_views/android-chrome-512x512.png", rel: "icon", type: "image/png", sizes: "512x512" %>
+    <%= tag.meta name: "theme-color", content: "#0F172A" %>
+    <%= stylesheet_link_tag "mat_views/application.css", media: "all", "data-turbo-track": "reload" %>
+    <%= javascript_importmap_tags "mat_views/application", importmap: MatViews.importmap %>
+
+    <%= javascript_tag do %>
+      window.MatViewsRoutes = { definitionsPath: "<%= admin_mat_view_definitions_path %>", runsPath: "<%= admin_runs_path %>", preferencesPath: "<%= admin_preferences_path %>" }
+    <% end %>
+  </head>
+  <body class="mv-shell" data-controller="turbo-frame-lifecycle drawer timezone mv-confirm">
+    <%= render "layouts/mat_views/header" %>
+    <main class="mv-main">
+      <div class="mv-container">
+        <%= render "mat_views/admin/ui/flash" %>
+        <%= yield %>
+      </div>
+    </main>
+    <%= render "layouts/mat_views/footer" %>
+  </body>
+</html>

data/app/views/layouts/mat_views/turbo_frame.html.erb

@@ -0,0 +1,3 @@
+<turbo-frame id="<%= @frame_id %>" class="mv-frame">
+  <%= yield %>
+</turbo-frame>

data/app/views/mat_views/admin/dashboard/index.html.erb

@@ -0,0 +1,33 @@
+<h1><%= t("mat_views.dashboard.title") %></h1>
+<div class="mv-card" style="margin-bottom:12px;">
+  <div class="mv-card-h"><%= t("mat_views.dashboard.metrics.title") %></div>
+  <div class="mv-card-b">
+    <div class="mv-flash mv-flash--ok">
+      <%= @metrics_note %>
+    </div>
+  </div>
+</div>
+<div data-controller="tabs">
+  <nav class="mv-tabs" style="margin-bottom:1rem;">
+    <%= mv_tab_link 'definitions', selected: true, testid: 'DEFINITIONS_TAB_LINK' do %>
+      <%= t("mat_views.definitions") %>
+    <% end %>
+    <%= mv_tab_link 'runs', selected: false, testid: 'RUNS_TAB_LINK' do %>
+      <%= t("mat_views.runs") %>
+    <% end %>
+  </nav>
+  <div data-tabs-target="panel" data-name="definitions">
+    <turbo-frame id="dash-definitions" data-src="<%= admin_mat_view_definitions_path(frame_id: 'dash-definitions') %>" data-turbo-temporary>
+      <div class="mv-card">
+        <div class="mv-card-b"><%= t("mat_views.loading_definitions") %></div>
+      </div>
+    </turbo-frame>
+  </div>
+  <div data-tabs-target="panel" data-name="runs" hidden>
+    <turbo-frame id="dash-runs" data-src="<%= admin_runs_path(frame_id: 'dash-runs') %>" data-turbo-temporary>
+      <div class="mv-card">
+        <div class="mv-card-b"><%= t("mat_views.loading_runs") %></div>
+      </div>
+    </turbo-frame>
+  </div>
+</div>

data/app/views/mat_views/admin/mat_view_definitions/_definition_actions.html.erb

@@ -0,0 +1,94 @@
+<div class="mv-actions">
+  <!-- GROUP: Definition -->
+  <div class="mv-action-group">
+    <div class="mv-action-title"><%= mv_icon(:layers) %>
+      <%= mv_t("definition") %></div>
+    <div class="mv-buttons">
+      <%= mv_button_link admin_root_path(tab: 'runs', mat_view_definition_id: defn.id),
+                         variant: :ghost,
+                         testid: 'VIEW_HISTORY_LINK',
+                         testid_identifier: "defn-#{defn.id}",
+                         data: { turbo: false, turbo_frame: "_top" } do %>
+        <%= mv_icon(:history) %>
+        <%= mv_t("history") %>
+      <% end %>
+      <%= mv_drawer_link(edit_admin_mat_view_definition_path(defn, frame_id: 'mv-drawer'),
+                         mv_t("edit_var", name: defn.name),
+                         testid: 'EDIT_LINK',
+                         testid_identifier: "defn-#{defn.id}",
+                         tooltip: mv_t("mat_view_definition.edit_tooltip")) do %>
+        <%= mv_icon(:edit) %>
+        <%= mv_t("edit") %>
+      <% end %>
+      <%= mv_button_to admin_mat_view_definition_path(defn, frame_id: frame_id, frame_action: 'close-and-refresh'),
+                       method: :delete,
+                       variant: :negative,
+                       testid: 'DELETE_LINK',
+                       testid_identifier: "defn-#{defn.id}",
+                       tooltip: mv_t("mat_view_definition.delete_tooltip"), tooltip_placement: "bottom",
+                       confirm: mv_t("mat_view_definition.delete_confirm", name: defn.name) do %>
+        <%= mv_icon(:trash) %>
+        <%= mv_t("delete") %>
+      <% end %>
+    </div>
+  </div>
+  <!-- GROUP: Materialized View -->
+  <div class="mv-action-group">
+    <div class="mv-action-title">
+      <%= mv_icon(:database) %>
+      <%= mv_t("mat_view_definition.materialized_view") %>
+      <% if mv_exists %>
+        <span class="mv-status-icon" data-controller="tooltip" data-tooltip-text-value="<%= mv_t("mat_view_definition.materialized_view_exists") %>">
+          <%= mv_icon(:check_circle, class_name: "mv-status-ok") %>
+        </span>
+      <% else %>
+        <span class="mv-status-icon" data-controller="tooltip" data-tooltip-text-value="<%= mv_t("mat_view_definition.materialized_view_not_exists") %>">
+          <%= mv_icon(:x_circle, class_name: "mv-status-missing") %>
+        </span>
+      <% end %>
+    </div>
+    <div class="mv-buttons">
+      <% if mv_exists %>
+        <%= mv_button_to refresh_admin_mat_view_definition_path(defn, frame_id: frame_id),
+                         variant: :primary,
+                         method: :post,
+                         testid: 'REFRESH_LINK',
+                         testid_identifier: "defn-#{defn.id}",
+                         tooltip: mv_t("mat_view_definition.refresh_tooltip") do %>
+          <%= mv_icon(:refresh) %>
+          <%= mv_t("refresh") %>
+        <% end %>
+        <%= mv_button_to delete_now_admin_mat_view_definition_path(defn, frame_id: frame_id),
+                         method: :post,
+                         variant: :negative,
+                         testid: 'DROP_LINK',
+                         testid_identifier: "defn-#{defn.id}",
+                         tooltip: mv_t("mat_view_definition.drop_mv_tooltip"), tooltip_placement: "bottom",
+                         confirm: mv_t("mat_view_definition.drop_mv_confirm", name: defn.name) do %>
+          <%= mv_icon(:x_circle) %>
+          <%= mv_t("mat_view_definition.drop_mv") %>
+        <% end %>
+        <%= mv_button_to delete_now_admin_mat_view_definition_path(defn, frame_id: frame_id, cascade: true),
+                         method: :post,
+                         variant: :negative,
+                         testid: 'DROP_CASCADE_LINK',
+                         testid_identifier: "defn-#{defn.id}",
+                         tooltip: mv_t("mat_view_definition.drop_mv_cascade_tooltip"), tooltip_placement: "bottom",
+                         confirm: mv_t("mat_view_definition.drop_mv_cascade_confirm", name: defn.name) do %>
+          <%= mv_icon(:x_circle) %>
+          <%= mv_t("mat_view_definition.drop_mv_cascade") %>
+        <% end %>
+      <% else %>
+        <%= mv_button_to create_now_admin_mat_view_definition_path(defn, frame_id: frame_id),
+                         method: :post,
+                         variant: :secondary,
+                         testid: 'CREATE_MV_LINK',
+                         testid_identifier: "defn-#{defn.id}",
+                         tooltip: mv_t("mat_view_definition.create_mv_tooltip"), tooltip_placement: "bottom" do %>
+          <%= mv_icon(:hammer) %>
+          <%= mv_t("mat_view_definition.create_mv") %>
+        <% end %>
+      <% end %>
+    </div>
+  </div>
+</div>

data/app/views/mat_views/admin/mat_view_definitions/_table.html.erb

@@ -0,0 +1,48 @@
+<% humanize_attr = ->(attr) { MatViews::MatViewDefinition.human_attribute_name(attr) } %>
+<% humanize_enum_attr = ->(col, val) { MatViews::MatViewDefinition.human_enum_name(col, val) } %>
+<table class="mv-table">
+  <colgroup>
+    <col class="col-name">
+    <col class="col-strategy">
+    <col class="col-schedule">
+    <col class="col-refreshed">
+    <col class="col-actions">
+  </colgroup>
+  <thead>
+    <tr class="mv-tr">
+      <th class="mv-th"><%= humanize_attr.call(:name) %></th>
+      <th class="mv-th"><%= humanize_attr.call(:refresh_strategy) %></th>
+      <th class="mv-th"><%= humanize_attr.call(:schedule_cron) %></th>
+      <th class="mv-th"><%= humanize_attr.call(:last_run) %></th>
+      <th class="mv-th" style="text-align:right;"><%= mv_t("actions") %></th>
+    </tr>
+  </thead>
+  <tbody>
+    <% if definitions.any? %>
+      <% definitions.each do |defn| %>
+        <tr class="mv-tr">
+          <td class="mv-td">
+            <%= mv_drawer_link(admin_mat_view_definition_path(defn, frame_id: 'mv-drawer'), mv_t("view_var", name: defn.name),
+                             variant: :ghost,
+                             testid: 'VIEW_LINK',
+                             testid_identifier: "defn-#{defn.id}",
+                             underline: true,
+                             tooltip: mv_t("mat_view_definition.view_tooltip")) do %>
+              <%= defn.name %>
+            <% end %>
+          </td>
+          <td class="mv-td"><%= humanize_enum_attr.call(:refresh_strategy, defn.refresh_strategy) %></td>
+          <td class="mv-td"><%= defn.schedule_cron.presence || "-" %></td>
+          <td class="mv-td"><%= defn.last_run ? l(defn.last_run.started_at.in_time_zone, format: :datetime12hour) : "-" %></td>
+          <td class="mv-td mv-td-actions">
+            <%= render "definition_actions", defn: defn, mv_exists: mv_exists_map[defn], frame_id: "dash-definitions" %>
+          </td>
+        </tr>
+      <% end %>
+    <% else %>
+      <tr class="mv-tr">
+        <td class="mv-td" colspan="5"><%= mv_t("mat_view_definition.no_definitions") %></td>
+      </tr>
+    <% end %>
+  </tbody>
+</table>

data/app/views/mat_views/admin/mat_view_definitions/empty.html.erb

@@ -0,0 +1 @@
+<h1><%= mv_t("reloading") %></h1>

data/app/views/mat_views/admin/mat_view_definitions/form.html.erb

@@ -0,0 +1,79 @@
+<% action = @definition.new_record? ? admin_mat_view_definitions_path(frame_id: "mv-drawer") : admin_mat_view_definition_path(@definition, frame_id: "mv-drawer") %>
+<% method = @definition.new_record? ? :post : :patch %>
+
+<input
+  type="hidden"
+  id="mv-drawer-title-text"
+  value="<%= @definition.new_record? ? mv_t('mat_view_definition.new_definition') : mv_t("edit_var", name: @definition.name) %>"
+/>
+
+<input type="hidden" id="mv-drawer-open-url-identifier" value="definitions_<%= @definition.new_record? ? 'new' : "edit_#{@definition.id}" %>"/>
+
+<%= form_with model: @definition, url: action, method: method, class: "mv-form" do |f| %>
+  <% if @definition.errors.any? %>
+    <div class="mv-flash mv-flash--err">
+      <strong><%= t("mat_views.errors.prevented_saving", count: @definition.errors.count) %></strong>
+      <ul style="margin:.25rem 1rem;">
+        <% @definition.errors.full_messages.each do |msg| %>
+          <li><%= msg %></li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+
+  <div class="mv-field">
+    <%= f.label :name, class: "mv-label" %>
+    <%= f.text_field :name, class: "mv-input", required: true, placeholder: MatViews::MatViewDefinition.placeholder_for(:name) %>
+    <%= content_tag :small, MatViews::MatViewDefinition.hint_for(:name), class: "mv-hint" %>
+
+  </div>
+
+  <div class="mv-field">
+    <%= f.label :sql, class: "mv-label" %>
+    <%= f.text_area :sql, class: "mv-textarea", placeholder: MatViews::MatViewDefinition.placeholder_for(:sql), required: true %>
+    <%= content_tag :small, MatViews::MatViewDefinition.hint_for(:sql), class: "mv-hint" %>
+  </div>
+
+  <div class="mv-field">
+    <%= f.label :refresh_strategy, class: "mv-label" %>
+    <%= f.select :refresh_strategy,
+             options_for_select(MatViews::MatViewDefinition.human_enum_options(:refresh_strategy), @definition.refresh_strategy),
+             {},
+             class: "mv-select" %>
+    <%= content_tag :small, MatViews::MatViewDefinition.hint_for(:refresh_strategy), class: "mv-hint" %>
+  </div>
+
+  <div class="mv-field">
+    <%= f.label :schedule_cron, class: "mv-label" %>
+    <%= f.text_field :schedule_cron, class: "mv-input", placeholder: MatViews::MatViewDefinition.placeholder_for(:schedule_cron) %>
+    <%= content_tag :small, MatViews::MatViewDefinition.hint_for(:schedule_cron), class: "mv-hint" %>
+  </div>
+
+  <div class="mv-field">
+    <%= f.label :unique_index_columns, class: "mv-label" %>
+    <% current_uic = Array(@definition.unique_index_columns).join(", ") %>
+    <%= f.text_field :unique_index_columns, value: current_uic, class: "mv-input", placeholder: MatViews::MatViewDefinition.placeholder_for(:unique_index_columns) %>
+    <%= content_tag :small, MatViews::MatViewDefinition.hint_for(:unique_index_columns), class: "mv-hint" %>
+  </div>
+
+  <div class="mv-field">
+    <%= f.label :dependencies, class: "mv-label" %>
+    <% current_dep = Array(@definition.dependencies).join(", ") %>
+    <%= f.text_field :dependencies, value: current_dep, class: "mv-input", placeholder: MatViews::MatViewDefinition.placeholder_for(:dependencies) %>
+    <%= content_tag :small, MatViews::MatViewDefinition.hint_for(:dependencies), class: "mv-hint" %>
+  </div>
+
+  <div style="display:flex;gap:.5rem;margin-top:.75rem;">
+    <%= mv_submit_button class: "mv-btn mv-btn--primary",
+                             testid: 'SUBMIT_BUTTON',
+                             testid_identifier: "defn-#{@definition.id || 'new'}" do %>
+      <%= @definition.new_record? ? t("mat_views.create") : t("mat_views.save_changes") %>
+    <% end %>
+
+    <%= mv_cancel_button variant: :ghost, data: { action: "click->drawer#close" },
+                             testid: 'CANCEL_BUTTON',
+                             testid_identifier: "defn-#{@definition.id || 'new'}"  do %>
+      <%= mv_t("cancel") %>
+    <% end %>
+  </div>
+<% end %>

data/app/views/mat_views/admin/mat_view_definitions/index.html.erb

@@ -0,0 +1,10 @@
+<div class="mv-toolbar start">
+  <%= mv_drawer_link(new_admin_mat_view_definition_path(frame_id: 'mv-drawer'), mv_t("mat_view_definition.new_definition"),
+                     variant: :primary,
+                     testid: 'NEW_DEFINITION_LINK',
+                     tooltip: mv_t("mat_view_definition.new_definition_tooltip")) do %>
+    <%= mv_icon(:plus_circle) %>
+    <%= mv_t("mat_view_definition.new_definition") %>
+  <% end %>
+</div>
+<%= render "table", definitions: @definitions, mv_exists_map: @mv_exists_map %>