glam/schemas/20251121/linkml/modules/classes/GiftShop.yaml

id: https://nde.nl/ontology/hc/class/gift-shop
name: gift_shop_class
title: GiftShop Class
imports:
  - linkml:types
  - ./Custodian
  - ./AuxiliaryPlace
  - ./AuxiliaryDigitalPlatform
  - ./CustodianObservation
  - ./ReconstructionActivity
  - ./TimeSpan
  - ../enums/GiftShopTypeEnum
  - ../enums/ProductCategoryEnum
  - ../slots/staff_count
  - ../slots/managed_by
  - ../slots/price_currency
  - ./ReconstructedEntity
  - ../slots/accepts_or_accepted
  - ./PaymentMethod
  - ../slots/has_or_had_annual_revenue
  - ../slots/giftshop_price_range
  - ../slots/online_shop
  - ../slots/opening_hour
  - ../slots/physical_location
  - ../slots/has_or_had_product_category
  - ../slots/refers_to_custodian
  # MIGRATED 2026-01-15: shop_* slots replaced with shared slots per Rule 53
  - ../slots/has_or_had_identifier  # was: shop_id
  - ../slots/has_or_had_label       # was: shop_name
  - ../slots/has_or_had_structured_description # was: shop_description
  - ./Label
  - ./Description
  - ../slots/shop_type
  - ../slots/specificity_annotation
  - ../slots/square_meters
  - ../slots/supplier_relationship
  - ../slots/template_specificity
  - ../slots/temporal_extent  # consolidated: absorbs valid_from + valid_to per Rule 53
  # REMOVED 2026-01-14: valid_from + valid_to - migrated to temporal_extent (Rule 53)
  - ../slots/has_or_had_conversion_rate
  - ./ConversionRate
  - ./ConversionRateType
  - ./ConversionRateTypes
  - ../slots/is_or_was_derived_from  # was: was_derived_from - migrated per Rule 53
  - ../slots/is_or_was_generated_by  # was: was_generated_by - migrated per Rule 53
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScores
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
  crm: http://www.cidoc-crm.org/cidoc-crm/
  prov: http://www.w3.org/ns/prov#
  gr: http://purl.org/goodrelations/v1#
  org: http://www.w3.org/ns/org#
  foaf: http://xmlns.com/foaf/0.1/
classes:
  GiftShop:
    is_a: ReconstructedEntity
    class_uri: schema:Store
    description: "Retail operation associated with a heritage custodian for selling merchandise,\nreproductions, books, and\
      \ heritage-related products.\n\n**PURPOSE AND SCOPE**:\n\nMuseum gift shops, archive bookshops, and library retail spaces\
      \ are important\nrevenue-generating operations that also serve educational and cultural missions:\n\n- **Revenue generation**:\
      \ Support institutional operations through merchandise sales\n- **Mission extension**: Offer products related to collections\
      \ and exhibitions\n- **Visitor experience**: Complete the visit with memorable takeaways\n- **Brand communication**:\
      \ Extend institutional identity through products\n- **Educational outreach**: Books, educational materials, replicas\
      \ for learning\n\n**PHYSICAL vs. DIGITAL PRESENCE**:\n\nGift shops can exist in multiple forms:\n\n1. **Physical shop**\
      \ (on-site): Located within museum/archive building\n   - Links to AuxiliaryPlace (physical location)\n   - Has opening_hours,\
      \ accepts_or_accepted (PaymentMethod)\n   \n2. **Physical shop** (separate): Stand-alone retail location\n   - Links\
      \ to AuxiliaryPlace with type RETAIL_SPACE\n   - May have separate street address, hours\n   \n3. **Online shop** (e-commerce):\
      \ Web-based retail platform\n   - Links to AuxiliaryDigitalPlatform with type WEBSHOP\n   - Has platform_url, shipping\
      \ policies\n   \n4. **Hybrid**: Both physical and online presence\n   - Multiple links to AuxiliaryPlace AND AuxiliaryDigitalPlatform\n\
      \n**SCHEMA.ORG ALIGNMENT**:\n\n`schema:Store` - \"A retail good store.\"\n\nKey properties:\n- `schema:openingHours`\
      \ - Operating hours\n- `schema:acceptedPaymentMethod` - Payment options\n- `schema:priceRange` - Price level indication\n\
      - `schema:currenciesAccepted` - Currency codes\n\n**GoodRelations Integration**:\n\nFor detailed product/offer modeling,\
      \ GiftShop can link to:\n- `gr:Offering` - Specific product offers\n- `gr:BusinessEntity` - Shop as business entity\n\
      - `gr:PaymentMethod` - Payment options\n\n**RELATIONSHIP TO CUSTODIAN HUB**:\n\n```\nCustodian (hub)\n  ├── gift_shop\
      \ → GiftShop (retail operations)\n  │   ├── physical_location → AuxiliaryPlace (shop location)\n  │   ├── online_shop\
      \ → AuxiliaryDigitalPlatform (e-commerce)\n  │   ├── product_categories → ProductCategoryEnum[]\n  │   └── revenue_data\
      \ → Annual sales, visitor conversion\n  │\n  └── commercial_activities (broader commercial operations)\n```\n\n**USE\
      \ CASES**:\n\n1. **Museum Shop** (Rijksmuseum):\n   - Physical shop in museum foyer\n   - Online shop at rijksmuseumshop.nl\n\
      \   - Products: Reproductions, books, design objects\n   \n2. **Archive Bookshop** (National Archives):\n   - Small\
      \ shop near reading room\n   - Publications, finding aids, historical maps\n   \n3. **Library Retail** (British Library):\n\
      \   - Multiple retail spaces (shop, cafe, bookshop)\n   - Extensive publication program\n   \n4. **Pop-up Shop** (Exhibition):\n\
      \   - Temporary retail for special exhibition\n   - Exhibition catalog, themed merchandise\n\n**Example - Rijksmuseum\
      \ Gift Shop**:\n```yaml\nCustodian:\n  hc_id: \"https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804\"\n  preferred_label:\
      \ \"Rijksmuseum\"\n  gift_shop:\n    - has_or_had_identifier: \"https://nde.nl/ontology/hc/gift-shop/rijksmuseum-shop\"  # was: shop_id\n      has_or_had_label:  # was: shop_name\n        label_text:\
      \ \"Rijksmuseum Shop\"\n      shop_type: MUSEUM_SHOP\n      has_or_had_structured_description:  # was: shop_description\n        description_text: |\n          Award-winning museum shop offering\
      \ reproductions, design objects,\n          books, and exclusive Rijksmuseum merchandise.\n      physical_location:\n\
      \        - place_name: \"Rijksmuseum Shop - Main Hall\"\n          auxiliary_place_type: RETAIL_SPACE\n          street_address:\
      \ \"Museumstraat 1, Amsterdam\"\n      online_shop:\n        - platform_name: \"Rijksmuseum Online Shop\"\n        \
      \  platform_url: \"https://www.rijksmuseumshop.nl/\"\n          auxiliary_platform_type: WEBSHOP\n      product_categories:\n\
      \        - REPRODUCTIONS\n        - BOOKS\n        - DESIGN_OBJECTS\n        - JEWELRY\n        - HOME_DECOR\n     \
      \ price_currency: EUR\n      accepts_payment_methods:\n        - CASH\n        - CREDIT_CARD\n        - DEBIT_CARD\n\
      \        - MOBILE_PAYMENT\n      opening_hours: \"09:00-18:00\"\n```\n\n**TEMPORAL VALIDITY**:\n\nGift shops can open/close\
      \ independently of the main institution:\n- New shop location opened 2013 after renovation\n- Temporary pop-up during\
      \ exhibition\n- Online shop launched 2010\n\nTrack with valid_from/valid_to dates.\n"
    exact_mappings:
    - schema:Store
    - gr:BusinessEntity
    close_mappings:
    - schema:LocalBusiness
    - schema:ShoppingCenter
    - crm:E39_Actor
    - foaf:Organization
    related_mappings:
    - schema:Offer
    - gr:Offering
    - schema:Product
    slots:
    - accepts_or_accepted
    - has_or_had_annual_revenue
    - giftshop_price_range
    - managed_by
    - online_shop
    - opening_hour
    - physical_location
    - price_currency
    - has_or_had_product_category
    - refers_to_custodian
    # MIGRATED 2026-01-15: shop_* slots replaced with shared slots per Rule 53
    - has_or_had_identifier   # was: shop_id
    - has_or_had_label        # was: shop_name
    - has_or_had_structured_description  # was: shop_description
    - shop_type
    - specificity_annotation
    - square_meters
    - staff_count
    - supplier_relationship
    - template_specificity
    - temporal_extent  # consolidated: absorbs valid_from + valid_to per Rule 53
    - has_or_had_conversion_rate
    - is_or_was_derived_from  # was: was_derived_from - migrated per Rule 53
    - is_or_was_generated_by  # was: was_generated_by - migrated per Rule 53
    slot_usage:
      # MIGRATED 2026-01-15: shop_* slots replaced with shared slots per Rule 53
      has_or_had_identifier:  # was: shop_id
        range: uriorcurie
        required: true
        identifier: true
        description: Unique identifier for the gift shop.
        examples:
        - value: https://nde.nl/ontology/hc/gift-shop/rijksmuseum-shop
          description: Rijksmuseum shop ID
      has_or_had_label:  # was: shop_name
        range: Label
        inlined: true
        required: true
        description: The name of the gift shop.
        examples:
        - value:
            label_text: Rijksmuseum Shop
          description: Museum shop name
        - value:
            label_text: British Library Bookshop
          description: Library bookshop name
      has_or_had_structured_description:  # was: shop_description
        range: Description
        inlined: true
        description: A description of the gift shop.
        examples:
        - value:
            description_text: Award-winning museum shop offering reproductions and design objects
          description: Rijksmuseum shop description
      shop_type:
        range: GiftShopTypeEnum
        required: true
        examples:
        - value: MUSEUM_SHOP
          description: General museum shop
        - value: BOOKSHOP
          description: Primarily publications
      physical_location:
        range: AuxiliaryPlace
        multivalued: true
        inlined_as_list: true
        required: false
        examples:
        - value:
            place_name: Rijksmuseum Shop - Main Hall
            auxiliary_place_type: RETAIL_SPACE
            street_address: Museumstraat 1
            city: Amsterdam
          description: Physical shop location
      online_shop:
        range: AuxiliaryDigitalPlatform
        multivalued: true
        inlined_as_list: true
        required: false
        examples:
        - value:
            platform_name: Rijksmuseum Online Shop
            platform_url: https://www.rijksmuseumshop.nl/
            auxiliary_platform_type: WEBSHOP
          description: Online shop platform
      has_or_had_product_category:
        range: ProductCategoryEnum
        multivalued: true
        required: true
        examples:
        - value:
          - REPRODUCTIONS
          - BOOKS
          - DESIGN_OBJECTS
          description: Rijksmuseum shop categories
      price_currency:
        range: string
        required: true
        pattern: ^[A-Z]{3}$
        examples:
        - value: EUR
          description: Euro currency
        - value: USD
          description: US Dollar
      giftshop_price_range:
        range: string
        required: false
        examples:
        - value: $$
          description: Mid-range pricing
        - value: €5-€500
          description: Price range in euros
      accepts_or_accepted:
        range: PaymentMethod
        inlined: true
        multivalued: true
        required: false
        description: Payment methods accepted by this gift shop.
        examples:
        - value:
            - method_type: "credit_card"
              provider: "Visa"
            - method_type: "digital"
              provider: "iDEAL"
          description: Common payment methods
      opening_hour:
        range: string
        required: false
        examples:
        - value: Mo-Su 09:00-18:00
          description: Daily hours
        - value: Mo-Fr 10:00-17:00, Sa-Su 10:00-18:00
          description: Weekday/weekend hours
      has_or_had_annual_revenue:
        range: string
        required: false
        examples:
        - value: EUR 5,000,000
          description: Annual revenue in euros
      has_or_had_conversion_rate:
        range: ConversionRate
        inlined: true
        multivalued: true
        required: false
        description: Conversion rate metrics for the gift shop (visitor-to-purchase, visitor-to-member, etc.)
        examples:
        - value: |
            has_or_had_conversion_rate:
              - rate_value: 0.35
                has_or_had_type:
                  type_label: "Visitor to Purchase"
                temporal_extent:
                  begin_of_the_begin: "2024-01-01"
                  end_of_the_end: "2024-12-31"            
          description: 35% visitor-to-purchase conversion rate for calendar year
      staff_count:
        range: integer
        required: false
        examples:
        - value: 15
          description: 15 shop staff
      square_meters:
        range: float
        required: false
        examples:
        - value: 250.0
          description: 250 square meters
      managed_by:
        range: string
        required: false
        examples:
        - value: In-house (Rijksmuseum BV)
          description: Internal management
        - value: Outsourced (Culture Shops Ltd)
          description: External operator
      supplier_relationship:
        range: string
        multivalued: true
        required: false
        examples:
        - value: King & McGaw (art prints)
          description: Print supplier
        - value: Museum Reproductions Ltd
          description: Reproduction supplier
      temporal_extent:  # was: valid_from + valid_to - migrated per Rule 53
        range: TimeSpan
        required: false
        examples:
        - value:
            begin_of_the_begin: '2010-01-01'
            end_of_the_begin: '2013-04-13'
          description: Shop opened sometime 2010-2013
      is_or_was_derived_from:  # was: was_derived_from - migrated per Rule 53
        range: CustodianObservation
        multivalued: true
        required: false
      is_or_was_generated_by:  # was: was_generated_by - migrated per Rule 53
        range: ReconstructionActivity
        required: false
      refers_to_custodian:
        range: Custodian
        required: true
        examples:
        - value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
          description: Rijksmuseum custodian hub
    comments:
    - GiftShop models retail operations of heritage custodians
    - Can have physical location (AuxiliaryPlace) and/or online presence (AuxiliaryDigitalPlatform)
    - Schema.org schema:Store for retail business modeling
    - GoodRelations (gr:) can be used for detailed product/offer modeling
    - Revenue and conversion metrics support institutional planning
    - Temporal validity tracks shop lifecycle (opening, renovation, closure)
    - May be in-house or outsourced to third-party operators
    see_also:
    - https://schema.org/Store
    - https://schema.org/LocalBusiness
    - http://purl.org/goodrelations/v1#
    - https://schema.org/Offer
    examples:
    # MIGRATED 2026-01-15: shop_* slots replaced with shared slots per Rule 53
    - value:
        has_or_had_identifier: https://nde.nl/ontology/hc/gift-shop/rijksmuseum-shop  # was: shop_id
        has_or_had_label:  # was: shop_name
          label_text: Rijksmuseum Shop
        shop_type: MUSEUM_SHOP
        has_or_had_structured_description:  # was: shop_description
          description_text: Award-winning museum shop offering reproductions, design objects, books, and exclusive Rijksmuseum merchandise. Located in the redesigned entrance hall.
        physical_location:
        - place_name: Rijksmuseum Shop - Main Hall
          auxiliary_place_type: RETAIL_SPACE
          street_address: Museumstraat 1
          postal_code: 1071 XX
          city: Amsterdam
          country: https://nde.nl/ontology/hc/country/NL
        online_shop:
        - platform_name: Rijksmuseum Online Shop
          platform_url: https://www.rijksmuseumshop.nl/
          auxiliary_platform_type: WEBSHOP
        has_or_had_product_category:
        - REPRODUCTIONS
        - BOOKS
        - DESIGN_OBJECTS
        - JEWELRY
        - HOME_DECOR
        price_currency: EUR
        giftshop_price_range: $$
        accepts_or_accepted:
        - method_type: CASH
        - method_type: CREDIT_CARD
          provider: Visa, Mastercard
        - method_type: DEBIT_CARD
          provider: Maestro
        - method_type: MOBILE_PAYMENT
          provider: Apple Pay, Google Pay
        - method_type: MUSEUM_CARD
          provider: Museumkaart
        opening_hours: Mo-Su 09:00-18:00
        staff_count: 25
        square_meters: 450.0
        managed_by: In-house (Rijksmuseum BV)
        valid_from: '2013-04-13'
        refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
      description: Rijksmuseum flagship museum shop
    - value:
        has_or_had_identifier: https://nde.nl/ontology/hc/gift-shop/british-library-shop  # was: shop_id
        has_or_had_label:  # was: shop_name
          label_text: British Library Shop
        shop_type: BOOKSHOP
        has_or_had_structured_description:  # was: shop_description
          description_text: Specialist bookshop focusing on rare book facsimiles, literary merchandise, and British Library publications.
        physical_location:
        - place_name: British Library Shop
          auxiliary_place_type: RETAIL_SPACE
          street_address: 96 Euston Road
          city: London
          country: https://nde.nl/ontology/hc/country/GB
        online_shop:
        - platform_name: British Library Shop Online
          platform_url: https://shop.bl.uk/
          auxiliary_platform_type: WEBSHOP
        has_or_had_product_category:
        - BOOKS
        - REPRODUCTIONS
        - STATIONERY
        - GIFTS
        price_currency: GBP
        giftshop_price_range: $$
        accepts_or_accepted:
        - method_type: CASH
        - method_type: CREDIT_CARD
          provider: Visa, Mastercard
        - method_type: DEBIT_CARD
          provider: V-Pay
        opening_hours: Mo-Fr 09:30-18:00, Sa 09:30-17:00, Su 11:00-17:00
        refers_to_custodian: https://nde.nl/ontology/hc/gb-british-library
      description: British Library specialist bookshop
    - value:
        has_or_had_identifier: https://nde.nl/ontology/hc/gift-shop/vermeer-exhibition-popup  # was: shop_id
        has_or_had_label:  # was: shop_name
          label_text: Vermeer Exhibition Pop-up Shop
        shop_type: POP_UP
        has_or_had_structured_description:  # was: shop_description
          description_text: Temporary retail for the 2023 Vermeer exhibition with exclusive exhibition merchandise and catalog.
        physical_location:
        - place_name: Vermeer Exhibition Shop
          auxiliary_place_type: RETAIL_SPACE
          street_address: Museumstraat 1
          city: Amsterdam
        has_or_had_product_category:
        - BOOKS
        - REPRODUCTIONS
        - SOUVENIRS
        price_currency: EUR
        valid_from: '2023-02-10'
        valid_to: '2023-06-04'
        refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
      description: Temporary exhibition pop-up shop