The PaydayCompass Methodology: Transparent Math, Zero Guesswork

1. The Fundamental Mathematical Contract

Traditional budgeting software asks users to categorize historical transactions into dozens of sub-categories. PaydayCompass uses forward-looking cash allocation based on a sequential linear equation:

Where:

2. The Four Archetype Weighting Vectors

When $R \ge 0$, flexible cash is distributed according to one of four mathematically balanced archetypes. Each archetype is governed by fixed weighting coefficients ($w_b, w_g, w_j$) where $w_b + w_g + w_j = 1.0$:

Compare the trade-offs of these frameworks in our paycheck split models guide or test them live in our Paycheck Budget Calculator.

3. Boundary Conditions & Safety Protocols

• Deficit State ($R < 0$): When hard obligations exceed take-home earnings ($H > P$), the engine sets $B = 0, G = 0, J = 0$. The application issues a critical warning indicating the exact shortfall ($|R|$) and locks all discretionary spending until bills are restructured.
• Goal Capping & Excess Redistribution: If the user specifies a goal target amount T and current savings S, the remaining goal balance is G_rem = max(0, T - S). If the calculated contribution G > G_rem, the excess is capped, and surplus funds are redistributed: 60% to Safety Buffer (B) and 40% to Joy (J).
• User Joy Overrides: When a user manually customizes their celebration percentage, the difference from the template default is subtracted proportionally from Buffer ($B$) and Goal ($G$), never exceeding the archetype's maximum joy cap.
• Penny Conservation & Rounding: All operations are rounded to the nearest cent ($0.01$). Any discrepancy between $B + G + J$ and $R$ caused by fractional-cent rounding is automatically absorbed into the Safety Buffer ($B$).

4. Pay-Frequency Timeline & Multi-Period Simulation Engine

Unlike generic calculators that assume every worker is paid once a month, PaydayCompass models the exact pay-frequency timeline for four payroll schedules:

• Weekly (52 checks/year): Pay event occurs every 7 days (5 paychecks in 30 days, 13 in 90 days).
• Biweekly (26 checks/year): Pay event occurs every 14 days (3 paychecks in 30 days, 7 in 90 days).
• Semimonthly (24 checks/year): Pay events occur twice per month (2 in 30 days, 6 in 90 days).
• Monthly (12 checks/year): Pay event occurs once per calendar month (1 in 30 days, 3 in 90 days).

The 90-Day Simulation aggregates cumulative buffer savings ($B \times N$), goal contributions ($G \times N$), and celebration pools ($J \times N$) based on the exact count of paychecks ($N$) falling within the horizon.

5. Engineering, Security & Privacy Invariants

• Zero Bank Login Requirement: We never integrate with Plaid, Finicity, or Yodlee. We do not ask for or store bank account numbers or credentials.
• Client-Side Pure Logic: All financial formulas reside in a standalone, zero-dependency package (@paydaycompass/domain) executed directly in your browser.
• Deterministic AI Boundaries: AI models never calculate or alter financial numbers. AI is used solely as an optional qualitative interpreter to explain pre-calculated math in plain English.
• Rigorous Automated Test Suite: Every formula, boundary condition, and frequency scenario is verified by 26+ deterministic unit tests running via Vitest.

Disclaimer

PaydayCompass is an educational financial planning tool designed for simulation and cash flow allocation. It does not constitute certified financial, tax, or investment advice. Simulations assume steady income and expenses over the projected timeline. Always consult a certified financial planner (CFP) or tax advisor for individualized guidance.