1
0
Fork 0
mirror of https://github.com/maybe-finance/maybe.git synced 2025-08-08 06:55:21 +02:00

Plaid sync domain improvements (#2267)
Some checks are pending
Publish Docker image / ci (push) Waiting to run
Publish Docker image / Build docker image (push) Blocked by required conditions

Breaks our Plaid sync process out into more manageable classes. Notably, this moves the sync process to a distinct, 2-step flow:

1. Import stage - we first make API calls and import Plaid data to "mirror" tables
2. Processing stage - read the raw data, apply business rules, build internal domain models and sync balances

This provides several benefits:

- Plaid syncs can now be "replayed" without fetching API data again
- Mirror tables provide better audit and debugging capabilities
- Eliminates the "all or nothing" sync behavior that is currently in place, which is brittle
This commit is contained in:
Zach Gollwitzer 2025-05-23 18:58:22 -04:00 committed by GitHub
parent 5c82af0e8c
commit 03a146222d
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
72 changed files with 3763 additions and 706 deletions

View file

@ -0,0 +1,25 @@
class PlaidAccount::Liabilities::CreditProcessor
def initialize(plaid_account)
@plaid_account = plaid_account
end
def process
return unless credit_data.present?
account.credit_card.update!(
minimum_payment: credit_data.dig("minimum_payment_amount"),
apr: credit_data.dig("aprs", 0, "apr_percentage")
)
end
private
attr_reader :plaid_account
def account
plaid_account.account
end
def credit_data
plaid_account.raw_liabilities_payload["credit"]
end
end

View file

@ -0,0 +1,25 @@
class PlaidAccount::Liabilities::MortgageProcessor
def initialize(plaid_account)
@plaid_account = plaid_account
end
def process
return unless mortgage_data.present?
account.loan.update!(
rate_type: mortgage_data.dig("interest_rate", "type"),
interest_rate: mortgage_data.dig("interest_rate", "percentage")
)
end
private
attr_reader :plaid_account
def account
plaid_account.account
end
def mortgage_data
plaid_account.raw_liabilities_payload["mortgage"]
end
end

View file

@ -0,0 +1,50 @@
class PlaidAccount::Liabilities::StudentLoanProcessor
def initialize(plaid_account)
@plaid_account = plaid_account
end
def process
return unless student_loan_data.present?
account.loan.update!(
rate_type: "fixed",
interest_rate: student_loan_data["interest_rate_percentage"],
initial_balance: student_loan_data["origination_principal_amount"],
term_months: term_months
)
end
private
attr_reader :plaid_account
def account
plaid_account.account
end
def term_months
return nil unless origination_date && expected_payoff_date
((expected_payoff_date - origination_date).to_i / 30).to_i
end
def origination_date
parse_date(student_loan_data["origination_date"])
end
def expected_payoff_date
parse_date(student_loan_data["expected_payoff_date"])
end
def parse_date(value)
return value if value.is_a?(Date)
return nil unless value.present?
Date.parse(value.to_s)
rescue ArgumentError
nil
end
def student_loan_data
plaid_account.raw_liabilities_payload["student"]
end
end