glam/schemas/20251121/linkml/modules/classes/GiftShop.yaml
kempersc fcd1c21c63 Add aliases and enhance slot definitions across various modules
- Added new aliases for existing slots to improve clarity and usability, including:
  - has_deadline: has_embargo_end_date
  - has_extent: has_extent_text
  - has_fonds: has_fond
  - has_laboratory: conservation_lab
  - has_language: has_iso_code639_1, has_iso_code639_3
  - has_legal_basis: legal_basis
  - has_light_exposure: max_light_lux
  - has_measurement_unit: has_unit
  - has_note: has_custodian_observation
  - has_occupation: occupation
  - has_operating_hours: has_operating_hours
  - has_position: position
  - has_quantity: has_artwork_count, link_count
  - has_roadmap: review_date
  - has_skill: skill
  - has_speaker: speaker_label
  - has_specification: specification_url
  - has_statement: rights_statement_url, rights_statement
  - has_type: custodian_only
  - has_user_category: serves_visitors_only
  - hold_record_set: record_count
  - identified_by: has_index_number
  - in_period: has_period
  - in_place: has_place
  - in_series: has_series
  - measure: has_measurement
  - measured_on: measurement_date
  - organized_by: has_organizer
  - originate_from: has_origin
  - part_of: suborganization_of
  - published_on: has_publication_date
  - receive_investment: has_investment
  - related_to: connection_heritage_type
  - require: preservation_requirement
  - safeguarded_by: current_keeper, record_holder_note
  - state: states_or_stated
  - take_comission: takes_or_took_comission
  - take_place_at: takes_or_took_place_at
  - transmit_through: transmits_or_transmitted_through
  - warrant: warrants_or_warranted

- Introduced a new slot definition for evaluated_through to capture evaluation methodologies and review statuses.
2026-02-14 14:41:49 +01:00

322 lines
15 KiB
YAML

id: https://nde.nl/ontology/hc/class/gift-shop
name: gift_shop_class
title: GiftShop Class
imports:
- linkml:types
- ../enums/GiftShopTypeEnum
- ../enums/ProductCategoryEnum
- ../slots/accept
- ../slots/has_description
- ../slots/identified_by
- ../slots/has_label
- ../slots/has_quantity
- ../slots/has_range
- ../slots/has_revenue
- ../slots/has_score
- ../slots/has_supplier
- ../slots/derive_from
- ../slots/generated_by
- ../slots/managed_by
- ../slots/has_digital_platform
- ../slots/has_operating_hours
- ../slots/located_at
- ../slots/has_currency
- ../slots/refer_to
- ../slots/has_type
- ../slots/temporal_extent
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, accept (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 identified_by: \"https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804\"\n preferred_label: \"Rijksmuseum\"\n gift_shop:\n - identified_by: \"https://nde.nl/ontology/hc/gift-shop/rijksmuseum-shop\" # was: shop_id\n has_label: # was: shop_name\n label_text: \"Rijksmuseum Shop\"\n shop_type: MUSEUM_SHOP\n has_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:
- accept
- has_revenue
- has_range
- managed_by
- has_digital_platform
- has_opening_hour
- located_at
- has_currency
- refer_to
- identified_by
- has_label
- has_description
- has_type
- has_quantity
- has_quantity
- has_supplier
- has_score
- temporal_extent
- derive_from
- generated_by
slot_usage:
identified_by:
# range: string # uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/gift-shop/rijksmuseum-shop
has_label:
# range: string
inlined: false # Fixed invalid inline for primitive type
required: true
examples:
- value:
label_text: Rijksmuseum Shop
- value:
label_text: British Library Bookshop
has_description:
# range: string
inlined: false # Fixed invalid inline for primitive type
examples:
- value:
description_text: Award-winning museum shop offering reproductions and design objects
has_type:
range: GiftShopTypeEnum
required: true
examples:
- value: MUSEUM_SHOP
- value: BOOKSHOP
located_at:
range: AuxiliaryPlace
multivalued: true
inlined_as_list: true
required: false
examples:
- value:
place_name: Rijksmuseum Shop - Main Hall
auxiliary_place_type: RETAIL_SPACE
has_digital_platform:
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
has_currency:
# range: string
required: true
pattern: ^[A-Z]{3}$
examples:
- value: EUR
- value: USD
has_range:
range: PriceRange
inlined: true
required: false
examples:
- value:
has_symbol: $$
has_description: Mid-range pricing
- value:
has_label: "\u20AC5-\u20AC500"
has_description: Price range in euros
accept:
range: PaymentMethod
inlined: true
multivalued: true
required: false
examples:
- value:
- method_type: credit_card
- method_type: digital
has_opening_hour:
# range: string
required: false
examples:
- value: Mo-Su 09:00-18:00
- value: Mo-Fr 10:00-17:00, Sa-Su 10:00-18:00
has_revenue:
range: Revenue
inlined: true
multivalued: true
examples:
- value:
has_quantity: 5000000.0
has_currency:
currency_code: EUR
has_time_interval:
- value: "has_conversion_rate:\n - rate_value: 0.35\n has_type:\n has_label: \"Visitor to Purchase\"\n temporal_extent:\n begin_of_the_begin: \"2024-01-01\"\n end_of_the_end: \"2024-12-31\"\n"
has_quantity:
range: integer
inlined: false # Fixed invalid inline for primitive type
has_quantity:
range: float
required: false
examples:
- value: 250.0
managed_by:
# range: string
required: false
examples:
- value: In-house (Rijksmuseum BV)
- value: Outsourced (Culture Shops Ltd)
has_supplier:
range: Supplier
inlined_as_list: true
multivalued: true
required: false
examples:
- value:
- has_label:
label_text: King & McGaw
has_type:
- has_label:
label_text: Print Supplier
has_description:
description_text: Art prints supplier
- has_label:
label_text: Museum Reproductions Ltd
has_type:
- has_label:
label_text: Reproduction Supplier
temporal_extent:
range: TimeSpan
required: false
examples:
- value:
begin_of_the_begin: '2010-01-01'
end_of_the_begin: '2013-04-13'
derive_from:
range: CustodianObservation
multivalued: true
required: false
generated_by:
range: ReconstructionActivity
required: false
refer_to:
range: Custodian
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
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:
identified_by: https://nde.nl/ontology/hc/gift-shop/rijksmuseum-shop
has_label:
label_text: Rijksmuseum Shop
shop_type: MUSEUM_SHOP
has_description:
description_text: Award-winning museum shop offering reproductions, design objects, books, and exclusive Rijksmuseum merchandise. Located in the redesigned entrance hall.
located_at:
- place_name: Rijksmuseum Shop - Main Hall
auxiliary_place_type: RETAIL_SPACE
postal_code: 1071 XX
country: https://nde.nl/ontology/hc/country/NL
has_digital_platform:
- platform_name: Rijksmuseum Online Shop
platform_url: https://www.rijksmuseumshop.nl/
auxiliary_platform_type: WEBSHOP
price_currency: EUR
has_range:
has_symbol: $$
has_description: Mid-range pricing
accept:
- method_type: CASH
- method_type: CREDIT_CARD
- method_type: DEBIT_CARD
- method_type: MOBILE_PAYMENT
- method_type: MUSEUM_CARD
opening_hours: Mo-Su 09:00-18:00
has_quantity:
range: integer
inlined: false # Fixed invalid inline for primitive type
square_meters: 450.0
managed_by: In-house (Rijksmuseum BV)
has_supplier:
- has_label:
label_text: King & McGaw
has_type:
- has_label:
label_text: Print Supplier
has_description:
description_text: Fine art prints supplier for museum reproductions
- has_label:
label_text: Museum Reproductions Ltd
has_type:
- has_label:
label_text: Reproduction Supplier
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
identified_by: https://nde.nl/ontology/hc/gift-shop/british-library-shop
has_label:
label_text: British Library Shop
shop_type: BOOKSHOP
has_description:
description_text: Specialist bookshop focusing on rare book facsimiles, literary merchandise, and British Library publications.
located_at:
- place_name: British Library Shop
auxiliary_place_type: RETAIL_SPACE
country: https://nde.nl/ontology/hc/country/GB
has_digital_platform:
- platform_name: British Library Shop Online
platform_url: https://shop.bl.uk/
auxiliary_platform_type: WEBSHOP
price_currency: GBP
has_range:
has_symbol: $$
has_description: Mid-range pricing
accept:
- method_type: CASH
- method_type: CREDIT_CARD
- method_type: DEBIT_CARD
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
- value:
identified_by: https://nde.nl/ontology/hc/gift-shop/vermeer-exhibition-popup
has_label:
label_text: Vermeer Exhibition Pop-up Shop
shop_type: POP_UP
has_description:
description_text: Temporary retail for the 2023 Vermeer exhibition with exclusive exhibition merchandise and catalog.
located_at:
- place_name: Vermeer Exhibition Shop
auxiliary_place_type: RETAIL_SPACE
price_currency: EUR
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"