agile_rails 0.0.0.1

data/app/models/agile_form_fields/text_autocomplete.rb

@@ -0,0 +1,171 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# 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.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of text_autocomplete AgileRails form field.
+# 
+# ===Form options:
+# * +name:+ field name (required)
+# * +type:+ text_autocomplete (required)
+# * +table+ Collection (table) name. When defined search must contain field name
+# * +with_new+ Will add an icon for shortcut to add new document to related collection
+# * +with_edit+ Will add an icon for shortcut to edit (view) related document
+# * +is_id+ Field value represent value as id. If false, field will use entered value and not value selected with autocomplete. Default is true.
+# * +search:+ Search may consist of three parameters from which are separated either by dot (.) 
+#   * search_field_name; when table option is defined search must define field name which will be used for search query
+#   * collection_name.search_field_name; Same as above except that table options must be ommited.
+#   * collection_name.search_field_name.method_name; When searching is more complex custom search
+#   method may be defined in CollectionName model which will provide dataset for search.
+# 
+# Form example:
+#    10:
+#      name: user_id
+#      type: text_autocomplete
+#      search: ar_user.name
+#      is_id: false
+#      size: 30
+#      with_new: user
+#      with_edit: user
+###########################################################################
+class TextAutocomplete < AgileFormField
+ 
+###########################################################################
+# Render text_autocomplete AgileRails form field code
+###########################################################################
+def render
+  # Return descriptive text and put it into input field
+  # search field name
+  if @yaml['search'].class.to_s == 'Hash'
+    table    = @yaml['search']['table']
+    ret_name = @yaml['search']['field']
+    method   = @yaml['search']['method']
+  elsif @yaml['search'].match(/\.|\,| /)
+    table, ret_name, method = @yaml['search'].split(/\.|\,| /).map(&:strip)
+  else
+    ret_name = @yaml['search']
+  end
+  # determine table name
+  if @yaml['table']
+    table = if @yaml['table'].is_a?(String)
+      @yaml['table']
+    elsif @yaml['table']['eval']
+      eval @yaml['table']['eval']
+    else
+      Rails.logger.error "Field #{ @yaml['name'] }: Invalid table parameter!"
+      nil
+    end
+  end
+  return ro_standard 'Table or field keyword not defined!' unless (table && ret_name)
+  # TODO check if table exists
+  model_klass = table.classify.constantize
+  # find record and return value of field
+  value_send_as = 'p_' + @yaml['name']
+  value = if @env.params[value_send_as]
+            @env.params[value_send_as]
+          elsif @record && @record[@yaml['name']]
+            @record[@yaml['name']]
+          end
+  not_id = @env.agile_dont?(@yaml['is_id'], false)
+
+  # Found value to be written in field. If field is not found write out value.
+  value_displayed = value
+  if value && !not_id
+    if value.class == Integer
+      record = model_klass.find(value)
+      value_displayed = record.send(ret_name) if record
+    else
+      value_displayed = model_klass.send(ret_name, method, @env, value)
+    end
+  end
+  return ro_standard(value_displayed) if @readonly
+
+  # Add method back, so autocomplete will know that it must search for method inside class
+  ret_name = "#{ret_name}.#{method}" if method
+  @yaml['html'] ||= {}
+  @yaml['html']['value'] = value_displayed
+  @yaml['html']['placeholder'] ||= t('agile.search_placeholder') || nil
+
+  _name = '_' + @yaml['name']
+  record = record_text_for(@yaml['name'])  
+  @html += '<span class="ar-text-autocomplete">' + @env.text_field(record, _name, @yaml['html']) + '<span></span>'
+  # with new icon
+  if @yaml['with_new'] && !@readonly
+    @html += ' ' + @env.mi_icon('plus-square-o', class: 'in-edit-add', title: t('agile.new'),
+             style: "vertical-align: top;", 'data-table' => @yaml['with_new'] )
+  end
+  # with edit icon
+  if @yaml['with_edit'] && @record && @record[@yaml['name']].present? && !@readonly
+    @html += ' ' + @env.mi_icon('edit-o', class: 'in-edit-add', title: t('agile.edit'),
+             style: "vertical-align: top;", 'data-table' => @yaml['with_edit'], 'data-id' => @record[@yaml['name']] )
+  end
+  @html += '</span>' + @env.hidden_field(record, @yaml['name'], value: value) # actual value will be in hidden field
+
+  # JS stuff
+  # allow unselected values on is_id: false option
+  not_id_code = %(
+if (ui.item == null) {  
+$("##{record}_#{@yaml['name']}").val($("##{record}__#{@yaml['name']}").val() );
+return;
+} ) if not_id
+
+  @js = <<EOJS
+$(document).ready(function() {
+  $("##{record}_#{_name}").autocomplete( {
+    source: function(request, response) {
+      $.ajax({
+        url: "/agile/autocomplete",
+        type: "POST",
+        dataType: "json",
+        data: { input: request.term, table: "#{table}", search: "#{ret_name}" #{(',id: "'+@yaml['id'] + '"') if @yaml['id']} },
+        success: function(data) {
+          response( $.map( data, function(key) {
+            return key;
+          }));
+        }
+      });
+    },
+
+    change: function (event, ui) { 
+      #{not_id_code}
+      if (ui.item == null) return;
+      $("##{record}_#{@yaml['name']}").val(ui.item.id).trigger('change');
+    },
+
+    minLength: 2
+  });
+});
+EOJS
+    
+  self 
+end
+
+###########################################################################
+# Return value. Return nil if input field is empty
+###########################################################################
+def self.get_data(params, name)
+  params['record']["_#{name}"].blank? ? nil : params['record'][name]
+end
+
+end
+end

data/app/models/agile_form_fields/text_field.rb

@@ -0,0 +1,55 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# 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.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of text_field AgileRails form field.
+# 
+# ===Form options:
+# * +type:+ text_field (required)
+# * +name:+ Field name (required) 
+# * +html:+ html options which apply to text_field field (optional)
+# 
+# Form example:
+#    10:
+#      name: title
+#      type: text_field
+#      size: 30
+#      html:
+#        required: yes
+###########################################################################
+class TextField < AgileFormField
+  
+###########################################################################
+# Render text_field AgileRails form field code
+###########################################################################
+def render
+  set_initial_value
+
+  record = record_text_for(@yaml['name'])
+  @html += @env.text_field( record, @yaml['name'], @yaml['html'])
+  self
+end
+
+end
+end

data/app/models/agile_form_fields/text_with_select.rb

@@ -0,0 +1,94 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# 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.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of text_with_select AgileRails form field. Field will provide
+# text_field entry field with select dropdown box with optional values for the field.
+# Form options are mostly same as in select field. 
+# 
+# ===Form options:
+# * +name:+ field name (required)
+# * +type:+ text_with_select (required)
+# * +choices:+ Values for choices separated by comma. Values can also be specified like description:value.
+# In this case description will be shown to user, but value will be saved to document.
+#   choices: 'OK:0,Ready:1,Error:2'
+#   choices: Ruby,Pyton,PHP
+# * +choices: eval+ Choices will be provided by evaluating expression
+#   choices: eval agile_choices_for('model_name','description_field_name','_id'); agile_choices_for helper will provide data for select field.
+#   choices: eval ModelName.choices_for_field; ModelName class will define method choices_for_field which
+#   will provide data for select field. Since expression is evaluated in the context of Form Field object
+# Even session session variables can be accessed. 
+#   choices: eval MyClass.method(@env.session[:user_id])
+# When searching is more complex custom search method may be defined in CollectionName 
+# model which will provide dataset for search.
+#   choices: eval collection_name.search_field_name.method_name;
+# If choices or eval is not defined choices will be provided from translation helpers. For example: 
+# Collection has field status. Choices for field will be provided by en.helpers.model_name.choices_for_status 
+# entry of english translation. English is of course default translation. If you provide translations in
+# your local language then select choices will be localized.
+#   en.helpers.model_name.choices_for_status: 'OK:0,Ready:1,Error:2'
+#   sl.helpers.model_name.choices_for_status: 'V redu:0,Pripravljen:1,Napaka:2'
+# * +html:+ html options which apply to select and text_field fields (optional)
+# 
+# Form example:
+#    10:
+#      name: link
+#      type: text_with_select
+#      choices: eval @env.agile_page_class.all_pages_for_site(@env.agile_get_site)
+#      size: 50
+###########################################################################
+class TextWithSelect < Select
+
+###########################################################################
+# Render text_with_select AgileRails form field code
+###########################################################################
+def render
+  set_initial_value('html','value')
+  
+  record = record_text_for(@yaml['name'])
+  @html += @env.text_field( record, @yaml['name'], @yaml['html'])
+  @yaml['html']['class'] ||= ''
+  @yaml['html']['class'] +=  ' text-with-select'
+  @yaml['html'].symbolize_keys!
+  unless @readonly
+    @html += @env.select( @yaml['name'] + '_', nil, get_choices, { include_blank: true }, { class: 'text-with-select' })
+  end
+
+  # javascript to update text field if new value is selected in select field
+  @js =<<EOJS
+$(document).ready(function() {
+ $('##{@yaml['name']}_').change( function() {
+  if ($(this).val().toString().length > 0) {
+    $('##{record}_#{@yaml['name']}').val( $(this).val() );
+    $('##{record}_#{@yaml['name']}').trigger("change");
+  }
+  $('##{record}_#{@yaml['name']}').focus();
+ });
+});
+EOJS
+  self
+end
+
+end
+end

data/app/models/agile_form_fields/tree_select.rb

@@ -0,0 +1,170 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# 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.
+#+
+module AgileFormFields
+
+###########################################################################
+# Implementation of tree_select AgileRails form field. Field will provides
+# multiple select functionality displayed as a tree. Might be used for selecting
+# multiple categories in a env-child tree view.# 
+# 
+# ===Form options:
+# * +name:+ field name (required)
+# * +type:+ tree_select (required)
+# * +choices:+ Values for choices separated by comma. Values can also be specified like description:value.
+# In this case description will be shown to user, but value will be saved to document.
+#   choices: 'OK:0,Ready:1,Error:2'
+#   choices: Ruby,Pyton,PHP
+# * +eval:+ Choices will be provided by evaluating expression
+#   choices: eval ModelName.choices_for_field; Model class should define method which will provide data for field.
+#   Data returned must be of type Array and have 3 elements.
+#   1 - description text
+#   2 - id values separated by ;
+#   3 - parent id
+#   4 - order
+# * +html:+ html options which apply to select and text_field fields (optional)
+# 
+# Form example:
+#    10:
+#      name: categories
+#      type: tree_select
+#      choices: eval Categories.all_categories
+#      multiple: true
+#      parent_disabled: false
+#      parent_opened: false
+#      size: 50x10
+###########################################################################
+class TreeSelect < Select
+
+###########################################################################
+# Prepare choices for AgileRails form field rendering.
+###########################################################################
+def make_tree(parent)
+  return '' unless @choices[parent.to_s]
+
+  @html += '<ul>'
+  choices = if @choices[parent.to_s].first[3] != 0
+              @choices[parent.to_s].sort_by { _1[3].to_i } # sort by order if first is not 0
+            else
+              #@choices[parent.to_s].sort_alphabetical_by(&:first) # use UTF-8 sort
+              @choices[parent.to_s].sort_by(&:first)
+            end
+  choices.each do |choice|
+    data = [%("selected" : #{choice.last ? 'true' : 'false'} )]
+    # only for parent objects
+    if @choices[ choice[1].to_s ]
+      # parent is not selectable
+      data += '"disabled" : true' unless @env.agile_dont?(@yaml['parent_disabled'], true)
+      # parents are opened on start
+      data += '"opened" : true' unless @env.agile_dont?(@yaml['parent_opened'], true)
+    end
+    # data-jstree must be singe quoted
+    @html += %(<li data-id="#{choice[1]}" data-jstree='{#{data.join(' , ')}}'>#{choice.first}\n)
+    # call recursively for children     
+    make_tree(choice[1]) if @choices[choice[1].to_s]
+    @html += '</li>'
+  end
+  @html + '</ul>'
+end
+
+###########################################################################
+# Render tree_select field html code
+###########################################################################
+def render
+  set_initial_value('html','value')
+  record = record_text_for(@yaml['name'])
+  clas   = 'tree-select' + (@readonly ? ' ar-readonly' : '')
+  @html += %(<div id="#{@yaml['name']}" class="#{clas}" #{set_style()} >)
+
+  # Create @choices hash. The key is parent object id
+  @choices = {}
+  choices_in_eval(@yaml['choices']).each do |data|
+    @choices[ data[2].to_s ] ||= [] 
+    @choices[ data[2].to_s ] << (data << false)
+  end
+  # Set last element of hash to true when selected. To speed up selection when there is a lot of items
+  current_values = {}
+  current = @record.send(@yaml['name']) || []
+  current = [current] unless current.is_a?(Array) # non array fields
+  current.each { |e| current_values[e.to_s] = true }
+
+  # set third element of @choices when selected
+  @choices.keys.each do |key|
+    0.upto( @choices[key].size - 1 ) do |i|
+      choice = @choices[key][i]
+      choice[choice.size - 1] = true if current_values[ choice[1].to_s ]
+    end
+  end
+  make_tree(nil)
+  @html += '</div>'
+  # add hidden communication field
+  @html += @env.hidden_field(record, @yaml['name'], value: current.join(','))
+  # save multiple indicator for data processing on return
+  @html += @env.hidden_field(record, "#{@yaml['name']}_multiple", value: 1) if @yaml['multiple']
+  # javascript to update hidden record field when tree looses focus
+  readonly_code = %(
+,
+"conditionalselect" : function (node) {
+return false; }
+)
+
+  @js =<<~EOJS
+    $(function(){
+      $("##{@yaml['name']}").jstree( {
+        "checkbox" : {"three_state" : false},
+        "core" : { "themes" : { "icons": false },
+                   "multiple" : #{@yaml['multiple'] ? 'true' : 'false'}  },
+        "plugins" : ["checkbox", "conditionalselect"]
+        #{@readonly ? readonly_code : ''}
+      });
+    });
+
+    $(document).ready(function() {
+      $('##{@yaml['name']}').on('focusout', function(e) {
+        var checked_ids = [];
+        var checked = $('##{@yaml['name']}').jstree("get_checked", true);
+        $.each(checked, function() {
+          checked_ids.push( this.data.id );
+        });
+        $('#record_#{@yaml['name']}').val( checked_ids.join(",") );
+      });
+    });
+  EOJS
+  self
+end
+
+###########################################################################
+# Return value. Return nil if input field is empty
+###########################################################################
+def self.get_data(params, name)
+  return nil if params['record'][name].blank?
+
+  result = params['record'][name].split(',')
+  result.delete_if(&:blank?)
+  return nil if result.size == 0
+
+  # return only first element if multiple values select was not allowed
+  params['record']["#{name}_multiple"] == '1' ? result : result.first  
+end
+
+end
+end

data/app/models/ar_big_table.rb

@@ -0,0 +1,82 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# 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.
+#+
+
+##########################################################################
+# == Schema information
+#
+# Table name: ar_big_table : Big Table
+#
+#  id                 Integer           id
+#  created_at           Time                 created_at
+#  updated_at           Time                 updated_at
+#  key                  String               Key (ident) used to retrieve key/values
+#  description          String               description
+#  site_id              Integer       Data will be used only for defined site. If empty, then it is default for all sites in database.
+#  active               Boolean     This key is active
+#  created_by           Integer       created_by
+#  updated_by           Integer       updated_by
+#  ar_big_table_values  Embedded: ArBigTableValue Values defined by this key
+#   
+# Big table is meant to be a common space for defining default choices for select fields on forms. 
+# Documents are organized as key-value pair with the difference that values for the key can 
+# be defined for each site and can also be localized.
+# 
+# Usage (as used in forms):
+# 
+# In the example administrator may help user by providing values that can be used 
+# on ArAd document position field by defining them in ads-position key of big table.
+# Example is from ar_ads.yml form.
+# 
+#    10:
+#      name: position
+#      type: text_with_select
+#      eval: ar_big_table 'ads-positions'
+#      size: 20
+#        
+##########################################################################
+class ArBigTable < ApplicationRecord
+
+has_many :ar_big_table_values
+
+validates :key,         presence: true
+validates :description, presence: true
+
+########################################################################
+# Will return possible choices for specified key prepared for usage in select input field.
+########################################################################
+def self.choices_for(key, site = nil, locale = nil)
+  result = []
+  data = find_by(key: key, site_id: site)
+  data ||= find_by(key: key, site_id: nil) if site
+  if data
+    data.ar_big_table_values.order(description: 'asc').each do |one_value|
+      next unless one_value.active
+
+      description = one_value.get_localized_description(locale)
+      result << [description, one_value.value]
+    end
+  end
+  result.empty? ? [nil] : result
+end
+
+end

data/app/models/ar_big_table_value.rb

@@ -0,0 +1,53 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# 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.
+#+
+
+#####################################################################
+# == Schema information
+#
+# Table name: ar_big_table_value : Big Table - values
+#
+#  id                  Integer        id
+#  created_at           Time          created_at
+#  updated_at           Time          updated_at
+#  value                String        Value to be returned
+#  locales              String        Translations written in YAML as en: English
+#                                                                     sl: Slovensko
+#  active               Boolean       Is Active
+#  created_by           Integer       created_by
+#  updated_by           Integer       updated_by
+#  ar_big_table_id      Integer
+#
+# Documents are embedded in ArBigTable document. Every value defined has its own description,
+# which can further be translated in embedded ArBigTableLocale documents.
+#####################################################################
+class ArBigTableValue < ApplicationRecord
+belongs_to :ar_big_table
+
+validates :value, presence: true
+
+def get_localized_description(locale = I18n.locale.to_s)
+  hash = YAML.load(locales) rescue {}
+  hash&.dig(locale) || (description.blank? ? value : description)
+end
+
+end