Ledger

A frozen prototype of a financial system of record, with a strict API/UI split.

STATUS: Early0 ARCHITECTURE DECISIONSLAST UPDATED: 2026-06-17

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.

MILESTONES

1 milestones
2026