unidom-article_number 2.3.5 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f230184a9348c0a6540ff87054d0e237210f44a9
-  data.tar.gz: 1680b0164bcdf2569392dcac358db9c414c47092
+SHA256:
+  metadata.gz: 20387d317914c567cade086d61a214bdc1544df3db3188765a6d1d876fbbf0d4
+  data.tar.gz: f3122b1aff3157ba6e49b2c60a1dbd832debe28c985482cb64ff0aee74e5f1da
 SHA512:
-  metadata.gz: 1ec8c735447b02c849a1b36479b895861ad88fd01e0f582df8e3586c455a7306c4b9f6eba335c53d454dc4204fa9758a204bc3caeabb1ea17784bc4064b7dac7
-  data.tar.gz: 34161d493bbf609110bcab81f9184b55bbaea889adc5294c141abec00a853f90eb27a6bc99523cd387893121ac9bc49a361e6d5466ccdeef61f219b1e41dac6e
+  metadata.gz: 41c78fa15b41db235ca0cd303c64127aa548339287eabe3d8a0f76ceecb277160457fec56f3a50233c825837258c0f909d21b2650cd36465522a9753cdc11096
+  data.tar.gz: 53956165e31e623a47cc60dfd1bba815050f0498d63a585d254c81886d03ecb39429132a5a35250c7322c96a82d05687a334b50df3ed49a40aac91e88f943186

data/README.md

@@ -120,6 +120,8 @@ end
 
 ## RSpec examples
 
+### RSpec example manifest (run automatically)
+
 ```ruby
 # spec/models/unidom_spec.rb
 require 'unidom/article_number/models_rspec'
@@ -130,3 +132,31 @@ require 'unidom/article_number/types_rspec'
 # spec/validators/unidom_spec.rb
 require 'unidom/article_number/validators_rspec'
 ```
+
+### RSpec shared examples (to be integrated)
+
+```ruby
+# The Unidom::ArticleNumber::Ean13Barcode model, the Unidom::ArticleNumber::Ean8Barcode model, & the Unidom::ArticleNumber::VehicleIdentificationNumber model already include the Unidom::ArticleNumber::Concerns::AsBarcode concern
+
+# app/models/your_barcode.rb
+class YourBarcode < ActiveRecord::Base
+
+  include Unidom::Common::Concerns::ModelExtension
+  include Unidom::ArticleNumber::Concerns::AsBarcode
+
+end
+
+# spec/support/unidom_rspec_shared_examples.rb
+require 'unidom/article_number/rspec_shared_examples'
+
+# spec/models/your_barcode_spec.rb
+describe YourBarcode do
+
+  model_attribtues = {
+    code: 'AABBCCDDEEFF'
+  }
+
+  it_behaves_like 'Unidom::ArticleNumber::Concerns::AsBarcode', model_attribtues
+
+end
+```

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

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

data/app/helpers/unidom/article_number/application_helper.rb

@@ -1,2 +1,9 @@
-module Unidom::ArticleNumber::ApplicationHelper
+
+module Unidom
+  module ArticleNumber
+
+    module ApplicationHelper
+    end
+
+  end
 end

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

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

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

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

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

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

data/app/models/unidom/article_number/concerns/as_barcode.rb

@@ -1,31 +1,39 @@
 ##
 # As Barcode 是条形码的领域逻辑关注点。
 
-module Unidom::ArticleNumber::Concerns::AsBarcode
+module Unidom
+  module ArticleNumber
+    module Concerns
 
-  extend ActiveSupport::Concern
+      module AsBarcode
 
-  included do |includer|
+        extend ActiveSupport::Concern
 
-    has_many :markings,        class_name: 'Unidom::ArticleNumber::Marking', as:     :barcode
-    has_many :marked_products, through:    :markings,                        source: :marked, source_type: 'Unidom::Product::Product'
+        included do |includer|
 
-    def mark!(marked, by: nil, at: Time.now)
-      raise ArgumentError.new('The marked argument is required.') if marked.blank?
-      raise ArgumentError.new('The by argument is required.'    ) if by.blank?
-      raise ArgumentError.new('The at argument is required.'    ) if at.blank?
-      markings.create! marked: marked, marker: by, opened_at: at
-    end
+          has_many :markings,        class_name: 'Unidom::ArticleNumber::Marking', as:     :barcode
+          has_many :marked_products, through:    :markings,                        source: :marked, source_type: 'Unidom::Product::Product'
 
-    def mark?(marked, at: Time.now)
-      raise ArgumentError.new('The marked argument is required.') if marked.blank?
-      raise ArgumentError.new('The at argument is required.'    ) if at.blank?
-      markings.marked_is(marked).valid_at(now: at).alive.exists?
-    end
+          def mark!(marked, by: nil, at: Time.now)
+            raise ArgumentError.new('The marked argument is required.') if marked.blank?
+            raise ArgumentError.new('The by argument is required.'    ) if by.blank?
+            raise ArgumentError.new('The at argument is required.'    ) if at.blank?
+            markings.create! marked: marked, marker: by, opened_at: at
+          end
 
-  end
+          def mark?(marked, at: Time.now)
+            raise ArgumentError.new('The marked argument is required.') if marked.blank?
+            raise ArgumentError.new('The at argument is required.'    ) if at.blank?
+            markings.marked_is(marked).valid_at(now: at).alive.exists?
+          end
 
-  module ClassMethods
-  end
+        end
 
+        module ClassMethods
+        end
+
+      end
+
+    end
+  end
 end

data/app/models/unidom/article_number/concerns/as_ean13_marked.rb

@@ -1,19 +1,27 @@
 ##
 # As EAN-13 Marked 是被 EAN-13 条形码标注的物品的领域逻辑关注点。
 
-module Unidom::ArticleNumber::Concerns::AsEan13Marked
+module Unidom
+  module ArticleNumber
+    module Concerns
 
-  extend ActiveSupport::Concern
+      module AsEan13Marked
 
-  include Unidom::ArticleNumber::Concerns::AsMarked
+        extend ActiveSupport::Concern
 
-  included do |includer|
+        include Unidom::ArticleNumber::Concerns::AsMarked
 
-    has_many :ean13_barcodes, through: :markings, source: :barcode, source_type: 'Unidom::ArticleNumber::Ean13Barcode'
+        included do |includer|
 
-  end
+          has_many :ean13_barcodes, through: :markings, source: :barcode, source_type: 'Unidom::ArticleNumber::Ean13Barcode'
 
-  module ClassMethods
-  end
+        end
+
+        module ClassMethods
+        end
 
+      end
+
+    end
+  end
 end

data/app/models/unidom/article_number/concerns/as_ean8_marked.rb

@@ -1,19 +1,27 @@
 ##
 # As EAN-8 Marked 是被 EAN-8 条形码标注的物品的领域逻辑关注点。
 
-module Unidom::ArticleNumber::Concerns::AsEan8Marked
+module Unidom
+  module ArticleNumber
+    module Concerns
 
-  extend ActiveSupport::Concern
+      module AsEan8Marked
 
-  include Unidom::ArticleNumber::Concerns::AsMarked
+        extend ActiveSupport::Concern
 
-  included do |includer|
+        include Unidom::ArticleNumber::Concerns::AsMarked
 
-    has_many :ean8_barcodes, through: :markings, source: :barcode, source_type: 'Unidom::ArticleNumber::Ean8Barcode'
+        included do |includer|
 
-  end
+          has_many :ean8_barcodes, through: :markings, source: :barcode, source_type: 'Unidom::ArticleNumber::Ean8Barcode'
 
-  module ClassMethods
-  end
+        end
+
+        module ClassMethods
+        end
 
+      end
+
+    end
+  end
 end

data/app/models/unidom/article_number/concerns/as_marked.rb

@@ -1,30 +1,38 @@
 ##
 # As Marked 是被条形码标注的物品的领域逻辑关注点。
 
-module Unidom::ArticleNumber::Concerns::AsMarked
+module Unidom
+  module ArticleNumber
+    module Concerns
 
-  extend ActiveSupport::Concern
+      module AsMarked
 
-  included do |includer|
+        extend ActiveSupport::Concern
 
-    has_many :markings, class_name: 'Unidom::ArticleNumber::Marking', as: :marked
+        included do |includer|
 
-    def is_marked!(as: nil, by: nil, at: Time.now)
-      raise ArgumentError.new('The as argument is required.') if as.blank?
-      raise ArgumentError.new('The by argument is required.') if by.blank?
-      raise ArgumentError.new('The at argument is required.') if at.blank?
-      markings.create! barcode: as, marker: by, opened_at: at
-    end
+          has_many :markings, class_name: 'Unidom::ArticleNumber::Marking', as: :marked
 
-    def is_marked?(as: nil, at: Time.now)
-      raise ArgumentError.new('The as argument is required.') if as.blank?
-      raise ArgumentError.new('The at argument is required.') if at.blank?
-      markings.barcode_is(as).valid_at(now: at).alive.exists?
-    end
+          def is_marked!(as: nil, by: nil, at: Time.now)
+            raise ArgumentError.new('The as argument is required.') if as.blank?
+            raise ArgumentError.new('The by argument is required.') if by.blank?
+            raise ArgumentError.new('The at argument is required.') if at.blank?
+            markings.create! barcode: as, marker: by, opened_at: at
+          end
 
-  end
+          def is_marked?(as: nil, at: Time.now)
+            raise ArgumentError.new('The as argument is required.') if as.blank?
+            raise ArgumentError.new('The at argument is required.') if at.blank?
+            markings.barcode_is(as).valid_at(now: at).alive.exists?
+          end
 
-  module ClassMethods
-  end
+        end
 
+        module ClassMethods
+        end
+
+      end
+
+    end
+  end
 end

data/app/models/unidom/article_number/concerns/code128_barcode.rb

@@ -4,28 +4,36 @@
 # Code 128 B 条形码 code set: ASCII characters 32 to 127 (0-9, A-Z, a-z), special characters, and FNC 1-4.
 # Code 128 C 条形码 code set: 00-99 (encodes each two digits with one code) and FNC1.
 
-module Unidom::ArticleNumber::Concerns::Code128Barcode
+module Unidom
+  module ArticleNumber
+    module Concerns
 
-  extend ActiveSupport::Concern
+      module Code128Barcode
 
-  included do |includer|
+        extend ActiveSupport::Concern
 
-    validates :code, uniqueness: true
-    validates :code, numericality: { only_integer: true }, if: Proc.new { |barcode| 'C'==barcode.code_set_code }
+        included do |includer|
 
-    has_many :markings, class_name: 'Unidom::ArticleNumber::Marking'
+          validates :code, uniqueness: true
+          validates :code, numericality: { only_integer: true }, if: Proc.new { |barcode| 'C'==barcode.code_set_code }
 
-    include Unidom::Common::Concerns::ModelExtension
+          has_many :markings, class_name: 'Unidom::ArticleNumber::Marking'
 
-    #def weighted_modulo_103_checksum(codes)
-    #  sum = 103
-    #  codes.each_with_index do |char, index| sum += (char.unpack('C').first-32)*(index+1) end
-    #  sum%103
-    #end
+          include Unidom::Common::Concerns::ModelExtension
 
-  end
+          #def weighted_modulo_103_checksum(codes)
+          #  sum = 103
+          #  codes.each_with_index do |char, index| sum += (char.unpack('C').first-32)*(index+1) end
+          #  sum%103
+          #end
 
-  module ClassMethods
-  end
+        end
+
+        module ClassMethods
+        end
 
+      end
+
+    end
+  end
 end

data/app/models/unidom/article_number/ean13_barcode.rb

@@ -3,34 +3,40 @@
 # https://en.wikipedia.org/wiki/EAN-13
 # https://en.wikipedia.org/wiki/International_Article_Number_(EAN)
 
-class Unidom::ArticleNumber::Ean13Barcode < Unidom::ArticleNumber::ApplicationRecord
-
-  RESTRICTED_DISTRIBUTION_GS1_PREFIXES = (('020'..'029').to_a + ('040'..'049').to_a + ('200'..'299').to_a).freeze
-
-  self.table_name = 'unidom_ean_13_barcodes'
-
-  include Unidom::Common::Concerns::ModelExtension
-  include Unidom::ArticleNumber::Concerns::AsBarcode
-
-  validates :code,           uniqueness: true, length: { minimum: 13 }, numericality: { only_integer: true }
-  validates :gs1_prefix,     presence:   true, length: { is:       3 }, numericality: { only_integer: true }
-  validates :company_number, presence:   true, length: { is:       4 }, numericality: { only_integer: true }
-  validates :item_reference, presence:   true, length: { is:       5 }, numericality: { only_integer: true }
-  validates :check_digit,    presence:   true, length: { is:       1 }, numericality: { only_integer: true }
-
-  def code=(code)
-    code = code.to_s
-    write_attribute :code, code
-    if code.present?
-      write_attribute :gs1_prefix,     code[0..2]
-      write_attribute :company_number, code[3..6]
-      write_attribute :item_reference, code[7..11]
-      write_attribute :check_digit,    code[12]
-    end
-  end
+module Unidom
+  module ArticleNumber
 
-  def restricted_distribution?
-    self.class::RESTRICTED_DISTRIBUTION_GS1_PREFIXES.include? gs1_prefix
-  end
+    class Ean13Barcode < ApplicationRecord
+
+      RESTRICTED_DISTRIBUTION_GS1_PREFIXES = (('020'..'029').to_a + ('040'..'049').to_a + ('200'..'299').to_a).freeze
+
+      self.table_name = 'unidom_ean_13_barcodes'
+
+      include Unidom::Common::Concerns::ModelExtension
+      include Unidom::ArticleNumber::Concerns::AsBarcode
 
-end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::ArticleNumber::Ean13Barcode'
+      validates :code,           uniqueness: true, length: { minimum: 13 }, numericality: { only_integer: true }
+      validates :gs1_prefix,     presence:   true, length: { is:       3 }, numericality: { only_integer: true }
+      validates :company_number, presence:   true, length: { is:       4 }, numericality: { only_integer: true }
+      validates :item_reference, presence:   true, length: { is:       5 }, numericality: { only_integer: true }
+      validates :check_digit,    presence:   true, length: { is:       1 }, numericality: { only_integer: true }
+
+      def code=(code)
+        code = code.to_s
+        write_attribute :code, code
+        if code.present?
+          write_attribute :gs1_prefix,     code[0..2]
+          write_attribute :company_number, code[3..6]
+          write_attribute :item_reference, code[7..11]
+          write_attribute :check_digit,    code[12]
+        end
+      end
+
+      def restricted_distribution?
+        self.class::RESTRICTED_DISTRIBUTION_GS1_PREFIXES.include? gs1_prefix
+      end
+
+    end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::ArticleNumber::Ean13Barcode'
+
+  end
+end

data/app/models/unidom/article_number/ean8_barcode.rb

@@ -2,32 +2,38 @@
 # EAN-8 Barcode 是8位条形码。
 # https://en.wikipedia.org/wiki/EAN-8
 
-class Unidom::ArticleNumber::Ean8Barcode < Unidom::ArticleNumber::ApplicationRecord
+module Unidom
+  module ArticleNumber
 
-  RESTRICTED_DISTRIBUTION_GS1_PREFIXES = (('020'..'029').to_a + ('040'..'049').to_a + ('200'..'299').to_a).freeze
+    class Ean8Barcode < ApplicationRecord
 
-  self.table_name = 'unidom_ean_8_barcodes'
+      RESTRICTED_DISTRIBUTION_GS1_PREFIXES = (('020'..'029').to_a + ('040'..'049').to_a + ('200'..'299').to_a).freeze
 
-  include Unidom::Common::Concerns::ModelExtension
-  include Unidom::ArticleNumber::Concerns::AsBarcode
+      self.table_name = 'unidom_ean_8_barcodes'
 
-  validates :code,           uniqueness: true, length: { minimum: 8 }, numericality: { only_integer: true }
-  validates :gs1_prefix,     presence:   true, length: { is:      3 }, numericality: { only_integer: true }
-  validates :item_reference, presence:   true, length: { is:      4 }, numericality: { only_integer: true }
-  validates :check_digit,    presence:   true, length: { is:      1 }, numericality: { only_integer: true }
+      include Unidom::Common::Concerns::ModelExtension
+      include Unidom::ArticleNumber::Concerns::AsBarcode
 
-  def code=(code)
-    code = code.to_s
-    write_attribute :code, code
-    if code.present?
-      write_attribute :gs1_prefix,     code[0..2]
-      write_attribute :item_reference, code[3..6]
-      write_attribute :check_digit,    code[7]
-    end
-  end
+      validates :code,           uniqueness: true, length: { minimum: 8 }, numericality: { only_integer: true }
+      validates :gs1_prefix,     presence:   true, length: { is:      3 }, numericality: { only_integer: true }
+      validates :item_reference, presence:   true, length: { is:      4 }, numericality: { only_integer: true }
+      validates :check_digit,    presence:   true, length: { is:      1 }, numericality: { only_integer: true }
 
-  def restricted_distribution?
-    self.class::RESTRICTED_DISTRIBUTION_GS1_PREFIXES.include? gs1_prefix
-  end
+      def code=(code)
+        code = code.to_s
+        write_attribute :code, code
+        if code.present?
+          write_attribute :gs1_prefix,     code[0..2]
+          write_attribute :item_reference, code[3..6]
+          write_attribute :check_digit,    code[7]
+        end
+      end
+
+      def restricted_distribution?
+        self.class::RESTRICTED_DISTRIBUTION_GS1_PREFIXES.include? gs1_prefix
+      end
 
-end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::ArticleNumber::Ean8Barcode'
+    end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::ArticleNumber::Ean8Barcode'
+
+  end
+end

data/app/models/unidom/article_number/marking.rb

@@ -1,36 +1,42 @@
 ##
 # Marking 是条码和物品的标记关系。
 
-class Unidom::ArticleNumber::Marking < Unidom::ArticleNumber::ApplicationRecord
+module Unidom
+  module ArticleNumber
 
-  self.table_name = 'unidom_markings'
+    class Marking < ApplicationRecord
 
-  include Unidom::Common::Concerns::ModelExtension
+      self.table_name = 'unidom_markings'
 
-  belongs_to :barcode, polymorphic: true
-  belongs_to :marked,  polymorphic: true
-  belongs_to :marker,  polymorphic: true
+      include Unidom::Common::Concerns::ModelExtension
 
-  scope :barcode_is, ->(barcode) { where barcode: barcode }
-  scope :marked_by,  ->(marker)  { where marker:  marker  }
-  scope :marked_is,  ->(marked)  { where marked:  marked  }
+      belongs_to :barcode, polymorphic: true
+      belongs_to :marked,  polymorphic: true
+      belongs_to :marker,  polymorphic: true
 
-  def self.mark!(barcode: nil, marked: nil, marker: nil, opened_at: Time.now)
+      scope :barcode_is, ->(barcode) { where barcode: barcode }
+      scope :marked_by,  ->(marker)  { where marker:  marker  }
+      scope :marked_is,  ->(marked)  { where marked:  marked  }
 
-    raise ArgumentError.new('The barcode argument is required.'  ) if barcode.blank?
-    raise ArgumentError.new('The marked argument is required.'   ) if marked.blank?
-    raise ArgumentError.new('The opened_at argument is required.') if opened_at.blank?
+      def self.mark!(barcode: nil, marked: nil, marker: nil, opened_at: Time.now)
 
-    query    = barcode_is(barcode).marked_is(marked).valid_at.alive
-    creation = { opened_at: opened_at }
-    if marker.present? && marker.respond_to?(:id)
-      creation[:marker] = marker
-    else
-      creation[:marker_id]   = Unidom::Common::NULL_UUID
-      creation[:marker_type] = ''
-    end
-    query.first_or_create! creation
+        raise ArgumentError.new('The barcode argument is required.'  ) if barcode.blank?
+        raise ArgumentError.new('The marked argument is required.'   ) if marked.blank?
+        raise ArgumentError.new('The opened_at argument is required.') if opened_at.blank?
 
-  end
+        query    = barcode_is(barcode).marked_is(marked).valid_at.alive
+        creation = { opened_at: opened_at }
+        if marker.present? && marker.respond_to?(:id)
+          creation[:marker] = marker
+        else
+          creation[:marker_id]   = Unidom::Common::NULL_UUID
+          creation[:marker_type] = ''
+        end
+        query.first_or_create! creation
+
+      end
 
-end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::ArticleNumber::Marking'
+    end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::ArticleNumber::Marking'
+
+  end
+end

data/app/models/unidom/article_number/vehicle_identification_number.rb

@@ -3,28 +3,34 @@
 # https://en.wikipedia.org/wiki/Vehicle_identification_number
 # GB 16735-2004
 
-class Unidom::ArticleNumber::VehicleIdentificationNumber < Unidom::ArticleNumber::ApplicationRecord
-
-  self.table_name = 'unidom_vehicle_identification_numbers'
-
-  include Unidom::Common::Concerns::ModelExtension
-  include Unidom::ArticleNumber::Concerns::AsBarcode
-
-  validates :code,                          uniqueness: true, 'unidom/article_number/vehicle_identification_number': true
-  validates :world_manufacturer_identifier, presence:   true, length: { is: columns_hash['world_manufacturer_identifier'].limit }
-  validates :vehicle_descriptor_section,    presence:   true, length: { is: columns_hash['vehicle_descriptor_section'].limit    }
-  validates :check_digit,                   presence:   true, length: { is: columns_hash['check_digit'].limit                   }
-  validates :vehicle_identifier_section,    presence:   true, length: { is: columns_hash['vehicle_identifier_section'].limit    }
-
-  def code=(code)
-    code = code.to_s
-    write_attribute :code, code
-    if code.present?
-      write_attribute :world_manufacturer_identifier, code[0..2]
-      write_attribute :vehicle_descriptor_section,    code[3..7]
-      write_attribute :check_digit,                   code[8]
-      write_attribute :vehicle_identifier_section,    code[9..16]
-    end
-  end
+module Unidom
+  module ArticleNumber
+
+    class VehicleIdentificationNumber < ApplicationRecord
+
+      self.table_name = 'unidom_vehicle_identification_numbers'
+
+      include Unidom::Common::Concerns::ModelExtension
+      include Unidom::ArticleNumber::Concerns::AsBarcode
 
-end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::ArticleNumber::VehicleIdentificationNumber'
+      validates :code,                          uniqueness: true, 'unidom/article_number/vehicle_identification_number': true
+      validates :world_manufacturer_identifier, presence:   true, length: { is: columns_hash['world_manufacturer_identifier'].limit }
+      validates :vehicle_descriptor_section,    presence:   true, length: { is: columns_hash['vehicle_descriptor_section'].limit    }
+      validates :check_digit,                   presence:   true, length: { is: columns_hash['check_digit'].limit                   }
+      validates :vehicle_identifier_section,    presence:   true, length: { is: columns_hash['vehicle_identifier_section'].limit    }
+
+      def code=(code)
+        code = code.to_s
+        write_attribute :code, code
+        if code.present?
+          write_attribute :world_manufacturer_identifier, code[0..2]
+          write_attribute :vehicle_descriptor_section,    code[3..7]
+          write_attribute :check_digit,                   code[8]
+          write_attribute :vehicle_identifier_section,    code[9..16]
+        end
+      end
+
+    end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::ArticleNumber::VehicleIdentificationNumber'
+
+  end
+end

data/app/validators/unidom/article_number/vehicle_identification_number_validator.rb

@@ -1,29 +1,35 @@
 # https://en.wikipedia.org/wiki/Vehicle_identification_number#Check-digit_calculation
 # GB 16735-2004
 
-class Unidom::ArticleNumber::VehicleIdentificationNumberValidator < ActiveModel::EachValidator
-
-  WEIGHTS         = '8765432X098765432'.freeze
-  TRANSLITERATION = '0123456789.ABCDEFGH..JKLMN.P.R..STUVWXYZ'.freeze
-  CHECK_DIGITS    = '0123456789X'.freeze
-
-  def validate_each(record, attribute, value)
-    value = value.to_s.upcase
-    if value.length>17
-      record.errors[attribute] << (options[:message]||'The length should be 17')
-    elsif value.match /I|O|Q/
-      record.errors[attribute] << (options[:message]||'I, O, Q should be excluded')
-    else
-      record.errors[attribute] << (options[:message]||'is invalid') unless check_digit(value)==value[8]
-    end
-  end
+module Unidom
+  module ArticleNumber
 
-  def check_digit(value)
-    checksum = 0
-    value.chars.each_with_index do |char, index| checksum += self.class::TRANSLITERATION.index(char)%10*self.class::CHECK_DIGITS.index(self.class::WEIGHTS.at(index)) end
-    self.class::CHECK_DIGITS.at checksum%11
-  end
+    class VehicleIdentificationNumberValidator < ActiveModel::EachValidator
+
+      WEIGHTS         = '8765432X098765432'.freeze
+      TRANSLITERATION = '0123456789.ABCDEFGH..JKLMN.P.R..STUVWXYZ'.freeze
+      CHECK_DIGITS    = '0123456789X'.freeze
+
+      def validate_each(record, attribute, value)
+        value = value.to_s.upcase
+        if value.length>17
+          record.errors[attribute] << (options[:message]||'The length should be 17')
+        elsif value.match /I|O|Q/
+          record.errors[attribute] << (options[:message]||'I, O, Q should be excluded')
+        else
+          record.errors[attribute] << (options[:message]||'is invalid') unless check_digit(value)==value[8]
+        end
+      end
 
-  private :check_digit
+      def check_digit(value)
+        checksum = 0
+        value.chars.each_with_index do |char, index| checksum += self.class::TRANSLITERATION.index(char)%10*self.class::CHECK_DIGITS.index(self.class::WEIGHTS.at(index)) end
+        self.class::CHECK_DIGITS.at checksum%11
+      end
 
+      private :check_digit
+
+    end
+
+  end
 end

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

@@ -2,7 +2,7 @@
 <html>
 <head>
   <title>Unidom Article Number</title>
-  <%= stylesheet_link_tag 'unidom/article_number/application', media: "all" %>
+  <%= stylesheet_link_tag 'unidom/article_number/application', media: 'all' %>
   <%= csrf_meta_tags %>
 </head>
 <body>

data/db/migrate/20020101000000_create_unidom_markings.rb

@@ -1,4 +1,4 @@
-class CreateUnidomMarkings < ActiveRecord::Migration
+class CreateUnidomMarkings < ActiveRecord::Migration[6.0]
 
   def change
 
@@ -11,9 +11,9 @@ class CreateUnidomMarkings < ActiveRecord::Migration
       t.references :marker,  type: :uuid, null: false,
         polymorphic: { null: false, default: '', limit: 200 }
 
-      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.column   :state, 'char(1)', null: false, default: Unidom::Common::STATE
+      t.datetime :opened_at,        null: false, default: Unidom::Common::OPENED_AT
+      t.datetime :closed_at,        null: false, default: Unidom::Common::CLOSED_AT
       t.boolean  :defunct,          null: false, default: false
       t.jsonb    :notation,         null: false, default: {}
 

data/db/migrate/20020102000000_create_unidom_ean_13_barcodes.rb

@@ -1,4 +1,4 @@
-class CreateUnidomEan13Barcodes < ActiveRecord::Migration
+class CreateUnidomEan13Barcodes < ActiveRecord::Migration[6.0]
 
   def change
 
@@ -10,9 +10,9 @@ class CreateUnidomEan13Barcodes < ActiveRecord::Migration
       t.string :item_reference,         null: false, default: '0'*2, limit: 6
       t.column :check_digit, 'char(1)', null: false, default: '0'
 
-      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.column   :state, 'char(1)', null: false, default: Unidom::Common::STATE
+      t.datetime :opened_at,        null: false, default: Unidom::Common::OPENED_AT
+      t.datetime :closed_at,        null: false, default: Unidom::Common::CLOSED_AT
       t.boolean  :defunct,          null: false, default: false
       t.jsonb    :notation,         null: false, default: {}
 

data/db/migrate/20020103000000_create_unidom_ean_8_barcodes.rb

@@ -1,4 +1,4 @@
-class CreateUnidomEan8Barcodes < ActiveRecord::Migration
+class CreateUnidomEan8Barcodes < ActiveRecord::Migration[6.0]
 
   def change
 
@@ -9,9 +9,9 @@ class CreateUnidomEan8Barcodes < ActiveRecord::Migration
       t.column :item_reference, 'char(4)', null: false, default: '0'*4
       t.column :check_digit,    'char(1)', null: false, default: '0'
 
-      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.column   :state, 'char(1)', null: false, default: Unidom::Common::STATE
+      t.datetime :opened_at,        null: false, default: Unidom::Common::OPENED_AT
+      t.datetime :closed_at,        null: false, default: Unidom::Common::CLOSED_AT
       t.boolean  :defunct,          null: false, default: false
       t.jsonb    :notation,         null: false, default: {}
 

data/db/migrate/20020111000000_create_unidom_vehicle_identification_numbers.rb

@@ -1,4 +1,4 @@
-class CreateUnidomVehicleIdentificationNumbers < ActiveRecord::Migration
+class CreateUnidomVehicleIdentificationNumbers < ActiveRecord::Migration[6.0]
 
   def change
 
@@ -10,9 +10,9 @@ class CreateUnidomVehicleIdentificationNumbers < ActiveRecord::Migration
       t.column :check_digit,                   'char(1)',  null: false, default: '0'
       t.column :vehicle_identifier_section,    'char(8)',  null: false, default: '0'*8
 
-      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.column   :state, 'char(1)', null: false, default: Unidom::Common::STATE
+      t.datetime :opened_at,        null: false, default: Unidom::Common::OPENED_AT
+      t.datetime :closed_at,        null: false, default: Unidom::Common::CLOSED_AT
       t.boolean  :defunct,          null: false, default: false
       t.jsonb    :notation,         null: false, default: {}
 

data/lib/rspec/models/unidom/article_number/concerns/as_barcode_shared_examples.rb

@@ -0,0 +1,19 @@
+shared_examples 'Unidom::ArticleNumber::Concerns::AsBarcode' do |model_attributes|
+
+  marking_1_attribtues = {
+      marked_id:   SecureRandom.uuid,
+      marked_type: 'Unidom::ArticleNumber::Marked::Mock',
+      marker_id:   SecureRandom.uuid,
+      marker_type: 'Unidom::ArticleNumber::Marker::Mock'
+    }
+
+  marking_2_attribtues = {
+      marked_id:   SecureRandom.uuid,
+      marked_type: 'Unidom::ArticleNumber::Marked::Mock',
+      marker_id:   SecureRandom.uuid,
+      marker_type: 'Unidom::ArticleNumber::Marker::Mock'
+    }
+
+  it_behaves_like 'has_many', model_attributes, :markings, Unidom::ArticleNumber::Marking, [ marking_1_attribtues, marking_2_attribtues ]
+
+end

data/lib/rspec/models/unidom/article_number/concerns/as_marked_shared_examples.rb

@@ -0,0 +1,25 @@
+shared_examples 'Unidom::ArticleNumber::Concerns::AsMarked' do |model_attributes|
+
+  marking_1_attribtues = {
+      marker_id:    SecureRandom.uuid,
+      marker_type:  'Unidom::ArticleNumber::Marker::Mock'
+    }
+
+  marking_2_attribtues = {
+      marker_id:    SecureRandom.uuid,
+      marker_type:  'Unidom::ArticleNumber::Marker::Mock'
+    }
+
+  marking_1_attribtues[:barcode] = Unidom::ArticleNumber::Ean13Barcode.coded_as('1234567899527').first_or_create!
+  marking_1_attribtues[:barcode] = Unidom::ArticleNumber::Ean13Barcode.coded_as('1234567899526').first_or_create!
+  it_behaves_like 'has_many', model_attributes, :markings, Unidom::ArticleNumber::Marking, [ marking_1_attribtues, marking_2_attribtues ]
+
+  marking_1_attribtues[:barcode] = Unidom::ArticleNumber::Ean8Barcode.coded_as('95279527').first_or_create!
+  marking_1_attribtues[:barcode] = Unidom::ArticleNumber::Ean8Barcode.coded_as('95269526').first_or_create!
+  it_behaves_like 'has_many', model_attributes, :markings, Unidom::ArticleNumber::Marking, [ marking_1_attribtues, marking_2_attribtues ]
+
+  #marking_1_attribtues[:barcode] = Unidom::ArticleNumber::VehicleIdentificationNumber.coded_as('LVHCU165XD5002138').first_or_create!
+  #marking_1_attribtues[:barcode] = Unidom::ArticleNumber::VehicleIdentificationNumber.coded_as('LFVAA11A6X2075355').first_or_create!
+  #it_behaves_like 'has_many', model_attributes, :markings, Unidom::ArticleNumber::Marking, [ marking_1_attribtues, marking_2_attribtues ]
+
+end

data/lib/rspec/models/unidom/article_number/ean13_barcode_spec.rb

@@ -12,10 +12,10 @@ describe Unidom::ArticleNumber::Ean13Barcode, type: :model do
       code: '1234567890123'
     }
 
-    code_max_length = described_class.columns_hash['code'].limit
-
-    it_behaves_like 'Unidom::Common::Concerns::ModelExtension', model_attributes
+    it_behaves_like 'Unidom::Common::Concerns::ModelExtension',   model_attributes
+    it_behaves_like 'Unidom::ArticleNumber::Concerns::AsBarcode', model_attributes
 
+    code_max_length = described_class.columns_hash['code'].limit
     it_behaves_like 'validates', model_attributes, :code,
       {             } => 0,
       { code: nil   } => 3,

data/lib/rspec/models/unidom/article_number/ean8_barcode_spec.rb

@@ -12,10 +12,10 @@ describe Unidom::ArticleNumber::Ean8Barcode, type: :model do
       code: '12345678'
     }
 
-    code_max_length = described_class.columns_hash['code'].limit
-
-    it_behaves_like 'Unidom::Common::Concerns::ModelExtension', model_attributes
+    it_behaves_like 'Unidom::Common::Concerns::ModelExtension',   model_attributes
+    it_behaves_like 'Unidom::ArticleNumber::Concerns::AsBarcode', model_attributes
 
+    code_max_length = described_class.columns_hash['code'].limit
     it_behaves_like 'validates', model_attributes, :code,
       {             } => 0,
       { code: nil   } => 3,

data/lib/rspec/models/unidom/article_number/marking_spec.rb

@@ -19,20 +19,7 @@ describe Unidom::ArticleNumber::Marking, type: :model do
 
     it_behaves_like 'Unidom::Common::Concerns::ModelExtension', model_attributes
 
-    it_behaves_like 'scope', :barcode_is, [
-      { attributes_collection: [ model_attributes                                                                           ], count_diff: 0, args: [ Unidom::ArticleNumber::Ean13Barcode.new(               id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes                                                                           ], count_diff: 0, args: [ Unidom::ArticleNumber::Ean8Barcode.new(                id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes                                                                           ], count_diff: 0, args: [ Unidom::ArticleNumber::VehicleIdentificationNumber.new(id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes.merge(barcode_type: 'Unidom::ArticleNumber::Ean13Barcode'               ) ], count_diff: 1, args: [ Unidom::ArticleNumber::Ean13Barcode.new(               id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes.merge(barcode_type: 'Unidom::ArticleNumber::Ean13Barcode'               ) ], count_diff: 0, args: [ Unidom::ArticleNumber::Ean8Barcode.new(                id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes.merge(barcode_type: 'Unidom::ArticleNumber::Ean13Barcode'               ) ], count_diff: 0, args: [ Unidom::ArticleNumber::VehicleIdentificationNumber.new(id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes.merge(barcode_type: 'Unidom::ArticleNumber::Ean8Barcode'                ) ], count_diff: 0, args: [ Unidom::ArticleNumber::Ean13Barcode.new(               id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes.merge(barcode_type: 'Unidom::ArticleNumber::Ean8Barcode'                ) ], count_diff: 1, args: [ Unidom::ArticleNumber::Ean8Barcode.new(                id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes.merge(barcode_type: 'Unidom::ArticleNumber::Ean8Barcode'                ) ], count_diff: 0, args: [ Unidom::ArticleNumber::VehicleIdentificationNumber.new(id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes.merge(barcode_type: 'Unidom::ArticleNumber::VehicleIdentificationNumber') ], count_diff: 0, args: [ Unidom::ArticleNumber::Ean13Barcode.new(               id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes.merge(barcode_type: 'Unidom::ArticleNumber::VehicleIdentificationNumber') ], count_diff: 0, args: [ Unidom::ArticleNumber::Ean8Barcode.new(                id: model_attributes[:barcode_id]) ] },
-      { attributes_collection: [ model_attributes.merge(barcode_type: 'Unidom::ArticleNumber::VehicleIdentificationNumber') ], count_diff: 1, args: [ Unidom::ArticleNumber::VehicleIdentificationNumber.new(id: model_attributes[:barcode_id]) ] }
-    ]
+    it_behaves_like 'polymorphic scope', model_attributes, :barcode_is, :barcode, [ Unidom::ArticleNumber::Ean13Barcode, Unidom::ArticleNumber::Ean8Barcode, Unidom::ArticleNumber::VehicleIdentificationNumber ]
 
   end
 

data/lib/rspec/models/unidom/article_number/vehicle_identification_number_spec.rb

@@ -12,7 +12,24 @@ describe Unidom::ArticleNumber::VehicleIdentificationNumber, type: :model do
       code: 'LVHCU165XD5002138'
     }
 
-    it_behaves_like 'Unidom::Common::Concerns::ModelExtension', model_attributes
+    it_behaves_like 'Unidom::Common::Concerns::ModelExtension',   model_attributes
+    it_behaves_like 'Unidom::ArticleNumber::Concerns::AsBarcode', model_attributes
+
+    it_behaves_like 'validates', model_attributes, :code,
+      {             } => 0,
+      { code: nil   } => 2,
+      { code: ''    } => 2,
+      { code: '1'   } => 1,
+      { code: 'A'   } => 1,
+      { code: '11'  } => 1,
+      { code: 'AA'  } => 1,
+      { code: '111' } => 1,
+      { code: 'AAA' } => 1,
+      { code: 'LFVAA11A6X207535'   } => 1,
+      { code: 'LFVAA11A6X2075354'  } => 1,
+      { code: 'LFVAA11A6X2075355'  } => 0,
+      { code: 'LFVAA11A6X2075356'  } => 1,
+      { code: 'LFVAA11A6X20753559' } => 2
 
   end
 

data/lib/unidom/article_number/engine.rb

@@ -1,7 +1,7 @@
 module Unidom
   module ArticleNumber
 
-    class Engine < ::Rails::Engine
+    class Engine < Rails::Engine
 
       include Unidom::Common::EngineExtension
 

data/lib/unidom/article_number/rspec_shared_examples.rb

@@ -0,0 +1,2 @@
+require 'rspec/models/unidom/article_number/concerns/as_barcode_shared_examples'
+# require 'rspec/models/unidom/article_number/concerns/as_marked_shared_examples'

data/lib/unidom/article_number/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module ArticleNumber
-    VERSION = '2.3.5'.freeze
+    VERSION = '3.0.1'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-article_number
 version: !ruby/object:Gem::Version
-  version: 2.3.5
+  version: 3.0.1
 platform: ruby
 authors:
 - Topbit Du
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-03-11 00:00:00.000000000 Z
+date: 2021-08-07 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.9'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '2.0'
 description: Unidom (UNIfied Domain Object Model) is a series of domain model engines.
   The Article Number domain model engine includes EAN-13, EAN-8, and IMEI models.
   Unidom (统一领域对象模型)是一系列的领域模型引擎。物品编码领域模型引擎包括EAN-13、EAN-8和IMEI的模型。
@@ -60,6 +60,8 @@ files:
 - db/migrate/20020102000000_create_unidom_ean_13_barcodes.rb
 - db/migrate/20020103000000_create_unidom_ean_8_barcodes.rb
 - db/migrate/20020111000000_create_unidom_vehicle_identification_numbers.rb
+- lib/rspec/models/unidom/article_number/concerns/as_barcode_shared_examples.rb
+- lib/rspec/models/unidom/article_number/concerns/as_marked_shared_examples.rb
 - lib/rspec/models/unidom/article_number/ean13_barcode_spec.rb
 - lib/rspec/models/unidom/article_number/ean8_barcode_spec.rb
 - lib/rspec/models/unidom/article_number/marking_spec.rb
@@ -69,14 +71,15 @@ files:
 - lib/unidom/article_number.rb
 - lib/unidom/article_number/engine.rb
 - lib/unidom/article_number/models_rspec.rb
+- lib/unidom/article_number/rspec_shared_examples.rb
 - lib/unidom/article_number/types_rspec.rb
 - lib/unidom/article_number/validators_rspec.rb
 - lib/unidom/article_number/version.rb
-homepage: https://github.com/topbitdu/unidom-article_number
+homepage: https://gitee.com/Unidom/unidom-article_number
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -91,9 +94,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.4
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
 summary: Unidom Article Number Domain Model Engine 物品编码领域模型引擎
 test_files: []