bscf-core 0.1.0 → 0.2.0

data/spec/models/bscf/core/quotation_item_spec.rb

@@ -0,0 +1,44 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe QuotationItem, type: :model do
+      attributes = [
+        { quantity: [ :presence, :numericality ] },
+        { unit_price: [ :presence, :numericality ] },
+        { unit: :presence },
+        { quotation: :belong_to },
+        { rfq_item: :belong_to },
+        { product: :belong_to }
+      ]
+
+      include_examples("model_shared_spec", :quotation_item, attributes)
+
+      describe 'validations' do
+        it { should validate_numericality_of(:quantity).is_greater_than(0) }
+        it { should validate_numericality_of(:unit_price).is_greater_than_or_equal_to(0) }
+      end
+
+      describe '#calculate_subtotal' do
+        let(:quotation_item) { build(:quotation_item, quantity: 5, unit_price: 10.0) }
+
+        it 'calculates subtotal before validation' do
+          quotation_item.valid?
+          expect(quotation_item.subtotal).to eq(50.0)
+        end
+
+        it 'does not calculate subtotal if quantity is missing' do
+          quotation_item.quantity = nil
+          quotation_item.valid?
+          expect(quotation_item.subtotal).to eq(50.0)
+        end
+
+        it 'does not calculate subtotal if unit_price is missing' do
+          quotation_item.unit_price = nil
+          quotation_item.valid?
+          expect(quotation_item.subtotal).to eq(50.0)
+        end
+      end
+    end
+  end
+end

data/spec/models/bscf/core/quotation_spec.rb

@@ -0,0 +1,41 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe Quotation, type: :model do
+      attributes = [
+        { price: [ :presence, :numericality ] },
+        { delivery_date: :presence },
+        { valid_until: :presence },
+        { status: :presence },
+        { request_for_quotation: :belong_to },
+        { business: :belong_to },
+        { quotation_items: :have_many },
+        { orders: :have_many },
+        { products: :have_many }
+      ]
+
+      include_examples("model_shared_spec", :quotation, attributes)
+
+      describe 'validations' do
+        it { should validate_numericality_of(:price).is_greater_than_or_equal_to(0) }
+      end
+
+      describe 'enums' do
+        it { should define_enum_for(:status).with_values(draft: 0, submitted: 1, accepted: 2, rejected: 3, expired: 4) }
+      end
+
+      describe 'scopes' do
+        let!(:draft_quotation) { create(:quotation) }
+        let!(:submitted_quotation) { create(:quotation, :submitted) }
+        let!(:rejected_quotation) { create(:quotation, :rejected) }
+        let!(:expired_quotation) { create(:quotation, :expired) }
+
+        it 'filters active quotations' do
+          expect(described_class.active).to include(draft_quotation, submitted_quotation)
+          expect(described_class.active).not_to include(rejected_quotation, expired_quotation)
+        end
+      end
+    end
+  end
+end

data/spec/models/bscf/core/request_for_quotation_spec.rb

@@ -0,0 +1,13 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe RequestForQuotation, type: :model do
+      attributes = [
+        { user: :belong_to },
+        { status: :presence }
+      ]
+      include_examples("model_shared_spec", :request_for_quotation, attributes)
+    end
+  end
+end

data/spec/models/bscf/core/rfq_item_spec.rb

@@ -0,0 +1,14 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe RfqItem, type: :model do
+      attributes = [
+        { request_for_quotation: :belong_to },
+        { product: :belong_to },
+        { quantity: :presence }
+      ]
+      include_examples("model_shared_spec", :rfq_item, attributes)
+    end
+  end
+end

data/spec/models/bscf/core/role_spec.rb

@@ -0,0 +1,14 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe Role, type: :model do
+      attributes = [
+        { name: :presence },
+        { user_roles: :have_many },
+        { users: :have_many }
+      ]
+      include_examples("model_shared_spec", :role, attributes)
+    end
+  end
+end

data/spec/models/bscf/core/user_profile_spec.rb

@@ -0,0 +1,20 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe UserProfile, type: :model do
+      attributes = [
+        { date_of_birth: :presence },
+        { nationality: :presence },
+        { occupation: :presence },
+        { source_of_funds: :presence },
+        { gender: :presence },
+        { user: :belong_to },
+        { address: :belong_to }
+      ]
+      include_examples("model_shared_spec", :user_profile, attributes)
+
+      it { is_expected.to belong_to(:verified_by).class_name('User').optional }
+    end
+  end
+end

data/spec/models/bscf/core/user_role_spec.rb

@@ -0,0 +1,13 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe UserRole, type: :model do
+      attributes = [
+        { user: :belong_to },
+        { role: :belong_to }
+      ]
+      include_examples("model_shared_spec", :user_role, attributes)
+    end
+  end
+end

data/spec/models/bscf/core/user_spec.rb

@@ -0,0 +1,22 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe User, type: :model do
+      attributes = [
+        { first_name: :presence },
+        { middle_name: :presence },
+        { last_name: :presence },
+        { password: :presence },
+        { phone_number: %i[presence uniqueness] },
+        { email: %i[presence uniqueness] },
+        { user_profile: :have_one },
+        { user_roles: :have_many },
+        { roles: :have_many },
+        { orders_placed: :have_many },
+        { orders_received: :have_many }
+      ]
+      include_examples("model_shared_spec", :user, attributes)
+    end
+  end
+end

data/spec/models/bscf/core/virtual_account_spec.rb

@@ -0,0 +1,111 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe VirtualAccount, type: :model do
+      attributes = [
+        { account_number: %i[presence uniqueness] },
+        { cbs_account_number: %i[presence uniqueness] },
+        { balance: [ :presence, :numericality ] },
+        { interest_rate: [ :presence, :numericality ] },
+        { interest_type: :presence },
+        { branch_code: :presence },
+        { product_scheme: [ :presence ] },
+        { voucher_type: [ :presence ] },
+        { status: :presence },
+        { user: :belong_to }
+      ]
+
+      include_examples("model_shared_spec", :virtual_account, attributes)
+
+      it { should validate_numericality_of(:balance).is_greater_than_or_equal_to(0) }
+      it { should validate_numericality_of(:interest_rate).is_greater_than_or_equal_to(0) }
+      it { should validate_inclusion_of(:product_scheme).in_array(VirtualAccount::PRODUCT_SCHEMES) }
+      it { should validate_inclusion_of(:voucher_type).in_array(VirtualAccount::VOUCHER_TYPES) }
+
+      describe 'scopes' do
+        let!(:active_account) { create(:virtual_account, :active_status) }
+        let!(:pending_account) { create(:virtual_account) }
+        let!(:savings_account) { create(:virtual_account) }
+        let!(:current_account) { create(:virtual_account, :current_account) }
+        let!(:loan_account) { create(:virtual_account, :loan_account) }
+
+        it 'filters active accounts' do
+          expect(described_class.active_accounts).to include(active_account)
+          expect(described_class.active_accounts).not_to include(pending_account)
+        end
+
+        it 'filters by branch' do
+          expect(described_class.by_branch('BR001')).to include(active_account)
+        end
+
+        it 'filters by product scheme' do
+          expect(described_class.by_product('SAVINGS')).to include(savings_account)
+          expect(described_class.by_product('SAVINGS')).not_to include(current_account)
+          expect(described_class.by_product('CURRENT')).to include(current_account)
+          expect(described_class.by_product('LOAN')).to include(loan_account)
+        end
+      end
+
+      describe '#generate_account_number' do
+        let(:virtual_account) { build(:virtual_account) }
+
+        it 'generates account number on create' do
+          expect(virtual_account.account_number).to be_nil
+          virtual_account.save
+          expect(virtual_account.account_number).to be_present
+          expect(virtual_account.account_number).to match(/\ABR001SAVINGSREGULAR\d{6}\z/)
+        end
+
+        it 'maintains existing account number' do
+          existing_number = 'BR001SAVINGSREGULAR000001'
+          virtual_account.account_number = existing_number
+          virtual_account.save
+          expect(virtual_account.account_number).to eq(existing_number)
+        end
+
+        it 'increments sequence number' do
+          first_account = create(:virtual_account)
+          second_account = create(:virtual_account)
+
+          first_seq = first_account.account_number[-6..-1].to_i
+          second_seq = second_account.account_number[-6..-1].to_i
+
+          expect(second_seq).to eq(first_seq + 1)
+        end
+      end
+
+      describe 'interest types' do
+        it 'supports simple interest' do
+          account = build(:virtual_account)
+          expect(account.interest_type).to eq('simple')
+        end
+
+        it 'supports compound interest' do
+          account = build(:virtual_account, :compound_interest)
+          expect(account.interest_type).to eq('compound')
+        end
+      end
+
+      describe 'account types' do
+        it 'creates savings account by default' do
+          account = create(:virtual_account)
+          expect(account.product_scheme).to eq('SAVINGS')
+          expect(account.interest_rate).to eq(2.5)
+        end
+
+        it 'creates current account' do
+          account = create(:virtual_account, :current_account)
+          expect(account.product_scheme).to eq('CURRENT')
+          expect(account.interest_rate).to eq(0.0)
+        end
+
+        it 'creates loan account' do
+          account = create(:virtual_account, :loan_account)
+          expect(account.product_scheme).to eq('LOAN')
+          expect(account.interest_rate).to eq(12.5)
+        end
+      end
+    end
+  end
+end

data/spec/models/bscf/core/virtual_account_transaction_spec.rb

@@ -0,0 +1,133 @@
+require 'rails_helper'
+
+module Bscf
+  module Core
+    RSpec.describe VirtualAccountTransaction, type: :model do
+      attributes = [
+        { amount: [ :presence, :numericality ] },
+        { transaction_type: :presence },
+        { status: :presence },
+        { reference_number: [ :presence, :uniqueness ] }
+      ]
+
+      include_examples("model_shared_spec", :virtual_account_transaction, attributes)
+
+      describe 'validations' do
+        it { should validate_numericality_of(:amount).is_greater_than(0) }
+      end
+
+      describe 'enums' do
+        it { should define_enum_for(:transaction_type).with_values(transfer: 0, deposit: 1, withdrawal: 2) }
+        it { should define_enum_for(:status).with_values(pending: 0, completed: 1, failed: 2, cancelled: 3) }
+      end
+
+      describe '#generate_reference_number' do
+        let(:transaction) { build(:virtual_account_transaction) }
+
+        it 'generates reference number before validation on create' do
+          transaction.save
+          expect(transaction.reference_number).to be_present
+          expect(transaction.reference_number).to match(/\ATXN\d{14}[0-9a-f]{6}\z/)
+        end
+
+        it 'does not override existing reference number' do
+          existing_ref = 'TXN20230101123456abc123'
+          transaction.reference_number = existing_ref
+          transaction.save
+          expect(transaction.reference_number).to eq(existing_ref)
+        end
+      end
+
+      describe 'transaction processing' do
+        let(:from_account) { create(:virtual_account, balance: 1000.00, status: :active) }
+        let(:to_account) { create(:virtual_account, balance: 500.00, status: :active) }
+        let(:transaction) do
+          build(:virtual_account_transaction,
+                from_account: from_account,
+                to_account: to_account,
+                amount: 300.00)
+        end
+
+        context 'when processing transfer' do
+          it 'updates account balances on successful transfer' do
+            expect(transaction.save).to be true
+            expect(transaction.process!).to be true
+
+            expect(from_account.reload.balance.round(2)).to eq(700.00)
+            expect(to_account.reload.balance.round(2)).to eq(800.00)
+            expect(transaction.reload.status).to eq('completed')
+          end
+
+          it 'validates sufficient balance' do
+            transaction.amount = 2000.00
+            expect(transaction.save).to be false
+            expect(transaction.errors[:from_account]).to include('insufficient balance')
+          end
+
+          it 'validates account status' do
+            from_account.update!(status: :suspended)
+            expect(transaction.save).to be false
+            expect(transaction.errors[:from_account]).to include('must be active')
+          end
+        end
+
+        context 'when processing deposit' do
+          let(:transaction) do
+            build(:virtual_account_transaction, :deposit,
+                  to_account: to_account,
+                  amount: 300.00)
+          end
+
+          it 'updates recipient account balance' do
+            expect(transaction.save).to be true
+            expect(transaction.process!).to be true
+
+            expect(to_account.reload.balance.round(2)).to eq(800.00)
+            expect(transaction.reload.status).to eq('completed')
+          end
+
+          it 'validates recipient account status' do
+            to_account.update!(status: :suspended)
+            expect(transaction.save).to be false
+            expect(transaction.errors[:to_account]).to include('must be active')
+          end
+        end
+
+        context 'when processing withdrawal' do
+          let(:transaction) do
+            build(:virtual_account_transaction, :withdrawal,
+                  from_account: from_account,
+                  amount: 300.00)
+          end
+
+          it 'updates source account balance' do
+            expect(transaction.save).to be true
+            expect(transaction.process!).to be true
+
+            expect(from_account.reload.balance.round(2)).to eq(700.00)
+            expect(transaction.reload.status).to eq('completed')
+          end
+
+          it 'validates source account status' do
+            from_account.update!(status: :suspended)
+            expect(transaction.save).to be false
+            expect(transaction.errors[:from_account]).to include('must be active')
+          end
+        end
+      end
+
+      describe '#cancel!' do
+        it 'cancels pending transaction' do
+          transaction = create(:virtual_account_transaction)
+          expect(transaction.cancel!).to be true
+          expect(transaction.status).to eq('cancelled')
+        end
+
+        it 'cannot cancel completed transaction' do
+          transaction = create(:virtual_account_transaction, :completed)
+          expect(transaction.cancel!).to be false
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,5 +1,5 @@
 require "simplecov"
-# require "./spec/support/models/shared_examples"
+require "./spec/support/models/shared_examples"
 # require "./spec/support/requests/shared_requests"
 require "rspec/retry"
 
@@ -15,6 +15,9 @@ RSpec.configure do |config|
   config.shared_context_metadata_behavior = :apply_to_host_groups
   config.example_status_persistence_file_path = "spec/examples.txt"
   config.disable_monkey_patching!
+
+  config.formatter = RSpec::Core::Formatters::DocumentationFormatter
+
   config.profile_examples = 10
   config.order = :random
   Kernel.srand config.seed

data/spec/support/requests/shared_requests.rb

@@ -39,7 +39,7 @@ module Bscf
         describe "POST /create" do
           context "with valid params" do
             it "creates a new object" do
-              params = {payload: valid_attributes}
+              params = { payload: valid_attributes }
               expect do
                 post(
                   send("#{controller}_url"),
@@ -58,7 +58,7 @@ module Bscf
 
           context "with invalid params" do
             it "renders a JSON response with errors for the new object" do
-              params = {payload: invalid_attributes}
+              params = { payload: invalid_attributes }
               post(
                 send("#{controller}_url"),
                 params: params,
@@ -82,7 +82,7 @@ module Bscf
           context "with valid params" do
             it "updates the requested object" do
               obj = create(factory)
-              params = {id: obj.to_param, payload: new_attributes}
+              params = { id: obj.to_param, payload: new_attributes }
               put(
                 send("#{controller.singularize}_url", obj),
                 headers: headers,
@@ -103,7 +103,7 @@ module Bscf
           context "with invalid params" do
             it "renders a JSON response with errors for the object" do
               obj = create(factory)
-              params = {id: obj.to_param, payload: invalid_attributes}
+              params = { id: obj.to_param, payload: invalid_attributes }
               put(
                 send("#{controller.singularize}_url", obj),
                 headers: headers,

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: bscf-core
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Asrat
 bindir: bin
 cert_chain: []
-date: 2025-03-24 00:00:00.000000000 Z
+date: 2025-03-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: active_model_serializers
@@ -286,13 +286,46 @@ files:
 - app/controllers/bscf/core/application_controller.rb
 - app/jobs/bscf/core/application_job.rb
 - app/mailers/bscf/core/application_mailer.rb
+- app/models/bscf/core/address.rb
 - app/models/bscf/core/application_record.rb
+- app/models/bscf/core/business.rb
+- app/models/bscf/core/category.rb
+- app/models/bscf/core/order.rb
+- app/models/bscf/core/order_item.rb
+- app/models/bscf/core/product.rb
+- app/models/bscf/core/quotation.rb
+- app/models/bscf/core/quotation_item.rb
+- app/models/bscf/core/request_for_quotation.rb
+- app/models/bscf/core/rfq_item.rb
+- app/models/bscf/core/role.rb
+- app/models/bscf/core/user.rb
+- app/models/bscf/core/user_profile.rb
+- app/models/bscf/core/user_role.rb
+- app/models/bscf/core/virtual_account.rb
+- app/models/bscf/core/virtual_account_transaction.rb
 - config/database.yml
 - config/routes.rb
+- db/migrate/20250326065606_create_bscf_core_users.rb
+- db/migrate/20250326075111_create_bscf_core_roles.rb
+- db/migrate/20250326080646_create_bscf_core_user_profiles.rb
+- db/migrate/20250326081052_create_bscf_core_addresses.rb
+- db/migrate/20250326084233_create_bscf_core_user_roles.rb
+- db/migrate/20250326085741_create_bscf_core_virtual_accounts.rb
+- db/migrate/20250326103305_create_bscf_core_categories.rb
+- db/migrate/20250326105652_create_bscf_core_products.rb
+- db/migrate/20250326112449_create_bscf_core_businesses.rb
+- db/migrate/20250326115203_create_bscf_core_request_for_quotations.rb
+- db/migrate/20250326120613_create_bscf_core_rfq_items.rb
+- db/migrate/20250326121246_create_bscf_core_bscf_core_virtual_account_transactions.rb
+- db/migrate/20250327041651_create_bscf_core_quotations.rb
+- db/migrate/20250327044020_create_bscf_core_quotation_items.rb
+- db/migrate/20250327102217_create_bscf_core_orders.rb
+- db/migrate/20250327112412_create_bscf_core_order_items.rb
 - lib/bscf/core.rb
 - lib/bscf/core/engine.rb
 - lib/bscf/core/version.rb
 - lib/tasks/bscf/core_tasks.rake
+- lib/tasks/release.rake
 - spec/dummy/Rakefile
 - spec/dummy/app/assets/stylesheets/application.css
 - spec/dummy/app/controllers/application_controller.rb
@@ -321,9 +354,43 @@ files:
 - spec/dummy/config/puma.rb
 - spec/dummy/config/routes.rb
 - spec/dummy/config/storage.yml
+- spec/dummy/db/schema.rb
 - spec/dummy/log/development.log
+- spec/dummy/log/test.log
 - spec/dummy/tmp/local_secret.txt
 - spec/examples.txt
+- spec/factories/bscf/core/addresses.rb
+- spec/factories/bscf/core/businesses.rb
+- spec/factories/bscf/core/categories.rb
+- spec/factories/bscf/core/order_items.rb
+- spec/factories/bscf/core/orders.rb
+- spec/factories/bscf/core/products.rb
+- spec/factories/bscf/core/quotation_items.rb
+- spec/factories/bscf/core/quotations.rb
+- spec/factories/bscf/core/request_for_quotations.rb
+- spec/factories/bscf/core/rfq_items.rb
+- spec/factories/bscf/core/roles.rb
+- spec/factories/bscf/core/user_profiles.rb
+- spec/factories/bscf/core/user_roles.rb
+- spec/factories/bscf/core/users.rb
+- spec/factories/bscf/core/virtual_account_transactions.rb
+- spec/factories/bscf/core/virtual_accounts.rb
+- spec/models/bscf/core/address_spec.rb
+- spec/models/bscf/core/business_spec.rb
+- spec/models/bscf/core/category_spec.rb
+- spec/models/bscf/core/order_item_spec.rb
+- spec/models/bscf/core/order_spec.rb
+- spec/models/bscf/core/product_spec.rb
+- spec/models/bscf/core/quotation_item_spec.rb
+- spec/models/bscf/core/quotation_spec.rb
+- spec/models/bscf/core/request_for_quotation_spec.rb
+- spec/models/bscf/core/rfq_item_spec.rb
+- spec/models/bscf/core/role_spec.rb
+- spec/models/bscf/core/user_profile_spec.rb
+- spec/models/bscf/core/user_role_spec.rb
+- spec/models/bscf/core/user_spec.rb
+- spec/models/bscf/core/virtual_account_spec.rb
+- spec/models/bscf/core/virtual_account_transaction_spec.rb
 - spec/rails_helper.rb
 - spec/spec_helper.rb
 - spec/support/models/shared_examples.rb