Ledger
A frozen prototype of a financial system of record, with a strict API/UI split.
Ledger is a frozen prototype of the finance domain's system of record: a Python 3.12 FastAPI core and a separate Next.js 14 frontend, with clean-architecture boundaries and a strict API/UI split. A rebuild is planned.
Overview
The Ledger is a frozen prototype of the ecosystem's financial system of record. It was built to process financial workflows with a strict boundary between data authority and user interface; development is paused.
Architecture
The system employs a strict split boundary: the backend is a FastAPI application written in Python 3.12, while the frontend (ledger-ui) is a Next.js 14 application running in an internal Docker container. The backend strictly adheres to Clean Architecture principles, isolating pure business rules (Domain Layer) from workflow orchestration (Application Layer) and persistence mechanisms (Infrastructure/SQLite).
Problem It Solves
Financial tracking requires data immutability, precision, and deterministic workflows. Tightly coupling financial data logic with presentation layers often results in data corruption or logic leaks; this API isolates the math from the interface.
Current State
Frozen; a rebuild is planned. The system-of-record boundary and the split between the financial engine and the UI are documented.