BalanceForward Specification

Home / BalanceForward / BalanceForward Specification

BalanceForward

Built Around the Life Behind the Loan.

BalanceForward is an open source deterministic financing specification for businesses developing debt refinancing and secured consumer financing systems. It provides a modular framework for evaluating realistic repayment capacity, calculating sustainable loan parameters, incorporating geographic cost of living, and securing financing through qualifying collateral.

BalanceForward is designed around the principle that financing should be based on the borrower’s sustainable financial reality rather than simply maximizing the amount a borrower can qualify for. The specification combines income verification, Qualifying Repayment Income (QRI), area-based cost of living analysis, repayment feasibility, debt verification, collateral valuation, and deterministic loan parameters into a structured financing framework.

The specification establishes a fixed 5% interest rate, a maximum 50% collateral advance rate, and a maximum 20-year loan term as core parameters of the BalanceForward financing model. These parameters are applied through deterministic rules designed to create predictable financing outcomes while maintaining a substantial collateral and repayment-capacity framework.

BalanceForward is designed for businesses, financial institutions, fintech organizations, lenders, credit unions, and other organizations that want to implement a transparent and modular financing architecture. Implementations may use independent data providers, financial infrastructure, custodians, servicing systems, and other technologies while conforming to the specification’s defined interfaces and requirements.

Specification Goals

Create a deterministic framework for consumer debt refinancing.
Evaluate repayment feasibility using actual financial circumstances.
Calculate Qualifying Repayment Income using a standardized tax allocation.
Incorporate geographic cost of living into affordability analysis.
Prevent collateral availability from overriding repayment capacity.
Convert qualifying revolving debt into structured amortizing financing.
Establish predictable loan rates, payments, and terms.
Provide a maximum 50% advance rate against qualifying collateral.
Limit loan terms to a maximum of 20 years.
Support modular implementations without requiring vendor lock-in.
Provide businesses with an extensible open source financing specification.

Core Modules

Income Verification Module

The Income Verification Module establishes the borrower’s verified recurring gross income.

Features:

Verified gross income calculation.
Recurring income identification.
Income-source classification.
Income consistency analysis.
Income verification requirements.
Income documentation handling.
Standardized income inputs for downstream modules.
Support for configurable business verification sources.

Qualifying Repayment Income Module

The Qualifying Repayment Income Module establishes the standardized income amount available for repayment analysis.

Features:

Gross income intake.
Fixed 33% tax-liability allocation.
Calculation of Qualifying Repayment Income.
Standardized QRI output.
Consistent treatment of income across applications.
Deterministic calculation rules.
Auditability of QRI calculations.

The core QRI calculation applies a 33% allocation for tax liabilities, leaving 67% of verified gross income as Qualifying Repayment Income.

Cost of Living Feasibility Module

The Cost of Living Feasibility Module determines a realistic baseline cost of living for the borrower’s geographic area and household circumstances.

Features:

Geographic cost of living analysis.
Area-level housing costs.
Utility cost analysis.
Food cost analysis.
Transportation cost analysis.
Insurance cost analysis.
Healthcare cost analysis.
Communications cost analysis.
Household necessity estimates.
Household-size adjustments.
Geographic normalization.
Current-cost data requirements.
Data freshness requirements.
Area-average calculation.
Cost-of-living baseline generation.

The module is intended to prevent loan approval decisions from relying solely on borrower-reported expenses when those expenses materially understate the reasonable cost of maintaining basic living requirements in the borrower’s area.

Actual Expense Verification Module

The Actual Expense Verification Module evaluates the borrower’s documented recurring expenses against the applicable cost of living baseline.

Features:

Housing expense verification.
Utility verification.
Transportation expense verification.
Insurance expense verification.
Healthcare expense verification.
Food and household expense verification.
Required obligation verification.
Expense normalization.
Comparison of verified expenses against geographic averages.
Detection of materially understated expenses.
Determination of applicable affordability expenses.

Repayment Capacity Module

The Repayment Capacity Module determines the amount of income realistically available for loan repayment.

Features:

QRI intake.
Cost of living deduction.
Required obligation deduction.
Verified expense integration.
Disposable repayment capacity calculation.
Sustainable payment analysis.
Payment feasibility determination.
Affordability thresholds.
Deterministic approval and rejection conditions.
Prevention of collateral-driven overextension.

The Repayment Capacity Module ensures that collateral availability does not independently determine the amount a borrower can receive.

Debt Verification Module

The Debt Verification Module identifies and validates the debt eligible for refinancing.

Features:

Creditor identification.
Account verification.
Outstanding balance verification.
Payoff amount verification.
Interest-rate documentation.
Eligible debt classification.
Direct-creditor-payoff calculations.
Duplicate debt detection.
Debt aggregation.
Refinancing amount determination.

Collateral Valuation Module

The Collateral Valuation Module determines the value of qualifying financial assets available to secure the loan.

Features:

Eligible asset identification.
Asset ownership verification.
Market-value determination.
Collateral valuation.
Asset-specific valuation adjustments.
Haircut application where required.
Existing encumbrance detection.
Collateral concentration analysis.
Eligible collateral value calculation.
Maximum advance calculation.

BalanceForward establishes a maximum 50% advance rate against eligible collateral value.

Loan Parameter Module

The Loan Parameter Module converts repayment capacity, collateral capacity, and verified debt into deterministic loan parameters.

Features:

Principal calculation.
Maximum loan calculation.
Payment capacity calculation.
Fixed-rate calculation.
Amortization calculation.
Term calculation.
Maturity calculation.
20-year maximum term enforcement.
Debt-limit enforcement.
Collateral-limit enforcement.
Income-limit enforcement.
Constraint reconciliation.
Deterministic loan decision output.

The approved loan amount must satisfy all applicable constraints simultaneously.

Solvra Loan Mechanics Module Specification

Solvra

Solvra provides the underlying loan mechanics used by BalanceForward.

Features:

Fixed-rate loan mechanics.
Amortization schedules.
Interest calculations.
Principal calculations.
Payment allocation.
Outstanding balance calculations.
Accrued interest calculations.
Early payoff calculations.
Maturity calculations.
Loan schedule generation.
Payment history processing.
Deterministic loan-state calculations.

BalanceForward treats Solvra as a modular component rather than requiring Solvra to define the complete financing architecture.

Collateral Control Module

The Collateral Control Module establishes the operational framework for securing the financing with qualifying financial assets.

Features:

Collateral assignment.
Security-interest integration.
Collateral account identification.
Custodian integration.
Collateral status tracking.
Encumbrance tracking.
Collateral release conditions.
Collateral documentation.
Control and authorization workflows.

Implementations must comply with applicable commercial, consumer-finance, securities, custody, lending, and other laws governing their specific deployment.

Collateral Monitoring Module

The Collateral Monitoring Module continuously evaluates collateral relative to the outstanding loan.

Features:

Current collateral valuation.
Outstanding principal comparison.
Loan-to-value monitoring.
Collateral threshold monitoring.
Collateral deficiency detection.
Valuation updates.
Monitoring alerts.
Maintenance-event generation.
Historical collateral records.
Deterministic monitoring rules.

Servicing Module

The Servicing Module manages the ongoing administration of BalanceForward loans.

Features:

Payment processing.
Payment allocation.
Account statements.
Principal tracking.
Interest tracking.
Balance tracking.
Payment history.
Payoff requests.
Maturity processing.
Account status management.
Servicing records.
Audit trails.

Default and Recovery Module

The Default and Recovery Module establishes deterministic procedures for delinquency, default, collateral enforcement, and recovery.

Features:

Delinquency identification.
Default-condition evaluation.
Notice generation.
Cure-period management.
Collateral deficiency handling.
Recovery calculations.
Collateral enforcement workflows.
Liquidation accounting.
Application of recovery proceeds.
Remaining-balance calculations.
Excess-proceeds accounting.
Collateral release after satisfaction.

Optional Plugin Modules

BalanceForward is designed to support optional plugins that extend functionality without changing the core financing specification.

Alternative Income Plugin

Features:

Self-employment income analysis.
Variable-income analysis.
Commission income.
Contract income.
Seasonal income.
Multiple income-source aggregation.

Employment Stability Plugin

Features:

Employment-history analysis.
Employment-duration analysis.
Income stability scoring.
Employment-gap analysis.
Industry-specific stability rules.

Geographic Data Provider Plugin

Features:

Integration with external cost-of-living datasets.
Geographic boundary resolution.
ZIP-code analysis.
County-level analysis.
Metropolitan-area analysis.
State-level fallback data.
Data freshness monitoring.

Inflation Adjustment Plugin

Features:

Inflation-indexed cost-of-living values.
Historical cost normalization.
Current-value adjustments.
Regional inflation adjustments.
Effective-date management.

Financial Asset Classification Plugin

Features:

Security classification.
Asset eligibility rules.
Liquidity classification.
Volatility classification.
Concentration analysis.
Asset-specific collateral adjustments.

Custodian Integration Plugin

Features:

Account verification.
Asset verification.
Collateral status retrieval.
Account restriction integration.
Collateral release workflows.
Custodian event processing.

Credit Reporting Plugin

Features:

Credit-report integration.
Existing-account verification.
Debt validation.
Credit-history retrieval.
Credit reporting workflows.
Post-refinance account monitoring.

Payment Processing Plugin

Features:

Automated payment processing.
Bank-account integration.
Payment scheduling.
Payment confirmation.
Failed-payment handling.
Payment reconciliation.

Direct Creditor Payoff Plugin

Features:

Creditor payment processing.
Payoff statement integration.
Payment confirmation.
Creditor reconciliation.
Account payoff verification.
Refinanced-account closure tracking.

Financial Counseling Plugin

Features:

Debt education.
Budgeting tools.
Repayment education.
Financial planning resources.
Post-refinance financial guidance.
Debt recurrence prevention.

Risk Analytics Plugin

Features:

Portfolio-level analysis.
Historical performance analysis.
Collateral stress testing.
Repayment stress testing.
Scenario analysis.
Aggregate exposure analysis.

Audit and Compliance Plugin

Features:

Decision audit trails.
Calculation records.
Data provenance.
Rule-version tracking.
Compliance reporting.
Decision reproducibility.
Regulatory record retention.

Reporting and Analytics Plugin

Features:

Loan portfolio reporting.
Repayment-capacity reporting.
Collateral reporting.
Geographic affordability analysis.
Loan-performance reporting.
Aggregate financing metrics.
Operational dashboards.

Deterministic Financing Model

BalanceForward establishes financing through a sequence of independent constraints.

Verified Gross Income

→ 33% Tax Liability Allocation

→ Qualifying Repayment Income

→ Cost of Living Feasibility

→ Verified Required Obligations

→ Available Repayment Capacity

→ Sustainable Payment Capacity

→ 5% Fixed-Rate Loan Calculation

→ Maximum 20-Year Term

→ 50% Collateral Advance Constraint

→ Qualifying Debt Constraint

→ Final Loan Parameters

The final loan must satisfy all applicable constraints.

Collateral availability must not be used to justify a loan payment that the borrower cannot realistically sustain.

Fixed Financing Parameters

BalanceForward defines the following core parameters:

Interest Rate: 5% fixed.
Maximum Collateral Advance Rate: 50%.
Maximum Loan Term: 20 years.
Tax Liability Allocation: 33% of verified gross income.
Qualifying Repayment Income: 67% of verified gross income before additional affordability deductions.
Loan Purpose: Qualifying debt refinancing.
Loan Structure: Secured, closed-end, amortizing financing.

Implementations may establish additional underwriting requirements, provided those requirements do not conflict with the core specification.

Payment Feasibility

Payment feasibility is determined using the borrower’s financial circumstances rather than collateral alone.

The system evaluates:

Verified income.
Tax liability allocation.
Geographic cost of living.
Household circumstances.
Verified actual expenses.
Required existing obligations.
Available repayment capacity.
Proposed loan payment.
Collateral coverage.
Loan term.

The objective is to determine a payment that is realistically sustainable for the borrower while maintaining defined collateral protection for the lender.

Direct Debt Refinancing

BalanceForward is designed to refinance qualifying debt rather than provide unrestricted cash.

Implementations should support:

Verified creditor identification.
Verified outstanding balances.
Verified payoff amounts.
Direct creditor payments.
Payoff confirmation.
Refinanced-account tracking.
Post-refinance balance verification.

This structure is intended to ensure that refinancing proceeds accomplish their stated debt-reduction purpose.

Specification Branding License (SBL)

Standard

Fully AGPL-3.0+ compliant system
Copyleft enforced for network deployments
Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/

Optional

Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/safeforge/

License & Notice Requirements

BalanceForward is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.

Please note the following:

All contributions must comply with the AGPL-3.0+ terms.
Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to Roxanne Ardary and roxanneardary.com.
BalanceForward specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
The project’s notice.md file tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also update notice.md.
When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.

For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.

Notice – BalanceForward

Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.

Contributors

This file tracks contributors and their specific contributions to the project.

Roxanne Ardary, roxanneardary.com – August 10, 2026
Created the repository for BalanceForward. Created the open source deterministic financing specification for businesses, defining a borrower-centered framework for debt refinancing based on Qualifying Repayment Income, area-based cost of living analysis, repayment feasibility, collateral constraints, fixed-rate financing, and modular loan mechanics.
Add other contributors here – [Date]
[Describe contribution in one sentence]

License – BalanceForward

This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

Key Points:

You are free to use, modify, and distribute the code.
All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
The software is provided “as is,” without warranty of any kind.

For the full license text, see GNU AGPL-3.0 License.