appydave-tools 0.85.0 → 0.86.0

data/lib/appydave/tools/bank_reconciliation/models/transaction.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+module Appydave
+  module Tools
+    module BankReconciliation
+      module Models
+        # Unified transaction model for raw and reconciled data
+        class Transaction
+          attr_accessor :bsb_number,
+                        :account_number,
+                        :transaction_date,
+                        :narration,
+                        :cheque_number,
+                        :debit,
+                        :credit,
+                        :balance,
+                        :transaction_type,
+                        :platform,
+                        :coa_code,
+                        :coa_match_type,
+                        :account_name,
+                        :source_files,
+                        :fin_year
+
+          def initialize(bsb_number: nil,
+                         account_number: nil,
+                         transaction_date: nil,
+                         narration: nil,
+                         cheque_number: nil,
+                         debit: nil,
+                         credit: nil,
+                         balance: nil,
+                         transaction_type: nil,
+                         platform: nil,
+                         coa_code: nil,
+                         coa_match_type: nil,
+                         account_name: nil)
+            account_number = account_number&.strip
+            @bsb_number = bsb_number&.strip
+            @account_number = account_number
+            @transaction_date = parse_date(transaction_date)
+            @narration = narration&.gsub(/\s{2,}/, ' ')&.strip
+            @cheque_number = cheque_number&.strip
+            @debit = debit # clean_amount(debit, account_number, coa_code)
+            @credit = credit # clean_amount(credit, account_number, coa_code)
+            @balance = balance&.strip
+            @transaction_type = transaction_type&.strip
+            @platform = platform
+            @coa_code = coa_code
+            @coa_match_type = coa_match_type
+            @account_name = account_name
+            @source_files = []
+            @fin_year = determine_fin_year(@transaction_date)
+          end
+
+          def add_source_file(source_file)
+            @source_files << source_file.strip unless @source_files.include?(source_file.strip)
+          end
+
+          def self.csv_headers
+            %i[
+              platform
+              account_name
+              bsb_number
+              account_number
+              transaction_date
+              narration
+              debit
+              credit
+              balance
+              transaction_type
+              coa_code
+              coa_match_type
+              source_files
+              fin_year
+            ]
+          end
+
+          def to_csv_row
+            [
+              @platform,
+              @account_name,
+              @bsb_number,
+              @account_number,
+              @transaction_date,
+              @narration,
+              @debit ? format('%.2f', @debit) : '',
+              @credit ? format('%.2f', @credit) : '',
+              @balance,
+              @transaction_type,
+              @coa_code,
+              @coa_match_type,
+              @source_files.join('; '),
+              @fin_year
+            ]
+          end
+
+          def clean_amount(amount)
+            return nil if amount.nil? || amount.strip.empty?
+
+            cleaned_amount = amount.to_f.round(2)
+
+            if swap_plus_minus_for_transactions
+              if cleaned_amount.negative?
+                cleaned_amount = cleaned_amount.abs
+                # else
+                #   cleaned_amount *= -1
+              end
+              puts "Fixed negative amount for account: #{account_number} and COA: #{coa_code}, original amount: #{amount}, fixed amount: #{cleaned_amount}" if coa_code == 'DANCE'
+            end
+            cleaned_amount
+          end
+
+          # Returns true if this transaction's amount should have its sign flipped
+          # based on the per-account, per-FY, per-COA rules stored in config.
+          #
+          # Rules live in ~/.config/appydave/bank-reconciliation.json under
+          # `sign_flip_rules` — see BankReconciliationConfig::SignFlipRule.
+          # Personal account numbers MUST NOT be hardcoded here; the config file
+          # is local-only and never committed to the repo.
+          def swap_plus_minus_for_transactions
+            sign_flip_rules.any? do |rule|
+              (rule.fin_year.nil? || rule.fin_year == fin_year) &&
+                rule.account_number == account_number &&
+                rule.coa_codes.include?(coa_code)
+            end
+          end
+
+          private
+
+          def sign_flip_rules
+            Appydave::Tools::Configuration::Config.bank_reconciliation.sign_flip_rules
+          rescue StandardError
+            []
+          end
+
+          def parse_date(date_string)
+            formats = ['%d/%m/%Y', '%Y-%m-%d %H:%M:%S']
+            formats.each do |format|
+              return Date.strptime(date_string, format)
+            rescue Date::Error
+              next
+            end
+            raise Date::Error, "Invalid date format: #{date_string}"
+          end
+
+          def determine_fin_year(date)
+            if date.month >= 7
+              "#{date.year}-#{date.year + 1}"
+            else
+              "#{date.year - 1}-#{date.year}"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/appydave/tools/configuration/models/bank_reconciliation_config.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+module Appydave
+  module Tools
+    module Configuration
+      module Models
+        # Bank reconciliation configuration
+        class BankReconciliationConfig < ConfigBase
+          # def
+          # Retrieve all bank accounts
+          def bank_accounts
+            data['bank_accounts'].map do |account|
+              BankAccount.new(account)
+            end
+          end
+
+          def chart_of_accounts
+            data['chart_of_accounts'].map do |entry|
+              ChartOfAccount.new(entry)
+            end
+          end
+
+          # Sign-flip rules — per-account, per-fin-year, per-COA exceptions where the
+          # raw bank-export sign is wrong and needs flipping during clean_amount.
+          # Personal account numbers belong here (in config), not in source.
+          def sign_flip_rules
+            (data['sign_flip_rules'] || []).map do |rule|
+              SignFlipRule.new(rule)
+            end
+          end
+
+          def get_bank_account(account_number, bsb = nil)
+            normalized_bsb = bsb.to_s.empty? ? nil : bsb
+            account_data = data['bank_accounts'].find do |account|
+              acct_bsb = account['bsb'].to_s.empty? ? nil : account['bsb']
+              account['account_number'] == account_number && (normalized_bsb.nil? || acct_bsb == normalized_bsb)
+            end
+
+            BankAccount.new(account_data) if account_data
+          end
+
+          # Retrieve a chart of account entry by code
+          def get_chart_of_account(code)
+            entry_data = data['chart_of_accounts'].find { |entry| entry['code'] == code }
+            ChartOfAccount.new(entry_data) if entry_data
+          end
+
+          def print
+            log.subheading 'Bank Reconciliation - Accounts'
+
+            tp bank_accounts, :account_number, :bsb, :name, :bank
+
+            log.subheading 'Bank Reconciliation - Chart of Accounts'
+
+            tp chart_of_accounts, :code, :narration
+          end
+
+          def coa_to_csv
+            csv_file_path = File.join(Config.config_path, 'bank_reconciliation.chart_of_accounts.csv')
+
+            CSV.open(csv_file_path, 'w') do |csv|
+              csv << %w[code narration]
+
+              chart_of_accounts.sort_by(&:code).each do |entry|
+                csv << [entry.code, entry.narration]
+              end
+            end
+          end
+
+          def coa_csv_to_json
+            csv_file_path = File.join(Config.config_path, 'bank_reconciliation.chart_of_accounts.csv')
+
+            coa_data = CSV.read(csv_file_path, headers: true).map(&:to_h)
+
+            data['chart_of_accounts'] = coa_data
+
+            save
+          end
+
+          private
+
+          def default_data
+            {
+              'bank_accounts' => [],
+              'chart_of_accounts' => [],
+              'sign_flip_rules' => []
+            }
+          end
+
+          # Inner class to represent a bank account
+          class BankAccount
+            attr_accessor :account_number, :bsb, :name, :platform
+
+            def initialize(data)
+              @account_number = data['account_number']
+              @bsb = data['bsb']
+              @name = data['name']
+              @platform = data['platform']
+            end
+
+            def to_h
+              {
+                'account_number' => @account_number,
+                'bsb' => @bsb,
+                'name' => @name,
+                'platform' => @platform
+              }
+            end
+          end
+
+          # Inner class to represent a chart of account entry
+          class ChartOfAccount
+            attr_accessor :code, :narration
+
+            def initialize(data)
+              @code = data['code']
+              @narration = data['narration']
+            end
+
+            def to_h
+              {
+                'code' => @code,
+                'narration' => @narration
+              }
+            end
+          end
+
+          # Inner class to represent a sign-flip rule.
+          # Matches a transaction by (optional fin_year, account_number, coa_code).
+          # When nil, fin_year matches any year.
+          class SignFlipRule
+            attr_accessor :fin_year, :account_number, :coa_codes
+
+            def initialize(data)
+              @fin_year = data['fin_year']
+              @account_number = data['account_number']
+              @coa_codes = data['coa_codes'] || []
+            end
+
+            def to_h
+              {
+                'fin_year' => @fin_year,
+                'account_number' => @account_number,
+                'coa_codes' => @coa_codes
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/appydave/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Appydave
   module Tools
-    VERSION = '0.85.0'
+    VERSION = '0.86.0'
   end
 end

data/lib/appydave/tools.rb

@@ -56,7 +56,13 @@ require 'appydave/tools/configuration/models/settings_config'
 require 'appydave/tools/configuration/models/brands_config'
 require 'appydave/tools/configuration/models/channels_config'
 require 'appydave/tools/configuration/models/youtube_automation_config'
+require 'appydave/tools/configuration/models/bank_reconciliation_config'
 require 'appydave/tools/configuration/example_installer'
+
+require 'appydave/tools/bank_reconciliation/models/transaction'
+require 'appydave/tools/bank_reconciliation/clean/read_transactions'
+require 'appydave/tools/bank_reconciliation/clean/mapper'
+require 'appydave/tools/bank_reconciliation/clean/clean_transactions'
 require 'appydave/tools/name_manager/project_name'
 
 require 'appydave/tools/prompt_tools/prompt_completion'
@@ -132,6 +138,7 @@ Appydave::Tools::Configuration::Config.set_default do |config|
   config.register(:brands, Appydave::Tools::Configuration::Models::BrandsConfig)
   config.register(:channels, Appydave::Tools::Configuration::Models::ChannelsConfig)
   config.register(:youtube_automation, Appydave::Tools::Configuration::Models::YoutubeAutomationConfig)
+  config.register(:bank_reconciliation, Appydave::Tools::Configuration::Models::BankReconciliationConfig)
 end
 
 module Appydave

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appydave-tools",
-  "version": "0.85.0",
+  "version": "0.86.0",
   "description": "AppyDave YouTube Automation Tools",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appydave-tools
 version: !ruby/object:Gem::Version
-  version: 0.85.0
+  version: 0.86.0
 platform: ruby
 authors:
 - David Cruwys
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-06 00:00:00.000000000 Z
+date: 2026-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -136,6 +136,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
 - !ruby/object:Gem::Dependency
   name: pstore
   requirement: !ruby/object:Gem::Requirement
@@ -369,6 +383,11 @@ files:
 - lib/appydave/tools/app_context/app_finder.rb
 - lib/appydave/tools/app_context/globs_loader.rb
 - lib/appydave/tools/app_context/options.rb
+- lib/appydave/tools/bank_reconciliation/_doc.md
+- lib/appydave/tools/bank_reconciliation/clean/clean_transactions.rb
+- lib/appydave/tools/bank_reconciliation/clean/mapper.rb
+- lib/appydave/tools/bank_reconciliation/clean/read_transactions.rb
+- lib/appydave/tools/bank_reconciliation/models/transaction.rb
 - lib/appydave/tools/brain_context/brain_finder.rb
 - lib/appydave/tools/brain_context/omi_finder.rb
 - lib/appydave/tools/brain_context/options.rb
@@ -381,6 +400,7 @@ files:
 - lib/appydave/tools/configuration/config.rb
 - lib/appydave/tools/configuration/configurable.rb
 - lib/appydave/tools/configuration/example_installer.rb
+- lib/appydave/tools/configuration/models/bank_reconciliation_config.rb
 - lib/appydave/tools/configuration/models/brands_config.rb
 - lib/appydave/tools/configuration/models/channels_config.rb
 - lib/appydave/tools/configuration/models/config_base.rb