07Field notes

Illustrative design note

A number should have a story you can follow

A useful financial tool should help someone trace a number to the records and decisions behind it. This note explores that design idea without presenting a product as tested or ready for someone else’s books.

2 min readWahiawā, Oʻahu
Illustrative record trail

Follow the number back.

  1. Source document
  2. Recorded transaction
  3. Review or correction
  4. Report reference
A reference trail explains how information reached a report; it does not by itself prove the information is correct.

A general recordkeeping concept and an illustrative software design. No live accounts, client records, product release, or audit result is presented.

This note explores a software design principle: make the story behind a number possible to follow. It is not a demonstration of live books, a client result, or an accounting product’s readiness. The record trail shown here is an illustrative model.

Double-entry, in plain language

A double-entry system records a transaction through debits and credits in accounts, with total debits equal to total credits. That balance is a useful structural check. It does not prove that the right accounts were used, that a transaction was recorded only once, or that the supporting information is correct.

The IRS’s recordkeeping guide describes journals, ledgers, supporting documents, and double-entry bookkeeping. For this design exercise, the important connection is between a report, the entries behind it, and the information used to create those entries.

Show the trail, not just the total

  1. Keep a source referenceLet a reviewer see which supporting document or input an entry came from. A missing reference should be visible as a question, not disguised as a completed check.
  2. Make corrections understandableIn an illustrative append-only design, a correction adds a linked record instead of silently replacing an earlier one. The reviewer can see what changed and the reason recorded for it.
  3. Explain what the checks proveA balanced entry is evidence of balance. A recorded review is evidence that a review was recorded. Each check has limits; the interface should avoid implying more than was established.

A fingerprint has limits, too

Software can use digital fingerprints to help detect changes to recorded data. That is one possible design element, not a guarantee that information was correct at entry or that all changes are impossible. Access controls, recovery, review, and independent verification still need their own design and testing.

A good explanation makes the evidence and its limits visible together.

A useful question for any financial tool

Choose a number in a report and ask how someone would trace it back. Which records support it? What was corrected? What is still unresolved? Those questions can help a team evaluate an existing tool or a proposed one without assuming that a new system is the answer.

Sources & further reading

A useful next step: describe one handoff in your own work, including what a person needs to check.