mensa 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10a862acae838d21598f9ce5d3e07b553a7a5e002b66c4993e32e0cb665d5a5d
-  data.tar.gz: 36115f04215a21212ad1f5f81ecd108f75e68199d4ae9a5db1c11cf74e136350
+  metadata.gz: 5ad9a06fc13439d733db95cc8d3c0142247291057d8a5c84fce0f090f8c96a63
+  data.tar.gz: fef0dcdcaf8b21e038af8baa90f3509016372f30998a7bdd0cb94c3050a19444
 SHA512:
-  metadata.gz: cfa2040a481694e363da898e51ab521ec7b8b4defc6775d46b919f8775296d57839e34afd690da5b7bfb478ab1ef9e727536ff6892db660fb4439026e5c7d2e0
-  data.tar.gz: 3080bef3dfe7f0ff02c64e43e7296865c1e835caa86f47bfeaa74d3e0c6232c2c886bd6f2ba3dafb7ffa0c7bc2790cce77a0fe5052e45c72a273874a7b63e226
+  metadata.gz: e86a46aab67adf045e5939e9d307732e7752ccc50f3bae26b67dc9176ecb00508405b9b8c9c146fd7f0eb88a71f2aeba7f9f49fc943e3b8bb6910cbd1858e2d9
+  data.tar.gz: 89e4d11db3e400215fdbce8cd5b031577a8c254cb92fc37f99c7ebbb726609c7d5e70c7bfb143a529f7ae6e9d5290d1bf4df314b6ca4e65384ebb20198f038dd

data/.zed/tasks.json

@@ -1,7 +1,7 @@
 [
     {
         "label": "Rails server",
-        "command": "bin/rails server -p 3000 -b 0.0.0.0",
+        "command": "pkill -f 'puma' && bin/rails server -p 3000 -b 0.0.0.0",
         "tags": ["rails"]
     },
     {

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mensa (0.3.4)
+    mensa (0.4.0)
       csv
       importmap-rails
       pagy (>= 43)

data/README.md

@@ -9,21 +9,19 @@ Due to search, it only works with postgresql at the moment.
 ![export](./docs/export.png)
 
 Features:
-
-- [x] very fast
-- [x] row-links
-- [x] sorting
-- [x] filtering of multiple columns
+- [x] Very fast
+- [x] Row-links
+- [x] Sorting
+- [x] Filtering of multiple columns
 - [X] Hide filter icon in case there are no filters
-- [X] column ordering
-- [X] editing of existing filters
-- [X] view selection and exports per view
-- [X] multiple selection of rows and batch processing
-- [x] tables without headers (and without most of the above)
-
-Todo/Fixme:
-- [ ] exports can be mailed - daily/weekly/monthly/quarterly/bi-yearly/yearly (time configurable)
-- [ ] Search only works on table text columns
+- [X] Column ordering
+- [X] Editing of existing filters
+- [X] View selection and exports per view
+- [X] Multiple selection of rows and batch processing
+- [x] Tables without headers (and without most of the above)
+- [X] Search works on all table columns
+- [X] Exports can be scheduled to run recurring (daily/weekly/monthly/quarterly/bi-yearly/yearly)
+      You will have to bring your own mailer, see configuration for details.
 
 Nice to haves:
 
@@ -191,6 +189,20 @@ Exporting is built into the table's control bar. Clicking the export button open
 a dialog that lists the user's previous downloads and lets them request a new
 export (scope and CSV format). 
 
+#### Repeating exports
+
+The user can choose to export a table on a regular basis (daily, weekly, monthly, quarterly, bi-yearly, yearly).
+
+When the user selects a repeating export, the table will be exported automatically on the specified schedule.
+
+For this to work you need to have a cron job which runs daily.
+When using `sidekiq-cron` or `goodjob` the `RecurringExportsJob` needs to be scheduled to run daily.
+
+If you're just using cron, you can add the following to your crontab:
+```
+0 0 * * * rails runner "Mensa::RecurringExportsJob.perform_later"
+```
+
 ## Contributing
 
 ```

data/app/components/mensa/add_filter/component.html.erb

@@ -4,7 +4,7 @@
      data-mensa-add-filter-operator-labels-value="<%= operator_labels.to_json %>">
   <button class="mensa-table__add_filter__trigger"
           type="button"
-          title="<%= t("mensa.add_filter.add", default: "Add filter") %>"
+          title="<%= t("mensa.add_filter.add") %>"
           data-action="mensa-add-filter#openAllColumns">
     <i class="fa-solid fa-circle-plus"></i>
   </button>

data/app/components/mensa/column_customizer/component_controller.js

@@ -273,7 +273,7 @@ export default class ColumnCustomizerController extends ApplicationController {
         if (!urlStr) return false;
 
         try {
-            const url = new URL(urlStr);
+            const url = new URL(urlStr, window.location.origin);
 
             const toDelete = [];
             url.searchParams.forEach((_, key) => {

data/app/components/mensa/control_bar/component.css

@@ -62,19 +62,31 @@
         }
 
         &__item {
-            @apply flex shrink-0 items-center justify-between gap-3 px-3 py-2.5;
+            @apply flex shrink-0 items-center gap-3 px-3 py-2.5;
+        }
+
+        &__delete-form {
+            @apply shrink-0;
+        }
+
+        &__delete {
+            @apply inline-flex h-9 w-9 items-center justify-center rounded-md text-gray-400 dark:text-gray-500 hover:bg-gray-100 dark:hover:bg-gray-700 hover:text-red-600 dark:hover:text-red-400 focus:outline-none focus:ring-2 focus:ring-red-500/30 transition-colors cursor-pointer;
         }
 
         &__item-info {
-            @apply flex flex-col min-w-0;
+            @apply flex flex-col min-w-0 flex-1;
         }
 
         &__item-name {
             @apply text-sm font-medium text-gray-900 dark:text-gray-100 truncate;
         }
 
+        &__item-repeat {
+            @apply text-xs font-normal text-gray-500 dark:text-gray-400;
+        }
+
         &__item-meta {
-            @apply text-xs text-gray-500 dark:text-gray-400;
+            @apply text-xs font-normal text-gray-400 dark:text-gray-500;
         }
 
         &__download {
@@ -109,6 +121,14 @@
             }
         }
 
+        &__repeat-options {
+            @apply pl-6;
+        }
+
+        &__select {
+            @apply w-full rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-900 shadow-sm focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-primary-500 focus:ring-opacity-20 dark:border-gray-600 dark:bg-gray-700 dark:text-gray-100;
+        }
+
         &__actions {
             @apply flex justify-end gap-2 pt-1;
         }

data/app/components/mensa/control_bar/component.html.erb

@@ -11,28 +11,28 @@
       <% if table.current_user && table.supports_custom_views? %>
         <div class="relative">
           <button class="mensa-table__control_bar__button hidden" type="button" data-mensa-table-target="saveSimple" data-action="mensa-table#saveAsNewView">
-            <%= t(".save", default: "Save") %>
+            <%= t("mensa.save") %>
           </button>
           <button class="mensa-table__control_bar__button hidden" type="button" data-mensa-table-target="saveSplit" data-action="mensa-table#toggleSaveDropdown">
-            <%= t(".save", default: "Save") %>
+            <%= t("mensa.save") %>
             <i class="fa-solid fa-chevron-down text-xs"></i>
           </button>
           <ul class="mensa-table__control_bar__save-dropdown hidden" data-mensa-table-target="saveDropdown">
             <li>
               <button class="mensa-table__control_bar__save-dropdown-item" type="button" data-action="mensa-table#updateCurrentViewAction">
-                <%= t(".update_view", default: "Update view") %>
+                <%= t("mensa.update_view") %>
               </button>
             </li>
             <li>
               <button class="mensa-table__control_bar__save-dropdown-item" type="button" data-action="mensa-table#saveAsNewView">
-                <%= t(".save_as_new_view", default: "Save as new view") %>
+                <%= t("mensa.save_as_new_view") %>
               </button>
             </li>
           </ul>
         </div>
       <% else %>
         <button class="mensa-table__control_bar__button" type="button" data-action="mensa-table#saveAsNewView">
-          <%= t(".save", default: "Save") %>
+          <%= t("mensa.save") %>
         </button>
       <% end %>
     </div>

data/app/components/mensa/empty_state/component.rb

@@ -11,7 +11,7 @@ module Mensa
 
       # "orders", "users", etc. — used inside the translated heading.
       def model_name_plural
-        table.model.model_name.human.pluralize.downcase
+        table.model.model_name.human(count: 2).downcase
       end
     end
   end

data/app/components/mensa/table/component.html.erb

@@ -1,7 +1,7 @@
 <div class="mensa-table"
      id="table-<%= table.table_id %>"
      data-mensa-table-supports-views-value="<%= table.supports_views? %>"
-     data-mensa-table-table-url-value="<%= helpers.mensa.table_url(table.name, {turbo_frame_id: table.table_id}.merge(params)) %>"
+     data-mensa-table-table-url-value="<%= table.path(turbo_frame_id: table.table_id, user_params: params) %>"
      data-mensa-table-save-view-url-value="<%= helpers.mensa.table_views_path(table.name) %>"
      data-mensa-table-views-url-value="<%= helpers.mensa.table_views_path(table.name) %>"
      data-mensa-table-exports-url-value="<%= helpers.mensa.table_exports_path(table.name) %>"

data/app/components/mensa/table/component.rb

@@ -8,11 +8,11 @@ module Mensa
       attr_reader :table
       attr_reader :params
 
-      def initialize(table_name, config = {}, **options)
-        @table = Mensa.for_name(table_name, config)
+      def initialize(table_name, params: {}, **options)
+        @params = params
+        @table = Mensa.for_name(table_name, {params: params})
         @table.original_view_context = options[:original_view_context]
         @table.component = self
-        @params = options[:params] || {}
       end
     end
   end

data/app/components/mensa/table/component_controller.js

@@ -43,7 +43,10 @@ export default class TableComponentController extends ApplicationController {
 
         // Close save dropdown when clicking outside
         this._saveDropdownOutsideHandler = (e) => {
-            if (this.hasSaveDropdownTarget && !this.saveDropdownTarget.classList.contains("hidden")) {
+            if (
+                this.hasSaveDropdownTarget &&
+                !this.saveDropdownTarget.classList.contains("hidden")
+            ) {
                 const saveArea = this.saveDropdownTarget.closest(".relative");
                 if (saveArea && !saveArea.contains(e.target)) {
                     this.saveDropdownTarget.classList.add("hidden");
@@ -98,12 +101,15 @@ export default class TableComponentController extends ApplicationController {
             const outlet = this.mensaFilterPillListOutlet;
             const state = {
                 filters: outlet.loadFilters(),
-                query:   outlet.loadQuery(),
-                view:    outlet.loadView(),
-                order:   outlet.loadOrder(),
-                page:    outlet.loadPage(),
+                query: outlet.loadQuery(),
+                view: outlet.loadView(),
+                order: outlet.loadOrder(),
+                page: outlet.loadPage(),
             };
-            this.turboFrameTarget.setAttribute("src", outlet.buildUrl(state).toString());
+            this.turboFrameTarget.setAttribute(
+                "src",
+                outlet.buildUrl(state).toString(),
+            );
         } else if (this.hasTableUrlValue) {
             this.turboFrameTarget.setAttribute("src", this.tableUrlValue);
         }
@@ -135,7 +141,8 @@ export default class TableComponentController extends ApplicationController {
     cancelFiltersAndSearch(event) {
         if (event) event.preventDefault();
         this.hideSaveReset();
-        if (this.hasSaveDropdownTarget) this.saveDropdownTarget.classList.add("hidden");
+        if (this.hasSaveDropdownTarget)
+            this.saveDropdownTarget.classList.add("hidden");
 
         if (this.hasMensaFilterPillListOutlet) {
             this.mensaFilterPillListOutlet.clearFiltersAndSearch();
@@ -164,14 +171,16 @@ export default class TableComponentController extends ApplicationController {
     // "Save as new view" — always opens the name dialog
     saveAsNewView(event) {
         if (event) event.preventDefault();
-        if (this.hasSaveDropdownTarget) this.saveDropdownTarget.classList.add("hidden");
+        if (this.hasSaveDropdownTarget)
+            this.saveDropdownTarget.classList.add("hidden");
         this._openSaveDialog();
     }
 
     // "Update view" — updates the currently selected user-owned view in place
     async updateCurrentViewAction(event) {
         if (event) event.preventDefault();
-        if (this.hasSaveDropdownTarget) this.saveDropdownTarget.classList.add("hidden");
+        if (this.hasSaveDropdownTarget)
+            this.saveDropdownTarget.classList.add("hidden");
 
         const viewId = this._selectedUserViewId();
         if (!viewId) {
@@ -204,7 +213,9 @@ export default class TableComponentController extends ApplicationController {
                 order: state.order,
                 column_order: state.column_order,
                 hidden_columns: state.hidden_columns,
-                turbo_frame_id: this.hasTurboFrameTarget ? this.turboFrameTarget.id : null,
+                turbo_frame_id: this.hasTurboFrameTarget
+                    ? this.turboFrameTarget.id
+                    : null,
             }),
             contentType: "application/json",
             responseKind: "turbo-stream",
@@ -239,9 +250,12 @@ export default class TableComponentController extends ApplicationController {
     async confirmSaveView(event) {
         event.preventDefault();
 
-        const name = this.hasSaveViewNameTarget ? this.saveViewNameTarget.value.trim() : "";
+        const name = this.hasSaveViewNameTarget
+            ? this.saveViewNameTarget.value.trim()
+            : "";
         if (!name) {
-            if (this.hasSaveViewNameTarget) this.saveViewNameTarget.reportValidity();
+            if (this.hasSaveViewNameTarget)
+                this.saveViewNameTarget.reportValidity();
             return;
         }
 
@@ -260,7 +274,9 @@ export default class TableComponentController extends ApplicationController {
                 order: state.order,
                 column_order: state.column_order,
                 hidden_columns: state.hidden_columns,
-                turbo_frame_id: this.hasTurboFrameTarget ? this.turboFrameTarget.id : null,
+                turbo_frame_id: this.hasTurboFrameTarget
+                    ? this.turboFrameTarget.id
+                    : null,
             }),
             contentType: "application/json",
             responseKind: "turbo-stream",
@@ -307,7 +323,10 @@ export default class TableComponentController extends ApplicationController {
         const hasViewFilters = this._hasViewFilterPills();
         if (hasViewFilters) {
             const visible = this._loadViewFiltersVisible();
-            this.element.classList.toggle("mensa-table--view-filters-hidden", !visible);
+            this.element.classList.toggle(
+                "mensa-table--view-filters-hidden",
+                !visible,
+            );
         } else {
             this.element.classList.remove("mensa-table--view-filters-hidden");
         }
@@ -328,13 +347,18 @@ export default class TableComponentController extends ApplicationController {
 
     toggleViewFilters(event) {
         if (event) event.preventDefault();
-        const nowHidden = this.element.classList.toggle("mensa-table--view-filters-hidden");
+        const nowHidden = this.element.classList.toggle(
+            "mensa-table--view-filters-hidden",
+        );
         this._saveViewFiltersVisible(!nowHidden);
         this._updateEyeButton();
     }
 
     _hasViewFilterPills() {
-        return this.element.querySelectorAll('[data-view-filter="true"]').length > 0;
+        return (
+            this.element.querySelectorAll('[data-view-filter="true"]').length >
+            0
+        );
     }
 
     // Only updates button visibility and icon — never touches the hidden class.
@@ -348,7 +372,9 @@ export default class TableComponentController extends ApplicationController {
         this.eyeButtonTarget.classList.toggle("hidden", !hasViewFilters);
 
         if (hasViewFilters) {
-            const hidden = this.element.classList.contains("mensa-table--view-filters-hidden");
+            const hidden = this.element.classList.contains(
+                "mensa-table--view-filters-hidden",
+            );
             // Replace innerHTML so FontAwesome's MutationObserver re-processes the new <i>
             this.eyeButtonTarget.innerHTML = hidden
                 ? '<i class="fa-solid fa-eye"></i>'
@@ -366,13 +392,18 @@ export default class TableComponentController extends ApplicationController {
         if (this.hasMensaFilterPillListOutlet) {
             return this.mensaFilterPillListOutlet.tableNameValue;
         }
-        const el = this.element.querySelector("[data-mensa-filter-pill-list-table-name-value]");
+        const el = this.element.querySelector(
+            "[data-mensa-filter-pill-list-table-name-value]",
+        );
         return el?.dataset?.mensaFilterPillListTableNameValue || "";
     }
 
     _loadViewFiltersVisible() {
         try {
-            return window.localStorage.getItem(this._viewFiltersStorageKey()) === "true";
+            return (
+                window.localStorage.getItem(this._viewFiltersStorageKey()) ===
+                "true"
+            );
         } catch (e) {
             return false;
         }
@@ -381,7 +412,10 @@ export default class TableComponentController extends ApplicationController {
     _saveViewFiltersVisible(visible) {
         try {
             if (visible) {
-                window.localStorage.setItem(this._viewFiltersStorageKey(), "true");
+                window.localStorage.setItem(
+                    this._viewFiltersStorageKey(),
+                    "true",
+                );
             } else {
                 window.localStorage.removeItem(this._viewFiltersStorageKey());
             }
@@ -432,13 +466,36 @@ export default class TableComponentController extends ApplicationController {
         }
     }
 
+    toggleExportRepeat() {
+        const dialog = this.exportDialogTarget;
+        const options = dialog.querySelector(
+            "[data-mensa-table-repeat-options]",
+        );
+        if (!options) return;
+
+        const mode = dialog.querySelector(
+            'input[name="repeat_mode"]:checked',
+        )?.value;
+        options.hidden = mode !== "repeating";
+    }
+
     confirmExport(event) {
         event.preventDefault();
         if (!this.hasExportsUrlValue) return;
 
         const dialog = this.exportDialogTarget;
-        const scope = dialog.querySelector('input[name="scope"]:checked')?.value || "all";
-        const exportFormat = dialog.querySelector('input[name="export_format"]:checked')?.value || "csv_excel";
+        const scope =
+            dialog.querySelector('input[name="scope"]:checked')?.value || "all";
+        const exportFormat =
+            dialog.querySelector('input[name="export_format"]:checked')
+                ?.value || "csv_excel";
+        const repeatMode = dialog.querySelector(
+            'input[name="repeat_mode"]:checked',
+        )?.value;
+        const repeat =
+            repeatMode === "repeating"
+                ? dialog.querySelector('select[name="repeat"]')?.value || ""
+                : "";
 
         const state = this.currentViewState();
         const nav = this.hasMensaFilterPillListOutlet
@@ -452,6 +509,7 @@ export default class TableComponentController extends ApplicationController {
             body: JSON.stringify({
                 scope,
                 export_format: exportFormat,
+                repeat,
                 table_view_id: view,
                 page: nav.page,
                 query: state.query || nav.query,
@@ -464,11 +522,17 @@ export default class TableComponentController extends ApplicationController {
     }
 
     get ourUrl() {
-        if (this.hasTurboFrameTarget && this.turboFrameTarget.getAttribute("src")) {
-            return new URL(this.turboFrameTarget.getAttribute("src"));
+        if (
+            this.hasTurboFrameTarget &&
+            this.turboFrameTarget.getAttribute("src")
+        ) {
+            return new URL(
+                this.turboFrameTarget.getAttribute("src"),
+                window.location.origin,
+            );
         }
         if (this.hasTableUrlValue && this.tableUrlValue) {
-            return new URL(this.tableUrlValue);
+            return new URL(this.tableUrlValue, window.location.origin);
         }
         return new URL(window.location.href);
     }
@@ -494,8 +558,12 @@ export default class TableComponentController extends ApplicationController {
     _updateSaveButtonMode() {
         if (!this.hasSaveSimpleTarget && !this.hasSaveSplitTarget) return;
         const isUserView = !!this._selectedUserViewId();
-        this.saveSimpleTargets.forEach((t) => t.classList.toggle("hidden", isUserView));
-        this.saveSplitTargets.forEach((t) => t.classList.toggle("hidden", !isUserView));
+        this.saveSimpleTargets.forEach((t) =>
+            t.classList.toggle("hidden", isUserView),
+        );
+        this.saveSplitTargets.forEach((t) =>
+            t.classList.toggle("hidden", !isUserView),
+        );
     }
 
     _selectedUserViewId() {
@@ -517,7 +585,8 @@ export default class TableComponentController extends ApplicationController {
     _openSaveDialog() {
         if (!this.hasSaveViewDialogTarget) return;
         if (this.hasSaveViewNameTarget) this.saveViewNameTarget.value = "";
-        if (this.hasSaveViewDescriptionTarget) this.saveViewDescriptionTarget.value = "";
+        if (this.hasSaveViewDescriptionTarget)
+            this.saveViewDescriptionTarget.value = "";
         if (typeof this.saveViewDialogTarget.showModal === "function") {
             this.saveViewDialogTarget.showModal();
         } else {

data/app/components/mensa/view/component.html.erb

@@ -27,7 +27,7 @@
             </th>
           <% end %>
           <% if table.actions? && Mensa.config.row_actions_position == :front %>
-            <th>Actions</th>
+            <th><%= t("mensa.actions") %></th>
           <% end %>
           <%= render(Mensa::Header::Component.with_collection(table.display_columns, table: table)) %>
           <% if table.actions? && Mensa.config.row_actions_position == :back %>

data/app/components/mensa/view/component.rb

@@ -14,7 +14,7 @@ module Mensa
 
       # "orders", "users", etc. — used in the paging info line.
       def model_name_plural
-        table.model.model_name.human.pluralize.downcase
+        table.model.model_name.human(count: 2)
       end
     end
   end

data/app/controllers/mensa/tables/exports_controller.rb

@@ -23,6 +23,7 @@ module Mensa
           user: current_mensa_user,
           format: params[:export_format].to_s.presence_in(Mensa::Export::FORMATS) || "csv_excel",
           scope: params[:scope].to_s.presence_in(Mensa::Export::SCOPES) || "all",
+          repeat: params[:repeat].to_s.presence_in(Mensa::Export::REPEATS) || "",
           config: params.permit(:query, :page, order: {}, filters: {}).to_h,
           status: "pending"
         )
@@ -42,6 +43,20 @@ module Mensa
         end
       end
 
+      # Deletes an export from the current user's download list. The attached
+      # asset is purged automatically when the record is destroyed.
+      def destroy
+        export = exports.find(params[:id])
+        export.destroy
+        Mensa::Export.broadcast_refresh(export.table_name, export.user)
+
+        respond_to do |format|
+          format.turbo_stream { render turbo_stream: [list_stream, badge_stream] }
+          format.json { head :no_content }
+          format.html { redirect_back fallback_location: mensa.table_exports_path(params[:table_id]) }
+        end
+      end
+
       # Streams the generated CSV and then removes the export, purging the
       # attached asset. Downloads are single-use: routing them through the
       # controller (instead of a direct Active Storage link) gives us a hook to
@@ -56,12 +71,17 @@ module Mensa
 
         send_data data, filename: filename, type: content_type, disposition: "attachment"
 
-        # Clean up after a successful send. `has_one_attached :asset` purges the
-        # blob when the record is destroyed (dependent: :purge_later). Never let
-        # cleanup failures break the download itself.
+        # One-off exports are single-use and are deleted after download.
+        # Repeating exports stay in place and can be removed explicitly via the
+        # trash action.
         begin
-          export.destroy
-          Mensa::Export.broadcast_refresh(export.table_name, export.user)
+          if export.repeating?
+            export.asset.purge_later
+            Mensa::Export.broadcast_refresh(export.table_name, export.user)
+          else
+            export.destroy
+            Mensa::Export.broadcast_refresh(export.table_name, export.user)
+          end
         rescue => e
           Mensa.config.logger&.warn("Mensa::Export cleanup failed for #{export.id}: #{e.class}: #{e.message}")
         end

data/app/controllers/mensa/tables_controller.rb

@@ -1,27 +1,25 @@
 module Mensa
   class TablesController < ApplicationController
     def show
-      @table = Mensa.for_name(params[:id])
+      config = params.permit(:format, :query, :id, :page, :table_view_id, :turbo_frame_id, order: {}, column_order: [], hidden_columns: [], params: {}).to_h
+      config[:filters] = params[:filters]&.to_unsafe_h || {}
+      config[:params] = params[:params]&.to_unsafe_h || {}
 
-      config = {}
       if params[:table_view_id]
+        view_lookup_table = Mensa.for_name(params[:id], config)
         @view = Mensa::TableView.find_by(table_name: params[:id], id: params[:table_view_id])
-        @view ||= @table.system_views.find { |v| v.id == params[:table_view_id].to_sym }
-        config = @view&.config&.deep_transform_keys(&:to_sym) if @view
+        @view ||= view_lookup_table.system_views.find { |v| v.id == params[:table_view_id].to_sym }
+        config = (@view&.config&.deep_transform_keys(&:to_sym) || {}).merge(config)
       end
 
-      config = config.merge(params.permit!.to_h)
-      config = config.merge(params.permit(:format, :query, :id, :page, :table_view_id, :turbo_frame_id, order: {}, column_order: [], hidden_columns: []).to_h)
-      config[:filters] = params[:filters]&.to_unsafe_h || config[:filters] || {}
-
       @table = Mensa.for_name(params[:id], config)
       @table.request = request
       @table.table_view = @view
       @table.original_view_context = helpers
 
       respond_to do |format|
-        format.turbo_stream # Used for filterering
-        format.html # You shouldn't get here
+        format.turbo_stream # Used for filtering
+        format.html
       end
     end
   end

data/app/helpers/mensa/application_helper.rb

@@ -1,7 +1,7 @@
 module Mensa
   module ApplicationHelper
-    def table(name, config = {}, **options)
-      component = ::Mensa::Table::Component.new(name, config, **options)
+    def table(name, params: {}, **options)
+      component = ::Mensa::Table::Component.new(name, params: params, **options)
       component.original_view_context = self
       render(component)
     end

data/app/jobs/mensa/export_job.rb

@@ -23,6 +23,7 @@ module Mensa
 
       data, filename, content_type = generate(table, export)
 
+      export.asset.purge if export.asset.attached?
       export.asset.attach(io: StringIO.new(data), filename: filename, content_type: content_type)
       finalize(export, status: "completed", filename: filename)
 
@@ -94,6 +95,9 @@ module Mensa
     def finalize(export, status:, filename: nil)
       attributes = {status: status}
       attributes[:filename] = filename if filename
+
+      attributes[:last_repeat_run_at] = Time.current if status == "completed" && export.repeat.present?
+
       export.update(attributes)
       # Refresh the export button badge (download count) and the downloads list
       # inside the export dialog for everyone viewing this table.

data/app/jobs/mensa/recurring_exports_job.rb

@@ -0,0 +1,17 @@
+module Mensa
+  # Sweeps recurring exports and re-enqueues any whose next scheduled run is due.
+  # This job is intended to be invoked by a daily cron entry or scheduler.
+  class RecurringExportsJob < ApplicationJob
+    queue_as :default
+
+    def perform(reference_time = Time.current)
+      reference_time = reference_time.in_time_zone if reference_time.respond_to?(:in_time_zone)
+
+      Mensa::Export.repeating.find_each do |export|
+        next unless export.repeat_due?(reference_time)
+
+        Mensa::ExportJob.perform_later(export)
+      end
+    end
+  end
+end

data/app/models/mensa/export.rb

@@ -7,17 +7,21 @@ module Mensa
     STATUSES = %w[pending processing completed failed].freeze
     FORMATS = %w[csv_excel plain_csv].freeze
     SCOPES = %w[all current_page].freeze
+    REPEATS = ["", "daily", "weekly", "monthly", "quarterly", "bi-yearly", "yearly"].freeze
 
     belongs_to :user, optional: true
     has_one_attached :asset
 
     validates :table_name, presence: true
     validates :status, inclusion: {in: STATUSES}
+    validates :repeat, inclusion: {in: REPEATS}
 
     scope :for_table, ->(table_name) { where(table_name: table_name.to_s) }
     scope :for_user, ->(user) { where(user_id: user.respond_to?(:id) ? user&.id : user) }
     scope :completed, -> { where(status: "completed") }
     scope :recent, -> { order(created_at: :desc) }
+    scope :repeating, -> { where.not(repeat: [nil, ""]) }
+    scope :with_downloadable_asset, -> { completed.joins(:asset_attachment).distinct }
 
     def completed?
       status == "completed"
@@ -35,15 +39,63 @@ module Mensa
       status == "pending"
     end
 
+    def next_repeat_run_at(from: nil)
+      return if repeat.blank?
+
+      anchor = from || last_repeat_run_at || created_at
+
+      case repeat
+      when "daily"
+        anchor + 1.day
+      when "weekly"
+        anchor + 1.week
+      when "monthly"
+        anchor.advance(months: 1)
+      when "quarterly"
+        anchor.advance(months: 3)
+      when "bi-yearly"
+        anchor.advance(months: 6)
+      when "yearly"
+        anchor.advance(years: 1)
+      end
+    end
+
+    def repeat_due?(reference_time = Time.current)
+      return false if repeat.blank? || pending? || processing?
+
+      next_run_at = next_repeat_run_at
+      next_run_at.present? && next_run_at <= reference_time
+    end
+
+    def repeating?
+      repeat.present?
+    end
+
+    def repeat_label
+      return if repeat.blank?
+
+      I18n.t(
+        "mensa.exports.repeats_with_interval",
+        default: "Repeats %{interval}",
+        interval: repeat_interval_label
+      )
+    end
+
+    def repeat_interval_label
+      return if repeat.blank?
+
+      I18n.t("mensa.exports.repeat_intervals.#{repeat}", default: repeat)
+    end
+
     # True once the asset is ready to be downloaded by the user.
     def downloadable?
       completed? && asset.attached?
     end
 
-    # Number of completed (downloadable) exports for a table/user combination.
+    # Number of currently-downloadable exports for a table/user combination.
     # This is the number rendered in the export button badge.
     def self.completed_count(table_name, user)
-      for_table(table_name).for_user(user).completed.count
+      for_table(table_name).for_user(user).with_downloadable_asset.count
     end
 
     # A stable, page-independent key identifying the exports of a table/user

data/app/tables/mensa/base.rb

@@ -8,8 +8,8 @@ module Mensa
 
     attr_writer :original_view_context
     attr_accessor :component, :name, :table_view, :request
-    attr_reader :params
 
+    config_reader :params
     config_reader :model
     config_reader :scope
     config_reader :link, call: false
@@ -22,12 +22,12 @@ module Mensa
     config_reader :export_with_password?
 
     def initialize(config = {})
-      @params = config.to_h.deep_symbolize_keys
-      @config = self.class.definition.merge(@params || {})
+      normalized_config = config.to_h.deep_symbolize_keys
+      @config = self.class.definition.merge(normalized_config)
+      @params = (@config[:params].presence || {}).deep_symbolize_keys
+      @config[:params] = @params
 
-      ensure_internal_columns_for_joined_associations
-
-      params[:hidden_columns]&.each do |column_name|
+      current_hidden_columns&.each do |column_name|
         c = columns.find { |c| c.name == column_name.to_sym }
         c.config[:visible] = false
       end
@@ -48,12 +48,17 @@ module Mensa
 
     # Returns all columns
     def columns
+      ensure_internal_columns_for_joined_associations
       @columns ||= column_order.map { |column_name| Mensa::Column.new(column_name, config: config.dig(:columns, column_name), table: self) }
     end
 
     # Returns a column by name
     # @param [String] name
     def column(name)
+      found_column = columns.find { |c| c.name == name.to_sym }
+      return found_column if found_column || @internal_columns_ensured
+
+      @columns = nil
       columns.find { |c| c.name == name.to_sym }
     end
 
@@ -117,16 +122,19 @@ module Mensa
     end
 
     # Returns the current path with configuration
-    def path(order: {}, turbo_frame_id: nil, table_view_id: params[:table_view_id], column_order: params[:column_order], hidden_columns: params[:hidden_columns])
+    def path(order: {}, turbo_frame_id: current_turbo_frame_id, table_view_id: current_table_view_id, column_order: current_column_order, hidden_columns: current_hidden_columns, user_params: nil)
       # FIXME: if someone doesn't use as: :mensa in the routes, it breaks
-      original_view_context.mensa.table_path(
-        name,
+      path = original_view_context.mensa.table_path(name)
+      query = {
+        params: user_params || params,
         order: order_hash(order),
         turbo_frame_id: turbo_frame_id,
         table_view_id: table_view_id,
         column_order: column_order,
         hidden_columns: hidden_columns
-      )
+      }.compact.to_query
+
+      query.present? ? "#{path}?#{query}" : path
     end
 
     def all_views
@@ -146,21 +154,53 @@ module Mensa
     def table_id
       return @table_id if @table_id
 
-      @table_id = params[:turbo_frame_id] || "#{name.to_s.gsub("/", "__")}-#{SecureRandom.base36}"
+      @table_id = current_turbo_frame_id || "#{name.to_s.gsub("/", "__")}-#{SecureRandom.base36}"
     end
 
     def original_view_context
       @original_view_context || component.original_view_context
     end
 
+    def current_query
+      config[:query]
+    end
+
+    def current_order
+      config[:order]
+    end
+
+    def current_order_provided?
+      config.key?(:order)
+    end
+
+    def current_table_view_id
+      config[:table_view_id]
+    end
+
+    def current_column_order
+      config[:column_order]
+    end
+
+    def current_hidden_columns
+      config[:hidden_columns]
+    end
+
+    def current_turbo_frame_id
+      config[:turbo_frame_id]
+    end
+
     private
 
     def ensure_internal_columns_for_joined_associations
+      return if @internal_columns_ensured
+
       config[:columns] ||= {}
 
       auto_internal_column_names.each do |column_name|
         config[:columns][column_name] ||= {internal: true, filter: false}
       end
+
+      @internal_columns_ensured = true
     end
 
     def auto_internal_column_names

data/app/tables/mensa/config/table_dsl.rb

@@ -48,6 +48,7 @@ module Mensa::Config
   class TableDsl
     include DslLogic
 
+    option :params, default: {}
     option :model, default: -> {
       begin
         self.class.name.demodulize.to_s.classify.gsub("Table", "").singularize.constantize

data/app/tables/mensa/scope.rb

@@ -14,7 +14,7 @@ module Mensa
       return @filtered_scope if @filtered_scope
 
       @filtered_scope = scope
-      @filtered_scope = search(@filtered_scope, params[:query]) if params[:query].present?
+      @filtered_scope = search(@filtered_scope, current_query) if current_query.present?
 
       # Use inject
       active_filters.each do |filter|
@@ -44,6 +44,8 @@ module Mensa
     def selected_scope
       return @selected_scope if @selected_scope
 
+      ensure_internal_columns_for_joined_associations
+
       @selected_scope = ordered_scope
       @selected_scope = @selected_scope.select([:id] + columns.filter_map(&:attribute))
 
@@ -72,7 +74,7 @@ module Mensa
     # (even with blank values), use only those — blank means "explicitly no sort".
     # Falls back to the view/config default only when no order params were sent.
     def effective_order
-      result = params.key?(:order) ? (params[:order] || {}) : (config[:order] || {})
+      result = current_order_provided? ? (current_order || {}) : (config[:order] || {})
       result = result.symbolize_keys.compact_blank.transform_values(&:to_sym)
       result.transform_keys { |column_name| column(column_name).attribute_for_condition }
     end
@@ -81,7 +83,7 @@ module Mensa
     # nil values become "" so they appear in the URL as order[col]= (which tells
     # the server the user explicitly cleared that column's sort direction).
     def order_hash(new_params = {})
-      base = params[:order]&.symbolize_keys || config[:order]&.symbolize_keys || {}
+      base = current_order&.symbolize_keys || config[:order]&.symbolize_keys || {}
       merged = base.merge(new_params.symbolize_keys)
       merged.transform_values { |v| v.nil? ? "" : v.to_sym }
     end

data/app/views/mensa/exports/_dialog.html.erb

@@ -37,6 +37,29 @@
           </label>
         </fieldset>
 
+        <fieldset class="mensa-table__export-dialog__fieldset">
+          <legend class="mensa-table__export-dialog__section-title"><%= t("mensa.exports.repeat_section", default: "Repeat") %></legend>
+          <label class="mensa-table__export-dialog__option">
+            <input type="radio" name="repeat_mode" value="once" checked data-action="change->mensa-table#toggleExportRepeat">
+            <span><%= t("mensa.exports.repeat_once", default: "Only once") %></span>
+          </label>
+          <label class="mensa-table__export-dialog__option">
+            <input type="radio" name="repeat_mode" value="repeating" data-action="change->mensa-table#toggleExportRepeat">
+            <span><%= t("mensa.exports.repeat_repeating", default: "Repeating") %></span>
+          </label>
+
+          <div class="mensa-table__export-dialog__repeat-options" hidden data-mensa-table-repeat-options>
+            <select name="repeat" class="mensa-table__export-dialog__select">
+              <option value="daily"><%= t("mensa.exports.repeat_intervals.daily", default: "daily") %></option>
+              <option value="weekly"><%= t("mensa.exports.repeat_intervals.weekly", default: "weekly") %></option>
+              <option value="monthly"><%= t("mensa.exports.repeat_intervals.monthly", default: "monthly") %></option>
+              <option value="quarterly"><%= t("mensa.exports.repeat_intervals.quarterly", default: "quarterly") %></option>
+              <option value="bi-yearly"><%= t("mensa.exports.repeat_intervals.bi-yearly", default: "bi-yearly") %></option>
+              <option value="yearly"><%= t("mensa.exports.repeat_intervals.yearly", default: "yearly") %></option>
+            </select>
+          </div>
+        </fieldset>
+
         <div class="mensa-table__export-dialog__actions">
           <button class="mensa-table__export-dialog__button mensa-table__export-dialog__button--secondary" type="button" data-action="mensa-table#cancelExport">
             <%= t("mensa.exports.cancel", default: "Cancel") %>

data/app/views/mensa/exports/_list.html.erb

@@ -6,8 +6,19 @@
     <ul class="mensa-table__export-dialog__list">
       <% exports.each do |export| %>
         <li class="mensa-table__export-dialog__item">
+          <%= button_to mensa.table_export_path(export.table_name, export),
+            method: :delete,
+            class: "mensa-table__export-dialog__delete",
+            form_class: "mensa-table__export-dialog__delete-form",
+            aria: {label: t("mensa.exports.delete", default: "Delete export") } do %>
+            <i class="fa-solid fa-trash"></i>
+          <% end %>
+
           <div class="mensa-table__export-dialog__item-info">
             <span class="mensa-table__export-dialog__item-name"><%= export.filename.presence || t("mensa.exports.item_name", default: "%{table} export", table: export.table_name.to_s.humanize) %></span>
+            <% if export.repeating? %>
+              <span class="mensa-table__export-dialog__item-repeat"><%= export.repeat_label %></span>
+            <% end %>
             <span class="mensa-table__export-dialog__item-meta"><%= export.created_at.strftime("%Y-%m-%d %H:%M") %></span>
           </div>
           <div class="mensa-table__export-dialog__item-action">
@@ -18,6 +29,8 @@
               <% end %>
             <% elsif export.failed? %>
               <span class="mensa-table__export-dialog__status mensa-table__export-dialog__status--failed"><%= t("mensa.exports.failed", default: "Failed") %></span>
+            <% elsif export.completed? %>
+              <span class="mensa-table__export-dialog__status mensa-table__export-dialog__status--pending"><%= t("mensa.exports.waiting", default: "Waiting") %></span>
             <% else %>
               <span class="mensa-table__export-dialog__status mensa-table__export-dialog__status--pending">
                 <i class="fa-solid fa-spinner fa-spin"></i>

data/app/views/mensa/tables/standard_error.html.erb

@@ -0,0 +1,9 @@
+<turbo-frame id="<%= @frame_id %>">
+  <div class="mensa-empty-state">
+    <div class="mensa-empty-state__icon">
+      <i class="fa-solid fa-circle-exclamation"></i>
+    </div>
+    <h3 class="mensa-empty-state__title">Could not load table</h3>
+    <p class="mensa-empty-state__subtitle"><%= @error_message %></p>
+  </div>
+</turbo-frame>

data/config/locales/en.yml

@@ -1,5 +1,10 @@
 en:
   mensa:
+    actions: Actions
+    save: Save
+    update_view: Update view
+    save_view: Save as new view
+    save_as_new_view: Save as new view
     operators:
       is: is
       isnt: isn't
@@ -12,6 +17,7 @@ en:
       lteq: less than or equal to
       is_empty: is empty
     add_filter:
+      add: Add filter
       component:
         add_filter: Add filter
     filter_pill_list:
@@ -20,6 +26,7 @@ en:
         search_only: Search
     search:
       component:
+        search: Search and filter
         search_in: Search in %{view}
         cancel: Cancel
         save: Save
@@ -35,8 +42,22 @@ en:
       available_downloads: Available downloads
       empty: You have no downloads yet. Create one below.
       item_name: "%{table} export"
+      repeats_with_interval: "Repeats %{interval}"
+      repeat_section: Repeat
+      repeat: Repeat
+      repeat_once: "Only once"
+      repeat_repeating: Repeating
+      repeat_intervals:
+        daily: daily
+        weekly: weekly
+        monthly: monthly
+        quarterly: quarterly
+        bi-yearly: bi-yearly
+        yearly: yearly
       download: Download
+      delete: Delete export
       processing: Preparing…
+      waiting: Waiting
       failed: Failed
       new_export: New export
       scope_all: All records (matching current filters)

data/config/locales/nl.yml

@@ -1,5 +1,10 @@
 nl:
   mensa:
+    actions: Acties
+    save: Bewaar
+    update_view: Bewaar weergave
+    save_view: Bewaar als nieuwe weergave
+    save_as_new_view: Bewaar als nieuwe weergave
     operators:
       is: is
       isnt: is niet
@@ -12,6 +17,7 @@ nl:
       lteq: kleiner dan of gelijk aan
       is_empty: is leeg
     add_filter:
+      add: Filter toevoegen
       component:
         add_filter: Filter toevoegen
     filter_pill_list:
@@ -36,8 +42,22 @@ nl:
       available_downloads: Beschikbare downloads
       empty: Je hebt nog geen downloads. Maak er hieronder een aan.
       item_name: "%{table} export"
+      repeats_with_interval: "Herhaalt %{interval}"
+      repeat_section: Herhalen
+      repeat: Herhalen
+      repeat_once: "Eenmalig"
+      repeat_repeating: Herhalend
+      repeat_intervals:
+        daily: dagelijks
+        weekly: wekelijks
+        monthly: maandelijks
+        quarterly: per kwartaal
+        bi-yearly: halfjaarlijks
+        yearly: jaarlijks
       download: Downloaden
+      delete: Export verwijderen
       processing: Bezig…
+      waiting: Wachtend
       failed: Mislukt
       new_export: Nieuwe export
       scope_all: Alle records (volgens huidige filters)

data/config/routes.rb

@@ -4,7 +4,7 @@ Mensa::Engine.routes.draw do
       resources :filters
       resources :views, only: [:create, :update, :destroy]
       resources :batch_actions, only: [:create]
-      resources :exports, only: [:index, :create] do
+      resources :exports, only: [:index, :create, :destroy] do
         member do
           get :download
         end

data/db/migrate/20260612110000_add_repeat_to_mensa_exports.rb

@@ -0,0 +1,8 @@
+class AddRepeatToMensaExports < ActiveRecord::Migration[7.1]
+  def change
+    add_column :mensa_exports, :repeat, :string, null: false, default: ""
+    add_column :mensa_exports, :last_repeat_run_at, :datetime
+    add_index :mensa_exports, :repeat
+    add_index :mensa_exports, :last_repeat_run_at
+  end
+end

data/lib/mensa/configuration.rb

@@ -72,6 +72,11 @@ module Mensa
       end,
       # Called with the Mensa::Export once the CSV has been generated and
       # attached (export.asset). Use this to e.g. notify or email the user.
+      #
+      # UserMailer.with(
+      #   user: User.find(export.user_id),
+      #   export: export,
+      # ).export_email.deliver_later
       export_complete: lambda do |export|
       end
     }

data/lib/mensa/version.rb

@@ -1,3 +1,3 @@
 module Mensa
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/tasks/mensa_tasks.rake

@@ -5,6 +5,13 @@ namespace :mensa do
       Rails::Generators.invoke("mensa:tailwind_config", ["--force"])
     end
   end
+
+  namespace :exports do
+    desc "Run recurring exports that are due"
+    task recurring: :environment do
+      Mensa::RecurringExportsJob.perform_now
+    end
+  end
 end
 
 if Rake::Task.task_defined?("tailwindcss:build")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mensa
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Tom de Grunt
@@ -247,6 +247,7 @@ files:
 - app/javascript/mensa/controllers/link_controller.js
 - app/jobs/mensa/application_job.rb
 - app/jobs/mensa/export_job.rb
+- app/jobs/mensa/recurring_exports_job.rb
 - app/models/concerns/.keep
 - app/models/mensa/application_record.rb
 - app/models/mensa/export.rb
@@ -276,6 +277,7 @@ files:
 - app/views/mensa/tables/filters/show.turbo_stream.erb
 - app/views/mensa/tables/show.html.erb
 - app/views/mensa/tables/show.turbo_stream.erb
+- app/views/mensa/tables/standard_error.html.erb
 - app/views/mensa/tables/views/create.turbo_stream.erb
 - app/views/mensa/tables/views/destroy.turbo_stream.erb
 - app/views/mensa/tables/views/update.turbo_stream.erb
@@ -290,6 +292,7 @@ files:
 - db/migrate/20240201184752_create_mensa_table_views.rb
 - db/migrate/20251112143558_add_description_to_table_view.rb
 - db/migrate/20260604120000_create_mensa_exports.rb
+- db/migrate/20260612110000_add_repeat_to_mensa_exports.rb
 - docs/columns.png
 - docs/export.png
 - docs/filters.png