unidom-inventory 0.5 → 0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f5478f1bad555fc1a2a79c73149c2f68d8152541
-  data.tar.gz: eddb97b1856d6e4da7f8d324608df5515a3f1a1e
+  metadata.gz: 59116b8cfb8504d2ff15c7ff9afa640d77542afc
+  data.tar.gz: 9df508c0df726dfb5b350d36dadea5a21bbae35a
 SHA512:
-  metadata.gz: ff4b4696568e894df9813d74e71c96211763385dfab254c6763976a0e80612e47ca8377ad630a1fdaf24adebb2d8b6fdf9b0e78a268131dd6d8438efd07be30c
-  data.tar.gz: 79215e93fe985eec472b13e512dc6f23bb61c28321db94a506aba17cd3b403b07b1b6ca4258c87c27bf31886872111dc01afb01306a7d511d7c2a85e3e1a9ec9
+  metadata.gz: f24af042b909c72252e548c4958894850108f9cc8097db04d2e33ea81650e00b0a14ab64351174f11ab5e2fdfb65f3e93e5faa4d98a14b831070dc36faacd821
+  data.tar.gz: 49e7eca834921f0c1e8663c58301256ae87e6be4936f67f0b7200900e7fe648b323812c1d2a8102f70c64fbe1f9945ca4ea300076894447541e757709928e061

data/README.md

@@ -34,6 +34,7 @@ The migration versions start with 200209.
 
 
 ## Call the Model
+
 ```ruby
 lot = Unidom::Inventory::Lot.create! identification_number: '20040312', description: '1 more thing', instruction: 'Please note...'
 
@@ -48,6 +49,10 @@ pick_list    = Unidom::Inventory::PickList.create!
 pick_item    = pick_list.items.create! inventory_item: grouped_inventory_item, quantity: 100
 item_issuing = Unidom::Inventory::ItemIssuing.create! pick_item: pick_item, inventory_item: grouped_inventory_item, target_item: nil
 # target_item could be nil or any model like: shipment item or order item
+
+variance = Unidom::Inventory::InventoryItemVariance.create! inventory_item: grouped_inventory_item, reason: nil, opened_at: Time.now
+# or the following source code do the exact same thing.
+grouped_inventory_item.variances.create! quantity: 10, reason: nil, opened_at: Time.now
 ```
 
 
@@ -61,19 +66,20 @@ include Unidom::Inventory::AsInventoryItem
 ### 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'``
+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``
 
 ### 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``
+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``
+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``

data/app/models/unidom/inventory/concerns/as_inventory_item.rb

@@ -8,7 +8,8 @@ module Unidom::Inventory::Concerns::AsInventoryItem
     belongs_to :store,  polymorphic: true
     belongs_to :lot,    class_name:  'Unidom::Inventory::Lot'
 
-    has_many :pick_items, class_name: 'Unidom::Inventory::PickItem', as: :inventory_item
+    has_many :pick_items, class_name: 'Unidom::Inventory::PickItem',              as: :inventory_item
+    has_many :variances,  class_name: 'Unidom::Inventory::InventoryItemVariance', as: :inventory_item
 
   end
 

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

@@ -0,0 +1,20 @@
+# Inventory Item Variance 是库存项变化。
+# #inventory_item 是被调整的库存项。
+# #reason 是调整的原因。
+# #quantity 是调整数量，正数表示库存增加，负数表示库存减少。
+
+class Unidom::Inventory::InventoryItemVariance < ActiveRecord::Base
+
+  self.table_name = 'unidom_inventory_item_variances'
+
+  include Unidom::Common::Concerns::ModelExtension
+
+  validates :quantity, presence: true, numericality: true
+
+  belongs_to :inventory_item, polymorphic: true
+  belongs_to :reason,         polymorphic: true
+
+  scope :inventory_item_is, ->(inventory_item) { where inventory_item: inventory_item }
+  scope :caused_by,         ->(reason)         { where reason:         reason         }
+
+end

data/db/migrate/20020903000000_create_unidom_inventory_item_variances.rb

@@ -0,0 +1,31 @@
+class CreateUnidomInventoryItemVariances < ActiveRecord::Migration
+
+  def change
+
+    create_table :unidom_inventory_item_variances, id: :uuid do |t|
+
+      t.references :inventory_item, type: :uuid,  null: false,
+        polymorphic: { null: false, default: '',  limit: 200 }
+      t.references :reason,         type: :uuid,  null: true,
+        polymorphic: { null: true,  default: nil, limit: 200 }
+
+      t.decimal :quantity, null: false, default: 0.0, precision: 10, scale: 6
+
+      t.text :description
+      t.text :instruction
+
+      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.boolean  :defunct,          null: false, default: false
+      t.jsonb    :notation,         null: false, default: {}
+
+      t.timestamps null: false
+
+    end
+
+    add_index :unidom_inventory_item_variances, :inventory_item_id
+
+  end
+
+end

data/lib/unidom/inventory/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Inventory
-    VERSION = '0.5'.freeze
+    VERSION = '0.6'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-inventory
 version: !ruby/object:Gem::Version
-  version: '0.5'
+  version: '0.6'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-09 00:00:00.000000000 Z
+date: 2016-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unidom-common
@@ -44,6 +44,7 @@ files:
 - app/models/unidom/inventory/concerns/as_store.rb
 - app/models/unidom/inventory/concerns/as_stored.rb
 - app/models/unidom/inventory/grouped_inventory_item.rb
+- app/models/unidom/inventory/inventory_item_variance.rb
 - app/models/unidom/inventory/item_issuing.rb
 - app/models/unidom/inventory/lot.rb
 - app/models/unidom/inventory/pick_item.rb
@@ -53,6 +54,7 @@ files:
 - config/routes.rb
 - db/migrate/20020901000000_create_unidom_serialized_inventory_items.rb
 - db/migrate/20020902000000_create_unidom_grouped_inventory_items.rb
+- db/migrate/20020903000000_create_unidom_inventory_item_variances.rb
 - db/migrate/20020911000000_create_unidom_lots.rb
 - db/migrate/20020921000000_create_unidom_pick_lists.rb
 - db/migrate/20020922000000_create_unidom_pick_items.rb