{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://seniorcre.com/data/canonical-objects.json",
  "title": "SeniorCRE Canonical Object Catalog",
  "version": "2026.09.06",
  "last_updated": "2026-09-06",
  "publisher": {
    "name": "SeniorCRE, LLC",
    "url": "https://seniorcre.com",
    "category": "operator-controlled operating infrastructure for senior housing & care"
  },
  "definition_of_canonical": "Canonical means the governed enterprise representation produced after Definitions, Source Authority and Reconciliation are applied under operator approval. It does not mean automatic database correctness, and it does not mean SeniorCRE overrides the operator. Multiple legitimate systems of record can exist; source authority is designated per fact, and lineage back to the originating system is preserved.",
  "deployment_roads": [
    {
      "road": "Govern What You Have",
      "description": "The operator retains existing systems. SeniorCRE governs definitions, source authority, reconciliation and lineage across them."
    },
    {
      "road": "Run on SeniorCRE",
      "description": "The operator selects SeniorCRE as system of record for chosen domains, including EHR and eMAR, by operator decision."
    }
  ],
  "doctrine": "Govern first. Replace only by choice. Either way, the operator determines what is authoritative.",
  "governing_decisions": {
    "definitions": "What the fact means, expressed as an operator-approved definition with a stable identifier.",
    "source_authority": "Which system is authoritative for that fact, designated by the operator, per fact and not per vendor.",
    "reconciliation": "How disagreement is resolved under operator-approved rules. Reconcile once under governed rules; stop re-reconciling downstream.",
    "lineage": "Where the governed value came from, preserved back to the originating system and retained for audit."
  },
  "objects": [
    {
      "name": "Entity",
      "description": "The legal or reporting entity that owns, leases or operates property and carries financial results.",
      "governed_facts": ["ownership structure", "reporting rollup", "lease and RIDEA structure", "consolidation scope"],
      "typical_source_authorities": ["general ledger / accounting system", "operator corporate records"],
      "children": ["Property"],
      "lineage_required": true,
      "phi": false
    },
    {
      "name": "Property",
      "description": "The physical community or campus operating under an Entity.",
      "governed_facts": ["licensed capacity", "care types offered", "market and submarket", "operating status"],
      "typical_source_authorities": ["state licensing record", "operator property master", "CMS Care Compare (where applicable)"],
      "children": ["Unit"],
      "lineage_required": true,
      "phi": false
    },
    {
      "name": "Unit",
      "description": "The rentable or licensed space within a Property. Bed is a Unit-level child, not a peer of Property.",
      "governed_facts": ["unit type", "care level", "availability state", "rate plan"],
      "typical_source_authorities": ["EHR / clinical census system", "leasing or CRM system", "operator unit master"],
      "children": ["Bed"],
      "lineage_required": true,
      "phi": false
    },
    {
      "name": "Resident",
      "description": "The person receiving care and services, and the economic and clinical journey record attached to them from referral through outcome.",
      "governed_facts": ["identity resolution across systems", "admission and discharge state", "payer and payer mix", "acuity", "length of stay"],
      "typical_source_authorities": ["EHR / clinical system of record", "billing system", "admissions record"],
      "children": ["Care Plan"],
      "lineage_required": true,
      "phi": true,
      "phi_note": "Resident-identifying data is authenticated, tenant-isolated and excluded from AI prompt payloads. It is never exposed through public discovery surfaces."
    },
    {
      "name": "Care Plan",
      "description": "The governed clinical plan, assessments and medication administration context attached to a Resident.",
      "governed_facts": ["assessment results", "ADL and acuity scoring", "medication administration record reference", "care interventions"],
      "typical_source_authorities": ["clinical system of record designated by the operator"],
      "authority_rule": "Exactly one authoritative medication administration record exists at any time. The operator designates which system holds it. SeniorCRE can be that system by operator choice, or can read from an incumbent clinical system in one direction only.",
      "lineage_required": true,
      "phi": true
    },
    {
      "name": "Shift",
      "description": "The scheduled and worked labor unit that carries care delivery capacity and labor cost.",
      "governed_facts": ["scheduled versus worked hours", "agency versus employed labor", "coverage and call-off state", "HPRD and PBJ inputs"],
      "typical_source_authorities": ["scheduling system", "time and attendance system", "payroll system", "agency vendor records"],
      "lineage_required": true,
      "phi": false
    },
    {
      "name": "Ledger",
      "description": "The financial record that produces revenue, cost, NOI and capital reporting.",
      "governed_facts": ["revenue recognition", "operating expense classification", "NOI", "intercompany and consolidation entries"],
      "normalization": "Monetary values are normalized to integer cents.",
      "typical_source_authorities": ["general ledger", "billing and AR system", "payroll system"],
      "lineage_required": true,
      "phi": false
    }
  ],
  "governed_value_envelope": {
    "$ref": "https://seniorcre.com/data/lineage-metadata.json"
  },
  "evidence_boundary": {
    "as_of": "2026-09-06",
    "statement": "This catalog describes the governed object model as designed and built. Described third-party integrations reflect design intent and pre-production validation. No third-party integration is live in operator production today.",
    "evidence_record": "https://seniorcre.com/evidence"
  }
}