dscf-marketplace 0.1.7 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60c2cbf7461bd253837b481338ec8105fc47e5ff3927855341efc9261bf193f5
-  data.tar.gz: 3d10a078bab90804d176823e1cf0e44ed74f617ca3f0adeff657339438404642
+  metadata.gz: e5af5705a5f167b0e7f9f34ae086a62f92528d0634e53ca1b50e1ddd0894934b
+  data.tar.gz: c53e6675625b7a1225ed8cdaaf977e940325ff9d9fe934f84a47517b22b82302
 SHA512:
-  metadata.gz: 96051d9c835dc17d0f8c7b495c28dd48b2b45a9690711be8d9a5650f6f36643498605d4d8bfdeaf6df6a7cea2f04567b6aff8479a444c525fb68ddbc60ebf41b
-  data.tar.gz: 6e35c21f3b43d962d838b1f5bbfb577db65e2c004c0665e340356994a93fb1e89d594d02358209af2670a6ea8638fc909347f80a8cbdd470e40d975520433af1
+  metadata.gz: 69d7b1dc54ca8c0df0177243a8a9c2b9e410348b7aaf53464890c07f90c2e13a0c9313805992db5e7f80962c771cde51ab7889046fb93a7ad7c4d07c532880ad
+  data.tar.gz: c00490bed736cc44c717edc3cbb64de8f2ebac369fd6f1ec98ecf24f44d4c00d07b52aeda5062d04663ecd079948890d0fe160721c2f2295272790b588bde568

data/app/controllers/dscf/marketplace/application_controller.rb

@@ -1,6 +1,8 @@
 module Dscf
   module Marketplace
     class ApplicationController < ActionController::API
+      include Dscf::Core::JsonResponse
+      include Dscf::Core::Authenticatable
     end
   end
 end

data/app/controllers/dscf/marketplace/categories_controller.rb

@@ -0,0 +1,26 @@
+module Dscf
+  module Marketplace
+    class CategoriesController < ApplicationController
+      include Dscf::Core::Common
+
+      private
+
+      def model_params
+        params.require(:category).permit(:name, :description, :parent_id)
+      end
+
+      def eager_loaded_associations
+        [ :parent, :subcategories, :products ]
+      end
+
+      def default_serializer_includes
+        {
+          index: [ :parent ],
+          show: [ :parent, :subcategories, :products ],
+          create: [ :parent ],
+          update: [ :parent ]
+        }
+      end
+    end
+  end
+end

data/app/controllers/dscf/marketplace/listings_controller.rb

@@ -0,0 +1,55 @@
+module Dscf
+  module Marketplace
+    class ListingsController < ApplicationController
+      include Dscf::Core::Common
+
+      def activate
+        @obj = find_record
+        if @obj.update(status: :active)
+          render_success("listings.success.activated", data: @obj)
+        else
+          render_error("listings.errors.activate_failed")
+        end
+      end
+
+      def pause
+        @obj = find_record
+        if @obj.update(status: :paused)
+          render_success("listings.success.paused", data: @obj)
+        else
+          render_error("listings.errors.pause_failed")
+        end
+      end
+
+      def sold_out
+        @obj = find_record
+        if @obj.update(status: :sold_out)
+          render_success("listings.success.sold_out", data: @obj)
+        else
+          render_error("listings.errors.sold_out_failed")
+        end
+      end
+
+      private
+
+      def model_params
+        params.require(:listing).permit(
+          :business_id, :supplier_product_id, :price, :quantity, :status
+        )
+      end
+
+      def eager_loaded_associations
+        [ :business, :supplier_product, :order_items ]
+      end
+
+      def default_serializer_includes
+        {
+          index: [ :business, :supplier_product ],
+          show: [ :business, :supplier_product, :order_items ],
+          create: [ :business, :supplier_product ],
+          update: [ :business, :supplier_product ]
+        }
+      end
+    end
+  end
+end

data/app/controllers/dscf/marketplace/orders_controller.rb

@@ -0,0 +1,58 @@
+module Dscf
+  module Marketplace
+    class OrdersController < ApplicationController
+      include Dscf::Core::Common
+
+      def confirm
+        @obj = find_record
+        if @obj.confirm!
+          render_success("orders.success.confirmed", data: @obj)
+        else
+          render_error("orders.errors.confirm_failed")
+        end
+      end
+
+      def cancel
+        @obj = find_record
+        if @obj.update(status: :cancelled)
+          @obj.order_items.update_all(status: OrderItem.statuses[:cancelled])
+          render_success("orders.success.cancelled", data: @obj)
+        else
+          render_error("orders.errors.cancel_failed")
+        end
+      end
+
+      def complete
+        @obj = find_record
+        if @obj.can_be_completed? && @obj.update(status: :completed)
+          @obj.order_items.update_all(status: OrderItem.statuses[:completed])
+          render_success("orders.success.completed", data: @obj)
+        else
+          render_error("orders.errors.complete_failed")
+        end
+      end
+
+      private
+
+      def model_params
+        params.require(:order).permit(
+          :quotation_id, :listing_id, :user_id, :delivery_order_id,
+          :order_type, :status, :fulfillment_type
+        )
+      end
+
+      def eager_loaded_associations
+        [ :quotation, :listing, :user, :delivery_order, :order_items ]
+      end
+
+      def default_serializer_includes
+        {
+          index: [ :user, :quotation, :listing ],
+          show: [ :user, :quotation, :listing, :delivery_order, :order_items ],
+          create: [ :user, :quotation, :listing ],
+          update: [ :user, :quotation, :listing ]
+        }
+      end
+    end
+  end
+end

data/app/controllers/dscf/marketplace/products_controller.rb

@@ -0,0 +1,30 @@
+module Dscf
+  module Marketplace
+    class ProductsController < ApplicationController
+      include Dscf::Core::Common
+
+      private
+
+      def model_params
+        params.require(:product).permit(
+          :sku, :name, :description, :category_id, :unit_id,
+          :base_price, :base_quantity, :business_only,
+          :thumbnail, images: []
+        )
+      end
+
+      def eager_loaded_associations
+        [ :category, :unit, :supplier_products ]
+      end
+
+      def default_serializer_includes
+        {
+          index: [ :category, :unit ],
+          show: [ :category, :unit, :supplier_products ],
+          create: [ :category, :unit ],
+          update: [ :category, :unit ]
+        }
+      end
+    end
+  end
+end

data/app/controllers/dscf/marketplace/quotations_controller.rb

@@ -0,0 +1,56 @@
+module Dscf
+  module Marketplace
+    class QuotationsController < ApplicationController
+      include Dscf::Core::Common
+
+      def accept
+        @obj = find_record
+        if @obj.accept!
+          render_success("quotations.success.accepted", data: @obj)
+        else
+          render_error("quotations.errors.accept_failed")
+        end
+      end
+
+      def reject
+        @obj = find_record
+        if @obj.reject!
+          render_success("quotations.success.rejected", data: @obj)
+        else
+          render_error("quotations.errors.reject_failed")
+        end
+      end
+
+      def send_quotation
+        @obj = find_record
+        if @obj.send_quotation!
+          render_success("quotations.success.sent", data: @obj)
+        else
+          render_error("quotations.errors.send_failed")
+        end
+      end
+
+      private
+
+      def model_params
+        params.require(:quotation).permit(
+          :request_for_quotation_id, :business_id, :total_price,
+          :delivery_date, :valid_until, :status, :notes
+        )
+      end
+
+      def eager_loaded_associations
+        [ :request_for_quotation, :business, :quotation_items, :order ]
+      end
+
+      def default_serializer_includes
+        {
+          index: [ :request_for_quotation, :business ],
+          show: [ :request_for_quotation, :business, :quotation_items, :order ],
+          create: [ :request_for_quotation, :business ],
+          update: [ :request_for_quotation, :business ]
+        }
+      end
+    end
+  end
+end

data/app/controllers/dscf/marketplace/request_for_quotations_controller.rb

@@ -0,0 +1,46 @@
+module Dscf
+  module Marketplace
+    class RequestForQuotationsController < ApplicationController
+      include Dscf::Core::Common
+
+      def send_rfq
+        @obj = find_record
+        if @obj.draft? && @obj.update(status: :sent)
+          render_success("request_for_quotations.success.sent", data: @obj)
+        else
+          render_error("request_for_quotations.errors.send_failed")
+        end
+      end
+
+      def close
+        @obj = find_record
+        if (@obj.sent? || @obj.responded?) && @obj.update(status: :closed)
+          render_success("request_for_quotations.success.closed", data: @obj)
+        else
+          render_error("request_for_quotations.errors.close_failed")
+        end
+      end
+
+      private
+
+      def model_params
+        params.require(:request_for_quotation).permit(
+          :user_id, :selected_quotation_id, :status, :notes
+        )
+      end
+
+      def eager_loaded_associations
+        [ :user, :selected_quotation, :rfq_items, :quotations ]
+      end
+
+      def default_serializer_includes
+        {
+          index: [ :user ],
+          show: [ :user, :selected_quotation, :rfq_items, :quotations ],
+          create: [ :user ],
+          update: [ :user ]
+        }
+      end
+    end
+  end
+end

data/app/models/dscf/marketplace/category.rb

@@ -12,6 +12,15 @@ module Dscf
 
       scope :root_categories, -> { where(parent_id: nil) }
 
+      # Ransack configuration for secure filtering
+      def self.ransackable_attributes(_auth_object = nil)
+        %w[id name description parent_id created_at updated_at]
+      end
+
+      def self.ransackable_associations(_auth_object = nil)
+        %w[parent subcategories products]
+      end
+
       def root?
         parent_id.nil?
       end

data/app/models/dscf/marketplace/delivery_order.rb

@@ -0,0 +1,116 @@
+module Dscf::Marketplace
+  class DeliveryOrder < ApplicationRecord
+    enum :status, {assigned: 0, picked_up: 1, in_transit: 2, delivered: 3, failed: 4}
+    enum :vehicle_type, {motorcycle: 0, car: 1, van: 2, truck: 3}
+
+    belongs_to :driver, class_name: "Dscf::Core::User"
+    belongs_to :pickup_address, class_name: "Dscf::Core::Address"
+    belongs_to :delivery_vehicle, optional: true
+    has_many :delivery_order_items, dependent: :destroy
+    has_many :marketplace_orders, class_name: "Dscf::Marketplace::Order", dependent: :nullify
+
+    validates :driver_id, presence: true
+    validates :pickup_address_id, presence: true
+    validates :status, presence: true
+    validates :vehicle_type, presence: true
+    validates :estimated_delivery_price, numericality: {greater_than_or_equal_to: 0}, allow_nil: true
+    validates :actual_delivery_price, numericality: {greater_than_or_equal_to: 0}, allow_nil: true
+
+    before_save :calculate_actual_delivery_price, if: :status_changed?
+
+    # Ransack configuration for secure filtering
+    def self.ransackable_attributes(_auth_object = nil)
+      %w[id driver_id pickup_address_id delivery_vehicle_id status vehicle_type estimated_delivery_price actual_delivery_price estimated_delivery_time actual_delivery_time delivery_notes created_at updated_at]
+    end
+
+    def self.ransackable_associations(_auth_object = nil)
+      %w[driver pickup_address delivery_vehicle delivery_order_items marketplace_orders]
+    end
+
+    def pickup!
+      return false unless assigned?
+      update!(status: :picked_up, actual_delivery_time: Time.current)
+      true
+    end
+
+    def start_delivery!
+      return false unless picked_up?
+      update!(status: :in_transit)
+      true
+    end
+
+    def complete_delivery!
+      return false unless in_transit?
+      update!(status: :delivered, actual_delivery_time: Time.current)
+      update_associated_orders
+      true
+    end
+
+    def mark_failed!(reason = nil)
+      update!(status: :failed, delivery_notes: reason)
+      true
+    end
+
+    def total_items
+      delivery_order_items.sum(:quantity)
+    end
+
+    def total_orders
+      marketplace_orders.count
+    end
+
+    def delivery_duration
+      return nil unless actual_delivery_time && estimated_delivery_time
+      (actual_delivery_time - estimated_delivery_time).to_i
+    end
+
+    def on_time?
+      return nil unless actual_delivery_time && estimated_delivery_time
+      actual_delivery_time <= estimated_delivery_time
+    end
+
+    # Handoff tracking methods
+    def handoff_completion_status
+      items = delivery_order_items
+      {
+        total_items: items.count,
+        confirmed_items: items.count(&:receiver_confirmed?),
+        pending_confirmation: items.count { |item| item.delivered? && !item.receiver_confirmed? },
+        issues_reported: items.count(&:requires_resolution?),
+        completion_percentage: items.present? ? (items.count(&:receiver_confirmed?).to_f / items.count * 100).round(2) : 0
+      }
+    end
+
+    def all_handoffs_confirmed?
+      delivery_order_items.all?(&:receiver_confirmed?)
+    end
+
+    def items_requiring_attention
+      delivery_order_items.select(&:requires_resolution?)
+    end
+
+    def generate_handoff_summary_report
+      {
+        delivery_order_id: id,
+        driver: driver&.name,
+        vehicle: vehicle_type,
+        total_destinations: delivery_order_items.distinct.pluck(:dropoff_address_id).count,
+        handoff_status: handoff_completion_status,
+        issues: items_requiring_attention.map(&:comprehensive_damage_report),
+        generated_at: Time.current
+      }
+    end
+
+    private
+
+    def calculate_actual_delivery_price
+      self.actual_delivery_price ||= estimated_delivery_price
+    end
+
+    def update_associated_orders
+      marketplace_orders.each do |order|
+        order.update!(status: :completed)
+      end
+    end
+  end
+end

data/app/models/dscf/marketplace/delivery_order_item.rb

@@ -0,0 +1,201 @@
+module Dscf::Marketplace
+  class DeliveryOrderItem < ApplicationRecord
+    enum :status, {pending: 0, picked_up: 1, delivered: 2, receiver_confirmed: 3, damaged: 4, missing: 5, disputed: 6}
+
+    belongs_to :delivery_order
+    belongs_to :order_item, class_name: "Dscf::Marketplace::OrderItem"
+    belongs_to :pickup_address, class_name: "Dscf::Core::Address"
+    belongs_to :dropoff_address, class_name: "Dscf::Core::Address"
+
+    validates :delivery_order_id, presence: true
+    validates :order_item_id, presence: true
+    validates :quantity, presence: true, numericality: {greater_than: 0}
+    validates :status, presence: true
+    validates :pickup_verified_quantity, numericality: {greater_than_or_equal_to: 0}, allow_nil: true
+    validates :dropoff_verified_quantity, numericality: {greater_than_or_equal_to: 0}, allow_nil: true
+    validates :damaged_quantity, numericality: {greater_than_or_equal_to: 0}, allow_nil: true
+    validates :missing_quantity, numericality: {greater_than_or_equal_to: 0}, allow_nil: true
+    validates :receiver_confirmed_by, presence: true, if: :receiver_action_taken?
+    validates :receiver_confirmed_at, presence: true, if: :receiver_action_taken?
+
+    before_save :calculate_verification_totals
+
+    # Ransack configuration for secure filtering
+    def self.ransackable_attributes(_auth_object = nil)
+      %w[id delivery_order_id order_item_id pickup_address_id dropoff_address_id quantity status pickup_verified_quantity dropoff_verified_quantity damaged_quantity missing_quantity receiver_confirmed_by receiver_confirmed_at receiver_notes handoff_checklist_completed created_at updated_at]
+    end
+
+    def self.ransackable_associations(_auth_object = nil)
+      %w[delivery_order order_item pickup_address dropoff_address]
+    end
+
+    def pending?
+      status == "pending"
+    end
+
+    def picked_up?
+      status == "picked_up"
+    end
+
+    def delivered?
+      status == "delivered"
+    end
+
+    def damaged?
+      status == "damaged"
+    end
+
+    def missing?
+      status == "missing"
+    end
+
+    def receiver_confirmed?
+      status == "receiver_confirmed"
+    end
+
+    def disputed?
+      status == "disputed"
+    end
+
+    def pickup!
+      return false unless pending?
+      update!(status: :picked_up, pickup_verified_quantity: quantity)
+      true
+    end
+
+    def deliver!
+      return false unless picked_up?
+      update!(status: :delivered, dropoff_verified_quantity: pickup_verified_quantity.to_f - (damaged_quantity || 0) - (missing_quantity || 0))
+      true
+    end
+
+    # Handoff workflow methods
+    def receiver_confirm!(confirmed_quantity, notes = nil, confirmed_by = nil)
+      return false unless delivered? || picked_up?
+
+      update!(
+        status: :receiver_confirmed,
+        dropoff_verified_quantity: confirmed_quantity,
+        receiver_notes: notes,
+        receiver_confirmed_at: Time.current,
+        receiver_confirmed_by: confirmed_by,
+        handoff_checklist_completed: true
+      )
+      notify_receiver_confirmation
+      true
+    end
+
+    def report_issue!(issue_type, quantity, description, reported_by)
+      return false unless delivered? || picked_up?
+
+      update!(
+        status: issue_type.to_sym, # :damaged or :missing
+        damaged_quantity: ((issue_type == "damaged") ? quantity : 0),
+        missing_quantity: ((issue_type == "missing") ? quantity : 0),
+        receiver_notes: description,
+        receiver_confirmed_at: Time.current,
+        receiver_confirmed_by: reported_by,
+        handoff_checklist_completed: true
+      )
+      notify_platform_of_issue
+      true
+    end
+
+    def dispute_delivery!(reason, disputed_by)
+      return false unless delivered? || receiver_confirmed?
+
+      update!(
+        status: :disputed,
+        receiver_notes: reason,
+        receiver_confirmed_at: Time.current,
+        receiver_confirmed_by: disputed_by
+      )
+      create_dispute_record
+      true
+    end
+
+    def mark_damaged!(quantity)
+      update!(status: :damaged, damaged_quantity: quantity)
+      true
+    end
+
+    def mark_missing!(quantity)
+      update!(status: :missing, missing_quantity: quantity)
+      true
+    end
+
+    def verification_complete?
+      pickup_verified_quantity.present? && dropoff_verified_quantity.present?
+    end
+
+    def has_discrepancy?
+      return false unless verification_complete?
+      pickup_verified_quantity != dropoff_verified_quantity
+    end
+
+    def discrepancy_amount
+      return 0 unless has_discrepancy?
+      (pickup_verified_quantity - dropoff_verified_quantity).abs
+    end
+
+    def product_name
+      order_item&.product_name
+    end
+
+    def unit_name
+      order_item&.unit_name
+    end
+
+    # Loss/Damage Reporting Methods
+    def comprehensive_damage_report
+      {
+        item_id: id,
+        product_name: order_item&.product&.name,
+        expected_quantity: quantity,
+        received_quantity: dropoff_verified_quantity,
+        damaged_quantity: damaged_quantity,
+        missing_quantity: missing_quantity,
+        total_discrepancy: discrepancy_amount,
+        issue_description: receiver_notes,
+        reported_at: receiver_confirmed_at,
+        reported_by: receiver_confirmed_by,
+        requires_resolution: requires_resolution?
+      }
+    end
+
+    def requires_resolution?
+      has_discrepancy? || damaged? || missing? || disputed?
+    end
+
+    private
+
+    def receiver_action_taken?
+      receiver_confirmed? || damaged? || missing? || disputed?
+    end
+
+    def notify_receiver_confirmation
+      # Placeholder for notification logic
+      # This will be implemented when we add notification system
+      Rails.logger.info("Receiver confirmation completed for delivery order item #{id}")
+    end
+
+    def notify_platform_of_issue
+      # Placeholder for platform notification
+      # This will be implemented when we add notification system
+      Rails.logger.info("Issue reported for delivery order item #{id}: #{status}")
+    end
+
+    def create_dispute_record
+      # Placeholder for dispute record creation
+      # This will be implemented when we add dispute management
+      Rails.logger.info("Dispute created for delivery order item #{id}")
+    end
+
+    def calculate_verification_totals
+      if pickup_verified_quantity.present? && damaged_quantity.present? && missing_quantity.present?
+        expected_dropoff = pickup_verified_quantity - damaged_quantity - missing_quantity
+        self.dropoff_verified_quantity ||= expected_dropoff
+      end
+    end
+  end
+end