kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/GiftShop.yaml
kempersc fc405445c6 Refactor and update schema definitions 
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

323 lines
15 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/gift-shop
name: gift_shop_class
title: GiftShop Class
imports:
- linkml:types
- ../enums/GiftShopTypeEnum
- ../enums/ProductCategoryEnum
- ../slots/accepts_or_accepted
- ../slots/has_or_had_description
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_quantity
- ../slots/has_or_had_range
- ../slots/has_or_had_revenue
- ../slots/has_or_had_score
- ../slots/has_or_had_supplier
- ../slots/is_or_was_derived_from
- ../slots/is_or_was_generated_by
- ../slots/managed_by
- ../slots/online_shop
- ../slots/opening_hour
- ../slots/physical_location
- ../slots/price_currency
- ../slots/refers_to_custodian
- ../slots/shop_type
- ../slots/square_meters
- ../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, 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
- refers_to_custodian
- has_or_had_identifier
- has_or_had_label
- has_or_had_description
- shop_type
- square_meters
- has_or_had_quantity
- has_or_had_supplier
- has_or_had_score
- temporal_extent
- is_or_was_derived_from
- is_or_was_generated_by
slot_usage:
has_or_had_identifier:
range: uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/gift-shop/rijksmuseum-shop
has_or_had_label:
range: string
inlined: true
required: true
examples:
- value:
label_text: Rijksmuseum Shop
- value:
label_text: British Library Bookshop
has_or_had_description:
range: string
inlined: true
examples:
- value:
description_text: Award-winning museum shop offering reproductions and design objects
shop_type:
range: GiftShopTypeEnum
required: true
examples:
- value: MUSEUM_SHOP
- value: BOOKSHOP
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
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
price_currency:
range: string
required: true
pattern: ^[A-Z]{3}$
examples:
- value: EUR
- value: USD
has_or_had_range:
range: PriceRange
inlined: true
required: false
examples:
- value:
has_or_had_symbol: $$
has_or_had_description: Mid-range pricing
- value:
has_or_had_label: "\u20AC5-\u20AC500"
has_or_had_description: Price range in euros
accepts_or_accepted:
range: PaymentMethod
inlined: true
multivalued: true
required: false
examples:
- value:
- method_type: credit_card
- method_type: digital
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_or_had_revenue:
range: Revenue
inlined: true
multivalued: true
examples:
- value:
has_or_had_quantity: 5000000.0
has_or_had_currency:
currency_code: EUR
has_or_had_time_interval:
- value: "has_or_had_conversion_rate:\n - rate_value: 0.35\n has_or_had_type:\n has_or_had_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_or_had_quantity:
range: integer
inlined: true
square_meters:
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_or_had_supplier:
range: Supplier
inlined_as_list: true
multivalued: true
required: false
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
temporal_extent:
range: TimeSpan
required: false
examples:
- value:
begin_of_the_begin: '2010-01-01'
end_of_the_begin: '2013-04-13'
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
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
postal_code: 1071 XX
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
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
- method_type: DEBIT_CARD
- method_type: MOBILE_PAYMENT
- method_type: MUSEUM_CARD
opening_hours: Mo-Su 09:00-18:00
has_or_had_quantity:
range: integer
inlined: true
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
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- 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
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
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
- 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:
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
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: "['*']"
Reference in a new issue View git blame Copy permalink