cats_core 1.3.29 → 1.3.33

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80cc6224c33fc3ce6d25d558a188ae7db720f032ae1dd18c39d2f74f67257eab
-  data.tar.gz: d866310b1bc91bc269538f80b9f944e3a2a4e1b6338490c209a74d343d897214
+  metadata.gz: c38a54131949eba79fc9b7fe05fec2201cb2f2631a63c00929c4ebbcb4b01084
+  data.tar.gz: be9da7ac9116b78d257846d5fd5451121dc838b473fc60acc0e684de1b35e7e4
 SHA512:
-  metadata.gz: f79355635f4c3fe924a112d88967a39140c47dd864b6ee3bb565093e8ec6768c8d973695dad89c822a69f2ae1bd5ff77e3650a7a05b4073ebeb73cb60ed04065
-  data.tar.gz: 0c66c37c48a2791a5726b107d840dcaddb6012f79d8998839d7995535cde0e5e89ca0b0198e5d0da5431d8a4e6e6fedd238c244e2816ae6f7ad24e897f3e17cc
+  metadata.gz: 270e76f46535f4ad1d8bd0dfaa13f94db98d8493379769682b64b7e314f0bcdbb0552c9f372606e9958634aa550108f9bceddd5212399ddb42c6ce62d1bceac4
+  data.tar.gz: d0072f07511d6a93f6e9592dd86b305be21096bfbb60dd936e406c21df8e545987c86a184307958a41bb1f7cf1ba05f767f96d935db7c1f55a2c986480fedfc5

data/app/controllers/cats/core/users_controller.rb

@@ -55,6 +55,8 @@ module Cats
           @user.add_detail(:warehouse, params[:warehouse_id])
         when 'hub_manager'
           @user.add_detail(:hub, params[:hub_id])
+        when 'regional_manager'
+          @user.add_detail(:region, params[:region_id])
         end
 
         data = ActiveModelSerializers::SerializableResource.new(role)
@@ -64,7 +66,7 @@ module Cats
       def revoke_role
         role = Cats::Core::Role.find(params[:role_id])
         @user.roles.delete(role)
-        @user.remove_detail(role.name) if %w[warehouse_manager hub_manager].include?(role.name)
+        @user.remove_detail(role.name) if %w[warehouse_manager hub_manager regional_manager].include?(role.name)
         data = ActiveModelSerializers::SerializableResource.new(role)
         render json: { success: true, data: data }
       end

data/app/models/cats/core/dispatch_plan_item.rb

@@ -1,13 +1,21 @@
 module Cats
   module Core
     class DispatchPlanItem < ApplicationRecord
+      AUTHORIZED = 'Authorized'.freeze
+      SOURCE_AUTHORIZED = 'Source Authorized'.freeze
+      DESTINATION_AUTHORIZED = 'Destination Authorized'.freeze
+      UNAUTHORIZED = 'Unauthorized'.freeze
+      STATUSES = [AUTHORIZED, DESTINATION_AUTHORIZED, SOURCE_AUTHORIZED, UNAUTHORIZED].freeze
+
       belongs_to :source, class_name: 'Cats::Core::Location'
       belongs_to :destination, class_name: 'Cats::Core::Location'
       belongs_to :dispatch_plan
       has_many :dispatches
+      has_many :hub_authorizations
 
-      validates :commodity_status, presence: true, inclusion: { in: Cats::Core::Commodity::COMMODITY_STATUSES }
+      validates :commodity_status, presence: true, inclusion: { in: Commodity::COMMODITY_STATUSES }
       validates :quantity, presence: true, numericality: { greater_than: 0 }
+      validates :status, presence: true, inclusion: { in: STATUSES }
 
       delegate(:reference_no, to: :dispatch_plan, prefix: :plan, allow_nil: true)
       delegate(:commodity_batch_no, :commodity_name, to: :dispatch_plan)
@@ -15,6 +23,63 @@ module Cats
       delegate(:name, to: :destination, prefix: true)
       delegate(:location_type, to: :source, prefix: true)
       delegate(:location_type, to: :destination, prefix: true)
+
+      # Authorize a dispatch plan item if it contains authorization entries
+      # under it. A dispatch plan item can be authorized by source hub, or
+      # source and destination hub. Hence the status can be `SOURCE_AUTHORIZED`,
+      # `AUTHORIZED`, or `UNAUTHORIZED` (default). This method sets those authorization
+      # values without any other interference by looking at available data and therefore
+      # no parameters are required.
+      #
+      def authorize
+        count = hub_authorizations.count
+        raise(StandardError, 'No authorization entries found.') if count.zero?
+
+        source_auth = hub_authorizations.where(authorization_type: HubAuthorization::SOURCE)
+        dest_auth = hub_authorizations.where(authorization_type: HubAuthorization::DESTINATION)
+
+        if source_auth.count.positive? && dest_auth.count.zero? && status == SOURCE_AUTHORIZED
+          raise(
+            StandardError,
+            'Plan item already authorized by source. Destination hub authorizations are required.'
+          )
+        end
+
+        if source_auth.count.zero? && dest_auth.count.positive? && status == DESTINATION_AUTHORIZED
+          raise(
+            StandardError,
+            'Plan item already authorized by destination. Source hub authorizations are required.'
+          )
+        end
+
+        total_src = source_auth.sum(&:quantity)
+        total_dest = dest_auth.sum(&:quantity)
+
+        if source_auth.count == count
+          validate_quantity(total_src, SOURCE_AUTHORIZED)
+          self.status = SOURCE_AUTHORIZED
+        elsif dest_auth.count == count
+          validate_quantity(total_dest, DESTINATION_AUTHORIZED)
+          self.status = DESTINATION_AUTHORIZED
+        else
+          validate_quantity(total_src, SOURCE_AUTHORIZED)
+          validate_quantity(total_dest, DESTINATION_AUTHORIZED)
+          self.status = AUTHORIZED
+        end
+        save!
+        self
+      end
+
+      def validate_quantity(quantity, type)
+        return if quantity == self.quantity
+
+        diff = self.quantity - quantity
+        desc = type.split(' ')[0].downcase
+        raise(
+          StandardError,
+          "Authorized #{desc} quantity is not the same as plan item quantity (#{diff} unaccounted for)."
+        )
+      end
     end
   end
 end

data/app/models/cats/core/donation.rb

@@ -19,7 +19,7 @@ module Cats
       validates :unit_of_measure, presence: true, if: -> { donation_type == KIND }
 
       delegate(:name, to: :donor, prefix: true)
-      delegate(:reference_no, to: :plan, prefix: true)
+      delegate(:reference_no, to: :plan, prefix: true, allow_nil: true)
       delegate(:name, to: :commodity_category, prefix: true, allow_nil: true)
       delegate(:code, to: :currency, prefix: true, allow_nil: true)
       delegate(:abbreviation, to: :unit_of_measure, prefix: true, allow_nil: true)

data/app/models/cats/core/hub_authorization.rb

@@ -0,0 +1,38 @@
+module Cats
+  module Core
+    class HubAuthorization < ApplicationRecord
+      SOURCE = 'Source'.freeze
+      DESTINATION = 'Destination'.freeze
+      AUTHORIZATION_TYPES = [SOURCE, DESTINATION].freeze
+
+      belongs_to :dispatch_plan_item, optional: true
+      belongs_to :store
+      belongs_to :authorized_by, class_name: 'Cats::Core::User'
+
+      validates :quantity, :authorization_type, presence: true
+      validates :quantity, numericality: { greater_than: 0 }
+      validates :authorization_type, inclusion: { in: AUTHORIZATION_TYPES }
+      validate :validate_quantity, on: %i[create update]
+
+      delegate(:plan_reference_no, to: :dispatch_plan_item)
+      delegate(:full_name, to: :authorized_by, prefix: true)
+      delegate(:name, to: :store, prefix: true)
+
+      def validate_quantity
+        return unless quantity
+
+        return unless dispatch_plan_item
+
+        total = dispatch_plan_item.quantity
+        used = HubAuthorization.where(
+          dispatch_plan_item: dispatch_plan_item,
+          authorization_type: authorization_type
+        ).sum(:quantity)
+        used -= quantity_was if quantity_was
+
+        remaining = total - used
+        errors.add(:quantity, "exceeds allocated quantity. Maximum allowed is #{remaining}") if quantity > remaining
+      end
+    end
+  end
+end

data/app/models/cats/core/monthly_plan_item_detail.rb

@@ -5,6 +5,10 @@ module Cats
       belongs_to :monthly_ration
 
       validates :amount, presence: true, numericality: { greater_than: 0 }
+
+      delegate(:commodity_category_name, to: :monthly_ration)
+      delegate(:unit_of_measure_abbreviation, to: :monthly_ration)
+      delegate(:no_of_days, to: :monthly_ration)
     end
   end
 end

data/db/migrate/20210718043401_create_cats_core_dispatch_plan_items.rb

@@ -15,6 +15,7 @@ class CreateCatsCoreDispatchPlanItems < ActiveRecord::Migration[6.1]
                    foreign_key: { to_table: :cats_core_locations }
       t.float :quantity, null: false
       t.string :commodity_status, null: false, default: 'Good'
+      t.string :status, null: false, default: 'Unauthorized'
 
       t.timestamps
     end

data/db/migrate/20220209083928_create_cats_core_hub_authorizations.rb

@@ -0,0 +1,22 @@
+class CreateCatsCoreHubAuthorizations < ActiveRecord::Migration[7.0]
+  def change
+    create_table :cats_core_hub_authorizations do |t|
+      t.references :dispatch_plan_item,
+                   null: true,
+                   index: { name: 'dpi_on_ha_indx' },
+                   foreign_key: { to_table: :cats_core_dispatch_plan_items }
+      t.references :store,
+                   null: false,
+                   index: { name: 'store_on_ha_indx' },
+                   foreign_key: { to_table: :cats_core_stores }
+      t.float :quantity, null: false
+      t.string :authorization_type, null: false
+      t.references :authorized_by,
+                   null: false,
+                   index: { name: 'ab_on_ha_indx' },
+                   foreign_key: { to_table: :cats_core_users }
+
+      t.timestamps
+    end
+  end
+end

data/lib/cats/core/version.rb

@@ -1,5 +1,5 @@
 module Cats
   module Core
-    VERSION = '1.3.29'.freeze
+    VERSION = '1.3.33'.freeze
   end
 end

data/spec/factories/cats/core/dispatch_plan_items.rb

@@ -5,5 +5,6 @@ FactoryBot.define do
     dispatch_plan
     quantity { 100 }
     commodity_status { Cats::Core::Commodity::GOOD }
+    status { Cats::Core::DispatchPlanItem::UNAUTHORIZED }
   end
 end

data/spec/factories/cats/core/hub_authorizations.rb

@@ -0,0 +1,9 @@
+FactoryBot.define do
+  factory :hub_authorization, class: 'Cats::Core::HubAuthorization' do
+    dispatch_plan_item
+    store
+    quantity { 100 }
+    authorization_type { Cats::Core::HubAuthorization::SOURCE }
+    authorized_by factory: :user
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cats_core
 version: !ruby/object:Gem::Version
-  version: 1.3.29
+  version: 1.3.33
 platform: ruby
 authors:
 - Henock L.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-05 00:00:00.000000000 Z
+date: 2022-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: active_model_serializers
@@ -267,6 +267,7 @@ files:
 - app/models/cats/core/donation.rb
 - app/models/cats/core/donor.rb
 - app/models/cats/core/gift_certificate.rb
+- app/models/cats/core/hub_authorization.rb
 - app/models/cats/core/location.rb
 - app/models/cats/core/menu.rb
 - app/models/cats/core/menu_item.rb
@@ -391,6 +392,7 @@ files:
 - db/migrate/20220107124630_create_cats_core_monthly_rations.rb
 - db/migrate/20220107125025_create_cats_core_monthly_plan_items.rb
 - db/migrate/20220107132433_create_cats_core_monthly_plan_item_details.rb
+- db/migrate/20220209083928_create_cats_core_hub_authorizations.rb
 - lib/cats/core.rb
 - lib/cats/core/engine.rb
 - lib/cats/core/version.rb
@@ -411,6 +413,7 @@ files:
 - spec/factories/cats/core/donations.rb
 - spec/factories/cats/core/donors.rb
 - spec/factories/cats/core/gift_certificates.rb
+- spec/factories/cats/core/hub_authorizations.rb
 - spec/factories/cats/core/locations.rb
 - spec/factories/cats/core/menu_items.rb
 - spec/factories/cats/core/menus.rb