unidom-category 1.6.6 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 288af343565aecbe82a1a407b826dbca5bb06479
-  data.tar.gz: 8f4ad8b60a1413f0b4208fa45a4d6d5b258e5bd3
+SHA256:
+  metadata.gz: f47f7dac9883328a8746f8f3f699eaaa7fdde0e4b5a7145e60cc2e146fd56483
+  data.tar.gz: e2e005009371483e95c018661e2117f863a2d54726c452d39f79923712fbe351
 SHA512:
-  metadata.gz: 3e4d56692789e12a9fee0e8ee3584c3115adbcd54bd8886454ab8bb9d0d6bc677bc312a59cde45c364d150ba8bb4bb89468c2e57b46ac63a15dbc5876562d75b
-  data.tar.gz: 296807f713273f5562411ed6981def77baf38b53162f59adf7ab8d0e321d084df2845197f93128a1ad1e528f0cd57004c57819ac85ba7bb8a08121adc6fd0121
+  metadata.gz: e72b79a725ebcf6e5f343602fc053fdfc0919f9b5fd91541584ee2f9b2eb638556fbddaf4e0e6a00d15f6c34d0bd2076d7cab6752294bb150b6df19138bca3d6
+  data.tar.gz: 3601009f81beb1e289baec9f4549b588b3168cd8f84ca7d2871bab5df3dd4e366e3759e6c70d64ded6c0c3a14d5947fa206e86321f2682eb88dc69a7a1981caf

data/README.md

@@ -62,31 +62,42 @@ include Unidom::Category::Concerns::AsDescendantCategory
 
 The As Category concern do the following tasks for the includer automatically:
 1. Define the has_many :categorizings macro as: ``has_many :categorizings, class_name: 'Category::Categorizing'``
+
 2. Define the #categorize! method as: ``categorize!(categorized, at: Time.now, primary: true)``
+
 3. Define the #categorize? method as: ``categorize?(categorized, at: Time.now, primary: true)``
 
 ### As Categorized concern
 
 The As Categorized concern do the following tasks for the includer automatically:
 1. Define the has_many :categorizings macro as: ``has_many :categorizings, class_name: 'Unidom::Category::Categorizing', as: :categorized``
+
 2. Define the has_many :categories macro as: ``has_many :categories, through: :categorizings, source: :category``
+
 3. Define the #is_categorized! method as: ``is_categorized!(into: nil, at: Time.now, primary: true)``
+
 4. Define the #is_categorized? method as: ``is_categorized?(into: nil, at: Time.now, primary: true)``
 
 ### As Ancestor Category concern
 
 The As Ancestor Category concern do the following tasks for the includer automatically:
 1. Define the has_many :descendant_category_rollups macro as: ``has_many :descendant_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :ancestor_category_id, source: :ancestor_category``
+
 2. Define the has_many :descendant_categories macro as: ``has_many :descendant_categories, class_name: 'Unidom::Category::Category', through: :descendant_category_rollups``
+
 3. Define the #roll_up! method as: ``roll_up!(it, at: Time.now, primary: true)``
+
 4. Define the #roll_up? method as: ``roll_up?(it, at: Time.now, primary: true)``
 
 ### As Descendant Category concern
 
 The As Descendant Category concern do the following tasks for the includer automatically:
 1. Define the has_many :ancestor_category_rollups macro as: ``has_many :ancestor_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :descendant_category_id, source: :descendant_category``
+
 2. Define the has_many :ancestor_categories macro as: ``has_many :ancestor_categories, class_name: 'Unidom::Category::Category', through: :ancestor_category_rollups``
+
 3. Define the #is_rolled_up! as: ``is_rolled_up!(it, at: Time.now, primary: true)``
+
 4. Define the #is_rolled_up? as: ``is_rolled_up?(it, at: Time.now, primary: true)``
 
 
@@ -109,6 +120,8 @@ end
 
 ## RSpec examples
 
+### RSpec example manifest (run automatically)
+
 ```ruby
 # spec/models/unidom_spec.rb
 require 'unidom/category/models_rspec'
@@ -119,3 +132,35 @@ require 'unidom/category/types_rspec'
 # spec/validators/unidom_spec.rb
 require 'unidom/category/validators_rspec'
 ```
+
+### RSpec shared examples (to be integrated)
+
+```ruby
+# spec/support/unidom_rspec_shared_examples.rb
+require 'unidom/category/rspec_shared_examples'
+
+# spec/models/unidom/category/categorizing_spec.rb
+describe Unidom::Category::Categorizing, type: :model do
+
+  before :each do
+  end
+
+  after :each do
+  end
+
+  context do
+
+    model_attributes = {}
+
+    categorized = Unidom::Product::Product.create! name: 'Model X', abbreviation: 'MX', packing_norm: 'car', measurement_unit: 'car', opened_at: Time.now
+
+    tesla    = Unidom::Party::Company.create!           name:   'Tesla'
+    scheme   = Unidom::Category::CategoryScheme.create! owner:  tesla,  name: 'eCar'
+    category = Unidom::Category::Category.create!       scheme: scheme, name: 'Battery-powered vehicles'
+
+    it_behaves_like 'Unidom::Category::Categorizing', model_attributes, categorized, category
+
+  end
+
+end
+```

data/app/controllers/unidom/category/application_controller.rb

@@ -1,6 +1,12 @@
 ##
 # Application controller 是模块内所有控制器的基类。
 
-class Unidom::Category::ApplicationController < ActionController::Base
-  protect_from_forgery with: :exception
+module Unidom
+  module Category
+
+    class ApplicationController < ActionController::Base
+      protect_from_forgery with: :exception
+    end
+
+  end
 end

data/app/helpers/unidom/category/application_helper.rb

@@ -1,2 +1,8 @@
-module Unidom::Category::ApplicationHelper
+module Unidom
+  module Category
+
+    module ApplicationHelper
+    end
+
+  end
 end

data/app/jobs/unidom/category/application_job.rb

@@ -1,5 +1,11 @@
 ##
 # Application job 是模块内所有异步任务的基类。
 
-class Unidom::Category::ApplicationJob < ActiveJob::Base
+module Unidom
+  module Category
+
+    class ApplicationJob < ActiveJob::Base
+    end
+
+  end
 end

data/app/mailers/unidom/category/application_mailer.rb

@@ -1,7 +1,13 @@
 ##
 # Application mailer 是模块内所有电子邮件发送类的基类。
 
-class Unidom::Category::ApplicationMailer < ActionMailer::Base
-  default from: 'from@example.com'
-  layout 'mailer'
+module Unidom
+  module Category
+
+    class ApplicationMailer < ActionMailer::Base
+      default from: 'from@example.com'
+      layout 'mailer'
+    end
+
+  end
 end

data/app/models/unidom/category/application_record.rb

@@ -1,6 +1,12 @@
 ##
 # Application record 是模块内所有模型的抽象基类。
 
-class Unidom::Category::ApplicationRecord < ActiveRecord::Base
-  self.abstract_class = true
+module Unidom
+  module Category
+
+    class ApplicationRecord < ActiveRecord::Base
+      self.abstract_class = true
+    end
+
+  end
 end

data/app/models/unidom/category/categorizing.rb

@@ -1,20 +1,32 @@
 ##
 # Categorizing 是分类（category）和被分类项（categorized）之间的关联关系。
 
-class Unidom::Category::Categorizing < Unidom::Category::ApplicationRecord
+module Unidom
+  module Category
 
-  self.table_name = 'unidom_categorizings'
+    class Categorizing < ApplicationRecord
 
-  include Unidom::Common::Concerns::ModelExtension
+      self.table_name = 'unidom_categorizings'
 
-  belongs_to :category,    class_name:  'Unidom::Category::Category'
-  belongs_to :categorized, polymorphic: true
+      include Unidom::Common::Concerns::ModelExtension
 
-  scope :category_is,    ->(category)    { where category_id: to_id(category) }
-  scope :categorized_is, ->(categorized) { where categorized: categorized     }
+      belongs_to :category,    class_name:  'Unidom::Category::Category'
+      belongs_to :categorized, polymorphic: true
 
-  def self.categorize!(categorized, into: nil, at: Time.now)
-    categorized_is(categorized).category_is(into).valid_at.alive.first_or_create! elemental: true, opened_at: at
-  end
+      scope :category_is,    ->(category)    { where category_id: to_id(category) }
+      scope :categorized_is, ->(categorized) { where categorized: categorized     }
+
+      def self.categorize!(categorized, into: nil, at: Time.now)
+
+        assert_present! :categorized, categorized
+        assert_present! :into,        into
+        assert_present! :at,          at
+
+        categorized_is(categorized).category_is(into).valid_at.alive.first_or_create! elemental: true, opened_at: at
 
-end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::Categorizing'
+      end
+
+    end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::Categorizing'
+
+  end
+end

data/app/models/unidom/category/category.rb

@@ -1,22 +1,28 @@
 ##
 # Category 是分类。
 
-class Unidom::Category::Category < Unidom::Category::ApplicationRecord
+module Unidom
+  module Category
 
-  self.table_name = 'unidom_categories'
+    class Category < ApplicationRecord
 
-  include Unidom::Common::Concerns::ModelExtension
-  include Unidom::Category::Concerns::AsCategory
-  include Unidom::Category::Concerns::AsAncestorCategory
-  include Unidom::Category::Concerns::AsDescendantCategory
+      self.table_name = 'unidom_categories'
 
-  validates :name,         presence:    true, length: { in: 2..self.columns_hash['name'].limit         }
-  validates :abbreviation, allow_blank: true, length: { in: 2..self.columns_hash['abbreviation'].limit }
+      include Unidom::Common::Concerns::ModelExtension
+      include Unidom::Category::Concerns::AsCategory
+      include Unidom::Category::Concerns::AsAncestorCategory
+      include Unidom::Category::Concerns::AsDescendantCategory
 
-  belongs_to :scheme, class_name: 'Unidom::Category::CategoryScheme', foreign_key: :scheme_id
+      validates :name,         presence:    true, length: { in: 2..self.columns_hash['name'].limit         }
+      validates :abbreviation, allow_blank: true, length: { in: 2..self.columns_hash['abbreviation'].limit }
 
-  scope :scheme_is,          ->(scheme) { where scheme_id: to_id(scheme)                                      }
-  scope :code_length_is,     ->(length) { where 'LENGTH(code) = :code_length',  code_length:       length     }
-  scope :code_starting_with, ->(prefix) { where 'code LIKE :prefix_expression', prefix_expression: prefix+'%' }
+      belongs_to :scheme, class_name: 'Unidom::Category::CategoryScheme', foreign_key: :scheme_id
 
-end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::Category'
+      scope :scheme_is,          ->(scheme) { where scheme_id: to_id(scheme)                                      }
+      scope :code_length_is,     ->(length) { where 'LENGTH(code) = :code_length',  code_length:       length     }
+      scope :code_starting_with, ->(prefix) { where 'code LIKE :prefix_expression', prefix_expression: prefix+'%' }
+
+    end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::Category'
+
+  end
+end

data/app/models/unidom/category/category_rollup.rb

@@ -1,39 +1,51 @@
 ##
 # Category Rollup 是分类的层级关系。
 
-class Unidom::Category::CategoryRollup < Unidom::Category::ApplicationRecord
+module Unidom
+  module Category
 
-  self.table_name = 'unidom_category_rollups'
+    class CategoryRollup < ApplicationRecord
 
-  include Unidom::Common::Concerns::ModelExtension
+      self.table_name = 'unidom_category_rollups'
 
-  validates :distance, presence: true, numericality: { integer_only: true, greater_than: 0 }
+      include Unidom::Common::Concerns::ModelExtension
 
-  belongs_to :ancestor_category,   class_name: 'Unidom::Category::Category'
-  belongs_to :descendant_category, class_name: 'Unidom::Category::Category'
+      validates :distance, presence: true, numericality: { integer_only: true, greater_than: 0 }
 
-  scope :apart, ->(distance = 1) { where distance: distance }
+      belongs_to :ancestor_category,   class_name: 'Unidom::Category::Category'
+      belongs_to :descendant_category, class_name: 'Unidom::Category::Category'
 
-  scope :ancestor_category_is,   ->(category) { where ancestor_category_id:   to_id(category) }
-  scope :descendant_category_is, ->(category) { where descendant_category_id: to_id(category) }
+      scope :apart, ->(distance = 1) { where distance: distance }
 
-  after_create ->(record) {
-    return unless 1==record.distance
-    ancestor_category = record.ancestor_category_id
-    ancestor_category_rollups_1 = self.class.descendant_category_is(record.ancestor_category_id).alive
-    ancestor_category_rollups_1.each do |ancestor_category_rollup|
-      self.class.apart(1+ancestor_category_rollup.distance).
-        ancestor_category_is(ancestor_category_rollup.ancestor_category_id).
-        descendant_category_is(record.descendant_category_id).
-        first_or_create! elemental: ancestor_category_rollup.elemental, from_date: ancestor_category_rollup.from_date
-    end
-  }
+      scope :ancestor_category_is,   ->(category) { where ancestor_category_id:   to_id(category) }
+      scope :descendant_category_is, ->(category) { where descendant_category_id: to_id(category) }
 
-  ##
-  # 将 it 归为 into 的下级分类，时间是 at ，缺省为当前时间。如：
-  # Unidom::Category::CategoryRollup.roll_up! moto, into: vehicle
-  def self.roll_up!(it, into: nil, at: Time.now)
-    self.descendant_category_is(it).ancestor_category_is(into).valid_at(now: at).alive.first_or_create! opened_at: at
-  end
+      after_create ->(record) {
+        return unless 1==record.distance
+        ancestor_category = record.ancestor_category_id
+        ancestor_category_rollups_1 = self.class.descendant_category_is(record.ancestor_category_id).alive
+        ancestor_category_rollups_1.each do |ancestor_category_rollup|
+          self.class.apart(1+ancestor_category_rollup.distance).
+            ancestor_category_is(ancestor_category_rollup.ancestor_category_id).
+            descendant_category_is(record.descendant_category_id).
+            first_or_create! elemental: ancestor_category_rollup.elemental, from_date: ancestor_category_rollup.from_date
+        end
+      }
+
+      ##
+      # 将 it 归为 into 的下级分类，时间是 at ，缺省为当前时间。如：
+      # Unidom::Category::CategoryRollup.roll_up! moto, into: vehicle
+      def self.roll_up!(it, into: nil, at: Time.now)
+
+        assert_present! :it,   it
+        assert_present! :into, into
+        assert_present! :at,   at
+
+        self.descendant_category_is(it).ancestor_category_is(into).valid_at(now: at).alive.first_or_create! opened_at: at
 
-end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::CategoryRollup'
+      end
+
+    end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::CategoryRollup'
+
+  end
+end

data/app/models/unidom/category/category_scheme.rb

@@ -2,17 +2,23 @@
 # Category Scheme 是分类体系。
 # 所有者（owner）可以是系统（System）、标准（Standard）、或者某个参与者（Party，如：Person、Shop、Company）。
 
-class Unidom::Category::CategoryScheme < Unidom::Category::ApplicationRecord
+module Unidom
+  module Category
 
-  self.table_name = 'unidom_category_schemes'
+    class CategoryScheme < ApplicationRecord
 
-  include Unidom::Common::Concerns::ModelExtension
+      self.table_name = 'unidom_category_schemes'
 
-  belongs_to :owner,      polymorphic: true
-  has_many   :categories, class_name: 'Unidom::Category::Category', foreign_key: :scheme_id
+      include Unidom::Common::Concerns::ModelExtension
 
-  validates :name, presence: true, length: { in: 2..self.columns_hash['name'].limit }
+      belongs_to :owner,      polymorphic: true
+      has_many   :categories, class_name: 'Unidom::Category::Category', foreign_key: :scheme_id
 
-  scope :owned_by, ->(owner) { where owner: owner }
+      validates :name, presence: true, length: { in: 2..self.columns_hash['name'].limit }
 
-end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::CategoryScheme'
+      scope :owned_by, ->(owner) { where owner: owner }
+
+    end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::CategoryScheme'
+
+  end
+end

data/app/models/unidom/category/concerns/as_ancestor_category.rb

@@ -1,26 +1,32 @@
-module Unidom::Category::Concerns::AsAncestorCategory
+module Unidom
+  module Category
+    module Concerns
+      module AsAncestorCategory
 
-  extend ActiveSupport::Concern
+        extend ActiveSupport::Concern
 
-  included do |includer|
+        included do |includer|
 
-    has_many :descendant_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :ancestor_category_id, source: :ancestor_category
-    has_many :descendant_categories,       class_name: 'Unidom::Category::Category',       through:     :descendant_category_rollups
+          has_many :descendant_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :ancestor_category_id, source: :ancestor_category
+          has_many :descendant_categories,       class_name: 'Unidom::Category::Category',       through:     :descendant_category_rollups
 
-    def roll_up!(it, at: Time.now, primary: true)
-      rollup = descendant_category_rollups.descendant_category_is(it).valid_at(now: at).alive.first_or_create! elemental: primary, opened_at: at
-      rollup.elemental = primary if rollup.elemental!=primary
-      rollup.save!
-      rollup
-    end
+          def roll_up!(it, at: Time.now, primary: true)
+            rollup = descendant_category_rollups.descendant_category_is(it).valid_at(now: at).alive.first_or_create! elemental: primary, opened_at: at
+            rollup.elemental = primary if rollup.elemental!=primary
+            rollup.save!
+            rollup
+          end
 
-    def roll_up?(it, at: Time.now, primary: true)
-      descendant_category_rollups.descendant_category_is(it).primary(primary).valid_at(now: at).alive.exists?
-    end
+          def roll_up?(it, at: Time.now, primary: true)
+            descendant_category_rollups.descendant_category_is(it).primary(primary).valid_at(now: at).alive.exists?
+          end
 
-  end
+        end
 
-  module ClassMethods
-  end
+        module ClassMethods
+        end
 
+      end
+    end
+  end
 end

data/app/models/unidom/category/concerns/as_categorized.rb

@@ -1,33 +1,39 @@
-module Unidom::Category::Concerns::AsCategorized
+module Unidom
+  module Category
+    module Concerns
+      module AsCategorized
 
-  extend ActiveSupport::Concern
+        extend ActiveSupport::Concern
 
-  included do |includer|
+        included do |includer|
 
-    has_many :categorizings, class_name: 'Unidom::Category::Categorizing', as:     :categorized
-    has_many :categories,    through:    :categorizings,                   source: :category
+          has_many :categorizings, class_name: 'Unidom::Category::Categorizing', as:     :categorized
+          has_many :categories,    through:    :categorizings,                   source: :category
 
-    def is_categorized!(into: nil, at: Time.now, primary: true)
+          def is_categorized!(into: nil, at: Time.now, primary: true)
 
-      raise ArgumentError('The into argument is required.') if into.blank?
-      raise ArgumentError('The at argument is required.'  ) if at.blank?
+            raise ArgumentError('The into argument is required.') if into.blank?
+            raise ArgumentError('The at argument is required.'  ) if at.blank?
 
-      categorizings.category_is(into).valid_at(now: at).alive.first_or_create! elemental: primary, opened_at: at
+            categorizings.category_is(into).valid_at(now: at).alive.first_or_create! elemental: primary, opened_at: at
 
-    end
+          end
 
-    def is_categorized?(into: nil, at: Time.now, primary: true)
+          def is_categorized?(into: nil, at: Time.now, primary: true)
 
-      raise ArgumentError('The into argument is required.') if into.blank?
-      raise ArgumentError('The at argument is required.'  ) if at.blank?
+            raise ArgumentError('The into argument is required.') if into.blank?
+            raise ArgumentError('The at argument is required.'  ) if at.blank?
 
-      categorizings.category_is(into).valid_at(now: at).alive.primary(primary).exists?
+            categorizings.category_is(into).valid_at(now: at).alive.primary(primary).exists?
 
-    end
+          end
 
-  end
+        end
 
-  module ClassMethods
-  end
+        module ClassMethods
+        end
 
+      end
+    end
+  end
 end

data/app/models/unidom/category/concerns/as_category.rb

@@ -1,32 +1,38 @@
-module Unidom::Category::Concerns::AsCategory
+module Unidom
+  module Category
+    module Concerns
+      module AsCategory
 
-  extend ActiveSupport::Concern
+        extend ActiveSupport::Concern
 
-  included do |includer|
+        included do |includer|
 
-    has_many :categorizings, class_name: 'Category::Categorizing'
+          has_many :categorizings, class_name: 'Category::Categorizing'
 
-    def categorize!(categorized, at: Time.now, primary: true)
+          def categorize!(categorized, at: Time.now, primary: true)
 
-      raise ArgumentError('The categorized argument is required.') if categorized.blank?
-      raise ArgumentError('The at argument is required.'         ) if at.blank?
+            raise ArgumentError('The categorized argument is required.') if categorized.blank?
+            raise ArgumentError('The at argument is required.'         ) if at.blank?
 
-      categorizings.categorized_is(categorized).valid_at(now: at).alive.first_or_create! elemental: primary, opened_at: at
+            categorizings.categorized_is(categorized).valid_at(now: at).alive.first_or_create! elemental: primary, opened_at: at
 
-    end
+          end
 
-    def categorize?(categorized, at: Time.now, primary: true)
+          def categorize?(categorized, at: Time.now, primary: true)
 
-      raise ArgumentError('The categorized argument is required.') if categorized.blank?
-      raise ArgumentError('The at argument is required.'         ) if at.blank?
+            raise ArgumentError('The categorized argument is required.') if categorized.blank?
+            raise ArgumentError('The at argument is required.'         ) if at.blank?
 
-      categorizings.categorized_is(categorized).valid_at(now: at).alive.primary(primary).exists?
+            categorizings.categorized_is(categorized).valid_at(now: at).alive.primary(primary).exists?
 
-    end
+          end
 
-  end
+        end
 
-  module ClassMethods
-  end
+        module ClassMethods
+        end
 
+      end
+    end
+  end
 end

data/app/models/unidom/category/concerns/as_descendant_category.rb

@@ -1,26 +1,32 @@
-module Unidom::Category::Concerns::AsDescendantCategory
+module Unidom
+  module Category
+    module Concerns
+      module AsDescendantCategory
 
-  extend ActiveSupport::Concern
+        extend ActiveSupport::Concern
 
-  included do |includer|
+        included do |includer|
 
-    has_many :ancestor_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :descendant_category_id, source: :descendant_category
-    has_many :ancestor_categories,       class_name: 'Unidom::Category::Category',       through:     :ancestor_category_rollups
+          has_many :ancestor_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :descendant_category_id, source: :descendant_category
+          has_many :ancestor_categories,       class_name: 'Unidom::Category::Category',       through:     :ancestor_category_rollups
 
-    def is_rolled_up!(it, at: Time.now, primary: true)
-      rollup = ancestor_category_rollups.ancestor_category_is(it).valid_at(now: at).alive.first_or_create! elemental: primary, opened_at: at
-      rollup.elemental = primary if rollup.elemental!=primary
-      rollup.save!
-      rollup
-    end
+          def is_rolled_up!(it, at: Time.now, primary: true)
+            rollup = ancestor_category_rollups.ancestor_category_is(it).valid_at(now: at).alive.first_or_create! elemental: primary, opened_at: at
+            rollup.elemental = primary if rollup.elemental!=primary
+            rollup.save!
+            rollup
+          end
 
-    def is_rolled_up?(it, at: Time.now, primary: true)
-      ancestor_category_rollups.ancestor_category_is(it).primary(primary).valid_at(now: at).alive.exists?
-    end
+          def is_rolled_up?(it, at: Time.now, primary: true)
+            ancestor_category_rollups.ancestor_category_is(it).primary(primary).valid_at(now: at).alive.exists?
+          end
 
-  end
+        end
 
-  module ClassMethods
-  end
+        module ClassMethods
+        end
 
+      end
+    end
+  end
 end

data/app/views/layouts/unidom/category/application.html.erb

@@ -2,7 +2,7 @@
 <html>
 <head>
   <title>Unidom Category</title>
-  <%= stylesheet_link_tag "unidom/category/application", media: 'all' %>
+  <%= stylesheet_link_tag 'unidom/category/application', media: 'all' %>
   <%= csrf_meta_tags %>
 </head>
 <body>

data/db/migrate/20000301000000_create_unidom_category_schemes.rb

@@ -1,4 +1,4 @@
-class CreateUnidomCategorySchemes < ActiveRecord::Migration
+class CreateUnidomCategorySchemes < ActiveRecord::Migration[6.0]
 
   def change
 
@@ -12,9 +12,9 @@ class CreateUnidomCategorySchemes < ActiveRecord::Migration
 
       t.text :description
 
-      t.column   :state, 'char(1)', null: false, default: 'C'
-      t.datetime :opened_at,        null: false, default: ::Time.utc(1970)
-      t.datetime :closed_at,        null: false, default: ::Time.utc(3000)
+      t.column   :state, 'char(1)', null: false, default: Unidom::Common::STATE
+      t.datetime :opened_at,        null: false, default: Unidom::Common::OPENED_AT
+      t.datetime :closed_at,        null: false, default: Unidom::Common::CLOSED_AT
       t.boolean  :defunct,          null: false, default: false
       t.jsonb    :notation,         null: false, default: {}
 

data/db/migrate/20000302000000_create_unidom_categories.rb

@@ -1,10 +1,11 @@
-class CreateUnidomCategories < ActiveRecord::Migration
+class CreateUnidomCategories < ActiveRecord::Migration[6.0]
 
   def change
 
     create_table :unidom_categories, id: :uuid do |t|
 
-      t.references :scheme, type: :uuid, null: false
+      t.references :scheme, type: :uuid, null: false,
+        foreign_key: false
 
       t.string :code,         null: true,  default: nil, limit: 64
       t.string :name,         null: false, default: '',  limit: 200
@@ -12,9 +13,9 @@ class CreateUnidomCategories < ActiveRecord::Migration
 
       t.text :description
 
-      t.column   :state, 'char(1)', null: false, default: 'C'
-      t.datetime :opened_at,        null: false, default: ::Time.utc(1970)
-      t.datetime :closed_at,        null: false, default: ::Time.utc(3000)
+      t.column   :state, 'char(1)', null: false, default: Unidom::Common::STATE
+      t.datetime :opened_at,        null: false, default: Unidom::Common::OPENED_AT
+      t.datetime :closed_at,        null: false, default: Unidom::Common::CLOSED_AT
       t.boolean  :defunct,          null: false, default: false
       t.jsonb    :notation,         null: false, default: {}
 
@@ -22,7 +23,7 @@ class CreateUnidomCategories < ActiveRecord::Migration
 
     end
 
-    add_index :unidom_categories, :scheme_id
+    #add_index :unidom_categories, :scheme_id
     add_index :unidom_categories, [ :code, :scheme_id ], unique: true
 
   end

data/db/migrate/20000303000000_create_unidom_category_rollups.rb

@@ -1,18 +1,20 @@
-class CreateUnidomCategoryRollups < ActiveRecord::Migration
+class CreateUnidomCategoryRollups < ActiveRecord::Migration[6.0]
 
   def change
 
     create_table :unidom_category_rollups, id: :uuid do |t|
 
-      t.references :ancestor_category,   type: :uuid, null: false
-      t.references :descendant_category, type: :uuid, null: false
+      t.references :ancestor_category,   type: :uuid, null: false,
+        foreign_key: false
+      t.references :descendant_category, type: :uuid, null: false,
+        foreign_key: false
 
       t.boolean :elemental, null: false, default: false
       t.integer :distance,  null: false, default: 1
 
-      t.column   :state, 'char(1)', null: false, default: 'C'
-      t.datetime :opened_at,        null: false, default: ::Time.utc(1970)
-      t.datetime :closed_at,        null: false, default: ::Time.utc(3000)
+      t.column   :state, 'char(1)', null: false, default: Unidom::Common::STATE
+      t.datetime :opened_at,        null: false, default: Unidom::Common::OPENED_AT
+      t.datetime :closed_at,        null: false, default: Unidom::Common::CLOSED_AT
       t.boolean  :defunct,          null: false, default: false
       t.jsonb    :notation,         null: false, default: {}
 
@@ -20,8 +22,8 @@ class CreateUnidomCategoryRollups < ActiveRecord::Migration
 
     end
 
-    add_index :unidom_category_rollups, :ancestor_category_id
-    add_index :unidom_category_rollups, :descendant_category_id
+    #add_index :unidom_category_rollups, :ancestor_category_id
+    #add_index :unidom_category_rollups, :descendant_category_id
 
   end
 

data/db/migrate/20000304000000_create_unidom_categorizings.rb

@@ -1,18 +1,19 @@
-class CreateUnidomCategorizings < ActiveRecord::Migration
+class CreateUnidomCategorizings < ActiveRecord::Migration[6.0]
 
   def change
 
     create_table :unidom_categorizings, id: :uuid do |t|
 
-      t.references :category,    type: :uuid, null: false
+      t.references :category,    type: :uuid, null: false,
+        foreign_key: false
       t.references :categorized, type: :uuid, null: false,
         polymorphic: { type: :uuid, null: false }
 
       t.boolean :elemental, null: false, default: false
 
-      t.column   :state, 'char(1)', null: false, default: 'C'
-      t.datetime :opened_at,        null: false, default: ::Time.utc(1970)
-      t.datetime :closed_at,        null: false, default: ::Time.utc(3000)
+      t.column   :state, 'char(1)', null: false, default: Unidom::Common::STATE
+      t.datetime :opened_at,        null: false, default: Unidom::Common::OPENED_AT
+      t.datetime :closed_at,        null: false, default: Unidom::Common::CLOSED_AT
       t.boolean  :defunct,          null: false, default: false
       t.jsonb    :notation,         null: false, default: {}
 
@@ -20,7 +21,7 @@ class CreateUnidomCategorizings < ActiveRecord::Migration
 
     end
 
-    add_index :unidom_categorizings, :category_id
+    #add_index :unidom_categorizings, :category_id
     add_index :unidom_categorizings, :categorized_id
 
   end

data/lib/rspec/models/unidom/category/categorizing_shared_examples.rb

@@ -0,0 +1,19 @@
+shared_examples 'Unidom::Category::Categorizing' do |model_attributes, categorized, category|
+
+  before :each do
+  end
+
+  after :each do
+  end
+
+  context do
+
+    it_behaves_like 'assert_present!', described_class, :categorize!, [ categorized, { into: category, at: Time.now } ], [ { 0 => :categorized }, :into, :at ]
+
+    it_behaves_like 'has_many', model_attributes, :categorized, categorized.class, [ categorized.attributes ]
+
+    it_behaves_like 'monomorphic scope', model_attributes, :category_is, :category, [ category.class ]
+
+  end
+
+end

data/lib/rspec/models/unidom/category/category_rollup_spec.rb

@@ -28,6 +28,11 @@ describe Unidom::Category::CategoryRollup, type: :model do
     it_behaves_like 'monomorphic scope', model_attributes, :ancestor_category_is,   :ancestor_category
     it_behaves_like 'monomorphic scope', model_attributes, :descendant_category_is, :descendant_category
 
+    it   = Unidom::Category::Category.create! category_attributes.merge(code: 'ZC', name: 'Sub Category', abbreviation: 'SubCat')
+    into = Unidom::Category::Category.create! category_attributes.merge(code: 'YC')
+
+    it_behaves_like 'assert_present!', described_class, :roll_up!, [ it, { into: into, at: Time.now } ], [ { 0 => :it }, :into, :at ]
+
   end
 
 end

data/lib/unidom/category/rspec_shared_examples.rb

@@ -0,0 +1 @@
+require 'rspec/models/unidom/category/categorizing_shared_examples'

data/lib/unidom/category/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Category
-    VERSION = '1.6.6'.freeze
+    VERSION = '2.0.1'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-category
 version: !ruby/object:Gem::Version
-  version: 1.6.6
+  version: 2.0.1
 platform: ruby
 authors:
 - Topbit Du
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-03-29 00:00:00.000000000 Z
+date: 2021-08-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unidom-common
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '2.0'
 description: Unidom (UNIfied Domain Object Model) is a series of domain model engines.
   The Category domain model engine includes Category and its relative models. Unidom
   (统一领域对象模型)是一系列的领域模型引擎。类别领域模型引擎包括类别及其相关的模型。
@@ -58,6 +58,7 @@ files:
 - db/migrate/20000302000000_create_unidom_categories.rb
 - db/migrate/20000303000000_create_unidom_category_rollups.rb
 - db/migrate/20000304000000_create_unidom_categorizings.rb
+- lib/rspec/models/unidom/category/categorizing_shared_examples.rb
 - lib/rspec/models/unidom/category/categorizing_spec.rb
 - lib/rspec/models/unidom/category/category_rollup_spec.rb
 - lib/rspec/models/unidom/category/category_scheme_spec.rb
@@ -66,14 +67,15 @@ files:
 - lib/unidom/category.rb
 - lib/unidom/category/engine.rb
 - lib/unidom/category/models_rspec.rb
+- lib/unidom/category/rspec_shared_examples.rb
 - lib/unidom/category/types_rspec.rb
 - lib/unidom/category/validators_rspec.rb
 - lib/unidom/category/version.rb
-homepage: https://github.com/topbitdu/unidom-category
+homepage: https://gitee.com/Unidom/unidom-category
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -88,9 +90,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.4
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
 summary: Unidom Category Domain Model Engine 类别领域模型引擎
 test_files: []