bscf-core 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3809381078c320ca29b8e18319a28a57f3ef7536a4db3beab9006d9e697b0a1
-  data.tar.gz: 413847ec12888e616845d0928fd21eb0391456a0ea0c3de2b695a53bb782b14b
+  metadata.gz: 0b265836a53a2c3d1b4c492d064732a6203150366915f479897ee293690414d3
+  data.tar.gz: 444ed29066f85fb8b2d0defd0c3c798bac8a657ef09ba6e1d6777204edff7a1f
 SHA512:
-  metadata.gz: 7bcd4a81d4536899afec6b26c4cbbe35e3454787e061b42930437284f2a0a5895bb7a4f13a3419f47fe517be670ea56157a9dd1bd53dc571d2669a4917c0625a
-  data.tar.gz: c1a1571b6f13b3cf1659870257e79ba378ac456f95e9db00b05db3d3c22e426ccc36e6e69e45a6298a91d4d79fba8d7093717a6a9b848f365bffd32320dfdee1
+  metadata.gz: 0e5cd8ca766f662abc09b4d1962b252087323fa2439773f4afdb3cde3dcf03fe0794ee860a130c3c48acdb44215a1ace729a38041bcae5ff38f16a55d57aee75
+  data.tar.gz: 8ea894bd332364d89656120224bdd57ec808dc80e6c588ff9be84b40fb030f7d449e80dc0bd6622064fe647eb71e31eef3d5a9de9a483507bc6db6983516b631

data/Rakefile

@@ -2,7 +2,7 @@ require "bundler/setup"
 
 APP_RAKEFILE = File.expand_path("spec/dummy/Rakefile", __dir__)
 load "rails/tasks/engine.rake"
-
 load "rails/tasks/statistics.rake"
 
 require "bundler/gem_tasks"
+Dir[File.join(File.dirname(__FILE__), 'lib/tasks/**/*.rake')].each { |f| load f }

data/app/models/bscf/core/address.rb

@@ -0,0 +1,7 @@
+module Bscf
+  module Core
+    class Address < ApplicationRecord
+      has_many :user_profiles
+    end
+  end
+end

data/app/models/bscf/core/business.rb

@@ -0,0 +1,15 @@
+module Bscf
+  module Core
+    class Business < ApplicationRecord
+      belongs_to :user
+
+      validates :business_name, presence: true
+      validates :tin_number, presence: true, uniqueness: { case_sensitive: false }
+      validates :business_type, presence: true
+      validates :verification_status, presence: true
+
+      enum :business_type, { retailer: 0, wholesaler: 1 }
+      enum :verification_status, { pending: 0, approved: 1, rejected: 2 }
+    end
+  end
+end

data/app/models/bscf/core/category.rb

@@ -0,0 +1,11 @@
+module Bscf
+  module Core
+    class Category < ApplicationRecord
+      validates :name, presence: true
+      validates :description, presence: true
+
+      belongs_to :parent, class_name: "Bscf::Core::Category", optional: true
+      has_many :children, class_name: "Bscf::Core::Category", foreign_key: "parent_id"
+    end
+  end
+end

data/app/models/bscf/core/order.rb

@@ -0,0 +1,24 @@
+module Bscf
+  module Core
+    class Order < ApplicationRecord
+      belongs_to :ordered_by, class_name: "Bscf::Core::User", optional: true
+      belongs_to :ordered_to, class_name: "Bscf::Core::User", optional: true
+      belongs_to :quotation, optional: true
+
+      validates :order_type, :status, presence: true
+
+      enum :order_type, {
+        order_from_quote: 0,
+        direct_order: 1
+      }
+
+      enum :status, {
+        draft: 0,
+        submitted: 1,
+        accepted: 3,
+        delivering: 4,
+        canceled: 5
+      }
+    end
+  end
+end

data/app/models/bscf/core/order_item.rb

@@ -0,0 +1,15 @@
+module Bscf::Core
+  class OrderItem < ApplicationRecord
+    belongs_to :order
+    belongs_to :product
+    belongs_to :quotation_item, optional: true
+    before_save :calculate_subtotal
+
+
+    validates :quantity, :unit_price, :subtotal, presence: true
+
+    def calculate_subtotal
+      self.subtotal = (unit_price * quantity).round(2)
+    end
+  end
+end

data/app/models/bscf/core/product.rb

@@ -0,0 +1,29 @@
+module Bscf
+  module Core
+    class Product < ApplicationRecord
+      belongs_to :category
+
+      has_many :rfq_items
+      has_many :request_for_quotations, through: :rfq_items
+
+      before_validation :generate_sku, on: :create
+
+      validates :sku, presence: true, uniqueness: true
+      validates :name, presence: true
+      validates :description, presence: true
+      validates :base_price, presence: true, numericality: { greater_than_or_equal_to: 0 }
+
+      private
+
+      def generate_sku
+        return if sku.present?
+
+        prefix = "BSC"
+        category_code = category.id.to_s.rjust(3, "0")
+        sequence = (Product.where("sku LIKE ?", "#{prefix}#{category_code}%").count + 1).to_s.rjust(4, "0")
+
+        self.sku = "#{prefix}#{category_code}#{sequence}"
+      end
+    end
+  end
+end

data/app/models/bscf/core/quotation.rb

@@ -0,0 +1,29 @@
+module Bscf
+  module Core
+    class Quotation < ApplicationRecord
+      belongs_to :request_for_quotation
+      belongs_to :business
+
+      has_many :quotation_items
+      has_many :products, through: :quotation_items
+      has_many :orders
+
+      validates :price, presence: true, numericality: { greater_than_or_equal_to: 0 }
+      validates :delivery_date, presence: true
+      validates :valid_until, presence: true
+      validates :status, presence: true
+
+      enum :status, {
+        draft: 0,
+        submitted: 1,
+        accepted: 2,
+        rejected: 3,
+        expired: 4
+      }
+
+      scope :active, -> { where.not(status: [ :rejected, :expired ]) }
+      scope :by_business, ->(business_id) { where(business_id: business_id) }
+      scope :by_rfq, ->(rfq_id) { where(request_for_quotation_id: rfq_id) }
+    end
+  end
+end

data/app/models/bscf/core/quotation_item.rb

@@ -0,0 +1,23 @@
+module Bscf
+  module Core
+    class QuotationItem < ApplicationRecord
+      belongs_to :quotation
+      belongs_to :rfq_item
+      belongs_to :product
+
+      validates :quantity, presence: true, numericality: { greater_than: 0 }
+      validates :unit_price, presence: true, numericality: { greater_than_or_equal_to: 0 }
+      validates :unit, presence: true
+      validates :subtotal, presence: true, numericality: { greater_than_or_equal_to: 0 }
+
+      before_validation :calculate_subtotal
+
+      private
+
+      def calculate_subtotal
+        return unless quantity.present? && unit_price.present?
+        self.subtotal = quantity * unit_price
+      end
+    end
+  end
+end

data/app/models/bscf/core/request_for_quotation.rb

@@ -0,0 +1,13 @@
+module Bscf
+  module Core
+    class RequestForQuotation < ApplicationRecord
+      belongs_to :user
+      validates :status, presence: true
+
+      has_many :rfq_items
+      has_many :products, through: :rfq_items
+
+      enum :status, { draft: 0, submitted: 1, awaiting_confirmation: 2, confirmed: 3, converted: 4 }
+    end
+  end
+end

data/app/models/bscf/core/rfq_item.rb

@@ -0,0 +1,9 @@
+module Bscf
+  module Core
+    class RfqItem < ApplicationRecord
+      belongs_to :request_for_quotation
+      belongs_to :product
+      validates :quantity, presence: true
+    end
+  end
+end

data/app/models/bscf/core/role.rb

@@ -0,0 +1,10 @@
+module Bscf
+  module Core
+    class Role < ApplicationRecord
+      has_many :user_roles
+      has_many :users, through: :user_roles
+
+      validates :name, presence: true
+    end
+  end
+end

data/app/models/bscf/core/user.rb

@@ -0,0 +1,21 @@
+module Bscf
+  module Core
+    class User < ApplicationRecord
+      has_secure_password
+
+      has_one :user_profile
+      has_many :user_roles
+      has_many :roles, through: :user_roles
+
+      has_many :orders_placed, class_name: "Bscf::Core::Order", foreign_key: "ordered_by_id"
+      has_many :orders_received, class_name: "Bscf::Core::Order", foreign_key: "ordered_to_id"
+
+      validates :first_name, presence: true
+      validates :middle_name, presence: true
+      validates :last_name, presence: true
+      validates :password, presence: true
+      validates :phone_number, presence: true, uniqueness: true
+      validates :email, presence: true, uniqueness: true
+    end
+  end
+end

data/app/models/bscf/core/user_profile.rb

@@ -0,0 +1,26 @@
+module Bscf
+  module Core
+    class UserProfile < ApplicationRecord
+      belongs_to :user
+      belongs_to :address
+      belongs_to :verified_by, class_name: "User", optional: true
+
+      validates :date_of_birth, presence: true
+      validates :nationality, presence: true
+      validates :occupation, presence: true
+      validates :source_of_funds, presence: true
+      validates :gender, presence: true
+
+      enum :gender, {
+        male: 0,
+        female: 1
+      }
+
+      enum :kyc_status, {
+        pending: 0,
+        approved: 1,
+        rejected: 2
+      }
+    end
+  end
+end

data/app/models/bscf/core/user_role.rb

@@ -0,0 +1,8 @@
+module Bscf
+  module Core
+    class UserRole < ApplicationRecord
+      belongs_to :user
+      belongs_to :role
+    end
+  end
+end

data/app/models/bscf/core/virtual_account.rb

@@ -0,0 +1,53 @@
+module Bscf
+  module Core
+    class VirtualAccount < ApplicationRecord
+      PRODUCT_SCHEMES = %w[SAVINGS CURRENT LOAN].freeze
+      VOUCHER_TYPES = %w[REGULAR SPECIAL TEMPORARY].freeze
+
+      belongs_to :user
+
+      validates :account_number, presence: true, uniqueness: true
+      validates :cbs_account_number, presence: true, uniqueness: true
+      validates :balance, presence: true, numericality: { greater_than_or_equal_to: 0 }
+      validates :interest_rate, presence: true, numericality: { greater_than_or_equal_to: 0 }
+      validates :interest_type, presence: true
+      validates :branch_code, presence: true
+      validates :product_scheme, presence: true, inclusion: { in: PRODUCT_SCHEMES }
+      validates :voucher_type, presence: true, inclusion: { in: VOUCHER_TYPES }
+      validates :status, presence: true
+
+      enum :interest_type, {
+        simple: 0,
+        compound: 1
+      }
+
+      enum :status, {
+        pending: 0,
+        active: 1,
+        suspended: 2,
+        closed: 3
+      }
+
+      before_validation :generate_account_number, on: :create
+
+      scope :active_accounts, -> { where(active: true, status: :active) }
+      scope :by_branch, ->(code) { where(branch_code: code) }
+      scope :by_product, ->(scheme) { where(product_scheme: scheme) }
+
+      private
+
+      def generate_account_number
+        return if account_number.present?
+
+        last_seq = self.class.maximum(:account_number).to_s[-6..-1].to_i
+        seq = (last_seq + 1).to_s.rjust(6, "0")
+        self.account_number = "#{branch_code}#{product_scheme}#{voucher_type}#{seq}"
+      end
+
+      has_many :sent_transactions, class_name: "Bscf::Core::VirtualAccountTransaction",
+               foreign_key: "from_account_id", dependent: :restrict_with_error
+      has_many :received_transactions, class_name: "Bscf::Core::VirtualAccountTransaction",
+               foreign_key: "to_account_id", dependent: :restrict_with_error
+    end
+  end
+end

data/app/models/bscf/core/virtual_account_transaction.rb

@@ -0,0 +1,158 @@
+module Bscf
+  module Core
+    class VirtualAccountTransaction < ApplicationRecord
+      belongs_to :from_account, class_name: "Bscf::Core::VirtualAccount", optional: true
+      belongs_to :to_account, class_name: "Bscf::Core::VirtualAccount", optional: true
+
+      validates :from_account_id, presence: true, if: :requires_from_account?
+      validates :to_account_id, presence: true, if: :requires_to_account?
+      validates :amount, presence: true, numericality: { greater_than: 0 }
+      validates :transaction_type, presence: true
+      validates :status, presence: true
+      validates :reference_number, presence: true, uniqueness: true
+
+      enum :transaction_type, {
+        transfer: 0,
+        deposit: 1,
+        withdrawal: 2
+      }
+
+      enum :status, {
+        pending: 0,
+        completed: 1,
+        failed: 2,
+        cancelled: 3
+      }
+
+      before_validation :generate_reference_number, on: :create
+      validate :validate_transaction, on: :create
+
+      def process!
+        return false unless pending?
+
+        ActiveRecord::Base.transaction do
+          process_transaction
+          update!(status: :completed)
+        end
+        true
+      rescue StandardError => e
+        update(status: :failed)
+        false
+      end
+
+      def cancel!
+        return false unless pending?
+        update(status: :cancelled)
+      end
+
+      private
+
+      def requires_from_account?
+        return false if transaction_type.nil?
+        %w[transfer withdrawal].include?(transaction_type)
+      end
+
+      def requires_to_account?
+        return false if transaction_type.nil?
+        %w[transfer deposit].include?(transaction_type)
+      end
+
+      def validate_transaction
+        case transaction_type.to_sym
+        when :transfer
+          validate_transfer
+        when :withdrawal
+          validate_withdrawal
+        when :deposit
+          validate_deposit
+        end
+
+        validate_account_requirements
+      end
+
+      def validate_transfer
+        return unless from_account && to_account
+
+        errors.add(:from_account, "must be active") unless from_account.active?
+        errors.add(:to_account, "must be active") unless to_account.active?
+        errors.add(:from_account, "insufficient balance") if from_account.balance.to_d < amount.to_d
+      end
+
+      private
+
+      def validate_account_requirements
+        case transaction_type.to_sym
+        when :transfer
+          return if from_account_id.present? && to_account_id.present?
+          errors.add(:base, "Both accounts are required for transfer")
+        when :withdrawal
+          return if from_account_id.present?
+          errors.add(:base, "Source account is required for withdrawal")
+          errors.add(:to_account_id, "must be blank for withdrawal")
+        when :deposit
+          return if to_account_id.present?
+          errors.add(:base, "Destination account is required for deposit")
+          errors.add(:from_account_id, "must be blank for deposit")
+        end
+      end
+
+      def validate_withdrawal
+        return unless from_account
+        errors.add(:from_account, "must be active") unless from_account.active?
+        errors.add(:from_account, "insufficient balance") if from_account.balance.to_d < amount.to_d
+      end
+
+      def validate_deposit
+        return unless to_account
+        errors.add(:to_account, "must be active") unless to_account.active?
+      end
+
+      def process_transaction
+        case transaction_type.to_sym
+        when :transfer
+          process_transfer
+        when :withdrawal
+          process_withdrawal
+        when :deposit
+          process_deposit
+        end
+      end
+
+      def process_transfer
+        ActiveRecord::Base.transaction do
+          from_account.with_lock do
+            to_account.with_lock do
+              new_from_balance = (from_account.balance - amount).round(2)
+              new_to_balance = (to_account.balance + amount).round(2)
+
+              from_account.update!(balance: new_from_balance)
+              to_account.update!(balance: new_to_balance)
+            end
+          end
+        end
+      end
+
+      def process_withdrawal
+        from_account.with_lock do
+          new_balance = (from_account.balance - amount).round(2)
+          from_account.update!(balance: new_balance)
+        end
+      end
+
+      def process_deposit
+        to_account.with_lock do
+          new_balance = (to_account.balance + amount).round(2)
+          to_account.update!(balance: new_balance)
+        end
+      end
+
+      def generate_reference_number
+        return if reference_number.present?
+
+        timestamp = Time.current.strftime("%Y%m%d%H%M%S")
+        random = SecureRandom.hex(3)
+        self.reference_number = "TXN#{timestamp}#{random}"
+      end
+    end
+  end
+end

data/db/migrate/20250326065606_create_bscf_core_users.rb

@@ -0,0 +1,18 @@
+class CreateBscfCoreUsers < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_users do |t|
+      t.string :first_name, null: false
+      t.string :middle_name, null: false
+      t.string :last_name, null: false
+      t.string :email, null: false
+      t.string :phone_number, null: false
+      t.string :password_digest, null: false
+
+      t.index :email, unique: true
+      t.index :phone_number, unique: true
+
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20250326075111_create_bscf_core_roles.rb

@@ -0,0 +1,9 @@
+class CreateBscfCoreRoles < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_roles do |t|
+      t.string :name, null: false
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20250326080646_create_bscf_core_user_profiles.rb

@@ -0,0 +1,19 @@
+class CreateBscfCoreUserProfiles < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_user_profiles do |t|
+      t.references :user, null: false, foreign_key: { to_table: :bscf_core_users }
+      t.date :date_of_birth, null: false
+      t.string :nationality, null: false
+      t.string :occupation, null: false
+      t.string :source_of_funds, null: false
+      t.integer :kyc_status, default: 0
+      t.integer :gender, null: false
+      t.datetime :verified_at
+      t.references :verified_by, null: true, foreign_key: { to_table: :bscf_core_users }
+      t.references :address, null: false, foreign_key: { to_table: :bscf_core_addresses }
+      t.string :fayda_id
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20250326081052_create_bscf_core_addresses.rb

@@ -0,0 +1,14 @@
+class CreateBscfCoreAddresses < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_addresses do |t|
+      t.string :city
+      t.string :sub_city
+      t.string :woreda
+      t.string :latitude
+      t.string :longitude
+      t.string :house_number
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20250326084233_create_bscf_core_user_roles.rb

@@ -0,0 +1,10 @@
+class CreateBscfCoreUserRoles < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_user_roles do |t|
+      t.references :user, null: false, foreign_key: { to_table: :bscf_core_users }
+      t.references :role, null: false, foreign_key: { to_table: :bscf_core_roles }
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20250326085741_create_bscf_core_virtual_accounts.rb

@@ -0,0 +1,24 @@
+class CreateBscfCoreVirtualAccounts < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_virtual_accounts do |t|
+      t.references :user, null: false, foreign_key: { to_table: :bscf_core_users }
+      t.string :account_number, null: false
+      t.string :cbs_account_number, null: false
+      t.decimal :balance, null: false, default: 0
+      t.decimal :interest_rate, null: false, default: 0
+      t.integer :interest_type, null: false, default: 0
+      t.boolean :active, null: false, default: true
+      t.string :branch_code, null: false
+      t.string :product_scheme, null: false
+      t.string :voucher_type, null: false
+      t.integer :status, null: false, default: 0
+
+      t.timestamps
+    end
+
+    add_index :bscf_core_virtual_accounts, :account_number, unique: true
+    add_index :bscf_core_virtual_accounts, :cbs_account_number, unique: true
+    add_index :bscf_core_virtual_accounts, :branch_code
+    add_index :bscf_core_virtual_accounts, [ :user_id, :account_number ]
+  end
+end

data/db/migrate/20250326103305_create_bscf_core_categories.rb

@@ -0,0 +1,11 @@
+class CreateBscfCoreCategories < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_categories do |t|
+      t.string :name, null: false
+      t.string :description, null: false
+      t.bigint :parent_id
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20250326105652_create_bscf_core_products.rb

@@ -0,0 +1,14 @@
+class CreateBscfCoreProducts < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_products do |t|
+      t.string :sku, null: false
+      t.string :name, null: false
+      t.string :description, null: false
+      t.references :category, null: false, foreign_key: { to_table: :bscf_core_categories }
+      t.decimal :base_price, null: false, default: 0.0
+
+      t.timestamps
+    end
+    add_index :bscf_core_products, :sku, unique: true
+  end
+end

data/db/migrate/20250326112449_create_bscf_core_businesses.rb

@@ -0,0 +1,14 @@
+class CreateBscfCoreBusinesses < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_businesses do |t|
+      t.references :user, null: false, foreign_key: { to_table: :bscf_core_users }
+      t.string :business_name, null: false
+      t.string :tin_number, null: false
+      t.integer :business_type, null: false, default: 0
+      t.datetime :verified_at
+      t.integer :verification_status, null: false, default: 0
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20250326115203_create_bscf_core_request_for_quotations.rb

@@ -0,0 +1,11 @@
+class CreateBscfCoreRequestForQuotations < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_request_for_quotations do |t|
+      t.references :user, null: false, foreign_key: { to_table: :bscf_core_users }
+      t.integer :status, null: false, default: 0
+      t.text :notes
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20250326120613_create_bscf_core_rfq_items.rb

@@ -0,0 +1,12 @@
+class CreateBscfCoreRfqItems < ActiveRecord::Migration[8.0]
+  def change
+    create_table :bscf_core_rfq_items do |t|
+      t.references :request_for_quotation, null: false, foreign_key: { to_table: :bscf_core_request_for_quotations }
+      t.references :product, null: false, foreign_key: { to_table: :bscf_core_products }
+      t.float :quantity, null: false
+      t.text :notes
+
+      t.timestamps
+    end
+  end
+end