unidom-order 1.4.1 → 1.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 01a8d08f48da45e3f69d83854fb7b62f75638160
-  data.tar.gz: ec8f32394c74a15518b8ff6179a76770310c988e
+  metadata.gz: e091e23d5b3eb27ad6a15956f79901c6cc293127
+  data.tar.gz: 242b53a3e93e89b0ae87957c241acd016a15c572
 SHA512:
-  metadata.gz: 9f3788cd64f303519346a8d3bf5063d158e4364fceb6a04286a280e118ef4a0e208670024784cf3605437ddd4d201cd9ebbc7657cb54438dd37178e40e893633
-  data.tar.gz: 59afcf91a336e94f77b35bc9c1a549c5f57b275523bdaab0790d2bb7af5ea08a0b66ffdb63d53b7567081cdd68814dc90810731e889beee04ef0fa6d53720be2
+  metadata.gz: 4a1f3ca8d004687a472626259f5400dcaf8a2b5924c1eaf5cb0e5f1d4f15cf37cfbd53613ae2eb0b39908842f59b25704258b569a8f13edf112bde597d2c06a3
+  data.tar.gz: 389637997d93c82734639e617a805757b50f4263298fe241637422eb88749cc9a6fdc658fb03f956c7999d01980db3f35e5697cb336373ea6a9fba7888daa27d

data/README.md

@@ -112,19 +112,24 @@ include Unidom::Order::AsOrderTaker
 
 ### As Adjusted concern
 
-The As Adjusted concern do the following tasks for the includer automatically:  
-1. Define the has_many :adjustments macro as: ``has_many :adjustments, class_name: 'Unidom::Order::OrderAdjustment', as: :adjusted``  
-2. Define the #is_adjusted! method as: ``is_adjusted!(amount, due_to: 'FRGT', at: Time.now)``  
+The As Adjusted concern do the following tasks for the includer automatically:
+
+1. Define the has_many :adjustments macro as: ``has_many :adjustments, class_name: 'Unidom::Order::OrderAdjustment', as: :adjusted``
+
+2. Define the #is_adjusted! method as: ``is_adjusted!(amount, due_to: 'FRGT', at: Time.now)``
+
 3. Define the #is_adjusted? method as: ``is_adjusted?(due_to: 'FRGT', at: Time.now)``
 
 ### As Order Placer concern
 
-The As Order Placer concern do the following tasks for the includer automatically:  
+The As Order Placer concern do the following tasks for the includer automatically:
+
 1. Define the has_many :placed_orders macro as: ``has_many :placed_orders, class_name: 'Unidom::Order::Order', as: :placer``
 
 ### As Order Taker concern
 
-The As Order Taker concern do the following tasks for the includer automatically:  
+The As Order Taker concern do the following tasks for the includer automatically:
+
 1. Define the has_many :taken_orders macro as: ``has_many :taken_orders, class_name: 'Unidom::Order::Order', as: :taker``
 
 
@@ -141,3 +146,19 @@ Unidom::Order::AdjustmentFactor::SHIPPING_AND_HANDLING_CHARGES # 装运和处理
 Unidom::Order::AdjustmentFactor::FEE                           # 手续费
 Unidom::Order::AdjustmentFactor::MISCELLANEOUS_CHARGE          # 杂项收费
 ```
+
+
+
+## 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::Order
+  }
+
+end
+```

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

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

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

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

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

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

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

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

data/app/models/unidom/order/order.rb

@@ -20,4 +20,4 @@ class Unidom::Order::Order < Unidom::Order::ApplicationRecord
   scope :placed_by, ->(placer) { where placer: placer }
   scope :taken_by,  ->(taker)  { where taker:  taker  }
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Order::Order'

data/app/models/unidom/order/order_adjustment.rb

@@ -16,6 +16,9 @@ class Unidom::Order::OrderAdjustment < Unidom::Order::ApplicationRecord
 
   code :adjustment_factor, Unidom::Order::AdjustmentFactor
 
+  ##
+  # 对订单或者订单项 adjusted 进行调整。调整金额为 amount ，缺省为 0 。调整原因是 due_to ，缺省是 FRGT 。调整时间是 opened_at ，缺省为当前时间。如：
+  # Unidom::Order::OrderAdjustment.adjust! order, amount: 7.90, due_to: 'LTAX'
   def self.adjust!(adjusted, amount: 0, due_to: 'FRGT', opened_at: Time.now)
     query      = adjusted_is(adjusted).adjustment_factor_coded_as(due_to).valid_at(now: opened_at).alive
     adjustment = query.first
@@ -32,4 +35,4 @@ class Unidom::Order::OrderAdjustment < Unidom::Order::ApplicationRecord
     adjustment
   end
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Order::OrderAdjustment'

data/app/models/unidom/order/order_item.rb

@@ -22,6 +22,9 @@ class Unidom::Order::OrderItem < Unidom::Order::ApplicationRecord
   scope :ordered_is, ->(ordered) { where ordered: ordered }
   scope :placed_by,  ->(placer)  { where placer:  placer  }
 
+  ##
+  # 订购商品 ordered ，放入订单 of 。订购者为 by ，缺省为订单的下单者。单价为 unit_price ，缺省值为 0 。数量为 quantity ，缺省值为 1。如：
+  # Unidom::Order::OrderItem.order! coca_cola, of: order, by: current_person, unit_price: 3.50, quantity: 2
   def self.order!(ordered, of: nil, by: of.placer, unit_price: 0, quantity: 1)
     item = of.items.ordered_is(ordered).placed_by(by).valid_at.alive.first
     if item.present?
@@ -36,4 +39,4 @@ class Unidom::Order::OrderItem < Unidom::Order::ApplicationRecord
     end
   end
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Order::OrderItem'

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

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <title>Order</title>
+  <title>Unidom Order</title>
   <%= stylesheet_link_tag "unidom/order/application", media: "all" %>
   <%= csrf_meta_tags %>
 </head>

data/lib/unidom/order/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Order
-    VERSION = '1.4.1'.freeze
+    VERSION = '1.4.2'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-order
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.4.2
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-03 00:00:00.000000000 Z
+date: 2017-01-21 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 Order domain model engine includes Order, Order Item, and Order Adjustment models.
   Unidom (统一领域对象模型)是一系列的领域模型引擎。订单领域模型引擎包括订单、订单项和订单调整的模型。