Diary photo observation

Diary photo observation is one of Demiton's published registers for Australian civil construction. What a site diary photo shows (subject, work type, quality, concerns), read from the image. 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 Projects in the register catalog.

Register ID

diary_photo_observationUse this name to ask for the register. The API calls it a shelf ID.

Each record is

An eventSomething that happened at a point in time.

Status

DeclaredDefined, and fills when a source produces its first record.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1 (1.0.3)Current version.

Download JSON SchemaSee an example record

Standards

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

• ISO 14001Environmental management systemsAustralia · 2016 (adopts ISO 14001:2015) · clause 10.2 · paywalled, from a secondary description
• ISO 45001Occupational health and safety management systemsAustralia · 2018 incl. Amd 1:2024 · clause 6.1.2.1, 6.1.2.2, 8.1, 10.2 · paywalled, from a secondary description
• ISO 9001Quality management systems - RequirementsAustralia · 2016 (adopts ISO 9001:2015) · clause 7.5, 8.7, 10.2 · paywalled, from a secondary description
• GDA2020 / MGA2020Geocentric Datum of Australia 2020Australia · GDA2020 · verified against full text
• ISO 14001Environmental management systemsInternational · 2026 (published 2026-04-15) · clause 10.2 · paywalled, from a secondary description
• ISO 45001Occupational health and safety management systemsInternational · 2018 incl. Amd 1:2024 · clause 6.1.2.1, 6.1.2.2, 8.1, 10.2 · paywalled, from a secondary description
• ISO 9001Quality management systems - RequirementsInternational · 2015 (ISO 9001:2026 successor expected; unverified) · clause 7.5, 8.7, 10.2 · paywalled, from a secondary description
• Health and Safety at Work Act 2015 (NZ)Records of notifiable eventsNew Zealand · as amended · public summary
• OSHAOSHA Recording and Reporting Occupational Injuries and IllnessesUnited States · as amended · clause 1904.33 · verified against full text

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.

• MittiPartial
• Oracle Aconex
• Procore

Fields

15 fields: 8 required, 7 optional.

Required

Every record carries these fields.

captionText

One factual sentence describing the image; the shelf's payload and Fact.content.

Example: Kerb and channel formwork placed along northern verge, re…

subjectText

What the photograph physically shows.

Example: kerb and channel formwork

fact_classText

Provenance class: this fact is a model's reading of an image, not a value the source reported.

Example: vision_observation

occurred_atDate and timeISO 8601, with time zone

Time of the parent diary event, inherited unchanged; the observation has no independent event time.

Example: 2026-07-14T07:45:00Z

photo_indexWhole number

Zero-based ordinal of the photo within the diary, assigned in _photo_urls order; the other half of the identity.

Example: 0

observation_idText

Stable identity of the per-photo observation: {parent diary source id}:{photo ordinal}. Maps to Fact.source_id/external_id.

Example: FR-91004:0

financial_periodDateYYYY-MM-DD

Declared FINANCIAL_PERIOD axis; derived from occurred_at when not inherited.

Example: 2026-07-01

parent_diary_source_idText

Source id of the site_diary fact this photo belongs to; the join back to the diary and the prefix of observation_id.

Example: FR-91004

Optional

Present when the source system records them.

assetText

Declared ASSET axis, inherited from the diary.

projectText

Declared PROJECT axis, inherited from the diary.

Example: BWG-2025-001

qualityTextUnit: acceptable\

poor)

Example: acceptable

concernsList

Review flags; the vision enum is identifiable_people, vehicle_plate, third_party_branding, unsafe_practice_visible, poor_legibility, not_construction.

work_typeText

The civil work visible, or the literal none_visible.

Example: kerb_and_channel

legal_entityText

Declared LEGAL_ENTITY axis, inherited from the diary.

source_imageGroup of fieldsUnit: px / —

Dimensions and container format of the fetched image, from the encoder.

Filed against

Records are indexed along these dimensions, so they can be asked for by any of them.

• Projectwhat the record is about, from When known
• Assetwhat the record is about, from When known
• Legal entitycontext for the record, from When known
• Financial periodcontext for the record, from Always set

Example record

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

diary_photo_observation.example.json

{
  "caption": "Kerb and channel formwork placed along northern verge, ready for pour.",
  "concerns": [],
  "fact_class": "vision_observation",
  "financial_period": "2026-07-01",
  "observation_id": "FR-91004:0",
  "occurred_at": "2026-07-14T07:45:00Z",
  "parent_diary_source_id": "FR-91004",
  "photo_index": 0,
  "project": "BWG-2025-001",
  "quality": "acceptable",
  "source_system": "ASSIGNAR",
  "subject": "kerb and channel formwork",
  "work_type": "kerb_and_channel"
}

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/diary_photo_observation/v1.json

Show the full JSON Schema

Loading the schema…