bankserv 0.1.3

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+spec/internal/db/bankserv_test.sqlite
+spec/internal/config/database.yml

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.9.2@bankserv --create

data/Gemfile

@@ -0,0 +1,16 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in bankserv.gemspec
+gemspec
+
+group :development do
+  gem 'mysql2'
+  gem 'rspec'
+  gem 'rspec-rails'
+  gem 'sqlite3'
+  gem 'timecop'
+  gem 'factory_girl'
+  gem 'faker'
+end
+
+gem "holidays"

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+
+# If you want to make this the default task
+task :default => :spec
+require "bundler/gem_tasks"

data/bankserv.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "bankserv/version"
+
+Gem::Specification.new do |s|
+  s.name        = "bankserv"
+  s.version     = Bankserv::VERSION
+  s.authors     = ["Jeffrey van Aswegen", "Douglas Anderson"]
+  s.email       = ["jeffmess@gmail.com", "i.am.douglas.anderson@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{ A rails 3 engine wrapped around the Absa Host 2 Host gem.}
+  s.description = %q{This engine allows users to inject requests into a queue to be processed. 
+    
+                    The queue handles bank account validations, credit payments, debit orders
+                    and collecting bank statements. }
+
+  s.rubyforge_project = "bankserv"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency "activesupport"
+  s.add_dependency "activerecord", "~> 3.0"
+  s.add_dependency "i18n"
+  s.add_dependency "absa-h2h", "~> 0.0.11"
+  s.add_dependency "absa-esd", "~> 0.0.1"
+
+  s.add_development_dependency 'combustion', '~> 0.3.1'
+end

data/config.ru

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'bundler'
+
+Bundler.require :default, :development
+
+Combustion.initialize!
+run Combustion::Application

data/lib/bankserv.rb

@@ -0,0 +1,48 @@
+require "absa-h2h"
+require "active_record"
+require "core_extensions"
+require "bankserv/version"
+
+module Bankserv
+    
+  def self.table_name_prefix
+    'bankserv_'
+  end
+  
+  CONFIG_DIR = File.expand_path(File.dirname(__FILE__)) + "/config"
+  
+end
+
+require "bankserv/configuration"
+require "bankserv/eft"
+require "bankserv/request"
+require "bankserv/bank_account"
+require "bankserv/account_holder_verification"
+require "bankserv/debit"
+require "bankserv/credit"
+
+require 'bankserv/transmission/document'
+require 'bankserv/transmission/output_document'
+require 'bankserv/transmission/input_document'
+require 'bankserv/transmission/reply_document'
+require 'bankserv/transmission/statement'
+
+require 'bankserv/transmission/set'
+require 'bankserv/transmission/record'
+
+require 'bankserv/transmission/set/document'
+require 'bankserv/transmission/set/account_holder_verification'
+require 'bankserv/transmission/set/account_holder_verification_output'
+require 'bankserv/transmission/set/eft'
+require 'bankserv/transmission/set/debit'
+require 'bankserv/transmission/set/credit'
+require 'bankserv/transmission/set/eft_output'
+require 'bankserv/transmission/set/eft_redirect'
+require 'bankserv/transmission/set/eft_unpaid'
+require 'bankserv/transmission/set/reply'
+
+require 'bankserv/engine'
+require 'bankserv/engine/engine_configuration'
+require 'bankserv/engine/engine_process'
+
+require 'bankserv/transaction'

data/lib/bankserv/account_holder_verification.rb

@@ -0,0 +1,90 @@
+module Bankserv
+  
+  class AccountHolderVerification < ActiveRecord::Base
+    
+    self.inheritance_column = :_type_disabled
+    serialize :response
+    
+    belongs_to :bank_account, :foreign_key => 'bankserv_bank_account_id'
+    belongs_to :request, :foreign_key => 'bankserv_request_id'
+    
+    scope :unprocessed, where(status: "new")
+    scope :internal, where(internal: true)
+    scope :external, where(internal: false)
+    
+    after_create :generate_internal_user_ref
+    
+    def generate_internal_user_ref
+      self.internal_user_ref = "AHV#{id}"
+      save!  
+    end
+  
+    def self.request(options = {})
+      options.merge!(type: 'ahv')
+      Request.create!(options)
+    end
+    
+    def self.test_request(options)
+      Request.create!(options.merge(test: true))
+    end
+    
+    def self.for_reference(reference)
+      self.where(:user_ref => reference)
+    end
+    
+    def self.for_internal_reference(reference)
+      self.where(:internal_user_ref => reference)
+    end
+    
+    def self.build!(options)
+      bank_account = BankAccount.new options[:bank_account].filter_attributes(BankAccount)
+      is_internal = bank_account.branch_code == Bankserv::Configuration.internal_branch_code
+      options = options.filter_attributes(self).merge(bank_account: bank_account, internal: is_internal)
+      
+      create!(options)
+    end
+    
+    def internal?
+      internal == true
+    end
+    
+    def external?
+      !internal?
+    end
+    
+    def new?
+      status == "new"
+    end
+    
+    def pending?
+      status == "pending"
+    end
+    
+    def error?
+      status == "error"
+    end
+    
+    def completed?
+      status == "completed"
+    end
+    
+    def process_response(data)
+      file_name = "#{Bankserv::CONFIG_DIR}/ahv.yml"
+      return_code_mapping = YAML.load(File.open(file_name))['return_codes']
+      
+      hash = {
+        account_number: return_code_mapping[data[:return_code_1]].to_sym,
+        id_number: return_code_mapping[data[:return_code_2]].to_sym,
+        initials: return_code_mapping[data[:return_code_3]].to_sym,
+        surname: return_code_mapping[data[:return_code_4]].to_sym
+      }
+      
+      self.response = hash
+      self.status = "completed"
+      self.save!
+    end
+    
+  end
+  
+end
+

data/lib/bankserv/bank_account.rb

@@ -0,0 +1,19 @@
+module Bankserv
+  
+  class BankAccount < ActiveRecord::Base
+    
+    def account_type_id
+      if self.account_type.to_i != 0
+        self.account_type.to_s
+      else
+        { "current" => "1",
+        "savings" => "2",
+        "transmission" => "3",
+        "bond" => "4",
+        "subscription" => "6" }[self.account_type.downcase]
+      end
+    end
+    
+  end
+  
+end

data/lib/bankserv/configuration.rb

@@ -0,0 +1,67 @@
+module Bankserv
+  
+  class Configuration < ActiveRecord::Base
+    
+    def self.active
+      self.where(active: true).last
+    end
+    
+    def self.client_code
+      self.active.client_code
+    end
+    
+    def self.client_name
+      self.active.client_name
+    end
+    
+    def self.client_abbreviated_name
+      self.active.client_abbreviated_name
+    end
+    
+    def self.user_code
+      self.active.user_code
+    end
+    
+    def self.department_code
+      self.active.department_code
+    end
+    
+    def self.user_generation_number
+      self.active.user_generation_number
+    end
+    
+    def self.internal_branch_code
+      self.active.internal_branch_code
+    end
+    
+    def self.transmission_number
+      self.active.transmission_number
+    end
+    
+    def self.set_transmission_number!(number)
+      self.active.update_attributes!(transmission_number: number)
+    end
+    
+    def self.reserve_transmission_number!
+      reserved = self.transmission_number
+      self.set_transmission_number!(reserved + 1)
+      reserved
+    end
+    
+    def self.set_user_generation_number!(number)
+      self.active.update_attributes!(user_generation_number: number)
+    end
+    
+    def self.reserve_user_generation_number!
+      reserved = self.user_generation_number
+      self.set_user_generation_number!(reserved + 1)
+      reserved
+    end
+    
+    def self.live_env?
+      self.active.live_env
+    end
+  
+  end
+  
+end

data/lib/bankserv/credit.rb

@@ -0,0 +1,70 @@
+module Bankserv
+  
+  class Credit < ActiveRecord::Base
+    extend Eft
+
+    serialize :response
+    scope :unprocessed, where(status: "new")
+
+    belongs_to :bank_account, :foreign_key => 'bankserv_bank_account_id'
+    belongs_to :request, :foreign_key => 'bankserv_request_id'
+    
+    after_create :generate_internal_user_ref
+    
+    def generate_internal_user_ref
+      self.internal_user_ref = "CREDIT#{id}"
+      save!
+    end
+    
+    def self.for_reference(reference)
+      self.where(:user_ref => reference)
+    end
+    
+    def self.for_internal_reference(reference)
+      self.where(:internal_user_ref => reference)
+    end
+    
+    def amount_in_cents
+      (amount * 100).to_i
+    end
+    
+    def new?
+      status == "new"
+    end
+    
+    def pending?
+      status == "pending"
+    end
+    
+    def error?
+      status == "error"
+    end
+    
+    def completed?
+      status == "completed"
+    end
+    
+    def standard?
+      record_type == "standard"
+    end
+    
+    def contra?
+      record_type == "contra"
+    end
+    
+    def formatted_user_ref
+      can_length = 10 - Configuration.client_abbreviated_name.length
+      "#{Configuration.client_abbreviated_name[0..9] << (' ' * can_length)}#{user_ref}"
+    end
+    
+    def contra_bank_details
+      if self.standard?
+        Credit.where(record_type: "contra", batch_id: self.batch_id, status: "new").first.bank_account
+      else
+        self.bank_account
+      end
+    end
+    
+  end
+  
+end

data/lib/bankserv/debit.rb

@@ -0,0 +1,94 @@
+module Bankserv
+  
+  class Debit < ActiveRecord::Base
+    extend Eft
+    
+    serialize :response
+    scope :unprocessed, where(status: "new")
+    
+    belongs_to :bank_account, :foreign_key => 'bankserv_bank_account_id'
+    belongs_to :request, :foreign_key => 'bankserv_request_id'
+    
+    after_create :generate_internal_user_ref
+    
+    def generate_internal_user_ref
+      self.internal_user_ref = "DEBIT#{id}"
+      save!  
+    end
+    
+    def standard?
+      record_type == "standard"
+    end
+    
+    def contra?
+      record_type == "contra"
+    end
+    
+    def amount_in_cents
+      (amount * 100).to_i
+    end
+    
+    def formatted_user_ref
+      can_length = 10 - Configuration.client_abbreviated_name.length
+      "#{Configuration.client_abbreviated_name[0..9] << (' ' * can_length)}#{user_ref}"
+    end
+    
+    def contra_bank_details
+      if self.standard?
+        Debit.where(record_type: "contra", batch_id: self.batch_id, status: "new").first.bank_account
+      else
+        self.bank_account
+      end
+    end
+    
+    def self.for_reference(reference)
+      self.where(:user_ref => reference)
+    end
+    
+    def self.for_internal_reference(reference)
+      self.where(:internal_user_ref => reference)
+    end
+    
+    def process_response(data)
+      save_data = if data[:response_status] == 'unpaid'
+        {
+          rejection_reason_description: Absa::H2h::Eft::RejectionCode.reason_for_code(data[:rejection_reason]),
+          rejection_reason: data[:rejection_reason],
+          rejection_qualifier_description: Absa::H2h::Eft::RejectionCode.qualifier_for_code(data[:rejection_qualifier]),
+          rejection_qualifier: data[:rejection_qualifier]
+        }
+      elsif data[:response_status] == 'redirect'
+        data.only([:new_homing_branch, :new_homing_account_number, :new_homing_account_type])
+      end
+      
+      self.response = save_data
+      self.status = data[:response_status]
+      self.save!
+    end
+    
+    def new?
+      status == "new"
+    end
+    
+    def pending?
+      status == "pending"
+    end
+    
+    def error?
+      status == "error"
+    end
+    
+    def completed?
+      status == "completed"
+    end
+    
+    def unpaid?
+      status == "unpaid"
+    end
+    
+    def redirect?
+      status == "redirect"
+    end
+  end
+  
+end