Restaurant

v3.0.0
PhysicalEntity
Hospitality

v3 schema for restaurants as static website intelligence profile: stable business metadata + external source links for dynamic data (menu/reviews), so AI can fetch fresh values without manual schema rewrites.

Top-level required
10
Required modules
1
Capability groups
1
Entity properties
10
Inheritance Chain
https://schemas.meta-aiml.org/v3.0.0/ontology/physical_entity.json
https://schemas.meta-aiml.org/v3.0.0/archetypes/direct_service.json

Interaction archetype

DirectService
Required Top-level Fields
These fields are enforced by JSON Schema required[] at root level.
@type
ontologicalMode
interactionArchetype
domain
name
description
deliveryFormat
modules
capabilities
structuralMetadata

Non-universal required fields

interactionArchetype
Entity-specific Properties
Keys under properties.properties dedicated to this entity contract.
contactPoints
cuisineTypes
identifiers
priceRange
seatingCapacity
serviceStyle
socialProfiles
supportsDelivery
supportsReservations
supportsTakeout
Modules Contract

Required modules

location

Optional modules

hours
menu
reservations
reviews
Capabilities Contract

Required capability groups

interaction

Optional capability groups

amenities
booking
commerce
content
financial
location
Governance Validation Rules
Normative rule list from governanceMetadata.sdkValidationRules.
RULE-REST-001: @type MUST equal "Restaurant"
RULE-REST-002: ontologicalMode MUST equal "PhysicalEntity"
RULE-REST-003: interactionArchetype MUST contain "DirectService"
RULE-REST-004: deliveryFormat MUST contain "PhysicalLocation"
RULE-REST-005: modules.location MUST be present
RULE-REST-006: capabilities.interaction MUST be present
RULE-REST-007: modules.reviews.ratingSources MUST contain provider and sourceUrl for each source entry
RULE-REST-008: modules.menu.menuDiscovery.dataSources MUST contain sourceType/sourceUrl/format and SHOULD avoid embedded catalogs
Canonical Contract JSON
https://schemas.meta-aiml.org/v3.0.0/entity/restaurant.json
https://schemas.meta-aiml.org/v3.0.0/entity/restaurant.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://schemas.meta-aiml.org/v3.0.0/entity/restaurant.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/restaurant.json",
  "@type": "Restaurant",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Restaurant Entity Schema",
  "description": "v3 schema for restaurants as static website intelligence profile: stable business metadata + external source links for dynamic data (menu/reviews), so AI can fetch fresh values without manual schema rewrites.",
  "examples": [
    {
      "description": "Urban fine-dining restaurant with online reservation and tasting menus",
      "reference": "restaurant_example_fine_dining"
    },
    {
      "description": "Neighborhood casual restaurant with dine-in, takeout, and delivery support",
      "reference": "restaurant_example_casual"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/physical_entity.json"
    },
    {
      "$ref": "../archetypes/direct_service.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "Restaurant"
    },
    "ontologicalMode": {
      "const": "PhysicalEntity"
    },
    "interactionArchetype": {
      "type": "array",
      "contains": {
        "const": "DirectService"
      },
      "items": {
        "type": "string",
        "enum": [
          "DirectService"
        ]
      }
    },
    "domain": {
      "const": "Hospitality"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Transactional",
          "Subscription",
          "PackagePricing"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "contains": {
        "const": "PhysicalLocation"
      },
      "items": {
        "type": "string",
        "enum": [
          "PhysicalLocation",
          "WebApp",
          "MobileApp"
        ]
      }
    },
    "name": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "description": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "shortDescription": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedTextOrString"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "foundingDate": {
      "type": "string",
      "format": "date"
    },
    "properties": {
      "type": "object",
      "properties": {
        "cuisineTypes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "serviceStyle": {
          "type": "string",
          "enum": [
            "fine_dining",
            "casual_dining",
            "fast_casual",
            "quick_service",
            "buffet"
          ]
        },
        "priceRange": {
          "type": "string",
          "enum": [
            "$",
            "$$",
            "$$$",
            "$$$$"
          ]
        },
        "seatingCapacity": {
          "type": "integer",
          "minimum": 1
        },
        "supportsReservations": {
          "type": "boolean"
        },
        "supportsDelivery": {
          "type": "boolean"
        },
        "supportsTakeout": {
          "type": "boolean"
        },
        "contactPoints": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/ContactPoint"
          }
        },
        "socialProfiles": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/SocialProfile"
          }
        },
        "identifiers": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/Identifier"
          }
        }
      }
    },
    "capabilities": {
      "type": "object",
      "required": [
        "interaction"
      ],
      "properties": {
        "interaction": {
          "$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
        },
        "booking": {
          "$ref": "../components/capability_groups.json#/$defs/BookingCapabilities"
        },
        "commerce": {
          "$ref": "../components/capability_groups.json#/$defs/CommerceCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        },
        "location": {
          "$ref": "../components/capability_groups.json#/$defs/LocationCapabilities"
        },
        "amenities": {
          "$ref": "../components/capability_groups.json#/$defs/AmenitiesCapabilities"
        },
        "content": {
          "$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "required": [
        "location"
      ],
      "properties": {
        "location": {
          "type": "object",
          "properties": {
            "address": {
              "$ref": "../components/address_format.json#/$defs/PostalAddress"
            },
            "geoCoordinates": {
              "$ref": "../components/address_format.json#/$defs/GeoCoordinates"
            },
            "serviceRadiusKm": {
              "type": "number",
              "minimum": 0
            }
          }
        },
        "hours": {
          "type": "object",
          "properties": {
            "operatingScheduleDefined": {
              "type": "boolean"
            },
            "specialHoursWorkflowEnabled": {
              "type": "boolean"
            },
            "holidayClosureRulesDefined": {
              "type": "boolean"
            }
          }
        },
        "menu": {
          "type": "object",
          "properties": {
            "digitalMenuEnabled": {
              "type": "boolean"
            },
            "seasonalMenuSupport": {
              "type": "boolean"
            },
            "allergenLabelsEnabled": {
              "type": "boolean"
            },
            "menuDiscovery": {
              "type": "object",
              "required": [
                "canonicalMenuUrl",
                "dataSources"
              ],
              "properties": {
                "canonicalMenuUrl": {
                  "type": "string",
                  "format": "uri"
                },
                "dataSources": {
                  "type": "array",
                  "minItems": 1,
                  "items": {
                    "type": "object",
                    "required": [
                      "sourceType",
                      "sourceUrl",
                      "format"
                    ],
                    "properties": {
                      "sourceType": {
                        "type": "string",
                        "enum": [
                          "file_export",
                          "public_feed_page",
                          "public_api_endpoint",
                          "other"
                        ]
                      },
                      "sourceUrl": {
                        "type": "string",
                        "format": "uri"
                      },
                      "format": {
                        "type": "string",
                        "enum": [
                          "json",
                          "xml",
                          "csv",
                          "rss",
                          "html",
                          "other"
                        ]
                      },
                      "updateCadence": {
                        "type": "string",
                        "enum": [
                          "real_time",
                          "hourly",
                          "daily",
                          "weekly",
                          "manual"
                        ]
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "reservations": {
          "type": "object",
          "properties": {
            "depositRulesEnabled": {
              "type": "boolean"
            },
            "noShowPolicyDefined": {
              "type": "boolean"
            },
            "tableTurnTimingEnabled": {
              "type": "boolean"
            }
          }
        },
        "reviews": {
          "type": "object",
          "properties": {
            "ratingSources": {
              "type": "array",
              "minItems": 1,
              "items": {
                "type": "object",
                "required": [
                  "provider",
                  "sourceUrl"
                ],
                "properties": {
                  "provider": {
                    "type": "string",
                    "enum": [
                      "google_business_profile",
                      "yelp",
                      "tripadvisor",
                      "opentable",
                      "facebook",
                      "custom"
                    ]
                  },
                  "sourceType": {
                    "type": "string",
                    "enum": [
                      "public_page",
                      "official_export",
                      "public_api_endpoint",
                      "other"
                    ]
                  },
                  "sourceUrl": {
                    "type": "string",
                    "format": "uri"
                  },
                  "format": {
                    "type": "string",
                    "enum": [
                      "json",
                      "xml",
                      "csv",
                      "rss",
                      "html",
                      "other"
                    ]
                  },
                  "updateCadence": {
                    "type": "string",
                    "enum": [
                      "real_time",
                      "hourly",
                      "daily",
                      "weekly",
                      "manual"
                    ]
                  }
                }
              }
            },
            "retrievalPolicy": {
              "type": "object",
              "properties": {
                "requiresLiveFetch": {
                  "type": "boolean"
                },
                "recommendedRefreshHours": {
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "binary"
        },
        "roles": {
          "const": [
            "user",
            "platform"
          ]
        },
        "valueSource": {
          "const": "platform_provided"
        },
        "transactionFlow": {
          "const": "direct"
        },
        "networkEffects": {
          "const": "none"
        },
        "serviceSetting": {
          "type": "string",
          "enum": [
            "on_premises",
            "mixed_service",
            "delivery_extended"
          ]
        }
      }
    },
    "targetAudience": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "siteCapabilities": {
      "type": "object",
      "properties": {
        "supportedDevices": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "desktop",
              "mobile",
              "tablet"
            ]
          }
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "accessibilityFeatures": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "@type",
    "ontologicalMode",
    "interactionArchetype",
    "domain",
    "name",
    "description",
    "deliveryFormat",
    "modules",
    "capabilities",
    "structuralMetadata"
  ],
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "entity",
    "status": "draft",
    "lastValidated": "2026-02-20T12:00:00Z",
    "validator": "META-AIML QA"
  },
  "semanticAnnotations": {
    "classificationRationale": "Restaurant is modeled as PhysicalEntity + DirectService because food and hospitality value is delivered directly by venue staff at a physical location.",
    "disambiguationNotes": "Different from food delivery aggregators and restaurant marketplaces that mediate third-party merchants. For static website schemas, keep dynamic data out of JSON payload: ratings and menu inventory should be referenced via source links only."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-REST-001: @type MUST equal \"Restaurant\"",
      "RULE-REST-002: ontologicalMode MUST equal \"PhysicalEntity\"",
      "RULE-REST-003: interactionArchetype MUST contain \"DirectService\"",
      "RULE-REST-004: deliveryFormat MUST contain \"PhysicalLocation\"",
      "RULE-REST-005: modules.location MUST be present",
      "RULE-REST-006: capabilities.interaction MUST be present",
      "RULE-REST-007: modules.reviews.ratingSources MUST contain provider and sourceUrl for each source entry",
      "RULE-REST-008: modules.menu.menuDiscovery.dataSources MUST contain sourceType/sourceUrl/format and SHOULD avoid embedded catalogs"
    ]
  }
}
Filled Example Instance
https://schemas.meta-aiml.org/v3.0.0/examples/restaurant_example_schema_v3.json
https://schemas.meta-aiml.org/v3.0.0/examples/restaurant_example_schema_v3.json
{
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://data.meta-aiml.org/v3.0.0/examples/restaurant/aurora-table-napa",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/restaurant/aurora-table-napa",
  "@type": "Restaurant",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Restaurant Entity Example (Aurora Table Napa)",
  "ontologicalMode": "PhysicalEntity",
  "interactionArchetype": [
    "DirectService"
  ],
  "domain": "Hospitality",
  "businessModel": [
    "Transactional",
    "PackagePricing",
    "Subscription"
  ],
  "deliveryFormat": [
    "PhysicalLocation",
    "WebApp",
    "MobileApp"
  ],
  "name": {
    "en": "Aurora Table Napa",
    "es": "Restaurante Aurora Table Napa",
    "fr": "Restaurant Aurora Table Napa"
  },
  "description": {
    "en": "Aurora Table Napa is a fictional fine dining restaurant in downtown Napa serving seasonal farm-to-table menus with curated wine pairings, chef tasting experiences, and full-service hospitality for dine-in, takeout, and premium delivery.",
    "es": "Aurora Table Napa es un restaurante ficticio de alta cocina en el centro de Napa con menu estacional, maridajes de vino y servicio completo para dine-in, takeout y delivery premium.",
    "fr": "Aurora Table Napa est un restaurant fictif de cuisine fine au centre de Napa avec menu saisonnier, accords mets-vins et service complet pour dine-in, takeout et livraison premium."
  },
  "shortDescription": {
    "en": "Seasonal fine dining with tasting menus, wine pairing, and digital-first reservations.",
    "es": "Alta cocina estacional con menu degustacion, maridaje de vinos y reservas digitales.",
    "fr": "Cuisine fine saisonniere avec menu degustation, accords vins et reservations numeriques."
  },
  "url": "https://auroratable-napa.example",
  "foundingDate": "2019-04-18",
  "createdDate": "2026-02-20T09:00:00Z",
  "lastModified": "2026-02-20T15:20:00Z",
  "examples": [
    {
      "scenario": "Weekend tasting menu traffic spike",
      "note": "AI agent fetches real-time review and menu data from declared sources before generating recommendations."
    },
    {
      "scenario": "Holiday service window",
      "note": "Source links remain stable while data changes externally; no schema rewrite required for each menu or rating change."
    }
  ],
  "properties": {
    "legalName": {
      "en": "Aurora Table Hospitality LLC"
    },
    "cuisineTypes": [
      "italian",
      "mediterranean",
      "fusion",
      "seafood"
    ],
    "serviceStyle": "fine_dining",
    "priceRange": "$$$",
    "seatingCapacity": 96,
    "supportsReservations": true,
    "supportsDelivery": true,
    "supportsTakeout": true,
    "acceptsPrivateEvents": true,
    "averageTicket": {
      "minPrice": 45,
      "maxPrice": 130,
      "currency": "USD",
      "label": "premium"
    },
    "contactPoints": [
      {
        "contactType": "customer_service",
        "telephone": "+1-707-555-0190",
        "email": "reservations@auroratable-napa.example",
        "url": "https://auroratable-napa.example/reservations",
        "areaServed": "Napa Valley",
        "availableLanguages": [
          "en",
          "es",
          "fr"
        ]
      },
      {
        "contactType": "general",
        "telephone": "+1-707-555-0101",
        "email": "hello@auroratable-napa.example",
        "url": "https://auroratable-napa.example/contact",
        "areaServed": "US",
        "availableLanguages": [
          "en",
          "es"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "instagram",
        "url": "https://instagram.com/auroratable_napa",
        "username": "auroratable_napa"
      },
      {
        "platform": "facebook",
        "url": "https://facebook.com/auroratable.napa",
        "username": "auroratable.napa"
      },
      {
        "platform": "yelp",
        "url": "https://yelp.com/biz/aurora-table-napa",
        "username": "aurora-table-napa"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://auroratable-napa.example"
      },
      {
        "type": "custom",
        "value": "NAPA-REST-AT-001"
      }
    ],
    "dressCode": "smart_casual",
    "paymentMethods": [
      "cash",
      "card",
      "contactless",
      "online_wallet"
    ],
    "dietaryOptions": [
      "vegan",
      "vegetarian",
      "gluten_free",
      "dairy_free",
      "nut_free"
    ],
    "supportedLanguages": [
      "en",
      "es",
      "fr"
    ],
    "reservationChannels": [
      "website",
      "mobile_app",
      "phone",
      "walk_in",
      "opentable"
    ],
    "alcoholPolicy": "full_bar",
    "accessibilityLevel": "full_compliance",
    "parkingAvailability": "onsite_with_valet",
    "petPolicy": "outdoor_only"
  },
  "capabilities": {
    "interaction": {
      "features": [
        "messaging",
        "rating",
        "reviews",
        "notifications"
      ],
      "interactionMethods": [
        "online_form",
        "phone_call",
        "email",
        "chat"
      ],
      "availableActions": [
        "view_menu",
        "make_reservation",
        "order_delivery",
        "request_private_event",
        "read_reviews",
        "contact"
      ],
      "hasMessaging": true,
      "hasComments": false,
      "hasRating": true,
      "hasReviews": true,
      "hasSocialGraph": false,
      "hasFeed": false,
      "hasNotifications": true,
      "hasMatching": false,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "public",
        "private",
        "semi_anonymous"
      ]
    },
    "booking": {
      "features": [
        "reservation",
        "availabilityCheck",
        "scheduling",
        "calendarSync",
        "instantBooking",
        "waitlist",
        "cancellation",
        "reminder"
      ],
      "acceptsReservations": true,
      "requiresDeposit": true,
      "cancellationPolicy": "24_hours",
      "minimumAdvanceBooking": "PT30M",
      "maximumAdvanceBooking": "P90D",
      "realTimeFeatures": [
        "real_time_availability",
        "instant_confirmation"
      ],
      "bookingChannels": [
        "website",
        "mobile_app",
        "phone",
        "in_person"
      ]
    },
    "commerce": {
      "features": [
        "productCatalog",
        "cart",
        "checkout",
        "orderTracking",
        "pricing",
        "search",
        "filtering"
      ],
      "hasProductCatalog": true,
      "catalogSize": 145,
      "supportsCart": true,
      "supportsCheckout": true,
      "hasOrderTracking": true,
      "recommendationEngine": true,
      "vendorManagement": false,
      "searchCapability": true,
      "filteringOptions": [
        "dietary",
        "allergens",
        "price",
        "popularity"
      ]
    },
    "financial": {
      "features": [
        "payments",
        "invoicing",
        "refunds",
        "billing",
        "subscriptionManagement"
      ],
      "paymentMethods": [
        "credit_card",
        "debit_card",
        "digital_wallet",
        "cash"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD"
      ],
      "priceRange": "$$$",
      "commissionModel": "hybrid",
      "commissionRate": 12.5,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    },
    "location": {
      "features": [
        "physicalAddress",
        "geoCoordinates",
        "directions",
        "mapIntegration",
        "proximitySearch",
        "routing"
      ],
      "hasPhysicalAddress": true,
      "hasGeoCoordinates": true,
      "hasMultipleLocations": false,
      "hasParking": true,
      "parkingType": "valet",
      "isWheelchairAccessible": true,
      "publicTransitAccess": true,
      "deliveryZones": [
        "Downtown Napa",
        "Old Town Napa",
        "Yountville",
        "South Napa"
      ],
      "serviceRadius": 12.5
    },
    "amenities": {
      "features": [
        "wifi",
        "parking",
        "accessibility",
        "outdoorSeating",
        "dietaryOptions",
        "childFriendly"
      ],
      "hasWifi": true,
      "wifiSpeed": "high_speed",
      "hasPowerOutlets": true,
      "hasOutdoorSeating": true,
      "hasVegetarianOptions": true,
      "hasVeganOptions": true,
      "hasGlutenFreeOptions": true,
      "petPolicy": "allowed_outdoor",
      "isChildFriendly": true,
      "hasPlayArea": false,
      "hasHighchairs": true,
      "hasChangingFacilities": true,
      "isQuiet": true,
      "hasPrivateRooms": true
    },
    "content": {
      "features": [
        "publishing",
        "curation",
        "mediaHosting",
        "search",
        "categories",
        "tags",
        "archives",
        "rss"
      ],
      "contentTypes": [
        "menu",
        "image",
        "video",
        "blog_post",
        "review"
      ],
      "contentFormats": [
        "text",
        "html",
        "markdown",
        "webp",
        "mp4"
      ],
      "contentAccess": [
        "public"
      ],
      "editorialControl": true,
      "userGeneratedContent": true,
      "mediaHosting": true,
      "searchPossible": true,
      "hasCategorization": true,
      "hasTagging": true,
      "archiveAccess": true,
      "rssFeeds": false
    }
  },
  "modules": {
    "location": {
      "address": {
        "streetAddress": "1287 Vineyard Avenue",
        "streetAddressAdditional": "Suite 100",
        "addressLocality": "Napa",
        "addressRegion": "CA",
        "postalCode": "94559",
        "addressCountry": "US"
      },
      "geoCoordinates": {
        "latitude": 38.2975,
        "longitude": -122.2869,
        "accuracy": 5
      },
      "serviceRadiusKm": 12.5,
      "entranceInstructions": {
        "en": "Main entrance is on Vineyard Avenue. Elevator access is available from the east side parking area.",
        "es": "La entrada principal esta en Vineyard Avenue. El acceso con elevador esta disponible desde el estacionamiento del lado este."
      },
      "parkingDetails": {
        "hasOnsiteParking": true,
        "valetAvailable": true,
        "parkingSpots": 54
      }
    },
    "hours": {
      "timezone": "America/Los_Angeles",
      "weeklySchedule": [
        {
          "dayOfWeek": [
            "Monday",
            "Tuesday",
            "Wednesday",
            "Thursday"
          ],
          "opens": "11:30",
          "closes": "22:00"
        },
        {
          "dayOfWeek": [
            "Friday",
            "Saturday"
          ],
          "opens": "11:30",
          "closes": "23:00"
        },
        {
          "dayOfWeek": [
            "Sunday"
          ],
          "opens": "10:30",
          "closes": "21:00"
        }
      ],
      "specialHours": [
        {
          "date": "2026-12-24",
          "opens": "12:00",
          "closes": "20:00",
          "reason": "holiday"
        },
        {
          "date": "2026-12-31",
          "opens": "17:00",
          "closes": "23:59",
          "reason": "event"
        }
      ]
    },
    "menu": {
      "digitalMenuEnabled": true,
      "seasonalMenuSupport": true,
      "allergenLabelsEnabled": true,
      "menuDiscovery": {
        "canonicalMenuUrl": "https://auroratable-napa.example/menu",
        "dataSources": [
          {
            "sourceType": "file_export",
            "sourceUrl": "https://auroratable-napa.example/data/menu-feed.xml",
            "format": "xml",
            "updateCadence": "daily"
          }
        ]
      }
    },
    "reservations": {
      "requiresReservationForDinner": true,
      "cancellationPolicy": "Free cancellation up to 24 hours before reservation time. A no-show fee may apply for tasting menu bookings.",
      "maxPartySize": 12,
      "leadTimeHours": 2,
      "depositRulesEnabled": true,
      "waitlistEnabled": true
    },
    "operations": {
      "kitchenCapacityPerHour": 180,
      "averageTableTurnMinutes": 95,
      "hasWaitlistWorkflow": true,
      "queueManagementMode": "digital_host",
      "deliveryFulfillmentModel": "hybrid"
    },
    "reviews": {
      "ratingSources": [
        {
          "provider": "google_business_profile",
          "sourceType": "public_page",
          "sourceUrl": "https://www.google.com/maps/place/Aurora+Table+Napa",
          "format": "html",
          "updateCadence": "daily"
        },
        {
          "provider": "yelp",
          "sourceType": "public_page",
          "sourceUrl": "https://www.yelp.com/biz/aurora-table-napa",
          "format": "html",
          "updateCadence": "weekly"
        },
        {
          "provider": "tripadvisor",
          "sourceType": "public_page",
          "sourceUrl": "https://www.tripadvisor.com/Restaurant_Review-g32766-d987654321",
          "format": "html",
          "updateCadence": "daily"
        }
      ],
      "retrievalPolicy": {
        "requiresLiveFetch": true,
        "recommendedRefreshHours": 24
      }
    },
    "compliance": {
      "healthInspectionGrade": "A",
      "lastInspectionDate": "2026-01-12",
      "foodSafetyCertification": "ServSafe Manager certification and HACCP operational plan (renewed 2026)",
      "allergenDisclosureRequired": true
    },
    "digitalPresence": {
      "primaryOrderingUrl": "https://order.auroratable-napa.example",
      "supportsOnlineOrdering": true,
      "supportsQrMenu": true,
      "integrations": [
        "google_maps",
        "opentable",
        "uber_eats",
        "doordash",
        "yelp_reservations"
      ]
    },
    "staffing": {
      "roles": [
        "head_chef",
        "line_chef",
        "host",
        "server",
        "sommelier",
        "manager"
      ],
      "trainingPolicy": "All front-of-house and kitchen staff complete onboarding on allergen handling, accessibility standards, service recovery, and quarterly hospitality quality refresh sessions."
    }
  },
  "structuralMetadata": {
    "topology": "binary",
    "roles": [
      "user",
      "platform"
    ],
    "valueSource": "platform_provided",
    "transactionFlow": "direct",
    "networkEffects": "none",
    "serviceSetting": "mixed_service",
    "capacityModel": "hybrid",
    "customerInteractionMode": "hosted_service",
    "fulfillmentPattern": "balanced_hybrid"
  },
  "targetAudience": [
    "families",
    "tourists",
    "business_customers",
    "local_community",
    "fine_dining_customers"
  ],
  "siteCapabilities": {
    "supportedDevices": [
      "desktop",
      "mobile",
      "tablet"
    ],
    "languages": [
      "en",
      "es",
      "fr"
    ],
    "accessibilityFeatures": [
      "keyboard_navigation",
      "high_contrast_mode",
      "screen_reader_labels",
      "aria_landmarks",
      "text_scaling"
    ],
    "performanceOptimization": {
      "usesCdn": true,
      "hasImageOptimization": true,
      "usesLazyLoading": true,
      "coreWebVitalsTarget": "good"
    }
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "example_instance",
    "status": "reference",
    "lastValidated": "2026-02-20T15:25:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "This filled example maps to PhysicalEntity plus DirectService because service value is created by restaurant staff and delivered directly to guests in a venue-centric operational model with optional digital ordering extensions.",
    "disambiguationNotes": "This is not a marketplace, delivery aggregator, or user-to-user exchange. Third-party integrations are operational channels only and do not alter the direct service archetype. Ratings and menu data are provided as links so agents fetch fresh values from source URLs at runtime.",
    "intendedUse": "Canonical filled reference entity for weaker model agents that must create complete restaurant entities without leaving undefined fields."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-RESTGF-001: @type MUST equal \"Restaurant\"",
      "RULE-RESTGF-002: ontologicalMode MUST equal \"PhysicalEntity\"",
      "RULE-RESTGF-003: interactionArchetype MUST contain exactly one value: \"DirectService\"",
      "RULE-RESTGF-004: modules.location MUST include valid address and geoCoordinates",
      "RULE-RESTGF-005: capabilities MUST include interaction and location groups",
      "RULE-RESTGF-006: structuralMetadata constants MUST align with DirectService archetype",
      "RULE-RESTGF-007: modules.reviews MUST declare source links and MUST NOT embed fixed aggregate snapshots",
      "RULE-RESTGF-008: modules.menu MUST declare source links and SHOULD NOT embed full item catalogs in static site schema",
      "RULE-RESTGF-009: examples MUST contain at least two practical scenarios",
      "RULE-RESTGF-010: validationMetadata and governanceMetadata MUST be present and version-aligned"
    ]
  }
}