order_adjustment.rb in unidom-order-1.4.2

- old
+ new

@@ -14,10 +14,13 @@
 
   scope :adjusted_is, ->(adjusted) { where adjusted: adjusted }
 
   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
     if adjustment.present?
       if 0==amount
@@ -30,6 +33,6 @@
       adjustment = query.create! amount: amount, opened_at: opened_at
     end
     adjustment
   end
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Order::OrderAdjustment'