cats_core 1.0.47 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efb65bb9da37fbd6070d5844cdcd48c9c7c7e6a5b264c41e2103593e309838bd
-  data.tar.gz: 512001fdb9ddb2fa71fac19683b105632926a4cf75857b44a1a267c8710d02d9
+  metadata.gz: ebf6bb336bcf7b1fa89d734c18444e8f41b586c480a24b675fb62d5a8e3d5528
+  data.tar.gz: 6a5adfade3042c981cc482f336393cd51265a636e56b2ae91b5f4c1d8193840a
 SHA512:
-  metadata.gz: 9f5188e5b7fbd88a26db6ee14473b199994b07fe42e475fea3b49fcb3dd63efe8beb07ad285733c9a9fcd14d1ef63740454905b4bd505c1217a02d7c3bb851b2
-  data.tar.gz: '082ab5a2755af2ce386e8c8636d1ae022fa6c486cd83d7da7410d74b26653d03f1d21f8ff5c79b936546f92bfc65c013fe781f5613e3ac8ae0c2ba895fbb7da0'
+  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/models/cats/core/dispatch_transaction.rb

@@ -3,6 +3,9 @@ module Cats
     class DispatchTransaction < Transaction
       belongs_to :source, class_name: 'Cats::Core::Stack'
       belongs_to :destination, class_name: 'Cats::Core::Dispatch'
+
+      delegate(:code, to: :source, prefix: true)
+      delegate(:reference_no, to: :destination, prefix: true)
     end
   end
 end

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

@@ -2,6 +2,7 @@ module Cats
   module Core
     class Transaction < ApplicationRecord
       self.abstract_class = true
+      after_initialize :set_status
 
       # Transaction statuses
       DRAFT = 'Draft'.freeze
@@ -25,8 +26,16 @@ module Cats
           destination.quantity += quantity
           source.save
           destination.save
+          self.status = COMMITTED
+          save
         end
       end
+
+      def set_status
+        return unless new_record?
+
+        self.status = DRAFT
+      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/app/services/cats/core/space_service.rb

@@ -8,7 +8,9 @@ module Cats
       def available_space(id, level)
         case level
         when HUB
-          warehouse_ids = Cats::Core::Location.find(id).children.map(&:id)
+          hub = Cats::Core::Location.find(id)
+          warehouses = hub.children
+          warehouse_ids = warehouses.map(&:id)
           stores = Cats::Core::Store.joins(:warehouse)
                                     .where(
                                       cats_core_locations: {
@@ -19,19 +21,48 @@ module Cats
           wh_details = []
           stores.each do |key, value|
             total_space = value.inject(0) { |sum, val| sum + val.available_space }
-            details = value.map { |val| { store_id: val.id, total_space: val.available_space } }
-            wh_details << { warehouse_id: key, total_space: total_space, details: details }
+            details = value.map do |val|
+              { store_id: val.id, code: val.code, name: val.name, total_space: val.available_space }
+            end
+            warehouse = warehouses.find(key)
+            wh_details << {
+              warehouse_id: key,
+              code: warehouse.code,
+              name: warehouse.name,
+              total_space: total_space,
+              details: details
+            }
           end
           hub_space = wh_details.inject(0) { |sum, val| sum + val[:total_space] }
-          space = { hub_id: id, total_space: hub_space, details: wh_details }
+          space = {
+            hub_id: id,
+            code: hub.code,
+            name: hub.name,
+            total_space: hub_space,
+            details: wh_details
+          }
         when WAREHOUSE
+          warehouse = Cats::Core::Location.find(id)
           stores = Cats::Core::Store.where(warehouse_id: id)
-          details = stores.map { |store| { store_id: store.id, total_space: store.available_space } }
+          details = stores.map do |store|
+            { store_id: store.id, code: store.code, name: store.name, total_space: store.available_space }
+          end
           total_space = stores.inject(0) { |sum, val| sum + val.available_space }
-          space = { warehouse_id: id, total_space: total_space, details: details }
+          space = {
+            warehouse_id: id,
+            code: warehouse.code,
+            name: warehouse.name,
+            total_space: total_space,
+            details: details
+          }
         when STORE
           store = Cats::Core::Store.find(id)
-          space = { store_id: store.id, total_space: store.available_space }
+          space = {
+            store_id: store.id,
+            code: store.code,
+            name: store.name,
+            total_space: store.available_space
+          }
         end
         space
       end

data/config/routes.rb

@@ -33,11 +33,11 @@ Cats::Core::Engine.routes.draw do
       to: 'spaces#available_space',
       as: :hub_space, 
       defaults: { level: Cats::Core::SpaceService::HUB }
-  get '/warehousess/:id/space',
+  get '/warehouses/:id/space',
       to: 'spaces#available_space',
       as: :warehouse_space,
       defaults: { level: Cats::Core::SpaceService::WAREHOUSE }
-  get '/store/:id/space',
+  get '/stores/:id/space',
       to: 'spaces#available_space',
       as: :store_space,
       defaults: { level: Cats::Core::SpaceService::STORE }
@@ -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.47'.freeze
+    VERSION = '1.1.0'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cats_core
 version: !ruby/object:Gem::Version
-  version: 1.0.47
+  version: 1.1.0
 platform: ruby
 authors:
 - Henock L.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-21 00:00:00.000000000 Z
+date: 2021-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: active_model_serializers
@@ -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