{
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://data.meta-aiml.org/v3.0.0/examples/store/lumen-mart-napa",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/store/lumen-mart-napa",
  "@type": "Store",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Store Entity Example (Lumen Mart Napa)",
  "ontologicalMode": "PhysicalEntity",
  "interactionArchetype": [
    "DirectService"
  ],
  "domain": "Retail",
  "businessModel": [
    "Transactional",
    "Membership"
  ],
  "deliveryFormat": [
    "PhysicalLocation",
    "WebApp",
    "MobileApp"
  ],
  "name": {
    "en": "Lumen Mart Napa",
    "es": "Lumen Mart Napa",
    "fr": "Lumen Mart Napa"
  },
  "description": {
    "en": "Lumen Mart Napa is a fictional neighborhood retail store with physical checkout, pickup support, and AI-discoverable catalog links for real-time product availability.",
    "es": "Lumen Mart Napa es una tienda minorista ficticia de barrio con caja fisica, soporte de recogida y enlaces de catalogo para que la IA consulte disponibilidad actual.",
    "fr": "Lumen Mart Napa est un magasin de detail fictif avec caisse physique, retrait en magasin et liens de catalogue pour recuperer la disponibilite en temps reel."
  },
  "shortDescription": {
    "en": "Neighborhood physical store with source-link catalog discovery.",
    "es": "Tienda fisica de barrio con descubrimiento de catalogo por enlaces.",
    "fr": "Magasin physique de proximite avec decouverte de catalogue par liens."
  },
  "url": "https://lumenmart-napa.example",
  "foundingDate": "2017-09-12",
  "createdDate": "2026-02-20T18:00:00Z",
  "lastModified": "2026-02-20T18:00:00Z",
  "examples": [
    {
      "scenario": "Weekend stock updates",
      "note": "Agent reads inventory links and fetches fresh stock metadata before generating answers."
    },
    {
      "scenario": "Holiday promotion week",
      "note": "Static schema stays unchanged while downstream feeds provide temporary assortment and pricing updates."
    }
  ],
  "properties": {
    "storeFormat": "grocery",
    "assortmentBreadth": "broad",
    "supportsInStorePickup": true,
    "supportsCurbsidePickup": true,
    "supportsReturnsAtStore": true,
    "averageFootfallPerDay": 820,
    "identifiers": [
      {
        "type": "url",
        "value": "https://lumenmart-napa.example"
      },
      {
        "type": "custom",
        "value": "STORE-NAPA-001"
      }
    ]
  },
  "capabilities": {
    "interaction": {
      "features": [
        "messaging",
        "notifications",
        "reviews"
      ],
      "interactionMethods": [
        "online_form",
        "phone_call",
        "in_person"
      ],
      "availableActions": [
        "find_product",
        "check_pickup",
        "contact_store"
      ],
      "hasMessaging": true,
      "hasComments": false,
      "hasRating": true,
      "hasReviews": true,
      "hasSocialGraph": false,
      "hasFeed": false,
      "hasNotifications": true,
      "hasMatching": false,
      "realTimeCommunication": false,
      "moderationEnabled": true,
      "privacyControls": [
        "public",
        "private"
      ]
    },
    "commerce": {
      "features": [
        "productCatalog",
        "checkout",
        "inventory",
        "search",
        "filtering"
      ],
      "hasProductCatalog": true,
      "catalogSize": 12000,
      "supportsCart": false,
      "supportsCheckout": true,
      "hasOrderTracking": false,
      "recommendationEngine": true,
      "vendorManagement": false,
      "searchCapability": true,
      "filteringOptions": [
        "category",
        "brand",
        "availability"
      ]
    },
    "financial": {
      "features": [
        "payments",
        "refunds",
        "billing"
      ],
      "paymentMethods": [
        "credit_card",
        "debit_card",
        "digital_wallet",
        "cash"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD"
      ],
      "priceRange": "$$",
      "commissionModel": "fixed_price",
      "commissionRate": 0,
      "supportsSubscriptions": false,
      "supportsInvoicing": true,
      "refundPolicy": "full_refund"
    },
    "location": {
      "features": [
        "physicalAddress",
        "geoCoordinates",
        "directions",
        "mapIntegration"
      ],
      "hasPhysicalAddress": true,
      "hasGeoCoordinates": true,
      "hasMultipleLocations": false,
      "hasParking": true,
      "parkingType": "free",
      "isWheelchairAccessible": true,
      "publicTransitAccess": true,
      "deliveryZones": [],
      "serviceRadius": 0
    },
    "amenities": {
      "features": [
        "wifi",
        "parking",
        "accessibility",
        "childFriendly"
      ],
      "hasWifi": true,
      "wifiSpeed": "standard",
      "hasPowerOutlets": false,
      "hasOutdoorSeating": false,
      "hasVegetarianOptions": false,
      "hasVeganOptions": false,
      "hasGlutenFreeOptions": false,
      "petPolicy": "not_allowed",
      "isChildFriendly": true,
      "hasPlayArea": false,
      "hasHighchairs": false,
      "hasChangingFacilities": true,
      "isQuiet": false,
      "hasPrivateRooms": false
    }
  },
  "modules": {
    "location": {
      "address": {
        "streetAddress": "412 Main Street",
        "addressLocality": "Napa",
        "addressRegion": "CA",
        "postalCode": "94559",
        "addressCountry": "US"
      },
      "geoCoordinates": {
        "latitude": 38.2972,
        "longitude": -122.2855,
        "accuracy": 5
      },
      "floorMapAvailable": true
    },
    "inventory": {
      "skuCount": 12000,
      "restockCadence": "daily",
      "supportsRealtimeStockVisibility": true,
      "inventoryDiscovery": {
        "canonicalCatalogUrl": "https://lumenmart-napa.example/catalog",
        "dataSources": [
          {
            "sourceType": "file_export",
            "sourceUrl": "https://lumenmart-napa.example/data/inventory-feed.xml",
            "format": "xml",
            "updateCadence": "daily"
          }
        ]
      }
    },
    "checkout": {
      "selfCheckoutEnabled": true,
      "posIntegratedLoyalty": true,
      "digitalReceiptEnabled": true
    },
    "reviews": {
      "ratingSources": [
        {
          "provider": "google_business_profile",
          "sourceType": "public_page",
          "sourceUrl": "https://www.google.com/maps/place/Lumen+Mart+Napa",
          "format": "html",
          "updateCadence": "daily"
        },
        {
          "provider": "yelp",
          "sourceType": "public_page",
          "sourceUrl": "https://www.yelp.com/biz/lumen-mart-napa",
          "format": "html",
          "updateCadence": "weekly"
        }
      ],
      "retrievalPolicy": {
        "requiresLiveFetch": true,
        "recommendedRefreshHours": 24
      }
    }
  },
  "structuralMetadata": {
    "topology": "binary",
    "roles": [
      "user",
      "platform"
    ],
    "valueSource": "platform_provided",
    "transactionFlow": "direct",
    "networkEffects": "none",
    "serviceMode": "omnichannel"
  },
  "targetAudience": [
    "families",
    "local_community",
    "daily_shoppers"
  ],
  "siteCapabilities": {
    "supportedDevices": [
      "desktop",
      "mobile",
      "tablet"
    ],
    "languages": [
      "en",
      "es",
      "fr"
    ],
    "accessibilityFeatures": [
      "keyboard_navigation",
      "screen_reader_labels",
      "text_scaling"
    ]
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "example_instance",
    "status": "reference",
    "lastValidated": "2026-02-20T18:00:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "Store maps to PhysicalEntity plus DirectService because value delivery requires in-person operations and direct first-party transaction flow.",
    "disambiguationNotes": "This is not a pure digital storefront or marketplace. Dynamic inventory and ratings are represented through source links for runtime fetching.",
    "intendedUse": "Canonical filled reference for static website schema with source-link product and review discovery."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-STORG-001: @type MUST equal \"Store\"",
      "RULE-STORG-002: ontologicalMode MUST equal \"PhysicalEntity\"",
      "RULE-STORG-003: interactionArchetype MUST contain exactly one value: \"DirectService\"",
      "RULE-STORG-004: modules.location MUST include valid address and geoCoordinates",
      "RULE-STORG-005: modules.inventory.inventoryDiscovery MUST declare external source links and avoid embedded product snapshots",
      "RULE-STORG-006: modules.reviews MUST declare source links and avoid embedded fixed rating snapshots",
      "RULE-STORG-007: examples MUST include at least two practical scenarios",
      "RULE-STORG-008: validationMetadata and governanceMetadata MUST be present and version-aligned"
    ]
  }
}