Unified Data Model (UDM)¶

The Unified Data Model (UDM) is the open, vendor-neutral schema for autonomous-system telemetry that PhyWare products consume and emit. Every PhyTrace event conforms to this schema, and so does anything PhyCloud ingests, PhySafe evaluates, or PhyComp audits.

UDM lives upstream as an open-source project at github.com/chrisherczeg/phyudm and is consumed inside this monorepo as a git submodule pinned to a specific commit. The pages below mirror the canonical spec from the submodule via symlink so they cannot drift from upstream.

Full Specification

The complete UDM spec — 24 domains, field definitions, versioning rules, and JSON Schema references.
Example: Mobile Robot Safety

A worked example showing UDM events for safety-compliance reporting in a mobile robot scenario.
Upstream OSS repo

Schemas (schemas/v*/), conformance suite, AI cookbook, and the Rust crates (udm-cli, udm-mcp, udm-eventstore) that wrap the spec for tooling.

What's in scope here¶

The phyudm/ section of this docs site is a thin landing page for the spec. The full multi-page spec tree (envelope, event types, source types, each of the 24 domains, appendices) lives in the upstream repo under spec/ and will be published separately at docs.phyudm.org as part of the OSS launch.

What's in scope upstream (not here)¶

Per-domain reference pages — see spec/domains/ upstream.
Schema artifacts (schemas/v0.0.3/) consumed via submodule by the PhyTrace SDKs.
The udm CLI / udm-mcp server / AI cookbook for LLM agents.