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

453 lines
19 KiB
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_revenue
- ../classes/Revenue
- ../slots/giftshop_price_range
- ../slots/online_shop
- ../slots/opening_hour
- ../slots/physical_location
- ../slots/sells_or_sold
- ../slots/refers_to_custodian
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_description
- ./Label
- ./Description
- ../slots/shop_type
- ../slots/specificity_annotation
- ../slots/square_meters
- ../slots/has_or_had_supplier
- ./Supplier
- ./SupplierType
- ./SupplierTypes
- ../slots/has_or_had_score
- ../slots/temporal_extent
- ../slots/has_or_had_conversion_rate
- ./ConversionRate
- ./ConversionRateType
- ./ConversionRateTypes
- ../slots/is_or_was_derived_from
- ../slots/is_or_was_generated_by
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
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 \u251C\u2500\u2500 gift_shop \u2192 GiftShop (retail operations)\n \u2502 \u251C\u2500\u2500 physical_location \u2192 AuxiliaryPlace (shop location)\n \u2502 \u251C\u2500\u2500 online_shop \u2192 AuxiliaryDigitalPlatform (e-commerce)\n \u2502 \u251C\u2500\u2500 product_categories \u2192 ProductCategoryEnum[]\n \u2502 \u2514\u2500\u2500 revenue_data \u2192 Annual sales, visitor conversion\n \u2502\n \u2514\u2500\u2500 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 has_or_had_identifier: \"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_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_revenue
- has_or_had_range
- managed_by
- online_shop
- opening_hour
- physical_location
- price_currency
- sells_or_sold
- refers_to_custodian
- has_or_had_identifier
- has_or_had_label
- has_or_had_description
- shop_type
- specificity_annotation
- square_meters
- staff_count
- has_or_had_supplier
- has_or_had_score
- temporal_extent
- has_or_had_conversion_rate
- is_or_was_derived_from
- is_or_was_generated_by
slot_usage:
has_or_had_identifier:
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:
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_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
sells_or_sold:
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
has_or_had_range:
description: 'Price range classification for the shop.
MIGRATED from giftshop_price_range per Rule 53.
Uses PriceRange class.
'
range: PriceRange
inlined: true
required: false
examples:
- value:
has_or_had_symbol: $$
has_or_had_description: Mid-range pricing
description: Mid-range pricing
- value:
has_or_had_label: "\u20AC5-\u20AC500"
has_or_had_description: Price range in euros
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_revenue:
range: Revenue
inlined: true
multivalued: true
description: 'Structured revenue data for the gift shop.
MIGRATED from has_or_had_annual_revenue per Rule 53.
Uses Revenue class.
'
examples:
- value:
has_or_had_quantity: 5000000.0
has_or_had_currency:
currency_code: EUR
has_or_had_time_interval:
duration_description: Annual
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:\n - rate_value: 0.35\n has_or_had_type:\n type_label: \"Visitor to Purchase\"\n temporal_extent:\n begin_of_the_begin: \"2024-01-01\"\n end_of_the_end: \"2024-12-31\"\n"
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
has_or_had_supplier:
range: Supplier
inlined_as_list: true
multivalued: true
required: false
description: 'Supplier relationships for shop merchandise.
MIGRATED from supplier_relationship slot per slot_fixes.yaml (Rule 53/56, 2026-01-16).
'
examples:
- value:
- has_or_had_label:
label_text: King & McGaw
has_or_had_type:
- has_or_had_label:
label_text: Print Supplier
has_or_had_description:
description_text: Art prints supplier
- has_or_had_label:
label_text: Museum Reproductions Ltd
has_or_had_type:
- has_or_had_label:
label_text: Reproduction Supplier
description: Structured supplier relationships with type classification
temporal_extent:
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:
range: CustodianObservation
multivalued: true
required: false
is_or_was_generated_by:
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:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/gift-shop/rijksmuseum-shop
has_or_had_label:
label_text: Rijksmuseum Shop
shop_type: MUSEUM_SHOP
has_or_had_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
sells_or_sold:
- REPRODUCTIONS
- BOOKS
- DESIGN_OBJECTS
- JEWELRY
- HOME_DECOR
price_currency: EUR
has_or_had_range:
has_or_had_symbol: $$
has_or_had_description: Mid-range pricing
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)
has_or_had_supplier:
- has_or_had_label:
label_text: King & McGaw
has_or_had_type:
- has_or_had_label:
label_text: Print Supplier
has_or_had_description:
description_text: Fine art prints supplier for museum reproductions
- has_or_had_label:
label_text: Museum Reproductions Ltd
has_or_had_type:
- has_or_had_label:
label_text: Reproduction Supplier
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
has_or_had_label:
label_text: British Library Shop
shop_type: BOOKSHOP
has_or_had_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
sells_or_sold:
- BOOKS
- REPRODUCTIONS
- STATIONERY
- GIFTS
price_currency: GBP
has_or_had_range:
has_or_had_symbol: $$
has_or_had_description: Mid-range pricing
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
has_or_had_label:
label_text: Vermeer Exhibition Pop-up Shop
shop_type: POP_UP
has_or_had_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
sells_or_sold:
- 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
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
custodian_types_rationale: Universal utility concept