03 / EVIDENCE-FIRST COMPUTATIONS

Keep irregular field calculations flexible

Do not force every sketch, scribble, formula and revised quantity into a spreadsheet. Keep raw site evidence intact, work in a versioned calculation document, validate the measured item, then publish an approved projection.

Recommended: Quarto .qmd · Optional: Jupyter .ipynb

Choose the right owner for each material

Original evidence

Controlled Google Drive

Camera images, scanned measurement books, CAD exports, PDF invoices, screenshots, Discord attachment bytes and engineer comments.

Original / immutable

Working calculations

Quarto or Jupyter

Freeform notes, LaTeX, variable definitions, sketches, steps, code, alternatives and assumptions with source pointers.

Draft / may be unverified

Accepted records

Original LIVE Sheet, verified CAD/QTO or governed database

Approved per-item measurements, quantities, unit selections, rates, BOQ, AOC, contract certificates and paid records.

Explicitly reviewed

Public website

GitHub Actions → Pages

Only sanitized, source-linked and validated projections, with accurate snapshot and approval labels.

Read-only publication

Evidence to publication: four non-interchangeable states

Missing quantity remains null; never quietly substitute 0. Contractor claims, certified bills and recorded payments are distinct authorities.

Public calculation-document template documentation →

Reusable document template

The public repository contains only a generic Quarto source template and metadata schema. Real project notebooks belong in appropriately restricted custody, not this public repo or Pages.

Safe source policy: source ID · organization/project/work item · revision · units · method · author/reviewer · evidence pointer · validation status · output hash. Original source data cannot be replaced by derived JSON.

Research backing this approach → · Measurement / BOQ overview →