glam/schemas/20251121/linkml/modules/classes/DonationScheme.yaml
kempersc 626bd3a095 refactor(schemas): apply naming conventions to 261 class files
- Apply Rule 39: RiC-O style hasOrHad*/isOrWas* for temporal slots
- Apply Rule 43: Singular noun convention (keywords → keyword)
- Update slot references to match renamed slot files
- Maintain schema integrity across all class definitions
2026-01-10 15:36:33 +01:00

548 lines
24 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
slots:
scheme_id:
identifier: true
range: uriorcurie
description: Unique identifier for this donation scheme
scheme_type:
range: DonationSchemeTypeEnum
description: Category of donation scheme (membership, patron, adoption, legacy,
etc.)
scheme_name:
range: string
description: Human-readable name of the donation scheme
scheme_description:
range: string
description: Description of the scheme including purpose and how it works
minimum_amount:
range: decimal
description: Minimum donation amount for this scheme
maximum_amount:
range: decimal
description: Maximum donation amount (if capped) for this scheme
currency:
range: string
description: ISO 4217 currency code for amounts (EUR, GBP, USD, etc.)
payment_frequency:
range: string
description: How often payment is made (one-time, monthly, annually)
benefit:
range: string
multivalued: true
description: List of benefits provided to donors in this scheme
offered_by:
range: uriorcurie
description: Heritage custodian that offers this donation scheme
scheme_url:
range: uri
description: URL to the donation scheme webpage
tax_deductible:
range: boolean
description: Whether donations to this scheme are tax-deductible
tax_scheme:
range: string
description: |
Tax scheme applicable (e.g., ANBI, Gift Aid, 501(c)(3)).
Multiple schemes may apply (e.g., ANBI + Cultural ANBI in NL)
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.\n\
These range from simple one-time donations to complex membership programs,\n\
adoption 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\nMany 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
description: |
Unique identifier for this donation scheme.
Format: https://nde.nl/ontology/hc/donation-scheme/{custodian-slug}/{scheme-slug}
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:
slot_uri: dcterms:type
required: true
range: DonationSchemeTypeEnum
description: |
Category of donation scheme from DonationSchemeTypeEnum.
Enables filtering and comparison of schemes across institutions.
See enum documentation for full category list with ~50 types.
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:
slot_uri: schema:name
required: true
range: string
description: |
Human-readable name of the donation scheme as presented by institution.
Preserve original language and branding.
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:
slot_uri: schema:description
range: string
description: |
Description of the scheme including purpose, requirements, and process.
Extract from institutional website or promotional materials.
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:
slot_uri: schema:minPrice
range: decimal
description: |
Minimum donation amount required to participate in this scheme.
For tiered schemes, use the entry-level amount.
examples:
- value: 60
description: €60 annual membership
- value: 25
description: £25 minimum book adoption
- value: 1500
description: £1,500 patron circle entry
maximum_amount:
slot_uri: schema:maxPrice
range: decimal
description: |
Maximum amount for this scheme tier (if applicable).
Helps distinguish between tiered patron levels.
examples:
- value: 4999
description: Silver tier up to £4,999
- value: 12000
description: Gold tier up to £12,000
currency:
slot_uri: schema:priceCurrency
range: string
description: |
ISO 4217 currency code for the amount fields.
Required if minimum_amount or maximum_amount is specified.
examples:
- value: EUR
description: Euro
- value: GBP
description: British Pound
- value: USD
description: US Dollar
payment_frequency:
range: string
description: |
How often payment is made for recurring schemes.
Use standardized values for queryability.
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:
slot_uri: schema:itemOffered
range: string
multivalued: true
description: |
List of benefits provided to donors participating in this scheme.
Extract key benefits as discrete items.
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:
slot_uri: schema:offeredBy
required: true
range: uriorcurie
description: |
Heritage custodian that offers this donation scheme.
Links to HeritageCustodian entity.
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:
slot_uri: schema:url
range: uri
description: |
URL to the donation scheme webpage on institutional website.
Primary source for extraction and verification.
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
description: |
Whether donations to this scheme are tax-deductible for donors.
Jurisdiction-specific; document applicable scheme in tax_scheme.
examples:
- value: true
description: Donations are tax-deductible
- value: false
description: Not tax-deductible (e.g., membership with significant benefits)
tax_scheme:
range: string
description: |
Tax scheme(s) applicable to donations. Multiple may apply.
Document country-specific scheme names.
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:
slot_uri: schema:email
range: string
description: |
Contact email for inquiries about this donation scheme.
May be general development office or scheme-specific.
examples:
- value: vrienden@rijksmuseum.nl
description: Friends scheme contact
- value: development@bl.uk
description: Development office
observed_in:
slot_uri: prov:wasDerivedFrom
required: true
range: uriorcurie
description: |
WebObservation documenting where this scheme was found.
Links scheme to its provenance:
- Source URL
- Retrieval timestamp
- Extraction method
- Original content
PROV-O: prov:wasDerivedFrom links Entity to Activity
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
description: |
Confidence score for this scheme extraction (0.0-1.0).
Higher confidence for clearly presented schemes with explicit
pricing and benefits; lower for schemes requiring inference.
Interpretation:
- 0.9-1.0: Clear pricing, benefits, and scheme structure
- 0.7-0.9: Most details clear, some inference required
- 0.5-0.7: Partial information, verification recommended
- <0.5: Uncertain, needs manual verification
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)