Skip to content
Demiton

Overstaffing verdict

Overstaffing verdict is one of Demiton's published registers for Australian civil construction. Whether a project's actual crew exceeds its tendered labour schedule. Demiton keeps it current from the systems a contractor already runs and publishes the record's shape as a versioned JSON Schema, so the same question works whichever system produced the record.

Part of Opportunities in the register catalog.

Register ID
overstaffing_verdictUse this name to ask for the register. The API calls it a shelf ID.
Each record is
A stateThe current value of something, replaced when it changes.
Status
DeclaredDefined, and fills when a source produces its first record.
Data
OrganisationPrivate to each organisation's own workspace.
Version
v1 (1.0.2)Current version.

Standards

This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.

  • ISO 30414Human resource management - Requirements and recommendations for human capital reporting and disclosureInternational · 2025 (2nd ed.; 2018 1st ed. cancelled) · paywalled, from a secondary description

Connectors

Connected today

Demiton keeps this register current from these systems now.

No system fills this register yet.

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

None planned yet.

Fields

12 fields: 8 required, 3 optional, 1 defined by each organisation.

Required

Every record carries these fields.

verdictText

The outcome: OVERSTAFFED, ON_TRACK or UNDERSTAFFED. BUDGET_ONLY is *not* a stored value — the writer returns without writing (:410-411).

Example: ON_TRACK

burn_pctNumberUnit: ratio (0–1+)

actual_hours / budget_hours.

Example: 0.568

assessed_atDate and timeISO 8601, with time zoneUnit: UTC

When the judgement was taken.

Example: 2026-06-30T18:00:00

elapsed_pctNumberUnit: fraction (0–1)

Fraction of project duration elapsed at assessment time.

Example: 0.557

project_refText

The Demiton project the verdict is about (the project_code the writer already keys on).

Example: BWG-2025-001

actual_hoursNumberUnit: hours

Labour hours actually charged to the project at assessment time.

Example: 4120

budget_hoursNumberUnit: hours

Tendered labour hours the actual is measured against (parsed schedule total or override).

Example: 7254

run_rate_pctNumberUnit: ratio

burn_pct / elapsed_pct — headcount run-rate against expected pace; the value the verdict thresholds are applied to.

Example: 1.02

Optional

Present when the source system records them.

confidenceNumberUnit: 0–1

Producer confidence in the judgement.

Example: 0.82

source_uriText

Canonical URI of the verdict fact (demiton://project/{code}/overstaffing-verdict).

source_fileText

Name of the resource-schedule workbook the budget side came from.

Defined by each organisation

Their contents come from the organisation's own forms or systems, so they differ between organisations.

verdict_thresholdsGroup of fields

The overstaffed_at / understaffed_at cut-offs used for this assessment.

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

overstaffing_verdict.example.json
{
"actual_hours": 4120,
"assessed_at": "2026-06-30T18:00:00",
"budget_hours": 7254,
"burn_pct": 0.568,
"confidence": 0.82,
"elapsed_pct": 0.557,
"project_ref": "BWG-2025-001",
"run_rate_pct": 1.02,
"verdict": "ON_TRACK"
}

Use this contract

The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.

Schema URL
https://docs.demiton.io/registers/overstaffing_verdict/v1.json
Show the full JSON Schema

Loading the schema…

Talk to the team

Tell us what you run - your ERP, field, payroll and document systems - and we will show you the registers Demiton would fill from them, on your data, in a 30-minute call.

Book a 30-minute callStart free