habarico 7.2.0.pre.beta.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1f8b6c198a99af28029879ffde809fdd78c4cfd3809798f2d4624040ccdf0614
+  data.tar.gz: b0ec882cb2c571cd9350d5b4a6a01706970661f5b52900789a7215c4ac523c6a
+SHA512:
+  metadata.gz: a8ab25a7e0b5c74f63a2d4b8203cd2bb797c1324a60c744a7e2db019a5dbdd7571fe252a21de1b3bb35ef821c31fcafc1305c7320e792f2c572d28277cf047fd
+  data.tar.gz: 3d8a9df73a2bcce948c33a21273f09d2864e81002bf56ed24cebd8be7862038874443c3c4edd3ace9a0f6b22301785cbbf7273f39fd21d9206431a7db02a1906

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Eluvia.land s.r.o.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,82 @@
+# habarico
+
+Habarico is a schema-driven admin library for Rails. The gem is an engine that turns Rails models
+into a complete admin API: REST endpoints plus JSON schemas describing resources, fields, views and
+actions. The [React frontend](https://docs.habarico.com/node/intro) renders the whole admin UI from
+those schemas — no screen is written per resource.
+
+## Installation
+
+The gem is published to the internal server, not to rubygems.org. Add it to your `Gemfile`:
+
+```ruby
+gem 'habarico'
+```
+
+```bash
+bundle install
+```
+
+Then configure the engine in `config/initializers/habarico.rb`:
+
+```ruby
+Habarico.setup do |config|
+  config.resources = [{ admin: [:products, :orders] }]
+  config.routing_url_prefix = ENV.fetch('URL_PREFIX') { '' }
+  config.routing_scope      = 'apps'
+  config.currency           = 'CZK'
+end
+```
+
+## Quick start
+
+A resource is a controller that includes the concern and describes itself through the DSL:
+
+```ruby
+class Apps::Admin::ProductsController < ApplicationController
+  include Habarico::Controller
+
+  model Product
+  default_sorting 'created_at:desc'
+
+  can_read   true
+  can_create { |c| c.policy.create? }
+  can_update { |c| c.policy.update? }
+
+  fields [:id, :name, :sku, :status, :category, :price, :stock, :created_at]
+  read_only_fields [:id, :created_at]
+  filters [:name, :status, :category]
+  sorting_fields [:name, :price, :created_at]
+
+  views   [:list, :show, :create, :edit]
+  actions [:show, :create, :edit, :delete]
+end
+```
+
+Routes are drawn from the configured resources — `config/routes.rb` only calls
+`Habarico::RoutingService.instance.draw_routes`.
+
+## Documentation
+
+Full documentation is at **[docs.habarico.com/ruby](https://docs.habarico.com/ruby/intro)** — this
+file is only a quick start.
+
+| Section | What it covers |
+| --- | --- |
+| [Installation](https://docs.habarico.com/ruby/installation) and [configuration](https://docs.habarico.com/ruby/configuration) | The initializer and its options |
+| [Basic usage](https://docs.habarico.com/ruby/basic-usage/) | Controllers, permissions, data loading, views, global search, aggregation, response field selection |
+| [Schema & field customization](https://docs.habarico.com/ruby/schema-and-field-customization/) | Shaping the list, detail and form views, custom actions, box types |
+| [Field types](https://docs.habarico.com/ruby/field-types) | The types a field can take and how they are inferred |
+| [Filtering and searching](https://docs.habarico.com/ruby/filtering-and-searching) | Filters, sorting and fulltext search |
+| [Change history](https://docs.habarico.com/ruby/change-history-paper-trail) | PaperTrail versions surfaced in the admin |
+| [Cross-service references](https://docs.habarico.com/ruby/cross-service-references) | Fields pointing at another service's records |
+| [User preferences](https://docs.habarico.com/ruby/user-preferences) | The per-user preference store the frontend syncs to |
+| [Complete example](https://docs.habarico.com/ruby/complete-example) | One resource wired up end to end |
+
+The frontend consuming these schemas is documented at
+[docs.habarico.com/node](https://docs.habarico.com/node/intro), and the contract between them is
+the [API reference](https://docs.habarico.com/api).
+
+## License
+
+[MIT](LICENSE)

data/Rakefile

@@ -0,0 +1,15 @@
+require "bundler/setup"
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+load "rails/tasks/statistics.rake"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.test_files = FileList["test/unit/**/*_test.rb"] +
+                 FileList["test/integration/**/*_test.rb"] +
+                 FileList["test/contrib/**/*_test.rb"]
+  t.verbose = true
+end
+
+task default: :test

data/VERSION

@@ -0,0 +1 @@
+7.2.0-beta.5

data/app/controllers/habarico/action_schema_controller.rb

@@ -0,0 +1,41 @@
+module Habarico
+  class ActionSchemaController < ApplicationController
+
+    def index
+      # Path is something like this: /xxx/:resource_name/:action_name/schema
+      resource_name = request.path.split('/')[-3]
+      action_name = request.path.split('/')[-2]
+      raise Eluvia::Errors::BadRequest.new("Missing resource name in the request path.") unless resource_name
+      raise Eluvia::Errors::BadRequest.new("Missing action name in the request path.") unless action_name
+
+      # Prepare context and generate schema
+      context = Habarico::Context.new(
+        current_user: current_user,
+        target: (JSON.parse(params['_target']) rescue {}).symbolize_keys
+      )
+      render json: Habarico::SchemaService.instance.get_action_schema(resource_name, action_name, context)
+                                          .as_json
+                                          .deep_compact(compactable: [nil, {}].freeze)
+    end
+
+    def show
+      # Path is something like this: /xxx/:resource_name/:id/:action_name/schema
+      resource_name = request.path.split('/')[-4]
+      action_name = request.path.split('/')[-2]
+      raise Eluvia::Errors::BadRequest.new("Missing resource name in the request path.") unless resource_name
+      raise Eluvia::Errors::BadRequest.new("Missing record PK in the request path.") unless params[:id]
+      raise Eluvia::Errors::BadRequest.new("Missing action name in the request path.") unless action_name
+
+      # Prepare context and generate schema
+      context = Habarico::Context.new(
+        current_user: current_user,
+        record_pk: params[:id],
+        target: (JSON.parse(params['_target']) rescue {}).symbolize_keys
+      )
+      render json: Habarico::SchemaService.instance.get_action_schema(resource_name, action_name, context)
+                                          .as_json
+                                          .deep_compact(compactable: [nil, {}].freeze)
+    end
+
+  end
+end

data/app/controllers/habarico/application_controller.rb

@@ -0,0 +1,15 @@
+module Habarico
+  class ApplicationController < Habarico::Config.base_controller_class.constantize
+    include Eluvia::ErrorHandler
+    include Habarico::Authenticatable
+
+    # ***************************************************************************
+    # JSON as default format
+    # ***************************************************************************
+
+    before_action do
+      request.format = :json if %w[text/html */*].include?(request.format.to_s)
+    end
+
+  end
+end

data/app/controllers/habarico/contrib/preferences/user_preferences_controller.rb

@@ -0,0 +1,105 @@
+module Habarico
+  module Contrib
+    module Preferences
+      # REST endpoints for the per-user preference store. Auth (`authenticate(['public'])`)
+      # and `current_user` come from Habarico::ApplicationController. Behavior mirrors the
+      # Python UserPreferenceViewSet 1:1 (status codes match doc/openapi.yaml: 200 / 204 /
+      # 404 unregistered-or-empty / 422 schema-invalid / 400 malformed body).
+      class UserPreferencesController < Habarico::ApplicationController
+        # GET user-preferences
+        def index
+          items = Habarico::Contrib::Preferences.get_values(user_scope).map { |resolved| Serializer.item(resolved) }
+          render json: items
+        end
+
+        # GET user-preferences/:key
+        def show
+          resolved = Habarico::Contrib::Preferences.get_value(user_scope, params[:key])
+          raise Eluvia::Errors::NotFound.new(not_found_message) if resolved.nil?
+
+          render json: Serializer.item(resolved)
+        rescue Habarico::Contrib::Preferences::PreferenceNotRegistered
+          raise Eluvia::Errors::NotFound.new(not_found_message)
+        end
+
+        # PUT user-preferences/:key
+        def update
+          resolved = Habarico::Contrib::Preferences.set_value(user_scope, params[:key], value_param)
+          render json: Serializer.item(resolved)
+        rescue Habarico::Contrib::Preferences::PreferenceNotRegistered
+          raise Eluvia::Errors::NotFound.new(not_found_message)
+        rescue Habarico::Contrib::Preferences::PreferenceValueTooLarge
+          raise Eluvia::Errors::UnprocessableEntity.new({ "value" => value_too_large_message })
+        rescue Habarico::Contrib::Preferences::TooManyPreferences
+          raise Eluvia::Errors::UnprocessableEntity.new({ "value" => too_many_preferences_message })
+        rescue Habarico::Contrib::Preferences::PreferenceValidationError
+          raise Eluvia::Errors::UnprocessableEntity.new({ "value" => invalid_value_message })
+        end
+
+        # DELETE user-preferences/:key
+        def destroy
+          Habarico::Contrib::Preferences.delete_value(user_scope, params[:key])
+          head :no_content
+        rescue Habarico::Contrib::Preferences::PreferenceNotRegistered
+          raise Eluvia::Errors::NotFound.new(not_found_message)
+        end
+
+        # DELETE user-preferences
+        def destroy_all
+          Habarico::Contrib::Preferences.delete_values(user_scope)
+          head :no_content
+        end
+
+        private
+
+        # The auth token subject, stored as a scalar (no DB foreign key).
+        def user_scope
+          current_user.id.to_s
+        end
+
+        # The raw request body IS the preference value (any JSON type: object, array or scalar),
+        # mirroring DRF's `request.data`. A malformed body is a 400 (matches openapi BadRequest).
+        def value_param
+          raw = request.raw_post
+          ensure_size_allowed!(raw)
+          return nil if raw.nil? || raw.empty?
+
+          JSON.parse(raw)
+        rescue JSON::ParserError
+          raise Eluvia::Errors::BadRequest.new("Malformed request body.")
+        end
+
+        # Refuses an oversized body before it is parsed - the key is in the URL, so its limit is
+        # known without looking at the body at all. The registry checks the parsed value as well;
+        # this only saves the parse of a body already known to be too big. Raises
+        # PreferenceNotRegistered for an unknown key, which `update` turns into the usual 404.
+        def ensure_size_allowed!(raw)
+          limit = Habarico::Contrib::Preferences.max_bytes_for(params[:key])
+          return if limit.nil? || raw.nil?
+
+          size = raw.bytesize
+          return if size <= limit
+
+          raise Habarico::Contrib::Preferences::PreferenceValueTooLarge.new(params[:key], limit, size)
+        end
+
+        def not_found_message
+          I18n.t("habarico.contrib.preferences.not_found", default: "Preference not found.")
+        end
+
+        def invalid_value_message
+          I18n.t("habarico.contrib.preferences.invalid_value", default: "Invalid value for preference.")
+        end
+
+        def value_too_large_message
+          I18n.t("habarico.contrib.preferences.value_too_large", default: "Preference value is too large.")
+        end
+
+        def too_many_preferences_message
+          I18n.t("habarico.contrib.preferences.too_many_preferences",
+                 default: "Too many preferences are stored for this user.")
+        end
+      end
+    end
+  end
+end

data/app/controllers/habarico/global_schema_controller.rb

@@ -0,0 +1,11 @@
+module Habarico
+  class GlobalSchemaController < ApplicationController
+
+    def index
+      # Prepare context and generate schema
+      context = Habarico::Context.new(current_user: current_user)
+      render json: Habarico::SchemaService.instance.get_global_schema(context).as_json.deep_compact(compactable: [nil, {}].freeze)
+    end
+
+  end
+end

data/app/controllers/habarico/local_schema_controller.rb

@@ -0,0 +1,35 @@
+module Habarico
+  class LocalSchemaController < ApplicationController
+
+    def index
+      # Path is something like this: /xxx/:resource_name/schema
+      resource_name = request.path.split('/')[-2]
+      raise Eluvia::Errors::BadRequest.new("Missing resource name in the request path.") unless resource_name
+
+      # Prepare context and generate schema
+      context = Habarico::Context.new(
+        current_user: current_user,
+        target: (JSON.parse(params['_target']) rescue {}).symbolize_keys,
+        source: (JSON.parse(params['_source']) rescue {}).symbolize_keys
+      )
+      render json: Habarico::SchemaService.instance.get_local_schema(resource_name, context).as_json.deep_compact(compactable: [nil, {}].freeze)
+    end
+
+    def show
+      # Path is something like this: /xxx/:resource_name/:id/schema
+      resource_name = request.path.split('/')[-3]
+      raise Eluvia::Errors::BadRequest.new("Missing resource name in the request path.") unless resource_name
+      raise Eluvia::Errors::BadRequest.new("Missing record PK in the request path.") unless params[:id]
+
+      # Prepare context and generate schema
+      context = Habarico::Context.new(
+        current_user: current_user,
+        record_pk: params[:id],
+        target: (JSON.parse(params['_target']) rescue {}).symbolize_keys,
+        source: (JSON.parse(params['_source']) rescue {}).symbolize_keys
+      )
+      render json: Habarico::SchemaService.instance.get_local_schema(resource_name, context).as_json.deep_compact(compactable: [nil, {}].freeze)
+    end
+
+  end
+end

data/app/helpers/habarico/application_helper.rb

@@ -0,0 +1,4 @@
+module Habarico
+  module ApplicationHelper
+  end
+end

data/app/models/habarico/application_record.rb

@@ -0,0 +1,5 @@
+module Habarico
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/views/layouts/habarico/application.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Habarico</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag    "habarico/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/locales/cs.yml

@@ -0,0 +1,39 @@
+cs:
+  # Default labels for Habarico's standard actions. Host apps override any key in
+  # their own config/locales (per-resource via `actions.<resource_path>.<action>`).
+  actions:
+    common:
+      show: "Detail"
+      create: "Vytvořit"
+      edit: "Upravit"
+      delete: "Smazat"
+      save: "Uložit"
+
+  # Default confirmation dialog for the standard delete action (delete_action.rb).
+  confirmations:
+    common:
+      delete:
+        title: "Opravdu chcete smazat záznam?"
+        message: "Tato akce způsobí ztrátu dat, které již nebude možné obnovit."
+
+  # Default label for the generic full-text search filter (search_filter_schema_generator.rb).
+  # Override per model via `activerecord.attributes.<model>.search`.
+  filters:
+    common:
+      search: "Hledat"
+
+  # Human-readable boolean labels used by the search highlighter (search_highlighter.rb) when a
+  # matched search field is a boolean column.
+  search:
+    "yes": "Ano"
+    "no": "Ne"
+
+  # Validation error messages for the order_by and filter query params (controller.rb). The
+  # `order_by` notation itself is validated by eluvia-base, which ships its own translations
+  # under `eluvia.errors.ordering` (HAB-915).
+  habarico:
+    errors:
+      order_by:
+        unknown_field: "Neznámý název pole."
+      filter:
+        unknown_term: "Neznámý filtrovací termín."

data/config/locales/de.yml

@@ -0,0 +1,39 @@
+de:
+  # Default labels for Habarico's standard actions. Host apps override any key in
+  # their own config/locales (per-resource via `actions.<resource_path>.<action>`).
+  actions:
+    common:
+      show: "Detail"
+      create: "Erstellen"
+      edit: "Bearbeiten"
+      delete: "Löschen"
+      save: "Speichern"
+
+  # Default confirmation dialog for the standard delete action (delete_action.rb).
+  confirmations:
+    common:
+      delete:
+        title: "Sind Sie sicher, dass Sie diesen Datensatz löschen möchten?"
+        message: "Diese Aktion führt zu einem Datenverlust, der nicht rückgängig gemacht werden kann."
+
+  # Default label for the generic full-text search filter (search_filter_schema_generator.rb).
+  # Override per model via `activerecord.attributes.<model>.search`.
+  filters:
+    common:
+      search: "Suchen"
+
+  # Human-readable boolean labels used by the search highlighter (search_highlighter.rb) when a
+  # matched search field is a boolean column.
+  search:
+    "yes": "Ja"
+    "no": "Nein"
+
+  # Validation error messages for the order_by and filter query params (controller.rb). The
+  # `order_by` notation itself is validated by eluvia-base, which ships its own translations
+  # under `eluvia.errors.ordering` (HAB-915).
+  habarico:
+    errors:
+      order_by:
+        unknown_field: "Unbekannter Feldname."
+      filter:
+        unknown_term: "Unbekannter Filterbegriff."

data/config/locales/en.yml

@@ -0,0 +1,39 @@
+en:
+  # Default labels for Habarico's standard actions. Host apps override any key in
+  # their own config/locales (per-resource via `actions.<resource_path>.<action>`).
+  actions:
+    common:
+      show: "Detail"
+      create: "Create"
+      edit: "Edit"
+      delete: "Delete"
+      save: "Save"
+
+  # Default confirmation dialog for the standard delete action (delete_action.rb).
+  confirmations:
+    common:
+      delete:
+        title: "Are you sure you want to delete this record?"
+        message: "This action will cause data loss that cannot be undone."
+
+  # Default label for the generic full-text search filter (search_filter_schema_generator.rb).
+  # Override per model via `activerecord.attributes.<model>.search`.
+  filters:
+    common:
+      search: "Search"
+
+  # Human-readable boolean labels used by the search highlighter (search_highlighter.rb) when a
+  # matched search field is a boolean column.
+  search:
+    "yes": "Yes"
+    "no": "No"
+
+  # Validation error messages for the order_by and filter query params (controller.rb). The
+  # `order_by` notation itself is validated by eluvia-base, which ships its own translations
+  # under `eluvia.errors.ordering` (HAB-915).
+  habarico:
+    errors:
+      order_by:
+        unknown_field: "Unknown field name."
+      filter:
+        unknown_term: "Unknown filter term."

data/config/locales/es.yml

@@ -0,0 +1,39 @@
+es:
+  # Default labels for Habarico's standard actions. Host apps override any key in
+  # their own config/locales (per-resource via `actions.<resource_path>.<action>`).
+  actions:
+    common:
+      show: "Detalle"
+      create: "Crear"
+      edit: "Editar"
+      delete: "Eliminar"
+      save: "Guardar"
+
+  # Default confirmation dialog for the standard delete action (delete_action.rb).
+  confirmations:
+    common:
+      delete:
+        title: "¿Está seguro de que desea eliminar este registro?"
+        message: "Esta acción provocará una pérdida de datos que no se podrá deshacer."
+
+  # Default label for the generic full-text search filter (search_filter_schema_generator.rb).
+  # Override per model via `activerecord.attributes.<model>.search`.
+  filters:
+    common:
+      search: "Buscar"
+
+  # Human-readable boolean labels used by the search highlighter (search_highlighter.rb) when a
+  # matched search field is a boolean column.
+  search:
+    "yes": "Sí"
+    "no": "No"
+
+  # Validation error messages for the order_by and filter query params (controller.rb). The
+  # `order_by` notation itself is validated by eluvia-base, which ships its own translations
+  # under `eluvia.errors.ordering` (HAB-915).
+  habarico:
+    errors:
+      order_by:
+        unknown_field: "Nombre de campo desconocido."
+      filter:
+        unknown_term: "Término de filtro desconocido."

data/config/locales/fr.yml

@@ -0,0 +1,39 @@
+fr:
+  # Default labels for Habarico's standard actions. Host apps override any key in
+  # their own config/locales (per-resource via `actions.<resource_path>.<action>`).
+  actions:
+    common:
+      show: "Détail"
+      create: "Créer"
+      edit: "Modifier"
+      delete: "Supprimer"
+      save: "Enregistrer"
+
+  # Default confirmation dialog for the standard delete action (delete_action.rb).
+  confirmations:
+    common:
+      delete:
+        title: "Êtes-vous sûr de vouloir supprimer cet enregistrement ?"
+        message: "Cette action entraînera une perte de données irréversible."
+
+  # Default label for the generic full-text search filter (search_filter_schema_generator.rb).
+  # Override per model via `activerecord.attributes.<model>.search`.
+  filters:
+    common:
+      search: "Rechercher"
+
+  # Human-readable boolean labels used by the search highlighter (search_highlighter.rb) when a
+  # matched search field is a boolean column.
+  search:
+    "yes": "Oui"
+    "no": "Non"
+
+  # Validation error messages for the order_by and filter query params (controller.rb). The
+  # `order_by` notation itself is validated by eluvia-base, which ships its own translations
+  # under `eluvia.errors.ordering` (HAB-915).
+  habarico:
+    errors:
+      order_by:
+        unknown_field: "Nom de champ inconnu."
+      filter:
+        unknown_term: "Terme de filtre inconnu."

data/config/locales/it.yml

@@ -0,0 +1,39 @@
+it:
+  # Default labels for Habarico's standard actions. Host apps override any key in
+  # their own config/locales (per-resource via `actions.<resource_path>.<action>`).
+  actions:
+    common:
+      show: "Dettaglio"
+      create: "Crea"
+      edit: "Modifica"
+      delete: "Elimina"
+      save: "Salva"
+
+  # Default confirmation dialog for the standard delete action (delete_action.rb).
+  confirmations:
+    common:
+      delete:
+        title: "Sei sicuro di voler eliminare questo record?"
+        message: "Questa azione causerà una perdita di dati che non potrà essere annullata."
+
+  # Default label for the generic full-text search filter (search_filter_schema_generator.rb).
+  # Override per model via `activerecord.attributes.<model>.search`.
+  filters:
+    common:
+      search: "Cerca"
+
+  # Human-readable boolean labels used by the search highlighter (search_highlighter.rb) when a
+  # matched search field is a boolean column.
+  search:
+    "yes": "Sì"
+    "no": "No"
+
+  # Validation error messages for the order_by and filter query params (controller.rb). The
+  # `order_by` notation itself is validated by eluvia-base, which ships its own translations
+  # under `eluvia.errors.ordering` (HAB-915).
+  habarico:
+    errors:
+      order_by:
+        unknown_field: "Nome campo sconosciuto."
+      filter:
+        unknown_term: "Termine di filtro sconosciuto."

data/config/locales/ja.yml

@@ -0,0 +1,39 @@
+ja:
+  # Default labels for Habarico's standard actions. Host apps override any key in
+  # their own config/locales (per-resource via `actions.<resource_path>.<action>`).
+  actions:
+    common:
+      show: "詳細"
+      create: "作成"
+      edit: "編集"
+      delete: "削除"
+      save: "保存"
+
+  # Default confirmation dialog for the standard delete action (delete_action.rb).
+  confirmations:
+    common:
+      delete:
+        title: "このレコードを削除してもよろしいですか?"
+        message: "この操作を行うと、元に戻せないデータ損失が発生します。"
+
+  # Default label for the generic full-text search filter (search_filter_schema_generator.rb).
+  # Override per model via `activerecord.attributes.<model>.search`.
+  filters:
+    common:
+      search: "検索"
+
+  # Human-readable boolean labels used by the search highlighter (search_highlighter.rb) when a
+  # matched search field is a boolean column.
+  search:
+    "yes": "はい"
+    "no": "いいえ"
+
+  # Validation error messages for the order_by and filter query params (controller.rb). The
+  # `order_by` notation itself is validated by eluvia-base, which ships its own translations
+  # under `eluvia.errors.ordering` (HAB-915).
+  habarico:
+    errors:
+      order_by:
+        unknown_field: "不明なフィールド名です。"
+      filter:
+        unknown_term: "不明なフィルター項目です。"