smriti 0.5.0

data/app/models/smriti/mat_view_run.rb

@@ -0,0 +1,275 @@
+# 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.
+
+##
+# Top-level namespace for the smriti engine.
+module Smriti
+  ##
+  # ActiveRecord model that tracks the lifecycle of *runs* for
+  # materialised views.
+  #
+  # Each record corresponds to a single attempt to mutate a materialised view
+  # from a {Smriti::MatViewDefinition}, storing its status, timing, and
+  # any associated error or metadata.
+  #
+  # This model provides an auditable history of view provisioning across
+  # environments, useful for telemetry, dashboards, and debugging.
+  #
+  # @see Smriti::MatViewDefinition
+  # @see Smriti::CreateViewJob
+  #
+  # @example Query recent successful runs
+  #   Smriti::MatViewRun.status_success.order(created_at: :desc).limit(10)
+  #
+  # @example Check if a definition has any failed runs
+  #   definition.mat_view_runs.status_failed.any?
+  #
+  class MatViewRun < ApplicationRecord
+    ##
+    # Underlying database table name.
+    self.table_name = 'mat_view_runs'
+
+    ##
+    # The definition this run belongs to.
+    #
+    # @return [Smriti::MatViewDefinition]
+    #
+    belongs_to :mat_view_definition, class_name: 'Smriti::MatViewDefinition'
+
+    ##
+    # Status of the create run.
+    #
+    # @!attribute [r] status
+    #   @return [Symbol] One of:
+    #     - `:running` - currently executing
+    #     - `:success` - completed successfully
+    #     - `:failed` - encountered an error
+    #
+    enum :status, {
+      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 materialised view
+    #     - `:refresh` - refreshing an existing view
+    #     - `:drop` - dropping the materialised view
+    enum :operation, {
+      create: 0,
+      refresh: 1,
+      drop: 2
+    }, prefix: :operation
+
+    ##
+    # Validations
+    #
+    # Ensures that a status is always present.
+    validates :status, presence: true
+
+    # ───────────────────────────────────────────────────────────────
+    # Scopes for runs, ordering, searching, filtering
+    # ───────────────────────────────────────────────────────────────
+
+    ##
+    # Scope create runs
+    # All runs with `operation: :create`.
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :create_runs, -> { where(operation: :create) }
+
+    ##
+    # Scope refresh runs
+    # All runs with `operation: :refresh`.
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :refresh_runs, -> { where(operation: :refresh) }
+
+    ##
+    # Scope drop runs
+    # All runs with `operation: :drop`.
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :drop_runs,    -> { where(operation: :drop) }
+
+    ##
+    # Scope ordered by operation
+    # Orders by the `operation` attribute using humanized enum labels.
+    #
+    # @param dir [Symbol, String] `:asc` or `:desc`
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :ordered_by_operation, ->(dir) { ordered_by_enum(enum_values: operations, enum_name: :operation, direction: dir) }
+
+    ##
+    # Scope ordered by definition name
+    # Orders by the associated definition's `name` attribute.
+    #
+    # @param dir [Symbol, String] `:asc` or `:desc`
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :ordered_by_definition, ->(dir) { left_joins(:mat_view_definition).order("mat_view_definitions.name #{dir.to_s.upcase}") }
+
+    ##
+    # Scope ordered by started_at
+    # Orders by the `started_at` attribute.
+    #
+    # @param dir [Symbol, String] `:asc` or `:desc`
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :ordered_by_started_at, ->(dir) { order("started_at #{dir.to_s.upcase}") }
+
+    ##
+    # Scope ordered by the 'status' attribute using humanized enum labels.
+    #
+    # @param dir [Symbol, String] `:asc` or `:desc`
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :ordered_by_status, ->(dir) { ordered_by_enum(enum_values: statuses, enum_name: :status, direction: dir) }
+
+    ##
+    # Scope ordered by duration_ms
+    # Orders by the `duration_ms` attribute.
+    #
+    # @param dir [Symbol, String] `:asc` or `:desc`
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :ordered_by_duration_ms, ->(dir) { order("duration_ms #{dir.to_s.upcase}") }
+
+    ##
+    # Scope search by operation
+    # Searches the `operation` attribute using humanized enum labels.
+    #
+    # @param term [String] search term
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :search_by_operation, ->(term) { search_by_enum(enum_values: operations, enum_name: :operation, term: term) }
+
+    ##
+    # Scope search by definition name
+    # Searches by the associated definition's `name` attribute using ILIKE.
+    #
+    # @param term [String] search term
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :search_by_definition, lambda { |term|
+      where(<<~SQL, like: "%#{term}%")
+        EXISTS (
+          SELECT 1
+          FROM mat_view_definitions d
+          WHERE d.id = mat_view_runs.mat_view_definition_id
+            AND d.name ILIKE :like
+        )
+      SQL
+    }
+
+    ##
+    # Scope search by status
+    # Searches the `status` attribute using humanized enum labels.
+    #
+    # @param term [String] search term
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :search_by_status, ->(term) { search_by_enum(enum_values: statuses, enum_name: :status, term: term) }
+
+    # Scope search by duration_ms
+    # Searches the `duration_ms` attribute by casting to text and using ILIKE.
+    # Also supports searching with localized "X milliseconds" format.
+    #
+    # @param term [String] search term
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :search_by_duration_ms, lambda { |term|
+      term_with_ms = I18n.t('smriti.x_miliseconds', count: term)
+      where('CAST(duration_ms AS TEXT) ILIKE ?', "%#{term}%")
+        .or(where('CAST(duration_ms AS TEXT) ILIKE ?', "%#{term_with_ms}%"))
+    }
+
+    ##
+    # Scope filter by operation
+    # Filters by the `operation` attribute.
+    #
+    # @param operation [String, Symbol] operation value
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :filtered_by_operation, ->(operation) { where(operation:) }
+
+    ##
+    # Scope filter by definition
+    # Filters by the associated definition's ID.
+    #
+    # @param definition_id [Integer] definition ID
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :filtered_by_definition, lambda { |definition_id|
+      where(mat_view_definition_id: definition_id)
+    }
+
+    ##
+    # Scope filter by status
+    # Filters by the `status` attribute.
+    #
+    # @param status [String, Symbol] status value
+    # @return [ActiveRecord::Relation<Smriti::MatViewRun>]
+    scope :filtered_by_status, ->(status) { where(status:) }
+
+    # ──────────────────────────────────────────────────────────────
+    # Class methods
+    # ──────────────────────────────────────────────────────────────
+
+    class << self
+      # Options for filtering by operation
+      #
+      # @return [Array<Array(String, String)>] array of `[label, value]` pairs
+      def filter_options_for_operation
+        order(:operation).distinct.pluck(:operation).compact.map { |operation| [human_enum_name(:operation, operation), operation] }
+      end
+
+      # Options for filtering by definition
+      #
+      # @return [Array<Array(String, Integer)>] array of `[name, id]` pairs
+      def filter_options_for_definition
+        Smriti::MatViewDefinition.order(:name).pluck(:name, :id)
+      end
+
+      # Options for filtering by status
+      #
+      # @return [Array<Array(String, String)>] array of `[label, value]` pairs
+      def filter_options_for_status
+        order(:status).distinct.pluck(:status).compact.map { |status| [human_enum_name(:status, status), status] }
+      end
+    end
+
+    # ──────────────────────────────────────────────────────────────
+    # Instance methods
+    # ──────────────────────────────────────────────────────────────
+
+    ##
+    # Metadata associated with the run.
+    #
+    # This is a JSONB column storing arbitrary structured data about the run,
+    # such as database responses, row counts, etc.
+    #
+    # @return [Hash] Parsed JSON metadata.
+    def meta
+      self[:meta] || {}
+    end
+
+    ##
+    # Error message if the run failed.
+    #
+    # Extracted from `meta['error']['message']` if present.
+    #
+    # @return [String, nil] Error message or `nil` if none.
+    def error_message
+      meta.dig('error', 'message')
+    end
+
+    ##
+
+    # row count before the operation, if applicable
+    # @return [Integer, nil]
+    def row_count_before
+      meta.dig('response', 'row_count_before')
+    end
+
+    # row count after the operation, if applicable
+    # @return [Integer, nil]
+    def row_count_after
+      meta.dig('response', 'row_count_after')
+    end
+  end
+end

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

@@ -0,0 +1,47 @@
+<footer class="mv-footer">
+  <div class="mv-container mv-footer-row">
+    <div>
+      <%= t("smriti.footer.tagline") %><br>
+      <%= t("smriti.footer.copyright", year: Time.current.year, company: Smriti::Engine.company_name) %>
+    </div>
+    <div class="mv-text-right">
+      <%= mv_link_to Smriti::Engine.rubygems_uri, tooltip: t("smriti.footer.tooltip.gem_version"), testid: 'GEM_LINK' do %>
+        <strong><%= Smriti::Engine.project_name %></strong>
+        <%= t("smriti.footer.version", version: Smriti::Engine.project_version) %><br>
+      <% end %>
+      <%= mv_link_to t("smriti.footer.project_homepage"),
+      Smriti::Engine.project_homepage,
+      tooltip: t("smriti.footer.tooltip.project_homepage"),
+      testid: "PROJECT_HOMEPAGE_LINK" %>
+      <%= mv_link_to t("smriti.footer.open_issue"), Smriti::Engine.bug_tracker_uri, tooltip: t("smriti.footer.tooltip.open_issue"), testid: "OPEN_ISSUE_LINK" %>
+      <%= mv_link_to t("smriti.footer.documentation"),
+      Smriti::Engine.documentation_uri,
+      tooltip: t("smriti.footer.tooltip.documentation"),
+      testid: "DOCUMENTATION_LINK" %>
+      <br/>
+      <span class="text-rose-700"><%= t("smriti.footer.need_help") %></span>
+      <%= mv_link_to t("smriti.footer.support"), Smriti::Engine.support_uri, tooltip: t("smriti.footer.tooltip.support"), testid: "SUPPORT_LINK" %>
+    </div>
+  </div>
+</footer>
+<div class="mv-drawer-root" aria-hidden="true" data-drawer-target="root">
+  <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="<%= t('smriti.details') %>" data-drawer-target="header">
+      <h2 id="mv-drawer-title" data-drawer-target="title">
+        <%= t("smriti.details") %>
+      </h2>
+      <div class='row-item'>
+        <%= mv_drawer_action_button(t("smriti.refresh"), "refresh", t("smriti.refresh_contents"), "left", testid: "DRAWER_REFRESH_LINK") { mv_icon(:refresh) } %>
+        <%= mv_drawer_action_button(t("smriti.close"), "close", t("smriti.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" data-turbo-frame-lifecycle-target="frame">
+        <div class="mv-card">
+          <div class="mv-card-b"><%= t("smriti.loading") %></div>
+        </div>
+      </turbo-frame>
+    </div>
+  </aside>
+</div>

data/app/views/layouts/smriti/_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 "smriti/logo.svg", alt: t("smriti.title"), class: "mv-logo" %>
+        <span><%= t("smriti.title") %></span>
+      <% end %>
+    </div>
+    <div class='row-item'>
+      <% if user %>
+        <span>
+          <%= t("smriti.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"),
+        t("smriti.settings.title"),
+        variant: :ghost,
+        tooltip: t("smriti.settings.title"),
+        tooltip_placement: "bottom",
+        testid: "PREFERENCES_LINK",
+      ) { mv_icon(:gear) } %>
+    </div>
+  </div>
+</header>

data/app/views/layouts/smriti/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="<%= smriti_data_theme || 'auto' %>">
+  <head>
+    <title><%= t("smriti.title") %><%= content_for?(:page_title) ? " | #{content_for(:page_title)}" : "" %></title>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+    <meta charset="utf-8">
+    <meta name="description" content="<%= t('smriti.project_description') %>">
+    <meta name="author" content="<%= t('smriti.project_author') %>">
+    <meta name="keywords" content="<%= t('smriti.project_tags') %>">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="color-scheme" content="<%= %w[light dark].include?(smriti_data_theme) ? smriti_data_theme : 'light dark' %>">
+    <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 "smriti/favicon.svg", type: "image/svg+xml" %>
+    <%= favicon_link_tag "smriti/favicon.ico", rel: "icon", sizes: "16x16 32x32 48x48" %>
+    <%= favicon_link_tag "smriti/favicon-16x16.png", rel: "icon", type: "image/png", sizes: "16x16" %>
+    <%= favicon_link_tag "smriti/favicon-32x32.png", rel: "icon", type: "image/png", sizes: "32x32" %>
+    <%= favicon_link_tag "smriti/favicon-48x48.png", rel: "icon", type: "image/png", sizes: "48x48" %>
+    <%= favicon_link_tag "smriti/apple-touch-icon.png", rel: "apple-touch-icon" %>
+    <%= favicon_link_tag "smriti/mask-icon.svg", rel: "mask-icon", color: "#0F172A" %>
+    <%= favicon_link_tag "smriti/android-chrome-192x192.png", rel: "icon", type: "image/png", sizes: "192x192" %>
+    <%= favicon_link_tag "smriti/android-chrome-512x512.png", rel: "icon", type: "image/png", sizes: "512x512" %>
+    <%= tag.meta name: "theme-color", content: "#0F172A" %>
+    <%= stylesheet_link_tag "smriti/application.css", media: "all", "data-turbo-track": "reload" %>
+    <%= javascript_importmap_tags "smriti/application", importmap: Smriti.importmap %>
+
+    <%= javascript_tag do %>
+      window.SmritiRoutes = { definitionsPath: "<%= admin_mat_view_definitions_path %>", runsPath: "<%= admin_mat_view_runs_path %>", preferencesPath: "<%= admin_preferences_path %>" }
+    <% end %>
+  </head>
+  <body class="mv-shell" data-controller="body-setup turbo-frame-lifecycle drawer mv-confirm" data-drawer-open-class="is-open">
+    <%= render "layouts/smriti/header" %>
+    <main class="mv-main">
+      <div class="mv-container">
+        <%= render "smriti/admin/ui/flash" %>
+        <%= yield %>
+      </div>
+    </main>
+    <%= render "layouts/smriti/footer" %>
+  </body>
+</html>

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

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

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

@@ -0,0 +1,38 @@
+<h1><%= t("smriti.dashboard.title") %></h1>
+<div class="mv-card" style="margin-bottom:12px;">
+  <div class="mv-card-h"><%= t("smriti.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" data-tabs-active-link-class="mv-tab--on" data-tabs-default-tab-value="definitions">
+  <nav class="mv-tabs" style="margin-bottom:1rem;">
+    <%= mv_tab_link 'definitions', selected: true, testid: 'DEFINITIONS_TAB_LINK' do %>
+      <%= t("smriti.definitions") %>
+    <% end %>
+    <%= mv_tab_link 'runs', selected: false, testid: 'RUNS_TAB_LINK' do %>
+      <%= t("smriti.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-frame-lifecycle-target="frame"
+      data-turbo-temporary
+    >
+      <div class="mv-card">
+        <div class="mv-card-b"><%= t("smriti.loading_definitions") %></div>
+      </div>
+    </turbo-frame>
+  </div>
+  <div data-tabs-target="panel" data-name="runs" hidden>
+    <turbo-frame id="dash-runs" data-src="<%= admin_mat_view_runs_path(frame_id: 'dash-runs') %>" data-turbo-frame-lifecycle-target="frame" data-turbo-temporary>
+      <div class="mv-card">
+        <div class="mv-card-b"><%= t("smriti.loading_runs") %></div>
+      </div>
+    </turbo-frame>
+  </div>
+</div>

data/app/views/smriti/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) %>
+      <%= t("smriti.definition") %></div>
+    <div class="mv-buttons">
+      <%= mv_button_link admin_root_path(tab: 'runs', dtfilter: "definition:#{defn.id}"),
+                         variant: :ghost,
+                         testid: 'VIEW_HISTORY_LINK',
+                         testid_identifier: "defn-#{defn.id}",
+                         data: { turbo: false, turbo_frame: "_top" } do %>
+        <%= mv_icon(:history) %>
+        <%= t("smriti.history") %>
+      <% end %>
+      <%= mv_drawer_link(edit_admin_mat_view_definition_path(defn, frame_id: 'mv-drawer'),
+                         t("smriti.edit_var", name: defn.name),
+                         testid: 'EDIT_LINK',
+                         testid_identifier: "defn-#{defn.id}",
+                         tooltip: t("smriti.mat_view_definition.edit_tooltip")) do %>
+        <%= mv_icon(:edit) %>
+        <%= t("smriti.edit") %>
+      <% end %>
+      <%= mv_button_to admin_mat_view_definition_path(defn, frame_id: frame_id),
+                       method: :delete,
+                       variant: :negative,
+                       testid: 'DELETE_LINK',
+                       testid_identifier: "defn-#{defn.id}",
+                       tooltip: t("smriti.mat_view_definition.delete_tooltip"), tooltip_placement: "bottom",
+                       confirm: t("smriti.mat_view_definition.delete_confirm", name: defn.name) do %>
+        <%= mv_icon(:trash) %>
+        <%= t("smriti.delete") %>
+      <% end %>
+    </div>
+  </div>
+  <!-- GROUP: Materialized View -->
+  <div class="mv-action-group">
+    <div class="mv-action-title">
+      <%= mv_icon(:database) %>
+      <%= t("smriti.mat_view_definition.materialized_view") %>
+      <% if mv_exists %>
+        <span class="mv-status-icon" data-controller="tooltip" data-tooltip-text-value="<%= t("smriti.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="<%= t("smriti.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: t("smriti.mat_view_definition.refresh_tooltip") do %>
+          <%= mv_icon(:refresh) %>
+          <%= t("smriti.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: t("smriti.mat_view_definition.drop_mv_tooltip"), tooltip_placement: "bottom",
+                         confirm: t("smriti.mat_view_definition.drop_mv_confirm", name: defn.name) do %>
+          <%= mv_icon(:x_circle) %>
+          <%= t("smriti.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: t("smriti.mat_view_definition.drop_mv_cascade_tooltip"), tooltip_placement: "bottom",
+                         confirm: t("smriti.mat_view_definition.drop_mv_cascade_confirm", name: defn.name) do %>
+          <%= mv_icon(:x_circle) %>
+          <%= t("smriti.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: t("smriti.mat_view_definition.create_mv_tooltip"), tooltip_placement: "bottom" do %>
+          <%= mv_icon(:hammer) %>
+          <%= t("smriti.mat_view_definition.create_mv") %>
+        <% end %>
+      <% end %>
+    </div>
+  </div>
+</div>

data/app/views/smriti/admin/mat_view_definitions/_dt-index-empty-row.html.erb

@@ -0,0 +1,11 @@
+<tr class="mv-tr">
+  <td class="mv-td" colspan="<%= dt_config[:columns].size %>">
+    <div class="mv-cell">
+      <% if params[:dtfilter] || params[:dtsearch] %>
+        <%= t("smriti.mat_view_definition.no_definitions_if_filtered") %>
+      <% else %>
+        <%= t("smriti.mat_view_definition.no_definitions") %>
+      <% end %>
+    </div>
+  </td>
+</tr>

data/app/views/smriti/admin/mat_view_definitions/_dt-index-row.html.erb

@@ -0,0 +1,27 @@
+<% dt_humanize_ref = dt_config[:dt_humanize_ref]
+dt_humanize_ref_klass = dt_humanize_ref.constantize
+humanize_attr = ->(attr) { dt_humanize_ref_klass.human_attribute_name(attr) }
+humanize_enum_attr = ->(col, val) { dt_humanize_ref_klass.human_enum_name(col, val) }
+mv_exists_map ||= {} %>
+<tr class="mv-tr">
+  <td class="mv-td">
+    <div class="mv-cell">
+      <%= mv_drawer_link(admin_mat_view_definition_path(row_value, frame_id: 'mv-drawer'), t("smriti.view_var", name: row_value.name),
+                       variant: :ghost,
+                       testid: 'VIEW_LINK',
+                       testid_identifier: "defn-#{row_value.id}",
+                       underline: true,
+                       tooltip: t("smriti.mat_view_definition.view_tooltip")) do %>
+        <%= row_value.name %>
+      <% end %>
+    </div>
+  </td>
+  <td class="mv-td"><div class="mv-cell"><%= humanize_enum_attr.call(:refresh_strategy, row_value.refresh_strategy) %></div></td>
+  <td class="mv-td"><div class="mv-cell"><%= row_value.schedule_cron.presence || "-" %></div></td>
+  <td class="mv-td"><div class="mv-cell"><%= row_value.last_run ? l_with_digits(row_value.last_run.started_at.in_time_zone, format: :datetime12hour) : "-" %></div></td>
+  <td class="mv-td mv-td-actions">
+    <div class="mv-cell">
+      <%= render "definition_actions", defn: row_value, mv_exists: mv_exists_map[row_value.name], frame_id: "dash-definitions" %>
+    </div>
+  </td>
+</tr>

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

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

data/app/views/smriti/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? ? t('smriti.mat_view_definition.new_definition') : t("smriti.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("smriti.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: Smriti::MatViewDefinition.placeholder_for(:name) %>
+    <%= content_tag :small, Smriti::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: Smriti::MatViewDefinition.placeholder_for(:sql), required: true %>
+    <%= content_tag :small, Smriti::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(Smriti::MatViewDefinition.human_enum_options(:refresh_strategy), @definition.refresh_strategy),
+             {},
+             class: "mv-select" %>
+    <%= content_tag :small, Smriti::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: Smriti::MatViewDefinition.placeholder_for(:schedule_cron) %>
+    <%= content_tag :small, Smriti::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: Smriti::MatViewDefinition.placeholder_for(:unique_index_columns) %>
+    <%= content_tag :small, Smriti::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: Smriti::MatViewDefinition.placeholder_for(:dependencies) %>
+    <%= content_tag :small, Smriti::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("smriti.create") : t("smriti.save_changes") %>
+    <% end %>
+
+    <%= mv_cancel_button variant: :ghost, data: { action: "click->drawer#close" },
+                             testid: 'CANCEL_BUTTON',
+                             testid_identifier: "defn-#{@definition.id || 'new'}"  do %>
+      <%= t("smriti.cancel") %>
+    <% end %>
+  </div>
+<% end %>