fin_it 0.1.0

data/lib/fin_it/complex_model.rb

@@ -0,0 +1,169 @@
+# frozen_string_literal: true
+
+require 'date'
+require_relative 'calculator'
+
+module FinIt
+  # Complex models with coded formulas (e.g., loans, amortization schedules)
+  # These models can define input variables and calculate their own transactions
+  class ComplexModel
+    attr_reader :name, :start_date, :end_date, :frequency, :input_variables, :formula_block, :debit_account, :credit_account, :project
+    
+    def initialize(name, start_date:, end_date: nil, frequency: :monthly, debit_account:, credit_account:, project: nil, &formula_block)
+      @name = name
+      @start_date = parse_date(start_date)
+      @end_date = parse_date(end_date)
+      @frequency = frequency
+      @debit_account = debit_account
+      @credit_account = credit_account
+      @project = project
+      @formula_block = formula_block
+      @input_variables = {}
+    end
+    
+    # Define an input variable for this model
+    def input_variable(name, value)
+      @input_variables[name] = value
+    end
+    
+    # Calculate transactions for this model up to end_date
+    def calculate_transactions(end_date, calculator, model_context = {})
+      end_date = parse_date(end_date)
+      transactions = []
+      
+      # Generate dates based on frequency
+      dates = generate_dates(@start_date, [@end_date, end_date].compact.min, @frequency)
+      
+      dates.each do |date|
+        # Build context with input variables and model context
+        context = @input_variables.merge(model_context)
+        
+        # Execute formula block - can return single amount or array of transactions
+        result = @formula_block.call(date, context)
+        
+        next unless result
+        
+        # Handle array of transactions (multiple transactions per period)
+        if result.is_a?(Array)
+          result.each do |txn_hash|
+            next unless txn_hash.is_a?(Hash) && txn_hash[:amount]
+            
+            # Convert to Money object for precision and currency safety
+            amount = if txn_hash[:amount].is_a?(Money)
+              txn_hash[:amount]
+            else
+              currency = txn_hash[:currency] || 'USD'
+              Money.new((txn_hash[:amount].to_f * 100).to_i, currency)
+            end
+            next if amount.zero?
+            
+            transactions << {
+              date: date,
+              variable: @name,
+              amount: amount,  # Money object
+              debit_account: txn_hash[:debit_account] || @debit_account,
+              credit_account: txn_hash[:credit_account] || @credit_account,
+              description: txn_hash[:description] || "Transaction for #{@name}",
+              currency: amount.currency.iso_code,
+              model_type: :complex
+            }
+          end
+        else
+          # Single transaction (backward compatibility)
+          # Convert to Money object for precision and currency safety
+          amount = if result.is_a?(Money)
+            result
+          else
+            Money.new((result.to_f * 100).to_i, 'USD')
+          end
+          next if amount.zero?
+          
+          transactions << {
+            date: date,
+            variable: @name,
+            amount: amount,  # Money object
+            debit_account: @debit_account,
+            credit_account: @credit_account,
+            description: "Transaction for #{@name}",
+            currency: amount.currency.iso_code,
+            model_type: :complex
+          }
+        end
+      end
+      
+      transactions
+    end
+    
+    # Calculate hash for this model (for cache invalidation)
+    def hash(calculator)
+      # Hash = hash of input variables + model definition
+      input_hash = @input_variables.sort_by { |k, _| k.to_s }
+        .map { |k, v| "#{k}:#{hash_value(v)}" }
+        .join('|')
+      
+      model_hash_data = [
+        @name.to_s,
+        @start_date.to_s,
+        @end_date&.to_s,
+        @frequency.to_s,
+        @debit_account.to_s,
+        @credit_account.to_s,
+        @project&.to_s
+      ].compact.join('|')
+      
+      require 'digest'
+      Digest::SHA256.hexdigest("#{input_hash}|#{model_hash_data}")
+    end
+    
+    private
+    
+    def generate_dates(start_date, end_date, frequency)
+      dates = []
+      current = start_date
+      
+      while current <= end_date
+        dates << current
+        
+        current = case frequency
+        when :daily
+          current + 1
+        when :weekly
+          current + 7
+        when :monthly
+          current >> 1
+        when :quarterly
+          current >> 3
+        when :annual
+          current >> 12
+        else
+          current >> 1 # Default monthly
+        end
+      end
+      
+      dates
+    end
+    
+    def hash_value(value)
+      if value.is_a?(Money)
+        "#{value.fractional}:#{value.currency.iso_code}"
+      else
+        value.to_s
+      end
+    end
+    
+    def parse_date(date)
+      return date if date.is_a?(Date)
+      return nil if date.nil?
+      
+      case date
+      when String
+        Date.parse(date)
+      when Time
+        date.to_date
+      else
+        date
+      end
+    end
+  end
+end
+

data/lib/fin_it/dsl/account_builder.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module FinIt
+  module DSL
+    # Builder for account definitions
+    class AccountBuilder
+      attr_reader :account_type, :account_currency, :account_opening_balance, :account_opening_balance_credit_account
+
+      def initialize(name)
+        @name = name
+        @account_type = nil
+        @account_currency = nil
+        @account_opening_balance = nil
+        @account_opening_balance_credit_account = :equity
+      end
+
+      def type(account_type)
+        @account_type = account_type
+      end
+
+      def currency(currency_code)
+        @account_currency = currency_code
+      end
+
+      def opening_balance(amount)
+        @account_opening_balance = amount
+      end
+
+      def opening_balance_credit_account(account_name)
+        @account_opening_balance_credit_account = account_name
+      end
+    end
+  end
+end
+

data/lib/fin_it/dsl/calculated_builder.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module FinIt
+  module DSL
+    # Builder for calculated variables
+    class CalculatedBuilder
+      def initialize(name, calculator)
+        @name = name
+        @calculator = calculator
+        @formula = nil
+        @round_to = nil
+        @start_date = nil
+        @end_date = nil
+        @frequency = nil
+        @payment_schedule = nil
+        @debit_account = nil
+        @credit_account = nil
+        @account = nil
+      end
+
+      def formula(expression = nil)
+        if expression
+          @formula = expression
+        else
+          @formula
+        end
+      end
+
+      def round_to(digits = nil)
+        if digits
+          @round_to = digits
+        else
+          @round_to
+        end
+      end
+
+      def start_date(date = nil)
+        if date
+          @start_date = date
+        else
+          @start_date
+        end
+      end
+
+      def end_date(date = nil)
+        if date
+          @end_date = date
+        else
+          @end_date
+        end
+      end
+
+      def frequency(freq = nil)
+        if freq
+          @frequency = freq
+        else
+          @frequency
+        end
+      end
+
+      def payment_schedule(schedule = nil)
+        if schedule
+          @payment_schedule = schedule
+        else
+          @payment_schedule
+        end
+      end
+
+      def description(text = nil)
+        # Store description
+      end
+      
+      def debit_account(account)
+        @debit_account = account
+      end
+      
+      def credit_account(account)
+        @credit_account = account
+      end
+      
+      def account(account)
+        @account = account
+      end
+    end
+  end
+end
+

data/lib/fin_it/dsl/config_builder.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module FinIt
+  module DSL
+    # Builder for configuration
+    class ConfigBuilder
+      def initialize(config)
+        @config = config
+      end
+
+      def with_bonus(value)
+        @config[:with_bonus] = value
+      end
+
+      def base_year(year)
+        @config[:base_year] = year
+      end
+      
+      def default_currency(currency)
+        @config[:default_currency] = currency
+      end
+      
+      def start_date(date_or_year)
+        # Accept year number (Integer) or Date
+        if date_or_year.is_a?(Integer)
+          @config[:start_date] = Date.new(date_or_year, 1, 1)
+        elsif date_or_year.is_a?(Date)
+          @config[:start_date] = date_or_year
+        elsif date_or_year.is_a?(String)
+          @config[:start_date] = Date.parse(date_or_year)
+        else
+          raise ArgumentError, "start_date must be a year (Integer), Date, or date string, got #{date_or_year.class}"
+        end
+      end
+      
+      def exchange_rates(rates)
+        rates.each do |from, to_rates|
+          to_rates.each do |to, rate|
+            Money.add_rate(from.to_s, to.to_s, rate)
+          end
+        end
+      end
+
+      def method_missing(name, *args)
+        if args.length == 1
+          @config[name] = args.first
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(name, include_private = false)
+        true
+      end
+    end
+  end
+end
+