job_progress contract v1

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/job_progress/v1.json",
  "title": "job_progress contract v1",
  "type": "object",
  "required": [
    "job_no",
    "percent_completed",
    "percent_invoiced",
    "project_id"
  ],
  "properties": {
    "job_no": {
      "type": "string",
      "description": "the external BC job number, kept as the reconciliation key back to the ERP",
      "x-demiton-requiredness": "required"
    },
    "suspect": {
      "type": "object",
      "description": "the raw rejected value(s) and the reason, present only when a percentage fell outside `[0, 105]`",
      "x-demiton-requiredness": "optional"
    },
    "job_status": {
      "type": "string",
      "description": "BC's own job status text, passed through verbatim",
      "x-demiton-requiredness": "optional"
    },
    "project_id": {
      "type": "string",
      "description": "the project (BC job) the KPIs belong to; the fact's subject anchor",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "job_end_date": {
      "type": "string",
      "description": "BC's planned job end",
      "x-demiton-requiredness": "optional",
      "format": "date",
      "x-demiton-type": "date"
    },
    "job_start_date": {
      "type": "string",
      "description": "BC's planned job start",
      "x-demiton-requiredness": "optional",
      "format": "date",
      "x-demiton-type": "date"
    },
    "project_manager": {
      "type": "string",
      "description": "the job's responsible person",
      "x-demiton-requiredness": "tenant-specific"
    },
    "percent_invoiced": {
      "type": "number",
      "description": "the share of the job claimed/invoiced to date, clamped `[0, 105]`",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "%"
    },
    "percent_completed": {
      "type": "number",
      "description": "WIP / cost-recognition completion for the job, clamped to `[0, 105]`, null when the BC WIP calc is invalid",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "%"
    },
    "percent_overdue_planning_lines": {
      "type": "number",
      "description": "planning-line slippage signal on the job",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "%"
    }
  },
  "x-demiton-register-type": "job_progress",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [
    {
      "axis": "legal_entity",
      "requirement": "optional",
      "role": "context"
    }
  ],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "AS 2124-1992",
        "title": "General Conditions of Contract",
        "access": "paywalled_secondary",
        "clause": "Annexure Part A",
        "region": "Australia",
        "edition": "1992 (superseded)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS 4000-1997",
        "title": "General Conditions of Contract",
        "access": "paywalled_secondary",
        "clause": "cl 37.1/37.2 (per commentary)",
        "region": "Australia",
        "edition": "1997 (superseded edition, still in use)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS 4000:2025",
        "title": "General Conditions of Contract (construct only)",
        "access": "paywalled_secondary",
        "clause": "cl 37.2 (per commentary)",
        "region": "Australia",
        "edition": "2025",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS 4902-2000",
        "title": "General Conditions of Contract for Design and Construct",
        "access": "paywalled_secondary",
        "region": "Australia",
        "edition": "2000 (R2005); status unverified",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Building Industry Fairness (Security of Payment) Act 2017 (Qld)",
        "title": "Qld security of payment",
        "access": "public_summary",
        "clause": "s 76",
        "region": "Australia",
        "edition": "as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Building and Construction Industry (Security of Payment) Act 2009 (ACT)",
        "title": "ACT security of payment",
        "access": "public_summary",
        "clause": "s 19(2)",
        "region": "Australia",
        "edition": "as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Building and Construction Industry (Security of Payment) Act 2021 (WA)",
        "title": "WA security of payment",
        "access": "full_text_verified",
        "clause": "ss 23(7), 25",
        "region": "Australia",
        "edition": "as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Building and Construction Industry Security of Payment Act 1999 (NSW)",
        "title": "NSW security of payment",
        "access": "public_summary",
        "region": "Australia",
        "edition": "as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Building and Construction Industry Security of Payment Act 2002 (Vic)",
        "title": "Vic security of payment (2026 reforms)",
        "access": "public_summary",
        "clause": "ss 14A-14D",
        "region": "Australia",
        "edition": "as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Building and Construction Industry Security of Payment Act 2009 (SA)",
        "title": "SA security of payment",
        "access": "public_summary",
        "clause": "s 17(2)",
        "region": "Australia",
        "edition": "as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Building and Construction Industry Security of Payment Act 2009 (Tas)",
        "title": "Tas security of payment",
        "access": "full_text_verified",
        "clause": "ss 17-19",
        "region": "Australia",
        "edition": "as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Construction Contracts Act 2002 (NZ)",
        "title": "Construction Contracts Act 2002 (2002 No 46)",
        "access": "full_text_verified",
        "clause": "ss 17, 20-22",
        "region": "New Zealand",
        "edition": "as at 5 Oct 2023",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Housing Grants, Construction and Regeneration Act 1996 Part II",
        "title": "HGCRA 1996 Part II (Payment), as amended by LDEDCA 2009",
        "access": "full_text_verified",
        "clause": "ss 110-113",
        "region": "United Kingdom",
        "edition": "as amended (2011)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "SI 1998/649",
        "title": "Scheme for Construction Contracts (England and Wales) Regulations 1998",
        "access": "full_text_verified",
        "clause": "paras 4-10",
        "region": "United Kingdom",
        "edition": "as amended 2011",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AIA G702-1992 / G703-1992",
        "title": "Application and Certificate for Payment / Continuation Sheet",
        "access": "public_summary",
        "region": "United States",
        "edition": "1992 (current base editions)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Job progress from your ERP: percent complete and percent invoiced.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/job_progress/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}