Developer reference
How financial concepts relate
A conceptual relationship map for accounts, entries, context and reviewed import evidence.
This map explains financial responsibilities. It is a conceptual diagram, not an exhaustive physical schema or migration specification.
Relationship map
| Concept | Relationship | What it means |
|---|---|---|
| Account | Money entries affect an account. | The account identifies where money lives or what is owed. |
| Transaction | A transaction contains money entries. | One real-world movement can affect several accounts; its entries balance separately in each currency. |
| Context | A movement can refer to a person or a persistent matter, alongside category and tags. | These dimensions explain the movement independently; they do not replace an account entry. |
| Obligation or recurring plan | Payment matching connects a plan to a recorded transaction. | A planned payment is distinct from evidence that money moved. |
| Bank source evidence | A reviewed preview leads to explicit recording consent, then accepted transactions. | Uploading a source or reviewing a preview does not itself record money. |
A transaction contains entries against accounts. Each entry carries an amount and currency; the transaction balances separately per currency at stored precision.
Context stays independent
A person, loan, event or obligation can give a movement meaning. An identity groups a persistent real-world matter. Category and tags classify independently; none replaces the account entry or the others.
Creating a context object does not prove money moved.
Group savings
Gameyya metadata describes the arrangement and schedule. Actual ledger movements record the user’s own contributions and receipt, not invented payments for every member.
Imports and evidence
An uploaded source and a financial transaction remain separate objects. The import lifecycle links reviewed, accepted recording to its source and tracks progress and eligible recovery. A preview is an interpretation, not consent.
Read import semantics and financial invariants for the corresponding constraints.