cats_core 1.4.40 → 1.4.43

data/app/services/cats/core/beneficiary_service.rb

@@ -0,0 +1,87 @@
+module Cats
+  module Core
+    class BeneficiaryService
+      def clear_distribution_list(id)
+        round_plan = RoundPlan.find(id)
+        raise(StandardError, 'Round plan is not in draft state.') unless round_plan.status == RoundPlan::DRAFT
+
+        RoundBeneficiary.joins(:round_plan_item).where(round_plan_item: { round_plan_id: id }).delete_all
+      end
+
+      def generate_distribution_list(id)
+        clear_distribution_list(id)
+        round_plan = RoundPlan.find(id)
+        plan_days = round_plan.plan.no_of_round_days
+        rounds = round_plan.rounds.count
+        beneficiaries = Beneficiary.joins(:beneficiary_category).where(
+          beneficiary_category: { plan_id: round_plan.plan_id }
+        ).group_by(&:fdp_id)
+        beneficiaries.each_key do |key|
+          beneficiaries[key] = beneficiaries[key].group_by(&:beneficiary_category_id)
+        end
+        rations = round_plan.round_rations
+
+        round_beneficiaries = []
+        round_plan.round_plan_items.each do |rpi|
+          fdp_beneficiaries = beneficiaries[rpi.fdp_id]
+          fdp_beneficiaries.each_key do |key|
+            category_rations = rations.select { |r| r.beneficiary_category_id == key }
+            category_rations.each do |ration|
+              fdp_beneficiaries[key].each do |beneficiary|
+                round_beneficiaries << {
+                  beneficiary_id: beneficiary.id,
+                  round_plan_item_id: rpi.id,
+                  commodity_category_id: ration.commodity_category_id,
+                  quantity: plan_days / ration.no_of_days * ration.quantity * rounds,
+                  unit_id: ration.unit_of_measure_id,
+                  received: false
+                }
+              end
+            end
+          end
+        end
+
+        RoundBeneficiary.insert_all!(round_beneficiaries, record_timestamps: true)
+        true
+      end
+
+      def remove_items(plan_id, ids)
+        raise(StandardError, 'No beneficiaries specified.') if ids.count.zero?
+
+        begin
+          plan = RoundPlan.find(plan_id)
+        rescue ActiveRecord::RecordNotFound
+          raise(StandardError, 'Round plan not found.') unless plan
+        end
+
+        beneficiaries = RoundBeneficiary.joins(:round_plan_item)
+                                        .where(round_plan_item: { round_plan_id: plan_id })
+        to_delete = RoundBeneficiary.where(id: ids)
+        diff = to_delete - beneficiaries
+        raise(StandardError, 'Round plan beneficiaries should be from the same plan.') if diff.count.positive?
+
+        to_delete.delete_all
+        true
+      end
+
+      def confirm_receipt(plan_id, ids)
+        raise(StandardError, 'No beneficiaries specified.') if ids.count.zero?
+
+        begin
+          plan = RoundPlan.find(plan_id)
+        rescue ActiveRecord::RecordNotFound
+          raise(StandardError, 'Round plan not found.') unless plan
+        end
+
+        beneficiaries = RoundBeneficiary.joins(:round_plan_item)
+                                        .where(round_plan_item: { round_plan_id: plan_id })
+        to_confirm = RoundBeneficiary.where(id: ids)
+        diff = to_confirm - beneficiaries
+        raise(StandardError, 'Round plan beneficiaries should be from the same plan.') if diff.count.positive?
+
+        to_confirm.update_all(received: true)
+        true
+      end
+    end
+  end
+end

data/app/services/cats/core/dispatch_plan_service.rb

@@ -59,6 +59,85 @@ module Cats
           end
         end
       end
+
+      # This method generates dispatch plan for a round plan by aggregating the FDP level
+      # quantities into woreda level quantity per commodity.
+      #
+      # Parameters:
+      #   id => The ID of the round plan for which dispatch plan is to be generated
+      #
+      def generate(id)
+        details = RoundPlanItemDetail.joins(
+          beneficiary_round_plan_item: { round_plan_item: :round_plan }
+        ).where(
+          beneficiary_round_plan_item: { cats_core_round_plan_items: { round_plan_id: id } }
+        ).includes(
+          beneficiary_round_plan_item: {
+            round_plan_item: %i[round_plan region zone woreda fdp]
+          },
+          round_ration: :commodity_category
+        )
+
+        items = details.each_with_object([]) do |detail, res|
+          res << {
+            reference_no: nil,
+            region: detail.beneficiary_round_plan_item.round_plan_item.region.name,
+            zone: detail.beneficiary_round_plan_item.round_plan_item.zone.name,
+            woreda: detail.beneficiary_round_plan_item.round_plan_item.woreda.name,
+            fdp: detail.beneficiary_round_plan_item.round_plan_item.fdp.name,
+            commodity_category: detail.round_ration.commodity_category.name,
+            unit_id: detail.round_ration.unit_of_measure_id,
+            unit: detail.round_ration.unit_of_measure.abbreviation,
+            quantity: detail.quantity,
+            source_id: nil,
+            destination_id: detail.beneficiary_round_plan_item.round_plan_item.fdp.id,
+            commodity_id: nil,
+            commodity_status: Cats::Core::Commodity::GOOD
+          }
+        end
+        {
+          reference_no: nil,
+          dispatchable_id: id,
+          dispatchable_type: 'Cats::Core::RoundPlan',
+          items: items
+        }
+      end
+
+      # This method creates dispatch and dispatch plan items once
+      # users fill out additional details such as source and destination
+      # for generated dispatch plan items.
+      #
+      # NOTE: Users still have to go through each plan item and set the
+      #       reference_no. If the product team comes up with a reference_no
+      #       generation scheme, then we may use that to avoid this.
+      #
+      def bulk_create(payload, user)
+        plan = Cats::Core::DispatchPlan.new(
+          reference_no: payload[:reference_no],
+          dispatchable_id: payload[:dispatchable_id],
+          dispatchable_type: payload[:dispatchable_type],
+          prepared_by: user
+        )
+        ActiveRecord::Base.transaction do
+          plan.save!
+
+          items = payload[:items].each_with_object([]) do |item, res|
+            res << {
+              reference_no: item[:reference_no],
+              source_id: item[:source_id],
+              destination_id: item[:destination_id],
+              dispatch_plan_id: plan.id,
+              quantity: item[:quantity],
+              unit_id: item[:unit_id],
+              commodity_id: item[:commodity_id],
+              commodity_status: item[:commodity_status],
+              status: Cats::Core::DispatchPlanItem::UNAUTHORIZED
+            }
+          end
+          Cats::Core::DispatchPlanItem.insert_all(items, record_timestamps: true)
+        end
+        plan
+      end
     end
   end
 end

data/config/routes.rb

@@ -84,7 +84,18 @@ Cats::Core::Engine.routes.draw do
   post '/routes/bulk_create', controller: :routes, action: :bulk_create
   resources :routes, except: %i[destroy]
 
+  resources :commodity_donations, except: %i[destroy]
+  resources :purchase_orders, except: %i[index destroy]
+  resources :cash_donations, except: %i[destroy] do
+    member do
+      get 'purchase_orders', controller: :purchase_orders, action: :index
+    end
+  end
+  resources :swaps, except: %i[destory]
+  resources :loans, except: %i[destory]
+
   post '/dispatch_plans/filter', controller: :dispatch_plans, action: :filter
+  post '/dispatch_plans/bulk_create'
   resources :dispatch_plans do
     member do
       get 'items', controller: :dispatch_plan_items, action: :index
@@ -160,13 +171,21 @@ Cats::Core::Engine.routes.draw do
   resources :receipt_transactions, except: %i[index new edit destroy]
   resources :lost_commodities, except: %i[index destroy]
   get '/plans/:id/round_plans', controller: :round_plans, action: :index, as: :round_plans_plan
+  
+  post '/round_beneficiaries/filter'
+  resources :round_beneficiaries, only: %i[show]
   post '/round_plans/generate'
   post '/round_plans/filter'
   resources :round_plans, except: %i[index destroy] do
     member do
+      post 'generate_dispatch_plan', controller: :dispatch_plans, action: :generate
       post 'remove_items'
+      post 'remove_beneficiaries', controller: :round_beneficiaries, action: :remove_beneficiaries
+      post 'confirm_receipt', controller: :round_beneficiaries, action: :confirm_receipt
       post 'generate_round_needs'
       post 'approve'
+      post 'generate_distribution_list', controller: :round_beneficiaries, action: :generate
+      get 'beneficiaries', controller: :round_beneficiaries, action: :index
     end
   end
 

data/db/migrate/20210717032330_create_cats_core_commodity_donations.rb

@@ -0,0 +1,29 @@
+class CreateCatsCoreCommodityDonations < ActiveRecord::Migration[6.1]
+  def change
+    create_table :cats_core_commodity_donations do |t|
+      t.string :reference_no, unique: true
+      t.string :description
+      t.string :shipping_reference
+      t.date :donated_on, null: false
+      t.references :donor,
+                   null: false,
+                   index: { name: 'donor_on_cd_indx' },
+                   foreign_key: { to_table: :cats_core_donors }
+      t.references :commodity_category,
+                   null: false,
+                   index: { name: 'cc_on_cd_indx' },
+                   foreign_key: { to_table: :cats_core_commodity_categories }
+      t.references :plan,
+                   null: true,
+                   index: { name: 'plan_on_cd_indx' },
+                   foreign_key: { to_table: :cats_core_plans }
+      t.float :quantity, null: false
+      t.references :unit,
+                   null: false,
+                   index: { name: 'unit_on_cd_indx' },
+                   foreign_key: { to_table: :cats_core_unit_of_measures }
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20210717032408_create_cats_core_cash_donations.rb

@@ -0,0 +1,20 @@
+class CreateCatsCoreCashDonations < ActiveRecord::Migration[7.0]
+  def change
+    create_table :cats_core_cash_donations do |t|
+      t.string :reference_no, unique: true
+      t.string :description
+      t.date :donated_on, null: false
+      t.references :donor,
+                   null: false,
+                   index: { name: 'donor_on_cad_indx' },
+                   foreign_key: { to_table: :cats_core_donors }
+      t.float :amount, null: false
+      t.references :currency,
+                   null: false,
+                   index: { name: 'currency_on_cad_indx' },
+                   foreign_key: { to_table: :cats_core_currencies }
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20210717032602_create_cats_core_gift_certificates.rb

@@ -3,12 +3,6 @@ class CreateCatsCoreGiftCertificates < ActiveRecord::Migration[6.1]
     create_table :cats_core_gift_certificates do |t|
       t.string :reference_no, unique: true
       t.date :gift_date, null: false
-
-      t.references :donation,
-                   null: true,
-                   index: { name: 'gc_on_donation_indx' },
-                   foreign_key: { to_table: :cats_core_donations }
-
       t.string :vessel
       t.string :port
       t.string :customs_declaration_no
@@ -20,9 +14,9 @@ class CreateCatsCoreGiftCertificates < ActiveRecord::Migration[6.1]
                    null: false,
                    index: { name: 'gc_on_cc_indx' },
                    foreign_key: { to_table: :cats_core_commodity_categories }
-      t.references :unit_of_measure,
+      t.references :unit,
                    null: false,
-                   index: { name: 'uom_on_gc_indx' },
+                   index: { name: 'unit_on_gc_indx' },
                    foreign_key: { to_table: :cats_core_unit_of_measures }
       t.references :destination_warehouse,
                    null: false,

data/db/migrate/20210717032855_create_cats_core_purchase_orders.rb

@@ -7,14 +7,18 @@ class CreateCatsCorePurchaseOrders < ActiveRecord::Migration[6.1]
       t.string :supplier, null: false
       t.float :quantity, null: false
       t.string :purchase_type, null: false
-
-      t.references :donation,
+      t.float :price, null: false
+      t.references :currency,
+                   null: false,
+                   index: { name: 'currency_on_po_indx' },
+                   foreign_key: { to_table: :cats_core_currencies }
+      t.references :cash_donation,
                    null: false,
-                   index: { name: 'po_on_donation_indx' },
-                   foreign_key: { to_table: :cats_core_donations }
+                   index: { name: 'cd_on_po_indx' },
+                   foreign_key: { to_table: :cats_core_cash_donations }
       t.references :commodity_category,
                    null: false,
-                   index: { name: 'po_on_cc_indx' },
+                   index: { name: 'cc_on_po_indx' },
                    foreign_key: { to_table: :cats_core_commodity_categories }
       t.references :unit,
                    null: false,

data/db/migrate/20220511082354_create_cats_core_beneficiaries.rb

@@ -9,6 +9,10 @@ class CreateCatsCoreBeneficiaries < ActiveRecord::Migration[7.0]
                    null: false,
                    index: { name: 'bc_on_beneficiaries_indx' },
                    foreign_key: { to_table: :cats_core_beneficiary_categories }
+      t.references :fdp,
+                   null: false,
+                   index: { name: 'fdp_on_beneficiaries_indx' },
+                   foreign_key: { to_table: :cats_core_locations }
 
       t.timestamps
     end

data/db/migrate/20220626063501_create_cats_core_loans.rb

@@ -0,0 +1,21 @@
+class CreateCatsCoreLoans < ActiveRecord::Migration[7.0]
+  def change
+    create_table :cats_core_loans do |t|
+      t.string :reference_no, unique: true
+      t.string :lender, null: false
+      t.date :agreement_date, null: false
+      t.date :repayment_date
+      t.references :commodity_category,
+                   null: false,
+                   index: { name: 'cc_on_loan_indx' },
+                   foreign_key: { to_table: :cats_core_commodity_categories }
+      t.float :quantity, null: false
+      t.references :unit,
+                   null: false,
+                   index: { name: 'unit_on_loan_indx' },
+                   foreign_key: { to_table: :cats_core_unit_of_measures }
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20220626063757_create_cats_core_swaps.rb

@@ -0,0 +1,29 @@
+class CreateCatsCoreSwaps < ActiveRecord::Migration[7.0]
+  def change
+    create_table :cats_core_swaps do |t|
+      t.string :reference_no, unique: true
+      t.string :swapper, null: false
+      t.date :agreement_date, null: false
+      t.float :issued_quantity, null: false
+      t.float :received_quantity, null: false
+      t.references :issued_commodity,
+                   null: false,
+                   index: { name: 'ic_on_swap_indx' },
+                   foreign_key: { to_table: :cats_core_commodity_categories }
+      t.references :received_commodity,
+                   null: false,
+                   index: { name: 'rc_on_swap_indx' },
+                   foreign_key: { to_table: :cats_core_commodity_categories }
+      t.references :issued_unit,
+                   null: false,
+                   index: { name: 'iu_on_swap_indx' },
+                   foreign_key: { to_table: :cats_core_unit_of_measures }
+      t.references :received_unit,
+                   null: false,
+                   index: { name: 'ru_on_swap_indx' },
+                   foreign_key: { to_table: :cats_core_unit_of_measures }
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20220626132050_create_cats_core_round_beneficiaries.rb

@@ -0,0 +1,26 @@
+class CreateCatsCoreRoundBeneficiaries < ActiveRecord::Migration[7.0]
+  def change
+    create_table :cats_core_round_beneficiaries do |t|
+      t.references :beneficiary, 
+                   null: false,
+                   index: { name: 'beneficiary_on_rb_indx' },
+                   foreign_key: { to_table: :cats_core_beneficiaries }
+      t.references :round_plan_item,
+                   null: false,
+                   index: { name: 'rpi_on_rb_indx' },
+                   foreign_key: { to_table: :cats_core_round_plan_items }
+      t.references :commodity_category,
+                   null: false,
+                   index: { name: 'cc_on_rb_indx' },
+                   foreign_key: { to_table: :cats_core_commodity_categories }
+      t.float :quantity, null: false
+      t.references :unit,
+                   null: false,
+                   index: { name: 'unit_on_rb_indx' },
+                   foreign_key: { to_table: :cats_core_unit_of_measures }
+      t.boolean :received, null: false, default: false
+
+      t.timestamps
+    end
+  end
+end

data/lib/cats/core/version.rb

@@ -1,5 +1,5 @@
 module Cats
   module Core
-    VERSION = '1.4.40'.freeze
+    VERSION = '1.4.43'.freeze
   end
 end

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

@@ -5,5 +5,6 @@ FactoryBot.define do
     gender { 'M' }
     phone { '0911121212' }
     beneficiary_category
+    fdp factory: :fdp
   end
 end

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

@@ -0,0 +1,10 @@
+FactoryBot.define do
+  factory :cash_donation, class: 'Cats::Core::CashDonation' do
+    reference_no { FFaker::Name.name }
+    description { FFaker::Name.name }
+    donated_on { Date.today.prev_week }
+    donor
+    amount { 10_000 }
+    currency
+  end
+end

data/spec/factories/cats/core/{donations.rb → commodity_donations.rb}

@@ -1,16 +1,13 @@
 FactoryBot.define do
-  factory :donation, class: 'Cats::Core::Donation' do
+  factory :commodity_donation, class: 'Cats::Core::CommodityDonation' do
     reference_no { FFaker::Name.name }
     description { FFaker::Name.name }
-    donation_type { Cats::Core::Donation::KIND }
     shipping_reference { FFaker::Name.name }
     donated_on { Date.today }
     donor
     plan
-    amount { 100 }
-    currency { nil }
+    quantity { 100 }
     commodity_category
-    unit_of_measure
-    active { false }
+    unit factory: :unit_of_measure
   end
 end

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

@@ -2,10 +2,6 @@ FactoryBot.define do
   factory :gift_certificate, class: 'Cats::Core::GiftCertificate' do
     reference_no { FFaker::Name.name }
     gift_date { Date.today - 1.month }
-    donation
-    commodity_category { donation.commodity_category }
-    unit_of_measure
-    destination_warehouse factory: :warehouse
     vessel { FFaker::Name.name }
     port { FFaker::Name.name }
     customs_declaration_no { FFaker::Name.name }
@@ -13,8 +9,11 @@ FactoryBot.define do
     expiry_date { Date.today + 6.month }
     bill_of_lading_no { FFaker::Name.name }
     quantity { 1.5 }
-    estimated_price { 1.5 }
-    estimated_tax { 1.5 }
+    commodity_category
+    unit factory: :unit_of_measure
+    destination_warehouse factory: :warehouse
+    estimated_price { 500 }
+    estimated_tax { 200 }
     currency
     registration_no { FFaker::Name.name }
     requested_by { FFaker::Name.name }

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

@@ -0,0 +1,11 @@
+FactoryBot.define do
+  factory :loan, class: 'Cats::Core::Loan' do
+    reference_no { FFaker::Name.name }
+    lender { FFaker::Name.name }
+    agreement_date { Date.today }
+    repayment_date { agreement_date.next_month }
+    commodity_category
+    quantity { 100 }
+    unit factory: :unit_of_measure
+  end
+end

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

@@ -2,7 +2,7 @@ FactoryBot.define do
   factory :project, class: 'Cats::Core::Project' do
     code { FFaker::Name.name }
     description { FFaker::Name.name }
-    source factory: :gift_certificate
+    source factory: :commodity_donation
     program
     year { 2022 }
     implementing_agency { FFaker::Name.name }

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

@@ -6,7 +6,9 @@ FactoryBot.define do
     supplier { FFaker::Name.name }
     quantity { 100 }
     purchase_type { Cats::Core::PurchaseOrder::LOCAL }
-    donation
+    price { 1_000 }
+    currency
+    cash_donation
     commodity_category
     unit factory: :unit_of_measure
   end

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

@@ -0,0 +1,10 @@
+FactoryBot.define do
+  factory :round_beneficiary, class: 'Cats::Core::RoundBeneficiary' do
+    beneficiary
+    round_plan_item
+    commodity_category
+    quantity { 150 }
+    unit factory: :unit_of_measure
+    received { false }
+  end
+end

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

@@ -0,0 +1,13 @@
+FactoryBot.define do
+  factory :swap, class: 'Cats::Core::Swap' do
+    reference_no { FFaker::Name.name }
+    swapper { FFaker::Name.name }
+    agreement_date { Date.yesterday }
+    issued_commodity factory: :commodity_category
+    issued_quantity { 100 }
+    issued_unit factory: :unit_of_measure
+    received_commodity factory: :commodity_category
+    received_quantity { 150 }
+    received_unit factory: :unit_of_measure
+  end
+end