1. Public Works Department
  2. Features
  3. Operations and exceptions
Feature · Operations and exceptions

Operations and exceptions

Trace guarded actions and investigate pending, failed or uncertain receipts.

OverviewFailed and Needs Review
Public Works Department · Operations and exceptions

Failed and Needs Review

Operation receipts

New
Operation keyActionResult stateFailure reasonParent
OK-572ACT-903FailedCut to lengthWP-37372
OK-814ACT-449Needs reviewWeld frameWP-93273
OK-288ACT-901FailedDrill and tapWP-99200
OK-144ACT-300Needs reviewDeburrWP-88874
OK-956ACT-432FailedAssembleWP-43313
6 of 6 records
OK-572Operation receipts · OR-15243
Failed
ActionACT-903
Failure reasonCut to length
ParentWP-37372
Example screen with sample data

What you can do

Keep the operation tied to its effect

An operation receipt records a stable operation key, action, expected revision, result state and occurrence time under its work package. External and effect references can be retained when applicable; a failure reason explains a failed or uncertain result. This lets the operations team examine one attempted action without assuming that repeating it is safe.

The Operations Overview brings planned and actual task hours by project, overdue tasks by owner and a paginated exception queue with source links together. It is a place to identify work needing attention, then open the source package, task, inspection or receipt. A dashboard figure should send a manager back to the underlying record before a decision is made.

How the work is organized

  • Record. A guarded package or inspection action carries a stable key and expected revision into its receipt.
  • Investigate. Operations Analyst compares Pending, Failed and needs review receipts with their linked local effects.
  • Resolve. Mark a receipt Completed only when the recorded scope, identity, quantity and revision match the effects; retain a specific discrepancy otherwise.

Reconciliation starts with the records already present. It must not execute the external action again merely because the response is uncertain. A later correction should preserve the original receipt and supporting evidence.

What to agree during setup

Choose who owns the exception queue and how quickly they inspect pending outcomes. Decide which effect references and external references need to be captured for each guarded action. Establish a rule for mismatched revisions and partial effects: the analyst records the discrepancy and sends it to the manager for review. Keep access to sensitive references narrow while allowing the package owner to see the business outcome.

Rehearse a receipt whose expected revision differs from the package’s current revision. The analyst should leave it needing review, document the mismatch and locate the original operation key. Also rehearse a matching receipt that can be completed without rerunning the action.

Check the handoff on an actual case

A package acceptance has a pending receipt after the owner sees the accepted status. Open the package and its decision history, compare the receipt’s key and expected revision with the local effect, and decide whether they match. Use the exception queue to return to the receipt. If the effect is incomplete, retain needs review and a precise failure reason. If it matches, mark the receipt Completed and keep the original action reference.

What your team sees

  • Failed and Needs Review — Guarded actions requiring investigation with their reason and parent package.
  • Pending Operation Receipts — Outcomes still awaiting reconciliation.
  • All Operation Receipts — The durable history of actions and result states.

Follow the work through

What it keeps track of

Data model
Operation receipts
Durable receipts for guarded operations with stable operation keys
Work packages
Baseline work packages with lifecycle, budget hours and counterparty scope
Tasks
Task lines under a work package with planned and actual hours
Public work inspections
Field inspections that certify accepted public works quantities
Review decisions
Independent reviewer decisions on work package revisions

Who uses it

Permissions
Operations Analyst
Investigates receipts; Public Works Manager resolves scope discrepancies; Independent Reviewer supplies decision evidence.

Set up Public Works Department your way.

Start free, then use Proto to change fields, steps and approvals before your team goes live.

How to get started