unidom-common 1.3 → 1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 72b239e03d003ae2a4e0f68db103b014417ea67e
-  data.tar.gz: 24dc122ec9aa546cbbe8565eab0bd56ace09a143
+  metadata.gz: 46f0e637b8fede019f80dea128b1aaff90f7901d
+  data.tar.gz: b7604abc60c3c05f6163368ea9e28d6cb4cba41d
 SHA512:
-  metadata.gz: d0ee19de3aaff418f90faf82cd2cf56e7dee37d42907057317161712d1f76ce7d06aa17321121ed9e22fbc817a3fb06bebc1b0342560c10cf669fd805e6f3a1d
-  data.tar.gz: b833df4e2a8e3efd2654ab64a379bcf0dd9ac1bbf4c99f6b4724fcdd89a5f3a7c9c78a27faa7bbb2400f34f20c329dd09196c56ff85f8f705f4c0eda3af07d1d
+  metadata.gz: ca5afb8e0c42bd8da40546735edaa919357fefe4f0745161abc30b8738596d59c5d020be9ed210c770355a32b2c3f1cf0a9495c43a20bbf49b7e80ee556e0695
+  data.tar.gz: ed2bc11249d6934302d5e202b7e5806bc132df713ba7c66be62075d535b856cfa32e23f7a39684ce115515c524176675ef32915e4b31f64480807b3dcb5aa570

data/README.md

@@ -7,28 +7,43 @@
 Unidom (UNIfied Domain Object Model) is a series of domain model engines. The Common domain model engine includes the common models.
 Unidom (统一领域对象模型)是一系列的领域模型引擎。常用领域模型引擎包括一些常用的模型。
 
+
+
 ## Recent Update
+
 Check out the [Road Map](ROADMAP.md) to find out what's the next.
 Check out the [Change Log](CHANGELOG.md) to find out what's new.
 
+
+
 ## Usage in Gemfile
+
 ```ruby
 gem 'unidom-common'
 ```
 
+
+
 ## Run the Database Migration
+
 ```shell
 rake db:migrate
 ```
 The migration versions starts with 200001.
 The migration enabled the PostgreSQL uuid-ossp extension.
 
+
+
 ## Include Concern in Models
+
 ```ruby
 include Unidom::Common::Concerns::ModelExtension
 ```
 
+
+
 ## Model Extension concern
+
 ```ruby
 class Project < ActiveRecord::Base
 
@@ -39,9 +54,17 @@ class Project < ActiveRecord::Base
 
   belongs_to :customer
   belongs_to :team
+  belongs_to :place
 
   # other fields: code, description
 
+  def kick_off(in: nil)
+    assert_present! :in, in
+    # An argument error is raised if in is blank.
+
+    self.place = in
+  end
+
 end
 
 Project.coded_as('JIRA').valid_at(Time.now).alive(true)     # Same as Project.coded_as('JIRA').valid_at.alive
@@ -54,7 +77,10 @@ Project.created_not_before('2015-01-01 00:00:00')
 Project.audition_transited_to('A').transited_to('C')
 ```
 
+
+
 ## No-SQL Columns
+
 ```ruby
 class Project < ActiveRecord::Base
 
@@ -81,7 +107,10 @@ project.enabled? # true
 Project.notation_boolean_column_where(:enabled, true) # All enabled projects
 ```
 
+
+
 ## Numeration
+
 ```ruby
 binary = 'some string'
 hex = Unidom::Common::Numeration.hex binary # "736f6d6520737472696e67"
@@ -91,7 +120,10 @@ text = Unidom::Common::Numeration.rev_hex hex # "some string"
 # convert a hex string to its text value
 ```
 
+
+
 ## AES 256 Cryptor
+
 ```ruby
 class IdentityCard
 
@@ -126,7 +158,10 @@ decrypted     = identity_card.decrypt_identification_number
 # The AES 256 Cryptor also has the #hex_encrypt and the #hex_decrypt methods
 ```
 
+
+
 ## MD 5 Digester
+
 ```ruby
 class IdentityCard
 
@@ -153,7 +188,10 @@ hex_digested  = identity_card.hex_digest_identification_number
 hex_digested == Unidom::Common::Numeration.hex digested # true
 ```
 
+
+
 ## SHA 256 Digester
+
 ```ruby
 class IdentityCard
 
@@ -180,7 +218,10 @@ hex_digested  = identity_card.hex_digest_identification_number
 hex_digested == Unidom::Common::Numeration.hex digested # true
 ```
 
+
+
 ## SHA 384 Digester
+
 ```ruby
 class IdentityCard
 
@@ -207,7 +248,10 @@ hex_digested  = identity_card.hex_digest_identification_number
 hex_digested == Unidom::Common::Numeration.hex digested # true
 ```
 
+
+
 ## SHA 512 Digester
+
 ```ruby
 class IdentityCard
 
@@ -235,7 +279,9 @@ hex_digested == Unidom::Common::Numeration.hex digested # true
 ```
 
 
+
 ## SHA 1 Digester
+
 ```ruby
 class IdentityCard
 
@@ -263,7 +309,9 @@ hex_digested == Unidom::Common::Numeration.hex digested # true
 ```
 
 
+
 ## SHA 2 Digester
+
 ```ruby
 class IdentityCard
 
@@ -291,7 +339,9 @@ hex_digested == Unidom::Common::Numeration.hex digested # true
 ```
 
 
+
 ## ActiveRecord Migration Naming Convention
+
 ### Domain Models (200YMMDDHHMMSS)
 
 <table class='table table-striped table-hover'>
@@ -351,6 +401,18 @@ hex_digested == Unidom::Common::Numeration.hex digested # true
       <td>The Authorization domain model engine includes the Permission and Authorizing models. 授权领域模型引擎包括权限、授权的模型。</td>
     </tr>
 
+    <tr>
+      <td>[![unidom-action](https://badge.fury.io/rb/unidom-action.svg)](https://github.com/topbitdu/unidom-action)</td>
+      <td>200005DDHHMMSS</td>
+      <td>
+        - Reason
+        - State Transition
+        - Obsolescence
+        - Acting
+      </td>
+      <td>The Action domain model engine includes the Reason, State Transition, Obsolescene, and the Acting models. 审计领域模型引擎包括原因、状态迁移、废弃和行为日志的模型。</td>
+    </tr>
+
     <tr>
       <td>[![unidom-standard](https://badge.fury.io/rb/unidom-standard.svg)](https://github.com/topbitdu/unidom-standard)</td>
       <td>200006DDHHMMSS</td>
@@ -469,6 +531,19 @@ hex_digested == Unidom::Common::Numeration.hex digested # true
       <td>The Inventory domain model engine includes the Serialized Inventory Item, the Grouped Inventory Item, the Lot, and the Inventory Item Variance models. 库存领域模型引擎包括序列化库存项、分组库存项、批量和库存项变化的模型。</td>
     </tr>
 
+    <tr>
+      <td>[![unidom-shipment](https://badge.fury.io/rb/unidom-shipment.svg)](https://github.com/topbitdu/unidom-shipment)</td>
+      <td>200210DDHHMMSS</td>
+      <td>
+        - Shipment
+        - Shipment Item
+        - Shipment Package
+        - Shipment Package Item
+        - Shipment Receipt
+      </td>
+      <td>The Shipment domain model engine includes the Shipment, Shipment Item, Shipment Package, Shipment Package Item, and Shipment Receipt model. 装运领域模型引擎包括装运、装运项、装运包裹、装运包裹项、装运收据的模型。</td>
+    </tr>
+
 
     <tr>
       <td>[![unidom-position](https://badge.fury.io/rb/unidom-position.svg)](https://github.com/topbitdu/unidom-position)</td>
@@ -497,6 +572,7 @@ hex_digested == Unidom::Common::Numeration.hex digested # true
 </table>
 
 ### Country Extensions (200YMM9NNNMMSS)
+
 The YMM part should be identical to the relative part of the Domain Models.
 The NNN is the numeric code of [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1 "codes for the names of countries, dependent territories, and special areas of geographical interest").
 The numeric code of China is 156.

data/app/models/unidom/common/concerns/model_extension.rb

@@ -136,6 +136,10 @@ module Unidom::Common::Concerns::ModelExtension
       end
     end
 
+    def assert_present!(name, value)
+      raise ArgumentError.new("The #{name} argument is required.") if value.blank?
+    end
+
   end
 
   module ClassMethods
@@ -174,6 +178,10 @@ module Unidom::Common::Concerns::ModelExtension
       end
     end
 
+    def assert_present!(name, value)
+      raise ArgumentError.new("The #{name} argument is required.") if value.blank?
+    end
+
   end
 
 end

data/lib/unidom/common/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Common
-    VERSION = '1.3'.freeze
+    VERSION = '1.4'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-common
 version: !ruby/object:Gem::Version
-  version: '1.3'
+  version: '1.4'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-28 00:00:00.000000000 Z
+date: 2016-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails