cats_core 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebf6bb336bcf7b1fa89d734c18444e8f41b586c480a24b675fb62d5a8e3d5528
-  data.tar.gz: 6a5adfade3042c981cc482f336393cd51265a636e56b2ae91b5f4c1d8193840a
+  metadata.gz: e1410fa75e3f9e4eb96e4c9df8cbd6bb358bb56e4cce6ef42b095aff3b6331b1
+  data.tar.gz: c1529759ffa5ba650bd31df10ae302943afc14e876fff0710a35144cf0841981
 SHA512:
-  metadata.gz: 5e3075ca71388f92b600ebfeb4d951e003b200987683a5de62d7138107d14efbd6c94a11425c1770e650ecf5facdcefd8ca90de71bb97d5b1685a9d787ef7ead
-  data.tar.gz: ecd7c5c357ea9e8a05c06523cd821a8c10fd21611e5cbc27390fefc8cec5aa54ea840175eb5c8419f484654bdb5a7918d2d551c36de242599e9b41dfa32377d8
+  metadata.gz: 9b31f50e3f08e9a65c1da38520f3afef988613654e5250607e48761274951d3be4975e6b47c704c65ad6211d03081ab1c60b3f6ae1eea6fae191d498bd021110
+  data.tar.gz: 4046501c4c360769d9bc23628f4e067b8c7b55d95f898d57fda4f202f75ddc73fa5d5a60e5f163cf37ab340024b12a28065bb80f8be9eb5f5fb64d81151e8863

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

@@ -3,7 +3,8 @@ module Cats
     class DispatchesController < ApplicationController
       include Common
 
-      before_action :set_service, only: %i[create_receipt_authorization approve start]
+      before_action :set_service, only: %i[create_receipt_authorization approve start search confirm]
+      before_action :set_dispatch, only: %i[approve start confirm]
 
       def index
         dispatches = Cats::Core::Dispatch.where(allocation_item_id: params[:id])
@@ -12,6 +13,7 @@ module Cats
 
       def create
         dispatch = Cats::Core::Dispatch.new(model_params)
+        dispatch.dispatch_status = Cats::Core::Dispatch::DRAFT
         dispatch.prepared_by = current_user
         if dispatch.save
           render json: { success: true, data: serialize(dispatch) }, status: :created
@@ -29,30 +31,44 @@ module Cats
       end
 
       def approve
-        dispatch = Cats::Core::Dispatch.find(params[:id])
-        dispatch = @service.approve(dispatch)
+        dispatch = @service.approve(@dispatch)
         render json: { success: true, data: serialize(dispatch) }
       rescue StandardError => e
         render json: { success: false, error: e.message }
       end
 
       def start
-        dispatch = Cats::Core::Dispatch.find(params[:id])
-        dispatch = @service.start(dispatch)
+        dispatch = @service.start(@dispatch)
         render json: { success: true, data: serialize(dispatch) }
       rescue StandardError => e
         render json: { success: false, error: e.message }
       end
 
+      def confirm
+        dispatch = @service.confirm(@dispatch)
+        render json: { success: true, data: serialize(dispatch) }
+      rescue StandardError => e
+        render json: { success: false, error: e.message }
+      end
+
+      def search
+        data = @service.search(current_user)
+        render json: { success: true, data: serialize(data) }
+      end
+
       private
 
       def set_service
         @service = DispatchService.new
       end
 
+      def set_dispatch
+        @dispatch = Cats::Core::Dispatch.find(params[:id])
+      end
+
       def model_params
         params.require(:payload).permit(:reference_no, :allocation_item_id, :transporter_id, :plate_no, :driver_name,
-                                        :driver_phone, :quantity, :remark, :dispatch_status)
+                                        :driver_phone, :quantity, :remark)
       end
     end
   end

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

@@ -0,0 +1,18 @@
+module Cats
+  module Core
+    class ReceiptsController < ApplicationController
+      include Common
+
+      def index
+        receipts = Cats::Core::Receipt.where(dispatch_id: params[:id])
+        render json: { success: true, data: serialize(receipts) }
+      end
+
+      private
+
+      def model_params
+        params.require(:payload).permit(:dispatch_id, :quantity, :commodity_status, :status, :remark, :prepared_by_id)
+      end
+    end
+  end
+end

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

@@ -13,6 +13,7 @@ module Cats
       belongs_to :prepared_by, class_name: 'Cats::Core::User'
       belongs_to :transporter
       belongs_to :allocation_item
+      has_many :receipts
 
       validates :reference_no, :plate_no, :driver_name, :driver_phone, :quantity, :commodity_status, presence: true
       validates :dispatch_status, presence: true, inclusion: { in: DISPATCH_STATUSES }

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

@@ -3,9 +3,8 @@ module Cats
     class Receipt < ApplicationRecord
       # Receipt status
       DRAFT = 'Draft'.freeze
-      ACCEPTED = 'Accepted'.freeze
-      DECLINED = 'Declined'.freeze
-      RECEIPT_STATUSES = [DRAFT, ACCEPTED, DECLINED].freeze
+      CONFIRMED = 'Confirmed'.freeze
+      RECEIPT_STATUSES = [DRAFT, CONFIRMED].freeze
 
       belongs_to :dispatch
       belongs_to :prepared_by, class_name: 'Cats::Core::User'
@@ -14,6 +13,28 @@ module Cats
       validates :quantity, numericality: { greater_than: 0 }
       validates :status, inclusion: { in: RECEIPT_STATUSES }
       validates :commodity_status, inclusion: { in: Cats::Core::Commodity::COMMODITY_STATUSES }
+      validate :validate_dispatch_status, :validate_total_quantity
+
+      delegate(:reference_no, to: :dispatch, prefix: true)
+      delegate(:email, to: :prepared_by, prefix: true)
+
+      def validate_dispatch_status
+        return unless dispatch
+
+        return if dispatch.dispatch_status == Cats::Core::Dispatch::STARTED
+
+        errors.add(:dispatch, 'Dispatch should be in "Started" state.')
+      end
+
+      def validate_total_quantity
+        return unless dispatch && quantity
+
+        received = Cats::Core::Receipt.where(dispatch: dispatch).sum(:quantity)
+        remaining = dispatch.quantity - received
+        return if quantity <= remaining
+
+        errors.add(:quantity, "Total receipt quantity is higher than dispatch quantity (Max = #{remaining}).")
+      end
     end
   end
 end

data/app/serializers/cats/core/receipt_serializer.rb

@@ -0,0 +1,4 @@
+class ReceiptSerializer < ActiveModel::Serializer
+  attributes :id, :dispatch_id, :dispatch_reference_no, :commodity_status, :quantity, :status, :remark,
+             :prepared_by_id, :prepared_by_email
+end

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

@@ -40,6 +40,53 @@ module Cats
         dispatch
       end
 
+      def search(user)
+        details = user.details
+
+        unless details['stores'] || details['warehouse'] || details['hub']
+          raise(StandardError, 'User does not have associated location.')
+        end
+
+        if details['stores']
+          warehouse = Cats::Core::Store.find(details['stores'][0]).warehouse
+          hub = warehouse.parent
+
+          dispatches = Cats::Core::Dispatch.joins(:allocation_item)
+                                           .where(
+                                             allocation_item: { destination: hub },
+                                             dispatch_status: Cats::Core::Dispatch::STARTED
+                                           ).or(
+                                             Cats::Core::Dispatch.joins(:allocation_item)
+                                                                 .where(
+                                                                   allocation_item: { destination: warehouse },
+                                                                   dispatch_status: Cats::Core::Dispatch::STARTED
+                                                                 )
+                                           )
+        elsif details['warehouse']
+          warehouse = Cats::Core::Location.find(details['warehouse'])
+          hub = warehouse.parent
+          dispatches = Cats::Core::Dispatch.joins(:allocation_item)
+                                           .where(
+                                             allocation_item: { destination: hub },
+                                             dispatch_status: Cats::Core::Dispatch::STARTED
+                                           ).or(
+                                             Cats::Core::Dispatch.joins(:allocation_item)
+                                                                 .where(
+                                                                   allocation_item: { destination: warehouse },
+                                                                   dispatch_status: Cats::Core::Dispatch::STARTED
+                                                                 )
+                                           )
+        elsif details['hub']
+          hub = Cats::Core::Location.find(details['hub'])
+          dispatches = Cats::Core::Dispatch.joins(:allocation_item)
+                                           .where(
+                                             allocation_item: { destination: hub },
+                                             dispatch_status: Cats::Core::Dispatch::STARTED
+                                           )
+        end
+        dispatches
+      end
+
       def approve(dispatch)
         unless dispatch.dispatch_status == Cats::Core::Dispatch::DRAFT
           raise(StandardError, 'Dispatch has to be in draft state.')
@@ -64,6 +111,26 @@ module Cats
         transactions.each(&:commit)
         dispatch
       end
+
+      def confirm(dispatch)
+        total = dispatch.receipts.sum(:quantity)
+
+        unless total == dispatch.quantity
+          raise(
+            StandardError,
+            "There is an amount of #{dispatch.quantity - total} in the dispatch which is unaccounted for."
+          )
+        end
+
+        Cats::Core::Dispatch.transaction do
+          dispatch.dispatch_status = Cats::Core::Dispatch::RECEIVED
+          dispatch.receipts.each { |r| r.status = Cats::Core::Receipt::CONFIRMED }
+          dispatch.save
+          dispatch.receipts.each(&:save)
+        end
+
+        dispatch
+      end
     end
   end
 end

data/config/routes.rb

@@ -56,11 +56,15 @@ Cats::Core::Engine.routes.draw do
        action: :create_receipt_authorization,
        as: :receipt_authorization_allocation_item
 
+  get '/dispatches/search', controller: :dispatches, action: :search, as: :search_dispatches
   resources :dispatches, except: %i[index destroy] do
     member do
+      get 'receipts', controller: :receipts, action: :index
       post 'approve'
       post 'start'
+      post 'confirm'
     end
   end
   resources :dispatch_transactions, except: %i[new edit destroy]
+  resources :receipts, except: %i[index new edit destroy]
 end

data/lib/cats/core/version.rb

@@ -1,5 +1,5 @@
 module Cats
   module Core
-    VERSION = '1.1.0'.freeze
+    VERSION = '1.1.1'.freeze
   end
 end

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

@@ -1,6 +1,6 @@
 FactoryBot.define do
   factory :receipt, class: 'Cats::Core::Receipt' do
-    dispatch
+    dispatch factory: :dispatch, dispatch_status: Cats::Core::Dispatch::STARTED
     quantity { 1.5 }
     commodity_status { Cats::Core::Commodity::GOOD }
     status { Cats::Core::Receipt::DRAFT }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cats_core
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Henock L.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-23 00:00:00.000000000 Z
+date: 2021-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: active_model_serializers
@@ -225,6 +225,7 @@ files:
 - app/controllers/cats/core/locations_controller.rb
 - app/controllers/cats/core/menus_controller.rb
 - app/controllers/cats/core/notifications_controller.rb
+- app/controllers/cats/core/receipts_controller.rb
 - app/controllers/cats/core/roles_controller.rb
 - app/controllers/cats/core/spaces_controller.rb
 - app/controllers/cats/core/unit_of_measures_controller.rb
@@ -275,6 +276,7 @@ files:
 - app/serializers/cats/core/dispatch_serializer.rb
 - app/serializers/cats/core/dispatch_transaction_serializer.rb
 - app/serializers/cats/core/location_serializer.rb
+- app/serializers/cats/core/receipt_serializer.rb
 - app/serializers/cats/core/role_menu_serializer.rb
 - app/serializers/cats/core/unit_of_measure_serializer.rb
 - app/services/cats/core/dispatch_service.rb