Hospitality

{
  "id": "guest-profile",
  "label": "Guest profile",
  "kind": "Record",
  "group": "People & trips",
  "description": "Reusable context about a Guest: prompted sections, notes and pinned places.",
  "iri": "urn:zendo:concierge:v1#GuestProfile",
  "fields": [
    {
      "name": "schema",
      "type": "\"zendo.guest-profile/v1\"",
      "required": true,
      "schema": {
        "const": "zendo.guest-profile/v1"
      }
    },
    {
      "name": "id",
      "type": "string",
      "required": true,
      "description": "Stable record ID; on Guest Profile, the legacy guest-ID alias.",
      "schema": {
        "type": "string",
        "maxLength": 120
      }
    },
    {
      "name": "revision",
      "type": "integer",
      "required": true,
      "description": "Record-local revision; distinct from the workspace version.",
      "schema": {
        "type": "integer",
        "minimum": 1
      }
    },
    {
      "name": "name",
      "type": "string",
      "required": true,
      "description": "Guest-selected or concierge-entered display identity.",
      "schema": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    {
      "name": "company",
      "type": "string",
      "required": false,
      "description": "Optional organisation display text; no directory membership is implied.",
      "schema": {
        "type": "string",
        "maxLength": 100
      }
    },
    {
      "name": "notes",
      "type": "string",
      "required": true,
      "description": "Ordinary freeform notes in the owning record.",
      "schema": {
        "type": "string",
        "maxLength": 2000
      }
    },
    {
      "name": "preferences",
      "type": "string",
      "required": true,
      "description": "Enduring interests and routines; soft retrieval context.",
      "schema": {
        "type": "string",
        "maxLength": 4000
      }
    },
    {
      "name": "profileId",
      "type": "string",
      "required": false,
      "description": "Identity of the reusable profile record.",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "guestId",
      "type": "string",
      "required": false,
      "description": "The Guest this record concerns.",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "chunks",
      "type": "array",
      "required": false,
      "description": "Prompted topic responses with source, revision and contribution history.",
      "schema": {
        "type": "array",
        "maxItems": 7,
        "items": {
          "$ref": "#/$defs/ProfileChunk"
        }
      }
    }
  ],
  "rules": [
    "A profile describes one Guest. Profile chunks describe topics; they are not new identity classes.",
    "Company is optional; notes are ordinary freeform notes.",
    "Guest-provided, concierge-observed and agent-suggested are sources, not separate profile types.",
    "Profile context informs matching. Hard trip requirements require an explicit brief edit.",
    "Pinned places are places the guest specifically likes; relevant places belong to a trip brief.",
    "Profile edits preserve the active brief, recommendations, selection and draft.",
    "Guest-only confirmation remains unavailable until a verified guest session exists."
  ],
  "facts": [
    {
      "label": "Identity",
      "value": "guestProfile.profileId; guestId points to Guest. id remains the legacy guest-ID alias."
    },
    {
      "label": "Owner",
      "value": "Concierge-maintained context with attributed contributions; no authenticated guest editor is simulated."
    }
  ],
  "links": [
    {
      "label": "pins place",
      "target": "context-reference",
      "note": "1 → 0..*"
    },
    {
      "label": "describes",
      "target": "guest",
      "note": "1 → 1"
    },
    {
      "label": "has topic response",
      "target": "profile-chunk",
      "note": "1 → 0..*"
    }
  ]
}