unidom-inventory 0.7.4 → 0.7.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: eb92d2f9e70d5f4cd23dda116402fea9179dcc78
-  data.tar.gz: d0914e4acd8fa703c36f9e8b7bd9a6d1f3891bd1
+  metadata.gz: 3def5f3156c518aea115d97b00a070fe8d1f67d4
+  data.tar.gz: 8530497bac887d9e94f1f80a3055fa454077cf4b
 SHA512:
-  metadata.gz: f4b31cb3d59e140a72a8bd539ec0c159c602db46169914cbb837ad181907c4e01354f73e9679d74a737cd7a266ce94086a48c2cac850d0cd9c764b0a9222a331
-  data.tar.gz: b467454a0b92364431e71f90f4fce6ae58fe8b67b4ebd092c6f364e830934c9a6896178ee8d8cc78c62a469d0a3763c4541ed6120128329acf6e5260fe0efe98
+  metadata.gz: 1eea9bb7dc43e33bfa6f2758a537727ba799781fe088ce75029050eb3b6fd17fc172f80d5a12b80e81484bae5bdc9547d9ac81a17bd3ac027b99e3f49de4db57
+  data.tar.gz: 9b0522a0c0c2294297654e6d6f582734ac1f300dd38b93c6530d3a4aa28b13669604787634ffadd390ddafbc3c913a26268fd37563e4a931dc7756e70d57a4fa

data/README.md

@@ -67,22 +67,48 @@ include Unidom::Inventory::Concerns::AsStored
 
 ### As Inventory Item concern
 
-The As Inventory Item concern do the following tasks for the includer automatically:  
-1. Define the belongs_to :stored macro as: ``belongs_to :stored, polymorphic: true``  
-2. Define the belongs_to :store macro as: ``belongs_to :store, polymorphic: true``  
-3. Define the belongs_to :lot macro as: ``belongs_to :lot, class_name: 'Unidom::Inventory::Lot'``  
-4. Define the has_many :pick_items macro as: ``has_many :pick_items, class_name: 'Unidom::Inventory::PickItem', as: :inventory_item``  
-5. Define the has_many :variances macro as: ``has_many :variances, class_name: 'Unidom::Inventory::InventoryItemVariance', as: :inventory_item``  
+The As Inventory Item concern do the following tasks for the includer automatically:
+
+1. Define the belongs_to :stored macro as: ``belongs_to :stored, polymorphic: true``
+
+2. Define the belongs_to :store macro as: ``belongs_to :store, polymorphic: true``
+
+3. Define the belongs_to :lot macro as: ``belongs_to :lot, class_name: 'Unidom::Inventory::Lot'``
+
+4. Define the has_many :pick_items macro as: ``has_many :pick_items, class_name: 'Unidom::Inventory::PickItem', as: :inventory_item``
+
+5. Define the has_many :variances macro as: ``has_many :variances, class_name: 'Unidom::Inventory::InventoryItemVariance', as: :inventory_item``
+
 6. Define the #is_adjusted! method as: ``is_adjusted!(quantity, due_to: nil, at: Time.now, description: nil, instruction: nil)``
 
 ### As Store concern
 
-The As Store concern do the following tasks for the includer automatically:  
-1. Define the has_many :grouped_inventory_items macro as: ``has_many :grouped_inventory_items, class_name: 'Unidom::Inventory::GroupedInventoryItem', foreign_key: :store_id``  
+The As Store concern do the following tasks for the includer automatically:
+
+1. Define the has_many :grouped_inventory_items macro as: ``has_many :grouped_inventory_items, class_name: 'Unidom::Inventory::GroupedInventoryItem', foreign_key: :store_id``
+
 2. Define the has_many :serialized_inventory_items macro as: ``has_many :serialized_inventory_items, class_name: 'Unidom::Inventory::SerializedInventoryItem', foreign_key: :store_id``
 
 ### As Stored concern
 
-The As Stored concern do the following tasks for the includer automatically:  
-1. Define the has_many :grouped_inventory_items macro as: ``has_many :grouped_inventory_items, class_name: 'Unidom::Inventory::GroupedInventoryItem', foreign_key: :stored_id``  
+The As Stored concern do the following tasks for the includer automatically:
+
+1. Define the has_many :grouped_inventory_items macro as: ``has_many :grouped_inventory_items, class_name: 'Unidom::Inventory::GroupedInventoryItem', foreign_key: :stored_id``
+
 2. Define the has_many :serialized_inventory_items macro as: ``has_many :serialized_inventory_items, class_name: 'Unidom::Inventory::SerializedInventoryItem', foreign_key: :stored_id``
+
+
+
+## Disable the Model & Migration
+
+If you only need the app components other than models, the migrations should be neglected, and the models should not be loaded.
+```ruby
+# config/initializers/unidom.rb
+Unidom::Common.configure do |options|
+
+  options[:neglected_namespaces] = %w{
+    Unidom::Inventory
+  }
+
+end
+```

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

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

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

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

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

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

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

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

data/app/models/unidom/inventory/grouped_inventory_item.rb

@@ -10,4 +10,4 @@ class Unidom::Inventory::GroupedInventoryItem < Unidom::Inventory::ApplicationRe
 
   validates :quantity, presence: true, numericality: true
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Inventory::GroupedInventoryItem'

data/app/models/unidom/inventory/inventory_item_variance.rb

@@ -18,6 +18,10 @@ class Unidom::Inventory::InventoryItemVariance < Unidom::Inventory::ApplicationR
   scope :inventory_item_is, ->(inventory_item) { where inventory_item: inventory_item }
   scope :caused_by,         ->(reason)         { where reason:         reason         }
 
+  ##
+  # 对库存项 inventory_item 进行调整。调整数量为 quantity ，缺省为 nil 。调整原因为 due_to 。调整时间为 at ，缺省为当前时间。
+  # 另有适用于己方的备注信息 description 和适用于对方的备注信息 instruction 。
+  # Unidom::Inventory::InventoryItemVariance.adjust! inventory_item, quantity: 3
   def self.adjust!(inventory_item, quantity: nil, due_to: nil, at: Time.now, description: nil, instruction: nil)
     if inventory_item.respond_to? :quantity
       inventory_item.increment! :quantity, quantity
@@ -32,4 +36,4 @@ class Unidom::Inventory::InventoryItemVariance < Unidom::Inventory::ApplicationR
     create! inventory_item: inventory_item, reason: due_to, quantity: quantity, description: description, instruction: instruction, opened_at: at
   end
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Inventory::InventoryItemVariance'

data/app/models/unidom/inventory/item_issuing.rb

@@ -16,4 +16,4 @@ class Unidom::Inventory::ItemIssuing < Unidom::Inventory::ApplicationRecord
   belongs_to :inventory_item, polymorphic: true
   belongs_to :target_item,    polymorphic: true
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Inventory::ItemIssuing'

data/app/models/unidom/inventory/lot.rb

@@ -13,4 +13,4 @@ class Unidom::Inventory::Lot < Unidom::Inventory::ApplicationRecord
   has_many :grouped_inventory_items,    class_name: 'Unidom::Inventory::GroupedInventoryItem'
   has_many :serialized_inventory_items, class_name: 'Unidom::Inventory::SerializedInventoryItem'
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Inventory::Lot'

data/app/models/unidom/inventory/pick_item.rb

@@ -12,4 +12,4 @@ class Unidom::Inventory::PickItem < Unidom::Inventory::ApplicationRecord
   belongs_to :pick_list,      class_name:  'Unidom::Inventory::PickList'
   belongs_to :inventory_item, polymorphic: true
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Inventory::PickItem'

data/app/models/unidom/inventory/pick_list.rb

@@ -9,4 +9,4 @@ class Unidom::Inventory::PickList < Unidom::Inventory::ApplicationRecord
 
   has_many :items, class_name: 'Unidom::Inventory::PickItem' #, foreign_key: :pick_list_id
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Inventory::PickList'

data/app/models/unidom/inventory/serialized_inventory_item.rb

@@ -10,4 +10,4 @@ class Unidom::Inventory::SerializedInventoryItem < Unidom::Inventory::Applicatio
 
   validates :serial_number, presence: true, length: { in: 2..columns_hash['serial_number'].limit }
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Inventory::SerializedInventoryItem'

data/lib/unidom/inventory/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Inventory
-    VERSION = '0.7.4'.freeze
+    VERSION = '0.7.5'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-inventory
 version: !ruby/object:Gem::Version
-  version: 0.7.4
+  version: 0.7.5
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-03 00:00:00.000000000 Z
+date: 2017-01-25 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.8'
+        version: '1.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '1.9'
 description: Unidom (UNIfied Domain Object Model) is a series of domain model engines.
   The Inventory domain model engine includes the Serialized Inventory Item, the Grouped
   Inventory Item, the Lot, and the Inventory Item Variance models. Unidom (统一领域对象模型)是一系列的领域模型引擎。库存领域模型引擎包括序列化库存项、分组库存项、批量和库存项变化的模型。