unidom-action 0.7 → 1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ab217d868ee6c7a3254a098fb76b2dc0fc597a3a
-  data.tar.gz: e12993e9c20532f8186e7f25c4f145ecd8cdf3e2
+  metadata.gz: 3471b684f908d9fbc84708e8ae0a07b687fd9716
+  data.tar.gz: b8fa0235ba1e59ce7d1c68c5900763aacff46013
 SHA512:
-  metadata.gz: fe8228fd8880c33bb7e2ef4c19e04a4e0ce8186356015274e72c86af7afb7ffaa33fd7e258264816cf531f709a840b2a985e4c8d694f5e72653e712374057ab9
-  data.tar.gz: 4b5f4f838d9ee6fca69dac42bb8fd7d2d221493744786103caffec9bb00bb7703efa7a7189c7bc8ba51a702aa1258ee11dd5fc1b884388cf16a8e79f4502d277
+  metadata.gz: 6123fd18b1db0fa66a3241569d8b19412d801cf25b2b8696f2711b78a77a6b8272c5ff44cf07ac1494dc9dab6e22f58aad05992f073a2adf10491a1fec74eb44
+  data.tar.gz: cf160b984f506f2aeec2322187f3e85e335ea9468d40fef556f2a7b9d5139999920fb413fe5745827b86aca5f4f07dac6d2ba18d96664e92c2ea8bf3db32abbc

data/README.md

@@ -48,11 +48,19 @@ acting = Unidom::Action::Acting.create! actor_visitor: user, actor_party: person
 # Update the state of the person
 person.state = 'R'
 person.save!
+# Create a state transition to record the above change
 transition = Unidom::Action::StateTransition.create! transitor_visitor: user, transitor_party: person, reason: reason, subject: person, from_state: 'C', thru_state: 'R'
+# The following source code also create a state transition to record the above change
+transition = Unidom::Action::StateTransition.transit! transitor_visitor: user, transitor_party: person, reason: reason, subject: person, from_state: 'C', thru_state: 'R', opened_at: Time.now
+# The reason could be nil.
 
 # Soft destroy the person
 person.soft_destroy
-obsolescence = Unidom::Action::Obsolescence.create! obsolescer_visitor: user, obsolescer_party: person, reason: reason, obsolesced: person
+# Create an obsolescing to record the above change
+obsolescence = Unidom::Action::Obsolescing.create! obsolescer_visitor: user, obsolescer_party: person, reason: reason, obsolesced: person, obsolescence_code: 'OBSL'
+# The following source code also create an obsolescing to record the above change
+obsolescence = Unidom::Action::Obsolescing.obsolesce! obsolesced: person, obsolescer_visitor: user, obsolescer_party: person, reason: reason, obsolescence_code: 'OBSL', opened_at: Time.now
+
 # The reason could be nil.
 ```
 

data/app/models/unidom/action/obsolescing.rb

@@ -14,4 +14,8 @@ class Unidom::Action::Obsolescing < Unidom::Action::ApplicationRecord
   belongs_to :obsolesced,         polymorphic: true
   belongs_to :reason,             class_name:  'Unidom::Action::Reason'
 
+  def self.obsolesce!(obsolesced: nil, obsolescer_visitor: nil, obsolescer_party: nil, reason: nil, obsolescence_code: 'OBSL', opened_at: Time.now)
+    create! obsolesced: obsolesced, obsolescer_visitor: obsolescer_visitor, obsolescer_party: obsolescer_party, reason: reason, obsolescence_code: obsolescence_code, opened_at: opened_at
+  end
+
 end

data/app/models/unidom/action/state_transition.rb

@@ -13,4 +13,8 @@ class Unidom::Action::StateTransition < Unidom::Action::ApplicationRecord
   belongs_to :subject,           polymorphic: true
   belongs_to :reason,            class_name:  'Unidom::Action::Reason'
 
+  def self.transit!(subject: nil, from_state: nil, thru_state: nil, transitor_visitor: nil, transitor_party: nil, reason: nil, opened_at: Time.now)
+    create! transitor_visitor: transitor_visitor, transitor_party: transitor_party, subject: subject, reason: reason, from_state: from_state, thru_state: thru_state, opened_at: opened_at
+  end
+
 end

data/lib/unidom/action/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Action
-    VERSION = '0.7'.freeze
+    VERSION = '1.0'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-action
 version: !ruby/object:Gem::Version
-  version: '0.7'
+  version: '1.0'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-06 00:00:00.000000000 Z
+date: 2016-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unidom-common