class

Finfry::Database

Inherits JSON::Serializable < Reference < Object

The full persisted state: an id counter, all transactions, per-account monthly budget limits (cents), the declared chart of accounts, the unknown-account policy, and the undo journal.

Constructors

new(pull : JSON::PullParser)

Source

new

Empty. A brand-new book gets its starter chart (DEFAULT_CHART) as the log's first commit — see Store — so replaying the log from nothing rebuilds exactly the same chart.

Source

new(*, __pull_for_json_serializable pull : JSON::PullParser)

Source

Instance methods

account_meta

Free-form per-account metadata (account => key => value), e.g. a credit card's apr/limit/due-day. Visible to the AI; secrets are a later feature.

Source

account_meta=(account_meta : Hash(String, Hash(String, String)))

Free-form per-account metadata (account => key => value), e.g. a credit card's apr/limit/due-day. Visible to the AI; secrets are a later feature.

Source

account_policy

"strict" | "guard" | "off"

Source

account_policy=(account_policy : String)

"strict" | "guard" | "off"

Source

accounts

Explicitly declared accounts (the chart). Empty by default so existing ledgers loaded via from_json aren't reseeded.

Source

accounts=(accounts : Array(String))

Explicitly declared accounts (the chart). Empty by default so existing ledgers loaded via from_json aren't reseeded.

Source

budgets

Source

budgets=(budgets : Hash(String, Int64))

Source

changesets

Undo journal — one entry per mutating operation, newest last.

Source

changesets=(changesets : Array(Changeset))

Undo journal — one entry per mutating operation, newest last.

Source

cleared

Reconciliation, two-tier. cleared is the staged tier — transactions toggled cleared during a session, still editable (account => [ids]). reconciled is the committed tier — transactions locked in by a finished, statement-balanced reconciliation; they drop off the working list.

Source

cleared=(cleared : Hash(String, Array(Int32)))

Source

due_entries

The due queue (generated occurrences awaiting review) + its id counter.

Source

due_entries=(due_entries : Array(DueEntry))

The due queue (generated occurrences awaiting review) + its id counter.

Source

example

Marks a book of made-up data (the one eg/seed.sh builds), so the UI can say "example book" vs "real book" and nobody records rent into the wrong one.

Source

example=(example : Bool)

Marks a book of made-up data (the one eg/seed.sh builds), so the UI can say "example book" vs "real book" and nobody records rent into the wrong one.

Source

next_changeset_id

Source

next_changeset_id=(next_changeset_id : Int32)

Source

next_due_id

Source

next_due_id=(next_due_id : Int32)

Source

next_id

Source

next_id=(next_id : Int32)