The Problem Space: Regional Friction
I wanted to follow Dave Ramsey’s Baby Steps, but as a Nigerian, the official 'EveryDollar' app was inaccessible. I refused to accept a 'manual-only' spreadsheet life, so I built a sovereign alternative.
StepSeven is an implementation of rigorous financial logic. It treats money not as a variable, but as an immutable ledger entry, forcing the user through a mathematically sound path to liquidity.
Engineering for Integrity
In financial systems, 'close enough' is a failure. I implemented three safeguards to ensure 100% accuracy in a high-friction environment:
- Integer-Based Arithmetic – All currency is processed in Kobo (integers) to neutralize the floating-point rounding errors inherent in JavaScript.
- Atomic Transactions – Utilized MongoDB Sessions for a Two-Phase Commit pattern. Transfers between accounts either succeed entirely or roll back—there is no 'lost' money.
- State Machine Logic – The 'BabyStepService' tracks progress through 7 distinct phases, locking further investment logic until debt-neutrality is achieved.
The Gazelle Logic
| Gate | Technical Implementation | Goal |
|---|---|---|
| Step 1 | Buffer-Threshold Check | ₦1,000 Starter EF |
| Step 2 | Snowball Sort Algorithm | Debt Elimination |
| Step 3 | Expense-Aggregator (6-month) | Full Emergency Fund |
| Audit | Unallocated Cash Logic | Real-Time Visualization |
Conclusion
StepSeven is a financial operating system. It moved me from financial chaos to clarity by replacing 'unattractive' and restricted defaults with a custom, high-integrity architecture.