uomi 0.2.13

data/lib/invoicing/line_item.rb

@@ -0,0 +1,17 @@
+module Invoicing
+  class LineItem < ActiveRecord::Base
+    belongs_to :invoice
+    belongs_to :invoiceable, polymorphic: true
+    belongs_to :line_item_type
+
+    validates :amount, numericality: {greater_than_or_equal_to: 0}, presence: true
+  
+    def net_amount
+      amount - tax
+    end
+
+    def self.for(item)
+      where(id: item.id).first
+    end
+  end
+end

data/lib/invoicing/line_item_type.rb

@@ -0,0 +1,6 @@
+module Invoicing
+  class LineItemType < ActiveRecord::Base
+    has_many :line_items
+
+  end
+end

data/lib/invoicing/overdue_invoice.rb

@@ -0,0 +1,16 @@
+module Invoicing
+  class OverdueInvoice
+  
+    def self.all
+      Invoice.owing.select{|invoice| invoice.overdue?}
+    end
+  
+    def self.record_late_payments!
+      OverdueInvoice.all.each do |invoice|
+        invoice.late_payment = LatePayment.new amount: invoice.balance.abs
+        invoice.save!
+      end
+    end
+  
+  end
+end

data/lib/invoicing/payment_reference.rb

@@ -0,0 +1,10 @@
+module Invoicing
+  
+  class PaymentReference < ActiveRecord::Base
+    
+    belongs_to :invoice
+    
+    
+  end
+  
+end

data/lib/invoicing/seller.rb

@@ -0,0 +1,10 @@
+module Invoicing
+  class Seller < ActiveRecord::Base
+    has_many :invoices
+    belongs_to :sellerable, polymorphic: true
+
+    def self.for(sellerable)
+      Seller.where(sellerable_type: sellerable.class.name, sellerable_id: sellerable.id).first || Seller.create!(sellerable_type: sellerable.class.name, sellerable_id: sellerable.id)
+    end
+  end
+end

data/lib/invoicing/transaction.rb

@@ -0,0 +1,13 @@
+module Invoicing
+  class Transaction < ActiveRecord::Base
+    belongs_to :invoice
+    
+    def debit?
+      false
+    end
+    
+    def credit?
+      false
+    end
+  end
+end

data/lib/invoicing/version.rb

@@ -0,0 +1,3 @@
+module Invoicing
+  VERSION = "0.2.13"
+end

data/lib/invoicing.rb

@@ -0,0 +1,46 @@
+require "active_record"
+require "workflow"
+require "invoicing/version"
+
+module Invoicing
+    
+  def self.table_name_prefix
+    'invoicing_'
+  end
+  
+  def self.generate(&block)
+    invoice = Invoice.new
+    invoice.instance_eval(&block)
+    invoice.save!
+    invoice
+  end
+
+  def self.generate_credit_note(&block)
+    credit_note = CreditNote.new
+    credit_note.instance_eval(&block)
+    credit_note.save!
+    credit_note.issue!
+    credit_note
+  end
+  
+end
+
+require "invoicing/exception"
+require "invoicing/invoiceable"
+require "invoicing/transaction"
+require "invoicing/credit_transaction"
+require "invoicing/debit_transaction"
+require "invoicing/late_payment"
+require "invoicing/line_item"
+require "invoicing/payment_reference"
+require "invoicing/seller"
+require "invoicing/buyer"
+require "invoicing/invoice_decorator"
+require "invoicing/credit_note_invoice"
+require "invoicing/credit_note_credit_transaction"
+
+require "invoicing/invoice"
+require "invoicing/credit_note"
+require "invoicing/overdue_invoice"
+require "invoicing/invoice_adjustment"
+require "invoicing/line_item_type"

data/spec/internal/config/database.yml.sample

@@ -0,0 +1,3 @@
+test:
+  adapter:  sqlite3
+  database: db/invoicing_test.sqlite

data/spec/internal/config/routes.rb

@@ -0,0 +1,3 @@
+Rails.application.routes.draw do
+  #
+end

data/spec/internal/db/schema.rb

@@ -0,0 +1,81 @@
+ActiveRecord::Schema.define do
+  
+  create_table "invoicing_late_payments", :force => true do |t|
+    t.integer  "invoice_id"
+    t.integer "amount"
+    t.datetime "penalty_date"
+    t.boolean  "processed"
+    t.timestamps
+  end
+  
+  create_table "invoicing_line_items", :force => true do |t|
+    t.integer "invoice_id"
+    t.string  "description"
+    t.integer "amount"
+    t.integer "tax"
+    t.integer "invoiceable_id"
+    t.string "invoiceable_type"
+    t.integer "line_item_type_id"
+    t.timestamps
+  end
+  
+  create_table "invoicing_transactions", :force => true do |t|
+    t.integer "invoice_id"
+    t.string  "type"
+    t.integer "amount"
+    t.timestamps
+  end
+  
+  create_table "invoicing_invoices", :force => true do |t|
+    t.integer  "seller_id"
+    t.integer  "buyer_id"
+    t.string   "invoice_number"
+    t.datetime "due_date"
+    t.datetime "issued_at"
+    t.integer  "total"
+    t.integer  "tax"
+    t.integer  "balance"
+    t.string   "type"
+    t.string   "workflow_state"
+    t.timestamps
+  end
+  
+  create_table "invoicing_payment_references", :force => true do |t|
+    t.integer "invoice_id"
+    t.string "reference"
+    t.timestamps
+  end
+  
+  create_table "invoicing_sellers", :force => true do |t|
+    t.integer "sellerable_id"
+    t.string "sellerable_type"
+    t.timestamps
+  end
+
+  create_table "invoicing_buyers", :force => true do |t|
+    t.integer "buyerable_id"
+    t.string "buyerable_type"
+    t.timestamps
+  end
+  
+  create_table "invoicing_invoice_decorators", :force => true do |t|
+    t.integer "invoice_id"
+    t.text "data"
+    t.timestamps
+  end
+
+  create_table "invoicing_credit_note_invoices", :force => true do |t|
+    t.integer "invoice_id"
+    t.integer "credit_note_id"
+  end
+
+  create_table "invoicing_credit_note_credit_transactions", :force => true do |t|
+    t.integer "credit_note_id"
+    t.integer "transaction_id"
+  end
+
+  create_table "invoicing_line_item_types", :force => true do |t|
+    t.string "name"
+  end
+  
+end

data/spec/internal/log/.gitignore

@@ -0,0 +1 @@
+*.log

data/spec/lib/invoicing/credit_note_spec.rb

@@ -0,0 +1,140 @@
+require 'spec_helper'
+
+describe Invoicing::CreditNote do
+  include Helpers
+  
+  before(:each) do
+    tear_it_down
+
+    invoice_buyer = Invoicing::DebitTransaction.create!
+    invoice_seller = Invoicing::DebitTransaction.create!
+    
+    @invoice = Invoicing::generate do
+      to invoice_buyer
+      from invoice_seller
+
+      line_item description: "Line Item 1", amount: 1101
+      line_item description: "Line Item 2", amount: 5097
+      line_item description: "Line Item 3", amount: 1714
+      line_item description: "Line Item 4", amount: 20300
+
+      payment_reference "REF123"
+      decorate_with tenant_name: "Peter"
+    end
+
+    @invoice_buyer = invoice_buyer
+    @invoice_seller = invoice_seller
+
+    @invoice.issue!
+  end
+
+  context "when recording a credit note" do
+    before(:each) do
+      @invoice.line_items.each do |li|
+        li.invoiceable = li
+        li.invoiceable.extend(Invoicing::Invoiceable)
+        li.amount = 0
+        li.tax = 0
+        li.save!
+      end
+
+      @invoice.reload
+    end
+
+    it "should raise an exception if the invoice is not in an issued state" do
+      lambda {
+        @credit_note = Invoicing::generate_credit_note do
+          against_invoice @invoice
+        end
+      }.should raise_error(RuntimeError, "You must allocate a credit note against an invoice")
+      
+    end
+
+    context "against an invoice" do
+      before(:each) do
+        invoice = @invoice
+        line_items = invoice.line_items
+
+        @credit_note = Invoicing::generate_credit_note do
+          line_items.each do |line_item|
+            credit amount: line_item.amount, line_item: line_item, description: "Credit note for Line Item #{line_item.id}", tax: 0
+          end
+
+          against_invoice invoice
+        end
+
+        @invoice.reload
+      end
+
+      it "should be issued" do
+        @credit_note.should be_issued
+      end
+
+      it "should have a receipt number" do
+        @credit_note.receipt_number.should == "CN#{@credit_note.id}"
+      end
+
+      it "should be able to record a line item for the credit note" do
+        @credit_note.line_items.count.should == @invoice.line_items.count
+        @credit_note.line_items.first.amount.should == @invoice.line_items.first.amount
+      end
+
+      it "should create a credit transaction against the invoice" do
+        @invoice.settled?.should be_true
+      end
+
+      it "should know if it is linked to an invoice" do
+        @credit_note.invoice.should == @invoice
+      end
+
+      it "should be linked to the credit transaction paid against the invoice" do
+        @credit_note.credit_note_credit_transactions.count.should == 1
+        @credit_note.credit_note_credit_transactions.first.transaction.amount.should == @invoice.total
+      end
+
+      it "should be recorded against the invoice" do
+        @invoice.reload
+        @invoice.credit_notes.count.should == 1
+        @invoice.credit_notes.first.receipt_number.should == "CN#{@credit_note.id}"
+      end
+
+      it "should set the buyer to the invoice's buyer" do
+        @credit_note.buyer.buyerable.should == @invoice_buyer
+      end
+
+      it "should set the seller to the invoice's seller" do
+        @credit_note.seller.sellerable.should == @invoice_seller
+      end
+
+    end
+
+    context "When applying credits to the invoiceables" do
+
+      it "should receive handle credit for each line item being credited" do
+        credit_note = Invoicing::CreditNote.new
+        credit_note.line_items = @invoice.line_items
+
+        credit_note.line_items.map(&:invoiceable).compact.each do |item|
+          item.should_receive(:handle_credit)
+        end
+
+        credit_note.record_credit_notes!
+      end
+
+    end
+
+    context "trying to create a standalone credit note" do
+
+      it "should raise an error if no invoice is specified" do
+        expect {Invoicing::generate_credit_note do
+          line_items.each do |line_item|
+            credit amount: 500, description: "Credit note for Line Item #{line_item.id}", tax: 0
+          end
+          decorate_with tenant_name: "Peter"
+        end}.to raise_error(RuntimeError, "You must allocate a credit note against an invoice")
+      end
+    end
+
+  end
+  
+end

data/spec/lib/invoicing/invoice_adjustment_spec.rb

@@ -0,0 +1,136 @@
+require 'spec_helper'
+
+describe Invoicing::InvoiceAdjustment do
+  include Helpers
+  
+  before(:each) do
+    tear_it_down
+
+    buyer = Invoicing::DebitTransaction.create!
+    
+    @invoice = Invoicing::generate do
+      to buyer
+      numbered "INV123"
+
+      line_item description: "Line Item 1", amount: 1101, line_item_type_id: 1
+      line_item description: "Line Item 2", amount: 5097, line_item_type_id: 1
+      line_item description: "Line Item 3", amount: 1714, line_item_type_id: 1
+
+      payment_reference "REF123"
+      decorate_with tenant_name: "Peter"
+    end
+  end
+
+  context "adjusting a draft invoice" do
+  
+    it "should allow the due date to be updated" do
+      @invoice.adjust do
+        due Date.tomorrow
+      end
+    end
+
+    it "should allow the buyer to be changed" do
+      new_buyer = Invoicing::DebitTransaction.create!
+
+      @invoice.adjust do
+        to new_buyer
+      end
+
+      @invoice.buyer.buyerable.should == new_buyer
+    end
+
+    it "should allow a payment references to be added" do
+      @invoice.adjust do
+        add_payment_reference "NEWREF123"
+      end
+
+      @invoice.payment_references.count.should == 2
+    end
+
+    it "should allow a payment references to be removed" do
+      @invoice.adjust do
+        remove_payment_reference @invoice.payment_references.last
+      end
+
+      @invoice.payment_references.count.should == 0
+    end
+
+    it "should allow the invoice decorator to be updated" do
+      decorations = {tenant_name: "Bob"}
+
+      @invoice.adjust do
+        decorate_with decorations
+      end
+
+      # @invoice.reload
+
+      @invoice.decorator.data.should == decorations
+    end
+
+    it "should allow line items to be added" do
+      item_to_invoice = @invoice.extend(Invoicing::Invoiceable)
+      @invoice.line_items.count.should == 3
+
+      @invoice.adjust do
+        add_line_item(item_to_invoice)
+      end
+
+      @invoice.line_items.count.should == 4
+      @invoice.total.should == 7912
+    end
+
+    it "should allow line items to be edited" do
+      line_item = @invoice.line_items.first
+      item_to_invoice = @invoice.extend(Invoicing::Invoiceable)
+
+      @invoice.adjust do
+        edit_line_item(line_item, {description: "Modified Line Item", amount: 500})
+      end
+
+      @invoice.line_items.count.should == 3
+      @invoice.total.should == 7311
+
+      line_item.reload
+
+      line_item.description.should == "Modified Line Item"
+      line_item.amount.should == 500
+    end
+
+    it "should allow line items to be removed" do
+      @invoice.line_items.count.should == 3
+
+      @invoice.adjust do
+        remove_line_item(@invoice.line_items.first)
+      end
+
+      @invoice.line_items.count.should == 2
+      @invoice.total.should == 6811
+    end
+
+  end
+
+  context "Adjusting an Invoice Number" do
+    it "should allow the invoice number to be updated" do
+      @invoice.adjust do
+        numbered "DRAFT-INV123"
+      end
+
+      @invoice.invoice_number.should == "DRAFT-INV123"
+    end
+  end
+
+  context "adjusting an issued invoice" do
+
+    it "should raise an exception" do
+      @invoice.issue!
+
+      expect {
+        @invoice.adjust do
+          due Date.tomorrow
+        end
+      }.to raise_error(Invoicing::CannotAdjustIssuedDocument)
+    end
+
+  end
+
+end

data/spec/lib/invoicing/invoice_late_payment_spec.rb

@@ -0,0 +1,10 @@
+# require 'spec_helper'
+# 
+# describe Invoicing::LatePayment do
+#   include Helpers
+#   
+#   before(:each) do
+#     tear_it_down
+#   end
+#   
+# end