askrobots / dbbasic-object-server
Public
Runs live, versioned Python application objects on one VM, with a suite of apps: projects, notes, tasks, files and more.
danq9
signup: the person chooses the password and name on the confirm page
83c7aa6
2 weeks, 5 days ago
History
value_account_counts.json · 3.4 KB · 34 lines
| 1 | { |
| 2 | "name": "value_account_counts", |
| 3 | "title": "Counts", |
| 4 | "version": 1, |
| 5 | "storage": "append", |
| 6 | "description": "Someone counted what was actually there. This is the reconciliation evidence for accounts nobody sends a statement for -- a till, a petty-cash box, a safe -- and it is append-only for the same reason imported bank lines are: a count is an observation made at a moment by a named person, not a figure to revise later (docs/logic-decisions.md #8). The book balance is STAMPED onto the count at the time it was taken, so the variance stays meaningful forever even as later entries move the balance (#1). What makes this different from every other reconciliation in the system is honesty about its own weakness: a count is SELF-CERTIFICATION -- the person counting the till is usually the person who could take from it, which is the oldest fraud pattern there is and precisely what an independent statement protects against. So the count records who counted AND who witnessed, the account can require a witness before a count is accepted (value_accounts.requires_second_attestor), and the assurance a witnessed count carries is rated above an unwitnessed one but still below an independent statement (object_money.assurance_for). A variance composes a real journal -- cash over/short is an expense a business genuinely incurs, and pretending the drawer always balances is how a slow leak stays invisible for years.", |
| 7 | "fields": [ |
| 8 | {"name": "id"}, |
| 9 | {"name": "value_account_id", "required": true, "label": "Account", |
| 10 | "relation": {"collection": "value_accounts", "display_field": "name"}}, |
| 11 | {"name": "counted_on", "type": "date", "required": true, "label": "Counted"}, |
| 12 | {"name": "counted_minor", "type": "integer", "required": true, "label": "Counted Amount", |
| 13 | "help": "What was actually there, in the account denomination's smallest unit (object_money.py)."}, |
| 14 | {"name": "book_balance_minor", "type": "integer", "label": "Book Balance At Count", |
| 15 | "help": "What the ledger said at the moment of the count, stamped so the variance stays meaningful after later entries move the balance."}, |
| 16 | {"name": "variance_minor", "type": "integer", "label": "Variance", |
| 17 | "help": "counted minus book. Negative is a shortage (less there than the books say), positive an overage."}, |
| 18 | {"name": "counted_by", "type": "text", "label": "Counted By"}, |
| 19 | {"name": "witnessed_by", "type": "text", "label": "Witnessed By", |
| 20 | "help": "The second person who attested. Empty means the count is self-certified, which the reconciliation view rates lower -- and which an account may refuse outright."}, |
| 21 | {"name": "journal_id", "label": "Variance Journal", |
| 22 | "relation": {"collection": "fin_journals", "display_field": "description"}, |
| 23 | "help": "The over/short entry this count composed, when there was a variance to book."}, |
| 24 | {"name": "notes", "type": "textarea", "label": "Notes"}, |
| 25 | {"name": "owner_id", "type": "text", "label": "Owner"}, |
| 26 | {"name": "entity_id", "type": "text", "label": "Entity", |
| 27 | "relation": {"collection": "entities", "display_field": "name"}}, |
| 28 | {"name": "created_at", "type": "datetime", "read_only": true, "label": "Recorded"} |
| 29 | ], |
| 30 | "views": {"list_mode": "table", |
| 31 | "list_fields": ["value_account_id", "counted_on", "counted_minor", |
| 32 | "variance_minor", "counted_by", "witnessed_by"], |
| 33 | "filter_fields": ["value_account_id"]} |
| 34 | } |