unidom-category 1.2 → 1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 93576c414117bd512f8cc34e2f744098d23f4306
-  data.tar.gz: 17bae303105dae01da620ec1f3a43d9ed7f96e9d
+  metadata.gz: 8f08019b4625520f38401076dfeecb7ae9554896
+  data.tar.gz: 6878e743ac7038c34d8129750ae784581db78c0c
 SHA512:
-  metadata.gz: e98a45ffb2ce9c06fcdadbc17ef584de584bd21f71f856dd2bdefce3c0757691aed825f671f83f72df4ec6da0c6416ed8256a285ae508ef47b730afb47a6b6d2
-  data.tar.gz: 15decf5e34ddb8572a3069179f82b5838cd47deca2a65e2701e0daf29cc78b4df05be965033f601446c26f7d947b68f6056f64156cfaceee85b9345ee05e70de
+  metadata.gz: e40165eaf0cd8a1314e9545c11de4ab734645603817af4dd171400e2352dfe30fd6117f9540c144b5eb9b6be3a48e19bd8d0191f799dd60dd01722a74a115071
+  data.tar.gz: 202be75deddd9cc57e4e6f3affbe50b778113154227dc8d83e8d5cb5390862bd496fc37d4031f37ebd51439b4dd3b1d7ff0aa94202dc2d66b71f3b21bf400030

data/README.md

@@ -6,22 +6,33 @@
 Unidom (UNIfied Domain Object Model) is a series of domain model engines. The Category domain model engine includes Category and its relative models.
 Unidom (统一领域对象模型)是一系列的领域模型引擎。类别领域模型引擎包括类别及其相关的模型。
 
+
+
 ## Recent Update
 Check out the [Road Map](ROADMAP.md) to find out what's the next.
 Check out the [Change Log](CHANGELOG.md) to find out what's new.
 
+
+
 ## Usage in Gemfile
+
 ```ruby
 gem 'unidom-category'
 ```
 
+
+
 ## Run the Database Migration
+
 ```shell
 rake db:migrate
 ```
 The migration versions start with 200003.
 
+
+
 ## Call the Model
+
 ```ruby
 @category = Unidom::Category::Category.coded_as('x1').scheme_is(scheme).valid_at.alive.first
 Unidom::Category::Categorizing.categorize! product, into: category, at: Time.now
@@ -32,10 +43,15 @@ Unidom::Category::CategoryRollup.roll_up! child_category, into: parent_category,
 @category.categorize! @product, primary: true
 ```
 
+
+
 ## Include the Concerns
+
 ```ruby
 include Unidom::Category::Concerns::AsCategorized
 include Unidom::Category::Concerns::AsCategory
+include Unidom::Category::Concerns::AsAncestorCategory
+include Unidom::Category::Concerns::AsDescendantCategory
 ```
 
 ### As Category concern
@@ -50,3 +66,13 @@ The As Categorized concern do the following tasks for the includer automatically
 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``
+
+### 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``

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

@@ -6,18 +6,14 @@ class Unidom::Category::Category < ActiveRecord::Base
 
   include Unidom::Common::Concerns::ModelExtension
   include Unidom::Category::Concerns::AsCategory
+  include Unidom::Category::Concerns::AsAncestorCategory
+  include Unidom::Category::Concerns::AsDescendantCategory
 
   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 }
 
   belongs_to :scheme, class_name: 'Unidom::Category::CategoryScheme', foreign_key: :scheme_id
 
-  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 :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
-
   scope :scheme_is,          ->(scheme) { where scheme_id: (scheme.respond_to?(:id) ? scheme.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+'%' }

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

@@ -0,0 +1,15 @@
+module Unidom::Category::Concerns::AsAncestorCategory
+
+  extend ActiveSupport::Concern
+
+  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
+
+  end
+
+  module ClassMethods
+  end
+
+end

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

@@ -27,4 +27,7 @@ module Unidom::Category::Concerns::AsCategorized
 
   end
 
+  module ClassMethods
+  end
+
 end

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

@@ -26,4 +26,7 @@ module Unidom::Category::Concerns::AsCategory
 
   end
 
+  module ClassMethods
+  end
+
 end

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

@@ -0,0 +1,15 @@
+module Unidom::Category::Concerns::AsDescendantCategory
+
+  extend ActiveSupport::Concern
+
+  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
+
+  end
+
+  module ClassMethods
+  end
+
+end

data/lib/unidom/category/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Category
-    VERSION = '1.2'.freeze
+    VERSION = '1.3'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-category
 version: !ruby/object:Gem::Version
-  version: '1.2'
+  version: '1.3'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-09 00:00:00.000000000 Z
+date: 2016-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unidom-common
@@ -44,8 +44,10 @@ files:
 - app/models/unidom/category/category.rb
 - app/models/unidom/category/category_rollup.rb
 - app/models/unidom/category/category_scheme.rb
+- app/models/unidom/category/concerns/as_ancestor_category.rb
 - app/models/unidom/category/concerns/as_categorized.rb
 - app/models/unidom/category/concerns/as_category.rb
+- app/models/unidom/category/concerns/as_descendant_category.rb
 - app/views/layouts/unidom/category/application.html.erb
 - config/routes.rb
 - db/migrate/20000301000000_create_unidom_category_schemes.rb