glam/schemas/20251121/linkml/modules/classes/DonationScheme.yaml
kempersc 0d5d48568d refactor(schema): centralize slot definitions per Rule 38
- Remove slot_uri, description, mappings from slot_usage sections
- Move these properties to centralized slot files in modules/slots/
- Keep only class-specific overrides in slot_usage (required, inlined, examples)
- Update 1,499 centralized slot files with enriched definitions
- Clean 188 class files

Violations fixed:
- slot_uri in slot_usage: 1,676 → 0
- description in slot_usage: 2,287 → 0 (moved to centralized)

Schema still validates: 816 classes, 2028 slots, 127 enums
2026-01-11 23:27:17 +01:00

402 lines
19 KiB
YAML

id: https://nde.nl/ontology/hc/class/DonationScheme
name: DonationScheme
title: DonationScheme Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
prov: http://www.w3.org/ns/prov#
pav: http://purl.org/pav/
skos: http://www.w3.org/2004/02/skos/core#
org: http://www.w3.org/ns/org#
imports:
- linkml:types
- ../enums/DonationSchemeTypeEnum
- ../slots/valid_from
- ../slots/valid_to
- ../slots/extraction_confidence
- ../slots/extraction_note
- ../slots/contact_email
- ../slots/observed_in
- ../slots/benefit
- ../slots/currency
- ../slots/maximum_amount
- ../slots/minimum_amount
- ../slots/offered_by
- ../slots/payment_frequency
- ../slots/scheme_description
- ../slots/scheme_id
- ../slots/scheme_name
- ../slots/scheme_type
- ../slots/scheme_url
- ../slots/specificity_annotation
- ../slots/tax_deductible
- ../slots/tax_scheme
- ../slots/template_specificity
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
default_prefix: hc
classes:
DonationScheme:
class_uri: schema:DonateAction
description: "A donation or giving scheme offered by a heritage custodian institution.\n\n**PURPOSE**:\n\nDonationScheme\
\ provides structured representation of the various ways\nindividuals and organizations can financially support heritage\
\ institutions.\nThese range from simple one-time donations to complex membership programs,\nadoption schemes, patron\
\ circles, and legacy giving vehicles.\n\n**HERITAGE SECTOR CONTEXT**:\n\nDonation schemes are critical for heritage\
\ institution sustainability:\n\n- **Museums**: Friends schemes, patron circles, acquisition fund drives\n- **Libraries**:\
\ Adopt-a-book programs, conservation appeals\n- **Archives**: \"Adopt history\" programs, preservation sponsorships\n\
- **Galleries**: Artist support funds, exhibition sponsorships\n- **Historical societies**: Heritage membership, research\
\ fellowships\n- **Botanical gardens**: Plant and animal adoption programs\n\n**MULTILINGUAL TERMINOLOGY**:\n\n\"Friends\"\
\ scheme terminology varies by country:\n- Dutch: Museumvriend, Vrienden van het museum\n- German: Förderverein, Freundeskreis\n\
- French: Amis du musée, Société des amis\n- Spanish: Amigos del museo\n- Italian: Amici del museo\n\n**PROVENANCE CHAIN**:\n\
\n```\nHeritageCustodian\n │\n ├── offers_donation_schemes ──→ DonationScheme[]\n │ \
\ │\n │ ├── scheme_type: MEMBERSHIP_FRIENDS\n │ \
\ ├── scheme_name: \"Rijksmuseum Vrienden\"\n │ ├──\
\ minimum_amount: 60\n │ ├── currency: \"EUR\"\n │ \
\ ├── payment_frequency: \"annually\"\n │ │\n │ \
\ └── observed_in ──→ WebObservation\n │ \
\ │\n │ ├── source_url: https://rijksmuseum.nl/steun\n\
\ │ ├── retrieved_on: 2026-01-01T10:00:00Z\n │ \
\ └── extraction_confidence: 0.95\n │\n └── web_observations\
\ ──→ WebObservation[] (general custodian provenance)\n```\n\n**ONTOLOGY ALIGNMENT**:\n\n- **Schema.org**: `schema:DonateAction`\
\ - Action of donating to organization\n- **Schema.org**: `schema:Offer` - Scheme as offer with price specification\n\
- **W3C Org**: `org:Membership` - For membership-type schemes\n- **Dublin Core**: `dcterms:isPartOf` - Scheme belongs\
\ to institution\n- **PROV-O**: `prov:wasDerivedFrom` - Links scheme to observation\n\n**TAX INCENTIVE SCHEMES**:\n\n\
Many countries provide tax benefits for cultural donations:\n\n| Country | Scheme | Benefit |\n|---------|--------|---------|\n\
| Netherlands | ANBI | 100% deductible |\n| Netherlands | Cultural ANBI | 125% deductible (extra 25%) |\n| UK | Gift\
\ Aid | 25% tax reclaim for charity |\n| UK | Cultural Gifts Scheme | Tax relief on objects donated |\n| USA | 501(c)(3)\
\ | Itemized deduction |\n| Germany | Gemeinnützigkeit | Tax deductible |\n| France | Mécénat culturel | 60% tax reduction\
\ |\n\n**SCHEME CATEGORIES**:\n\nSchemes are classified via DonationSchemeTypeEnum into eight categories:\n\n1. **MEMBERSHIP_***\
\ - Recurring membership/subscription\n - Friends, Young Friends, Family, Corporate, Research Fellow\n \n2. **PATRON_***\
\ - High-value donor circles\n - Circle, Benefactor, Founders Circle, Life, National\n \n3. **ADOPTION_*** - Object\
\ sponsorship\n - Book, Artifact, Archive Collection, Artwork, Animal, Plant\n \n4. **LEGACY_*** - Planned/estate\
\ giving\n - Bequest, Charitable Trust, Endowment, Named Fund\n \n5. **DONATION_*** - Direct monetary gifts\n \
\ - One-off, Recurring, Appeal, Project, Tax Incentive\n \n6. **INKIND_*** - Non-monetary contributions\n - Object,\
\ Artwork, Archive, Library Collection, Expertise, Volunteer\n \n7. **SPONSORSHIP_*** - Corporate/event support\n\
\ - Exhibition, Gallery, Event, Program, Digitization, Conservation\n \n8. **CROWDFUNDING_*** - Campaign-based collective\
\ funding\n - Acquisition, Conservation, Building, Exhibition\n\n**EXTRACTION PATTERN**:\n\nWhen extracting donation\
\ schemes from institutional websites:\n\n1. Create WebObservation for the support/donate page\n2. For each scheme found:\n\
\ - Create DonationScheme with observed_in → WebObservation\n - Classify using DonationSchemeTypeEnum\n - Extract\
\ financial details (amounts, currency, frequency)\n - List benefits provided to donors\n - Note tax deductibility\
\ and applicable schemes\n - Assign extraction_confidence based on clarity\n\n**EXAMPLES**:\n\nSee class examples\
\ section for detailed instances.\n"
exact_mappings:
- schema:DonateAction
close_mappings:
- schema:Offer
- org:Membership
- schema:MemberProgramTier
related_mappings:
- dcterms:isPartOf
- prov:wasDerivedFrom
- schema:priceSpecification
- schema:itemOffered
slots:
- benefit
- contact_email
- currency
- extraction_confidence
- extraction_note
- maximum_amount
- minimum_amount
- observed_in
- offered_by
- payment_frequency
- scheme_description
- scheme_id
- scheme_name
- scheme_type
- scheme_url
- specificity_annotation
- tax_deductible
- tax_scheme
- template_specificity
- valid_from
- valid_to
slot_usage:
scheme_id:
identifier: true
required: true
range: uriorcurie
pattern: ^https://nde\.nl/ontology/hc/donation-scheme/[a-z0-9-]+/[a-z0-9-]+$
examples:
- value: https://nde.nl/ontology/hc/donation-scheme/rijksmuseum/vrienden
description: Rijksmuseum Friends membership scheme
- value: https://nde.nl/ontology/hc/donation-scheme/british-library/adopt-a-book
description: British Library Adopt-a-Book program
- value: https://nde.nl/ontology/hc/donation-scheme/nhm-london/patrons-silver
description: Natural History Museum Silver Patron tier
scheme_type:
required: true
range: DonationSchemeTypeEnum
examples:
- value: MEMBERSHIP_FRIENDS
description: Standard friends/membership scheme
- value: ADOPTION_BOOK
description: Adopt-a-book conservation program
- value: PATRON_CIRCLE
description: High-value patron circle with tiered benefits
- value: LEGACY_BEQUEST
description: Gift through will/estate
scheme_name:
required: true
range: string
examples:
- value: Rijksmuseum Vrienden
description: Dutch museum friends scheme
- value: Adopt a Book
description: Book sponsorship program
- value: Director's Circle
description: High-level patron program
- value: Amis du Louvre
description: French museum friends society
scheme_description:
range: string
examples:
- value: Become a Friend of the Rijksmuseum and enjoy unlimited free entry, exclusive member events, and a 10% discount
in the museum shop.
description: Membership scheme description
- value: Your adoption supports the conservation of fragile historic books. Choose a book to adopt and receive a certificate
and bookplate.
description: Adoption scheme description
minimum_amount:
range: decimal
examples:
- value: 60
description: €60 annual membership
- value: 25
description: £25 minimum book adoption
- value: 1500
description: £1,500 patron circle entry
maximum_amount:
range: decimal
examples:
- value: 4999
description: Silver tier up to £4,999
- value: 12000
description: Gold tier up to £12,000
currency:
range: string
examples:
- value: EUR
description: Euro
- value: GBP
description: British Pound
- value: USD
description: US Dollar
payment_frequency:
range: string
examples:
- value: one-time
description: Single donation
- value: monthly
description: Monthly recurring
- value: annually
description: Annual membership/renewal
- value: life
description: One-time payment for lifetime benefits
benefit:
range: string
multivalued: true
examples:
- value: Free unlimited admission
description: Entry benefit
- value: 10% discount in museum shop
description: Retail benefit
- value: Member-only preview events
description: Event benefit
- value: Quarterly newsletter
description: Communication benefit
- value: Bookplate with donor name
description: Recognition benefit
offered_by:
required: true
range: uriorcurie
examples:
- value: https://nde.nl/ontology/hc/custodian/nl/rijksmuseum
description: Rijksmuseum
- value: https://nde.nl/ontology/hc/custodian/uk/british-library
description: British Library
scheme_url:
range: uri
examples:
- value: https://www.rijksmuseum.nl/nl/steun-het-rijksmuseum/word-vriend
description: Rijksmuseum Vrienden page
- value: https://support.bl.uk/Page/Adopt-a-book
description: British Library adoption page
tax_deductible:
range: boolean
examples:
- value: true
description: Donations are tax-deductible
- value: false
description: Not tax-deductible (e.g., membership with significant benefits)
tax_scheme:
range: string
examples:
- value: ANBI
description: Dutch general public benefit institution
- value: Cultural ANBI (125%)
description: Dutch cultural institution with extra deduction
- value: Gift Aid
description: UK Gift Aid scheme
- value: 501(c)(3)
description: US tax-exempt charitable organization
- value: Gemeinnützigkeit
description: German charitable status
contact_email:
range: string
examples:
- value: vrienden@rijksmuseum.nl
description: Friends scheme contact
- value: development@bl.uk
description: Development office
observed_in:
required: true
range: uriorcurie
examples:
- value: https://nde.nl/ontology/hc/observation/web/2026-01-01/rijksmuseum-support
description: Observation of Rijksmuseum support page
extraction_confidence:
range: float
minimum_value: 0.0
maximum_value: 1.0
examples:
- value: 0.95
description: Clear scheme page with pricing table
- value: 0.75
description: Benefits clear but pricing requires inquiry
- value: 0.6
description: Scheme mentioned but details unclear
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
comments:
- Each scheme links to WebObservation for full provenance chain
- Tax deductibility varies by jurisdiction - always document tax_scheme
- Benefits should be extracted as discrete items for comparison
- Tiered schemes (e.g., Silver/Gold/Platinum) are separate DonationScheme instances
- Use payment_frequency to distinguish one-time vs recurring schemes
see_also:
- https://schema.org/DonateAction
- https://schema.org/MemberProgramTier
- https://www.w3.org/ns/org#Membership
- https://www.belastingdienst.nl/wps/wcm/connect/nl/aftrek-en-kortingen/content/gift-aftrekken
- https://www.gov.uk/donating-to-charity/gift-aid
examples:
- value:
scheme_id: https://nde.nl/ontology/hc/donation-scheme/rijksmuseum/vrienden
scheme_type: MEMBERSHIP_FRIENDS
scheme_name: Rijksmuseum Vrienden
scheme_description: Word Vriend van het Rijksmuseum en geniet van gratis toegang, exclusieve evenementen en 10% korting
in de museumwinkel.
minimum_amount: 60
currency: EUR
payment_frequency: annually
benefit:
- Gratis onbeperkt toegang
- Exclusieve vriendenevenementen
- 10% korting in de museumwinkel
- Kwartaalnieuwsbrief
offered_by: https://nde.nl/ontology/hc/custodian/nl/rijksmuseum
scheme_url: https://www.rijksmuseum.nl/nl/steun-het-rijksmuseum/word-vriend
tax_deductible: true
tax_scheme: Cultural ANBI (125%)
observed_in: https://nde.nl/ontology/hc/observation/web/2026-01-01/rijksmuseum-support
extraction_confidence: 0.95
extraction_notes: Clear scheme page with pricing and benefits listed.
description: Rijksmuseum Friends membership scheme (Netherlands)
- value:
scheme_id: https://nde.nl/ontology/hc/donation-scheme/british-library/adopt-a-book
scheme_type: ADOPTION_BOOK
scheme_name: Adopt a Book
scheme_description: Help preserve the nation's written heritage by adopting a book. Your donation funds conservation
work on fragile historic books and manuscripts in the British Library collection.
minimum_amount: 25
currency: GBP
payment_frequency: one-time
benefit:
- Certificate of adoption
- Bookplate with your name in the book
- Digital image of your adopted book
- Conservation report
offered_by: https://nde.nl/ontology/hc/custodian/uk/british-library
scheme_url: https://support.bl.uk/Page/Adopt-a-book
tax_deductible: true
tax_scheme: Gift Aid
observed_in: https://nde.nl/ontology/hc/observation/web/2026-01-01/bl-support
extraction_confidence: 0.98
extraction_notes: Well-documented scheme with clear tiers and benefits.
description: British Library Adopt-a-Book program (UK)
- value:
scheme_id: https://nde.nl/ontology/hc/donation-scheme/nhm-london/patrons-silver
scheme_type: PATRON_CIRCLE
scheme_name: Natural History Museum Patrons - Silver
scheme_description: Join the Silver level of our Patrons programme and enjoy exclusive behind-the-scenes access, curator-led
tours, and invitations to special events throughout the year.
minimum_amount: 1500
maximum_amount: 4999
currency: GBP
payment_frequency: annually
benefit:
- Behind-the-scenes tours
- Curator-led collection visits
- Patron-only evening events
- Recognition in annual report
- Two guest passes per visit
offered_by: https://nde.nl/ontology/hc/custodian/uk/nhm-london
scheme_url: https://www.nhm.ac.uk/support-us/patrons
tax_deductible: true
tax_scheme: Gift Aid
observed_in: https://nde.nl/ontology/hc/observation/web/2026-01-01/nhm-patrons
extraction_confidence: 0.92
extraction_notes: Three-tier patron program. Silver is entry level.
description: Natural History Museum Silver Patron tier (UK)
- value:
scheme_id: https://nde.nl/ontology/hc/donation-scheme/iish/adopt-history
scheme_type: ADOPTION_ARCHIVE_COLLECTION
scheme_name: Adopt History
scheme_description: Adopt a historical document from the IISH collection and help preserve social history. Your adoption
supports digitization and conservation of labor movement archives.
minimum_amount: 150
currency: EUR
payment_frequency: one-time
benefit:
- Adoption certificate
- Digital copy of document
- Name on website donor wall
- Behind-the-scenes tour invitation
offered_by: https://nde.nl/ontology/hc/custodian/nl/iish
scheme_url: https://iisg.amsterdam/en/support/adopt-history
tax_deductible: true
tax_scheme: ANBI
observed_in: https://nde.nl/ontology/hc/observation/web/2026-01-01/iish-support
extraction_confidence: 0.9
extraction_notes: Archive document adoption with flexible donation levels.
description: IISH Adopt History program for archival documents (Netherlands)
- value:
scheme_id: https://nde.nl/ontology/hc/donation-scheme/kb-nl/legacy
scheme_type: LEGACY_BEQUEST
scheme_name: Nalatenschap aan de KB
scheme_description: Overweeg een nalatenschap aan de Koninklijke Bibliotheek en help de nationale bibliotheekcollectie
voor toekomstige generaties te bewaren.
minimum_amount: null
currency: EUR
payment_frequency: one-time
benefit:
- Persoonlijk gesprek met directie
- Erkenning in jaarverslag (optioneel)
- Nalatenschap volledig naar collectie
offered_by: https://nde.nl/ontology/hc/custodian/nl/kb
scheme_url: https://www.kb.nl/over-ons/steun-de-kb/nalatenschap
tax_deductible: true
tax_scheme: ANBI (erfbelasting vrijstelling)
contact_email: ontwikkeling@kb.nl
observed_in: https://nde.nl/ontology/hc/observation/web/2026-01-01/kb-support
extraction_confidence: 0.85
extraction_notes: Legacy giving page with limited detail. Estate tax benefits apply.
description: Koninklijke Bibliotheek legacy giving (Netherlands)