glam/schemas/20251121/linkml/modules/classes/Budget.yaml
kempersc 174a420c08
All checks were successful
Deploy Frontend / build-and-deploy (push) Successful in 3m57s
refactor(schema): centralize 1515 inline slot definitions per Rule 48
- Remove inline slot definitions from 144 class files
- Create 7 new centralized slot files in modules/slots/:
  - custodian_type_broader.yaml
  - custodian_type_narrower.yaml
  - custodian_type_related.yaml
  - definition.yaml
  - finding_aid_access_restriction.yaml
  - finding_aid_description.yaml
  - finding_aid_temporal_coverage.yaml
- Add centralize_inline_slots.py automation script
- Update manifest with new timestamp

Rule 48: Class files must NOT define inline slots - all slots
must be imported from modules/slots/ directory.

Note: Pre-existing IdentifierFormat duplicate class definition
(in Standard.yaml and IdentifierFormat.yaml) not addressed in
this commit - requires separate schema refactor.
2026-01-11 22:02:14 +01:00

692 lines
19 KiB
YAML

id: https://nde.nl/ontology/hc/class/Budget
name: budget_class
title: Budget Class
imports:
- linkml:types
- ./Custodian
- ./CustodianObservation
- ./ReconstructionActivity
- ./TimeSpan
- ./OrganizationalStructure
- ./ReconstructedEntity
- ../slots/revision_date
- ../slots/has_approval_date
- ../slots/has_or_had_acquisition_budget
- ../slots/approved_by
- ../slots/budget_currency
- ../slots/budget_description
- ../slots/budget_name
- ../slots/budget_status
- ../slots/budget_type
- ../slots/capital_budget
- ../slots/digitization_budget
- ../slots/documented_by
- ../slots/endowment_draw
- ../slots/external_funding
- ../slots/fiscal_year_end
- ../slots/fiscal_year_start
- ../slots/id
- ../slots/innovation_budget
- ../slots/internal_funding
- ../slots/managing_unit
- ../slots/operating_budget
- ../slots/personnel_budget
- ../slots/preservation_budget
- ../slots/refers_to_custodian
- ../slots/revision_number
- ../slots/specificity_annotation
- ../slots/template_specificity
- ../slots/total_budget_amount
- ../slots/valid_from
- ../slots/valid_to
- ../slots/was_derived_from
- ../slots/was_generated_by
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
- ../slots/was_approved_by
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
dcterms: http://purl.org/dc/terms/
rico: https://www.ica.org/standards/RiC/ontology#
prov: http://www.w3.org/ns/prov#
time: http://www.w3.org/2006/time#
org: http://www.w3.org/ns/org#
schema: http://schema.org/
frapo: http://purl.org/cerif/frapo/
classes:
Budget:
is_a: ReconstructedEntity
class_uri: frapo:FundingProgramme
description: "Represents an annual or multi-year BUDGET for a heritage custodian institution.\n\n**CRITICAL DISTINCTION\
\ - BUDGET vs. FINANCIAL STATEMENT**:\n\n| Budget | FinancialStatement |\n|--------|-------------------|\n| **PLAN**\
\ - intended allocations | **ACTUALS** - what actually happened |\n| Forward-looking | Backward-looking |\n| Approved\
\ by governance | Audited/reviewed |\n| May be revised during period | Final (unalterable after close) |\n| Internal\
\ planning document | External reporting document |\n\n**WHY MODEL BUDGETS FOR HERITAGE CUSTODIANS?**:\n\nUnderstanding\
\ custodian budgets is critical for:\n\n1. **Sustainability Assessment**: Is the institution financially viable?\n2.\
\ **Collection Development**: Budget allocations for acquisitions\n3. **Preservation Capacity**: Funding for conservation\
\ and digitization\n4. **Staffing Levels**: Personnel budget indicates operational capacity\n5. **Grant Planning**:\
\ Understanding baseline funding for grant applications\n6. **Partnership Potential**: Assessing capacity for collaborative\
\ projects\n\n**BUDGET TYPES FOR HERITAGE INSTITUTIONS**:\n\n- **Operating Budget**: Day-to-day operations (staff, utilities,\
\ supplies)\n- **Capital Budget**: Major investments (building, equipment, systems)\n- **Acquisition Budget**: Collection\
\ purchases and donations\n- **Project Budget**: Time-limited initiatives (digitization, exhibitions)\n- **Endowment\
\ Draw**: Spending from endowment principal/income\n\n**TEMPORAL PATTERN**:\n\nBudgets typically follow fiscal year\
\ cycles:\n- Calendar year (Jan-Dec): Common in private sector\n- Academic year: Universities, education providers\n\
- Government fiscal year: Varies by country (e.g., Apr-Mar in UK, Oct-Sep in US federal)\n\n**NONPROFIT/FOUNDATION CONTEXT**:\n\
\nHeritage custodians are predominantly nonprofits:\n- Netherlands: \"stichting\" (foundation), \"vereniging\" (association)\n\
- USA: 501(c)(3) organizations\n- UK: Charities, CICs\n\nBudget transparency is often legally required for nonprofits\
\ (Form 990, ANBI status).\n\n- **FRAPO** (Funding, Research Administration and Projects Ontology):\n - frapo:FundingProgramme\
\ for budget allocation\n - frapo:hasFunding for monetary amounts\n- **Schema.org**:\n - schema:MonetaryAmount for\
\ currency values\n - schema:Grant for external funding\n- **FIBO** (Financial Industry Business Ontology):\n - Provides\
\ sophisticated financial modeling (via Commons Ontology)\n"
exact_mappings:
- frapo:FundingProgramme
close_mappings:
- schema:FinancialProduct
- crm:E54_Dimension
related_mappings:
- schema:MonetaryAmount
- frapo:hasFunding
slots:
- has_or_had_acquisition_budget
- has_approval_date
- approved_by
- budget_currency
- budget_description
- budget_name
- budget_status
- budget_type
- capital_budget
- digitization_budget
- documented_by
- endowment_draw
- external_funding
- fiscal_year_end
- fiscal_year_start
- id
- innovation_budget
- internal_funding
- managing_unit
- operating_budget
- personnel_budget
- preservation_budget
- refers_to_custodian
- revision_date
- revision_number
- specificity_annotation
- template_specificity
- total_budget_amount
- valid_from
- valid_to
- was_derived_from
- was_generated_by
slot_usage:
id:
identifier: true
required: true
description: 'Unique identifier for this budget (URI).
Format: https://nde.nl/ontology/hc/budget/{custodian-id}/{fiscal-year}
'
budget_name:
slot_uri: dcterms:title
range: string
required: true
description: 'Name/title for this budget.
**Examples**:
- "Rijksmuseum Operating Budget FY2024"
- "Noord-Hollands Archief Annual Budget 2024-2025"
- "Wallace Collection Capital Plan 2024-2028"
'
budget_description:
slot_uri: dcterms:description
range: string
required: false
description: 'Narrative description of budget scope, priorities, and key allocations.
'
budget_type:
slot_uri: dcterms:type
range: string
multivalued: true
required: true
description: 'Type(s) of budget.
**Values**:
- OPERATING: Day-to-day operations
- CAPITAL: Major investments
- PROJECT: Time-limited initiative
- MULTI_YEAR: Spanning multiple fiscal years
- CONSOLIDATED: Institution-wide (all departments)
- DEPARTMENTAL: Single department/unit
'
examples:
- value:
- OPERATING
- CONSOLIDATED
description: Institution-wide operating budget
fiscal_year_start:
slot_uri: time:hasBeginning
range: date
required: true
description: 'Start date of fiscal year covered by this budget.
**Common patterns**:
- Calendar year: 2024-01-01
- UK government: 2024-04-01
- US federal: 2023-10-01 (for FY2024)
- Academic: 2024-09-01
'
fiscal_year_end:
slot_uri: time:hasEnd
range: date
required: true
description: 'End date of fiscal year covered by this budget.
'
total_budget_amount:
slot_uri: schema:amount
range: decimal
required: false
description: 'Total budget amount (sum of all categories).
**Schema.org**: schema:amount for monetary values.
Express in budget_currency units.
'
examples:
- value: 45000000.0
description: EUR 45 million annual budget
budget_currency:
slot_uri: schema:currency
range: string
required: true
description: 'Currency for all monetary amounts in this budget.
**ISO 4217 codes**: EUR, USD, GBP, etc.
**Schema.org**: schema:currency for currency designation.
'
examples:
- value: EUR
description: Euro currency
- value: USD
description: US Dollar currency
operating_budget:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'Operating budget allocation (day-to-day operations).
**FRAPO**: frapo:hasFunding for funding amounts.
Typically includes:
- Personnel costs
- Utilities
- Supplies
- Maintenance
- Marketing
'
capital_budget:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'Capital budget allocation (major investments).
Typically includes:
- Building construction/renovation
- Major equipment
- IT systems
- Infrastructure
'
has_or_had_acquisition_budget:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'Collection acquisition budget.
**Heritage-specific**: Budget for purchasing or acquiring
heritage materials (artworks, documents, objects).
May be supplemented by:
- Donor-funded acquisitions
- Government grants
- Deaccessioning proceeds (where permitted)
'
personnel_budget:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'Personnel budget allocation.
Includes:
- Salaries and wages
- Benefits
- Pension contributions
- Contract staff
Often 50-70% of operating budget for heritage institutions.
'
preservation_budget:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'Conservation and preservation budget.
**Heritage-specific**: Budget for maintaining and conserving
heritage collections.
Includes:
- Conservation treatments
- Preventive conservation
- Environmental controls
- Pest management
'
digitization_budget:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'Digitization budget allocation.
**Heritage-specific**: Budget for creating digital surrogates
of physical collections.
Includes:
- Equipment
- Staff/contractors
- Storage infrastructure
- Metadata creation
'
innovation_budget:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'Innovation budget allocation.
**Heritage-specific**: Budget for innovation projects that transform
how the institution operates, preserves, or provides access to heritage.
Includes:
- Digital transformation initiatives
- R&D and experimental programs
- New technology adoption (AI, machine learning, etc.)
- Process automation and improvement
- Visitor experience innovation
- Collection management system upgrades
- Data infrastructure modernization
**Distinct from digitization_budget**: Innovation focuses on transforming
processes and capabilities, while digitization focuses on creating
digital surrogates of physical collections.
**Examples**:
- AI-powered cataloging systems
- Virtual/augmented reality experiences
- Automated conservation monitoring
- Linked open data infrastructure
'
external_funding:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'External funding included in budget.
Sources:
- Government subsidies
- Grants
- Corporate sponsorship
- Donations
Typically must be distinguished for reporting purposes.
'
internal_funding:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'Internal/earned revenue included in budget.
Sources:
- Admission fees
- Merchandise sales
- Venue rental
- Licensing fees
- Membership dues
'
endowment_draw:
slot_uri: frapo:hasFunding
range: decimal
required: false
description: 'Endowment draw/spend rate.
**Nonprofit-specific**: Amount drawn from endowment
principal or income for operations.
Typically governed by spending policy (e.g., 5% rule).
'
has_approval_date:
slot_uri: dcterms:dateAccepted
range: date
required: false
description: 'Date when budget was approved by governance body.
**Dublin Core**: dcterms:dateAccepted for approval.
'
was_approved_by:
slot_uri: prov:wasAttributedTo
range: string
required: false
description: 'Governance body or authority that approved budget.
**Examples**:
- "Board of Directors"
- "Executive Committee"
- "Ministry of Culture"
- "City Council"
'
budget_status:
slot_uri: schema:eventStatus
range: string
required: true
description: 'Current status of this budget.
**Values**:
- DRAFT: Under development
- PROPOSED: Submitted for approval
- APPROVED: Officially approved
- ACTIVE: Currently in effect
- REVISED: Modified after approval
- CLOSED: Fiscal period ended
'
examples:
- value: ACTIVE
description: Current fiscal year budget in effect
revision_number:
slot_uri: dcterms:hasVersion
range: integer
required: false
description: 'Version number if budget has been revised.
Initial budget = 0, first revision = 1, etc.
'
revision_date:
slot_uri: dcterms:modified
range: date
required: false
description: 'Date of most recent budget revision.
'
managing_unit:
slot_uri: org:unitOf
range: OrganizationalStructure
required: false
description: 'Organizational unit responsible for this budget.
For DEPARTMENTAL budgets: the department
For CONSOLIDATED budgets: Finance department or executive office
'
documented_by:
slot_uri: rico:isDocumentedBy
range: uriorcurie
multivalued: true
required: false
description: 'FinancialStatement(s) that document actual performance against this budget.
**RiC-O**: rico:isDocumentedBy for documentation relationship.
**Inverse**: FinancialStatement.documents_budget
Links to:
- Annual reports
- Quarterly financial statements
- Audit reports
- Form 990 (US nonprofits)
'
refers_to_custodian:
slot_uri: crm:P46i_forms_part_of
range: Custodian
required: true
description: 'Links this budget to the Custodian hub.
**CIDOC-CRM**: P46i_forms_part_of for part-whole.
'
was_derived_from:
slot_uri: prov:wasDerivedFrom
range: CustodianObservation
multivalued: true
required: false
description: 'Observation(s) from which this budget was derived.
**PROV-O**: prov:wasDerivedFrom for provenance.
'
was_generated_by:
slot_uri: prov:wasGeneratedBy
range: ReconstructionActivity
required: false
description: 'Reconstruction activity that generated this record.
**PROV-O**: prov:wasGeneratedBy for generation.
'
valid_from:
slot_uri: time:hasBeginning
range: date
required: false
description: 'Start of validity period (typically = fiscal_year_start).
'
valid_to:
slot_uri: time:hasEnd
range: date
required: false
description: 'End of validity period (typically = fiscal_year_end).
'
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
comments:
- Represents PLANNED financial allocations (not actuals)
- 'Heritage-specific categories: acquisition, preservation, digitization budgets'
- Links to FinancialStatement via documented_by inverse relationship
- FRAPO frapo:FundingProgramme as primary ontology class
- Budget transparency often legally required for nonprofits
see_also:
- http://purl.org/cerif/frapo/FundingProgramme
- https://schema.org/FinancialStatement
- https://nde.nl/ontology/hc/class/Custodian
examples:
- value:
id: https://nde.nl/ontology/hc/budget/rm/fy2024
budget_name: Rijksmuseum Operating Budget FY2024
budget_description: Annual operating budget for fiscal year 2024, including major exhibition initiatives and digitization
expansion.
budget_type:
- OPERATING
- CONSOLIDATED
fiscal_year_start: '2024-01-01'
fiscal_year_end: '2024-12-31'
total_budget_amount: 45000000.0
budget_currency: EUR
operating_budget: 38000000.0
capital_budget: 3000000.0
acquisition_budget: 2000000.0
personnel_budget: 22000000.0
preservation_budget: 1500000.0
digitization_budget: 500000.0
innovation_budget: 750000.0
external_funding: 15000000.0
internal_funding: 25000000.0
endowment_draw: 5000000.0
approval_date: '2023-11-15'
approved_by: Board of Directors
budget_status: ACTIVE
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Major museum annual operating budget
- value:
id: https://nde.nl/ontology/hc/budget/nha/fy2024-2025
budget_name: Noord-Hollands Archief Annual Budget 2024-2025
budget_description: Provincial archive annual budget aligned with government fiscal year.
budget_type:
- OPERATING
- CONSOLIDATED
fiscal_year_start: '2024-04-01'
fiscal_year_end: '2025-03-31'
total_budget_amount: 8500000.0
budget_currency: EUR
operating_budget: 7500000.0
capital_budget: 500000.0
personnel_budget: 5200000.0
digitization_budget: 800000.0
external_funding: 6000000.0
internal_funding: 2500000.0
approval_date: '2024-03-01'
approved_by: Province of Noord-Holland
budget_status: ACTIVE
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-haa-a-nha
description: Regional archive government-funded budget