cats_core 1.0.50 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b13a3549ac212c8e869ce5aff6b3508787e75af7afaeadba4b0e99f5476b101e
-  data.tar.gz: d4993f0e36936fc4ed18ae9accca173189056c3cddae7fc2f16704f6509bac80
+  metadata.gz: ebf6bb336bcf7b1fa89d734c18444e8f41b586c480a24b675fb62d5a8e3d5528
+  data.tar.gz: 6a5adfade3042c981cc482f336393cd51265a636e56b2ae91b5f4c1d8193840a
 SHA512:
-  metadata.gz: 91d4ba5e59ef7da90cf36d6073d20819496bae612eff73cdeccada481293a956311732201b049da61e84ba1c12b1a7464d636202b101f66a49bcf22146211440
-  data.tar.gz: afdceef95b3321eaea7ebad43bd622b814ef268f97b20c5815af07376fc710b338b74a25bc3e81d6c4b366f00e30e6553c2f2dcc38e84685bc670201ce4e4e13
+  metadata.gz: 5e3075ca71388f92b600ebfeb4d951e003b200987683a5de62d7138107d14efbd6c94a11425c1770e650ecf5facdcefd8ca90de71bb97d5b1685a9d787ef7ead
+  data.tar.gz: ecd7c5c357ea9e8a05c06523cd821a8c10fd21611e5cbc27390fefc8cec5aa54ea840175eb5c8419f484654bdb5a7918d2d551c36de242599e9b41dfa32377d8

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

@@ -0,0 +1,13 @@
+module Cats
+  module Core
+    class DispatchTransactionsController < ApplicationController
+      include Common
+
+      private
+
+      def model_params
+        params.require(:payload).permit(:source_id, :destination_id, :transaction_date, :quantity)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,59 @@
+module Cats
+  module Core
+    class DispatchesController < ApplicationController
+      include Common
+
+      before_action :set_service, only: %i[create_receipt_authorization approve start]
+
+      def index
+        dispatches = Cats::Core::Dispatch.where(allocation_item_id: params[:id])
+        render json: { success: true, data: serialize(dispatches) }
+      end
+
+      def create
+        dispatch = Cats::Core::Dispatch.new(model_params)
+        dispatch.prepared_by = current_user
+        if dispatch.save
+          render json: { success: true, data: serialize(dispatch) }, status: :created
+        else
+          render json: { success: false, error: dispatch.errors.full_messages[0] }, status: :unprocessable_entity
+        end
+      end
+
+      def create_receipt_authorization
+        allocation_item = Cats::Core::AllocationItem.find(params[:id])
+        dispatch = @service.create_receipt_authorization(
+          params[:reference_no], allocation_item, params[:quantity], params[:remark], current_user
+        )
+        render json: { success: true, data: serialize(dispatch) }
+      end
+
+      def approve
+        dispatch = Cats::Core::Dispatch.find(params[:id])
+        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)
+        render json: { success: true, data: serialize(dispatch) }
+      rescue StandardError => e
+        render json: { success: false, error: e.message }
+      end
+
+      private
+
+      def set_service
+        @service = DispatchService.new
+      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)
+      end
+    end
+  end
+end

data/app/controllers/concerns/cats/core/common.rb

@@ -0,0 +1,55 @@
+module Cats
+  module Core
+    module Common
+      extend ActiveSupport::Concern
+
+      included do
+        before_action :set_clazz
+        before_action :set_object, only: %i[show update]
+      end
+
+      def index
+        data = serialize(@clazz.all)
+        render json: { success: true, data: data }
+      end
+
+      def show
+        render json: { success: true, data: serialize(@obj) }
+      end
+
+      def create
+        obj = @clazz.new(model_params)
+        if obj.save
+          render json: { success: true, data: serialize(obj) }, status: :created
+        else
+          render json: { success: false, error: obj.errors.full_messages[0] }, status: :unprocessable_entity
+        end
+      end
+
+      def update
+        if @obj.update(model_params)
+          render json: { success: true, data: serialize(@obj) }
+        else
+          render json: { success: false, error: @obj.errors.full_messages[0] }, status: :unprocessable_entity
+        end
+      end
+
+      private
+
+      def serialize(data)
+        ActiveModelSerializers::SerializableResource.new(data)
+      end
+
+      def set_clazz
+        @clazz = "Cats::Core::#{controller_name.classify}".constantize
+      end
+
+      def set_object
+        @obj = @clazz.find(params[:id])
+      end
+
+      # This class should be overridden by respective child controllers
+      def model_params; end
+    end
+  end
+end

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

@@ -0,0 +1,8 @@
+class DispatchSerializer < ActiveModel::Serializer
+  attributes :id, :reference_no, :allocation_item_id, :transporter_id, :transporter_name, :plate_no, :driver_name,
+             :driver_phone, :quantity, :remark, :prepared_by_id, :prepared_by_email, :dispatch_status, :destination
+
+  def destination
+    object.allocation_item.destination.name
+  end
+end

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

@@ -0,0 +1,4 @@
+class DispatchTransactionSerializer < ActiveModel::Serializer
+  attributes :id, :source_id, :source_code, :destination_id, :destination_reference_no, :quantity, :transaction_date,
+             :status
+end

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

@@ -0,0 +1,69 @@
+module Cats
+  module Core
+    class DispatchService
+      def create_receipt_authorization(reference_no, allocation_item, quantity, remark, user)
+        status = allocation_item.allocation.allocation_status
+        raise(StandardError, 'Allocation not approved.') unless status == Cats::Core::Allocation::APPROVED
+
+        transporter = Cats::Core::Transporter.find_by(code: 'SUP-TRANS')
+        raise(StandardError, 'Supplier transporter does not exist.') unless transporter
+
+        store = Cats::Core::Store.find_by(code: 'SUP-STORE')
+        raise(StandardError, 'Supplier store does not exist.') unless store
+
+        commodity = allocation_item.allocation.commodity
+        stack = store.stacks.find_by(commodity: commodity)
+
+        raise(StandardError, 'Commodity not found in supplier store.') unless stack
+
+        dispatch = Cats::Core::Dispatch.create!(
+          reference_no: reference_no,
+          allocation_item: allocation_item,
+          transporter: transporter,
+          plate_no: 'Supplier plate no',
+          driver_name: 'Supplier driver',
+          driver_phone: 'Supplier driver phone',
+          quantity: quantity,
+          remark: remark,
+          prepared_by: user,
+          dispatch_status: Cats::Core::Dispatch::DRAFT
+        )
+
+        # Create a dispatch transaction
+        Cats::Core::DispatchTransaction.create!(
+          source: stack,
+          destination: dispatch,
+          transaction_date: Date.today,
+          quantity: quantity,
+          status: Cats::Core::Transaction::DRAFT
+        )
+        dispatch
+      end
+
+      def approve(dispatch)
+        unless dispatch.dispatch_status == Cats::Core::Dispatch::DRAFT
+          raise(StandardError, 'Dispatch has to be in draft state.')
+        end
+
+        transactions = Cats::Core::DispatchTransaction.where(destination: dispatch).count
+        raise(StandardError, 'Dispatch has no transactions.') unless transactions.positive?
+
+        dispatch.dispatch_status = Cats::Core::Dispatch::APPROVED
+        dispatch.save
+        dispatch
+      end
+
+      def start(dispatch)
+        unless dispatch.dispatch_status == Cats::Core::Dispatch::APPROVED
+          raise(StandardError, 'Dispatch has to be approved first.')
+        end
+
+        dispatch.dispatch_status = Cats::Core::Dispatch::STARTED
+        dispatch.save
+        transactions = Cats::Core::DispatchTransaction.where(destination: dispatch)
+        transactions.each(&:commit)
+        dispatch
+      end
+    end
+  end
+end

data/config/routes.rb

@@ -49,4 +49,18 @@ Cats::Core::Engine.routes.draw do
   end
   resources :currencies, except: %i[destroy]
   resources :unit_of_measures, except: %i[destroy]
+
+  get '/allocation_items/:id/dispatches', controller: :dispatches, action: :index, as: :dispatches_allocation_item
+  post '/allocation_items/:id/receipt_authorizaton',
+       controller: :dispatches,
+       action: :create_receipt_authorization,
+       as: :receipt_authorization_allocation_item
+
+  resources :dispatches, except: %i[index destroy] do
+    member do
+      post 'approve'
+      post 'start'
+    end
+  end
+  resources :dispatch_transactions, except: %i[new edit destroy]
 end

data/lib/cats/core/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cats_core
 version: !ruby/object:Gem::Version
-  version: 1.0.50
+  version: 1.1.0
 platform: ruby
 authors:
 - Henock L.
@@ -220,6 +220,8 @@ files:
 - app/controllers/cats/core/application_controller.rb
 - app/controllers/cats/core/commodity_categories_controller.rb
 - app/controllers/cats/core/currencies_controller.rb
+- app/controllers/cats/core/dispatch_transactions_controller.rb
+- app/controllers/cats/core/dispatches_controller.rb
 - app/controllers/cats/core/locations_controller.rb
 - app/controllers/cats/core/menus_controller.rb
 - app/controllers/cats/core/notifications_controller.rb
@@ -227,6 +229,7 @@ files:
 - app/controllers/cats/core/spaces_controller.rb
 - app/controllers/cats/core/unit_of_measures_controller.rb
 - app/controllers/cats/core/users_controller.rb
+- app/controllers/concerns/cats/core/common.rb
 - app/jobs/cats/core/application_job.rb
 - app/models/cats/core/allocation.rb
 - app/models/cats/core/allocation_item.rb
@@ -269,9 +272,12 @@ files:
 - app/notifications/cats/core/simple_notification.rb
 - app/serializers/cats/core/commodity_category_serializer.rb
 - app/serializers/cats/core/currency_serializer.rb
+- 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/role_menu_serializer.rb
 - app/serializers/cats/core/unit_of_measure_serializer.rb
+- app/services/cats/core/dispatch_service.rb
 - app/services/cats/core/menu_service.rb
 - app/services/cats/core/notification_service.rb
 - app/services/cats/core/space_service.rb