437 lines
16 KiB
YAML
437 lines
16 KiB
YAML
# MissionStatement Class
|
|
# Models mission, vision, and goal statements from heritage custodian websites
|
|
#
|
|
# Created December 2025 to capture organizational purpose with full provenance:
|
|
# - Mission statements (core purpose/raison d'être)
|
|
# - Vision statements (aspirational future state)
|
|
# - Goal/objective statements (specific measurable aims)
|
|
#
|
|
# Key principle:
|
|
# Mission statements MUST have verifiable provenance linking to the source webpage.
|
|
# Following the WebObservation pattern, claims without source documentation are rejected.
|
|
#
|
|
# Ontology Alignment:
|
|
# - W3C Org: org:purpose (primary)
|
|
# - Schema.org: schema:description (for text content)
|
|
# - PROV-O: prov:Entity (for provenance chain)
|
|
# - PAV: pav:retrievedFrom, pav:retrievedOn (for web source tracking)
|
|
#
|
|
# The org:purpose property from W3C Organization Ontology:
|
|
# "Indicates the purpose of this Organization. There can be many purposes at
|
|
# different levels of abstraction but the nature of an organization is to have
|
|
# a reason for existence and this property is a means to document that reason."
|
|
|
|
id: https://nde.nl/ontology/hc/class/MissionStatement
|
|
name: MissionStatement
|
|
title: MissionStatement Class - Organizational Purpose Documentation
|
|
|
|
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/
|
|
org: http://www.w3.org/ns/org#
|
|
xsd: http://www.w3.org/2001/XMLSchema#
|
|
oa: http://www.w3.org/ns/oa#
|
|
|
|
imports:
|
|
- linkml:types
|
|
- ../slots/source_url
|
|
- ../slots/retrieved_on
|
|
|
|
default_prefix: hc
|
|
|
|
enums:
|
|
StatementTypeEnum:
|
|
description: |
|
|
Types of organizational purpose statements.
|
|
Heritage custodians often publish distinct mission, vision, and goal statements,
|
|
each serving different communicative functions.
|
|
permissible_values:
|
|
mission:
|
|
description: |
|
|
Core purpose statement - why the organization exists.
|
|
Answers: "What do we do and for whom?"
|
|
Often includes: scope, audience, unique value proposition.
|
|
Dutch: "missie"
|
|
meaning: org:purpose
|
|
comments:
|
|
- "Primary statement of organizational raison d'être"
|
|
- "Usually 1-3 sentences"
|
|
- "Present-tense, action-oriented"
|
|
vision:
|
|
description: |
|
|
Aspirational future state - what the organization aims to achieve.
|
|
Answers: "What will the world look like if we succeed?"
|
|
Dutch: "visie"
|
|
meaning: schema:seeks
|
|
comments:
|
|
- "Forward-looking, inspirational"
|
|
- "Often begins with 'To be...' or 'We envision...'"
|
|
- "Longer time horizon than mission"
|
|
goal:
|
|
description: |
|
|
Specific measurable objective - concrete aims.
|
|
Answers: "What specific outcomes do we pursue?"
|
|
Dutch: "doelstelling", "doel"
|
|
meaning: schema:seeks
|
|
comments:
|
|
- "More specific than mission/vision"
|
|
- "Often time-bound or measurable"
|
|
- "May have multiple goals listed"
|
|
value:
|
|
description: |
|
|
Core organizational values - guiding principles.
|
|
Answers: "What principles guide our work?"
|
|
Dutch: "waarden", "kernwaarden"
|
|
meaning: schema:ethicsPolicy
|
|
comments:
|
|
- "Often expressed as single words or phrases"
|
|
- "Examples: integrity, accessibility, inclusivity"
|
|
motto:
|
|
description: |
|
|
Short memorable phrase encapsulating purpose.
|
|
Often used in branding/marketing.
|
|
Dutch: "motto", "slagzin"
|
|
meaning: schema:slogan
|
|
comments:
|
|
- "Very brief (3-10 words typically)"
|
|
- "May be poetic or alliterative"
|
|
- "Example: 'Waar komt ons voedsel écht vandaan'"
|
|
|
|
slots:
|
|
statement_id:
|
|
identifier: true
|
|
range: uriorcurie
|
|
description: Unique identifier for this mission statement record
|
|
|
|
statement_type:
|
|
range: StatementTypeEnum
|
|
required: true
|
|
description: |
|
|
Type of organizational purpose statement (mission, vision, goal, value, motto).
|
|
Determines semantic interpretation and ontology mapping.
|
|
|
|
statement_text:
|
|
range: string
|
|
required: true
|
|
description: |
|
|
The actual statement text as extracted from the source.
|
|
Should preserve original language and formatting where practical.
|
|
For Dutch heritage custodians, typically in Dutch.
|
|
|
|
statement_language:
|
|
range: string
|
|
description: |
|
|
ISO 639-1 language code for the statement text.
|
|
Examples: "nl" (Dutch), "en" (English), "de" (German)
|
|
pattern: "^[a-z]{2}$"
|
|
|
|
statement_summary:
|
|
range: string
|
|
description: |
|
|
Optional English summary/translation for non-English statements.
|
|
Useful for international discoverability.
|
|
|
|
# NOTE: source_url imported from global slot ../slots/source_url.yaml
|
|
# NOTE: retrieved_on imported from global slot ../slots/retrieved_on.yaml
|
|
|
|
page_section:
|
|
range: string
|
|
description: |
|
|
Section or heading on the web page where statement was found.
|
|
Examples: "Onze Missie", "Vision Statement", "About Us"
|
|
|
|
xpath:
|
|
range: string
|
|
description: |
|
|
XPath to the element containing this statement in archived HTML.
|
|
Required for full provenance verification.
|
|
Format: Standard XPath 1.0 expression
|
|
pattern: "^/.*"
|
|
|
|
css_selector:
|
|
range: string
|
|
description: |
|
|
CSS selector for the statement element (alternative to xpath).
|
|
May be easier to maintain for dynamic pages.
|
|
|
|
html_file:
|
|
range: string
|
|
description: |
|
|
Relative path to the archived HTML file containing this statement.
|
|
Path is relative to the custodian data file.
|
|
Example: web/NL-ZH-ZUI-M-LMT/landbouwmuseumtiengemeten.nl/missie-en-visie/rendered.html
|
|
|
|
content_hash:
|
|
range: string
|
|
description: |
|
|
SHA-256 hash of the statement text for integrity verification.
|
|
Format: sha256-{base64_hash} (SRI format)
|
|
pattern: "^sha256-[A-Za-z0-9+/=]+$"
|
|
|
|
text_fragment:
|
|
range: uri
|
|
description: |
|
|
W3C Text Fragment URL pointing to exact text in the source page.
|
|
Format: {source_url}#:~:text={encoded_text}
|
|
Enables direct deep-linking to the statement.
|
|
|
|
archive_memento_uri:
|
|
range: uri
|
|
description: |
|
|
Wayback Machine or other web archive memento URI.
|
|
Ensures long-term accessibility of source evidence.
|
|
Format: https://web.archive.org/web/{timestamp}/{url}
|
|
|
|
effective_date:
|
|
range: date
|
|
description: |
|
|
Date when this statement became effective (if known).
|
|
May be inferred from page metadata or explicit statement.
|
|
|
|
supersedes:
|
|
range: uriorcurie
|
|
description: |
|
|
Reference to previous statement_id that this statement replaced.
|
|
Enables tracking of mission statement evolution over time.
|
|
|
|
adoption_context:
|
|
range: string
|
|
description: |
|
|
Context in which the statement was adopted (if documented).
|
|
Examples: "Annual report 2024", "Board meeting 2023-06-15"
|
|
|
|
extraction_agent:
|
|
range: string
|
|
description: |
|
|
Agent (person, script, or AI) that extracted this statement.
|
|
Examples: "claude-opus-4.5", "glam-harvester/1.0", "manual"
|
|
|
|
extraction_timestamp:
|
|
range: datetime
|
|
description: |
|
|
When the statement was extracted from the archived HTML.
|
|
May differ from retrieved_on if extraction happens later.
|
|
|
|
extraction_confidence:
|
|
range: float
|
|
minimum_value: 0.0
|
|
maximum_value: 1.0
|
|
description: |
|
|
Confidence score for extraction accuracy (0.0-1.0).
|
|
Higher values indicate clearer source attribution.
|
|
|
|
extraction_notes:
|
|
range: string
|
|
description: |
|
|
Notes about the extraction process, ambiguities, or data quality.
|
|
|
|
classes:
|
|
MissionStatement:
|
|
class_uri: org:purpose
|
|
description: |
|
|
A structured record of an organizational purpose statement (mission, vision,
|
|
goals, values, or motto) extracted from a heritage custodian's website with
|
|
full provenance documentation.
|
|
|
|
**PURPOSE**:
|
|
|
|
Heritage custodians publish mission and vision statements that articulate:
|
|
- Why they exist (mission)
|
|
- What future state they aspire to (vision)
|
|
- What specific outcomes they pursue (goals)
|
|
- What principles guide their work (values)
|
|
- Memorable phrases encapsulating their purpose (mottos)
|
|
|
|
These statements are valuable for:
|
|
- Understanding organizational identity and purpose
|
|
- Comparing institutions within and across sectors
|
|
- Tracking organizational evolution over time
|
|
- Research on heritage sector discourse and priorities
|
|
|
|
**PROVENANCE REQUIREMENTS**:
|
|
|
|
Following the WebObservation pattern, every MissionStatement MUST have:
|
|
|
|
1. **Source documentation**: source_url + retrieved_on
|
|
2. **Location evidence**: xpath OR css_selector + html_file
|
|
3. **Integrity verification**: content_hash (SHA-256)
|
|
4. **Archive link**: archive_memento_uri (recommended)
|
|
|
|
Statements without verifiable provenance are rejected.
|
|
|
|
**ONTOLOGY ALIGNMENT**:
|
|
|
|
W3C Organization Ontology `org:purpose`:
|
|
- "Indicates the purpose of this Organization"
|
|
- "There can be many purposes at different levels of abstraction"
|
|
- "It is recommended that the purpose be denoted by a controlled term"
|
|
|
|
We extend this by:
|
|
- Distinguishing statement types (mission, vision, goal, value, motto)
|
|
- Adding temporal tracking (effective_date, supersedes)
|
|
- Full provenance chain (source_url, xpath, content_hash, archive)
|
|
|
|
**MULTILINGUAL SUPPORT**:
|
|
|
|
Heritage custodians publish statements in their native language.
|
|
For Dutch institutions, statements are typically in Dutch.
|
|
The statement_language field captures the ISO 639-1 code,
|
|
and statement_summary can provide English translation.
|
|
|
|
**TEMPORAL TRACKING**:
|
|
|
|
Organizations revise their mission statements over time.
|
|
The `supersedes` field links to previous statements,
|
|
enabling tracking of how organizational purpose evolves.
|
|
|
|
**EXAMPLES**:
|
|
|
|
1. **Dutch Agricultural Museum Mission**
|
|
- statement_type: mission
|
|
- statement_text: "Waar komt ons voedsel écht vandaan."
|
|
- statement_language: nl
|
|
- source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie
|
|
|
|
2. **Rijksmuseum Vision**
|
|
- statement_type: vision
|
|
- statement_text: "Het Rijksmuseum verbindt mensen met kunst en geschiedenis."
|
|
- statement_language: nl
|
|
- statement_summary: "The Rijksmuseum connects people with art and history."
|
|
|
|
exact_mappings:
|
|
- org:purpose
|
|
|
|
close_mappings:
|
|
- schema:description
|
|
- prov:Entity
|
|
|
|
related_mappings:
|
|
- schema:slogan
|
|
- schema:ethicsPolicy
|
|
- schema:seeks
|
|
|
|
slots:
|
|
- statement_id
|
|
- statement_type
|
|
- statement_text
|
|
- statement_language
|
|
- statement_summary
|
|
- source_url
|
|
- retrieved_on
|
|
- page_section
|
|
- xpath
|
|
- css_selector
|
|
- html_file
|
|
- content_hash
|
|
- text_fragment
|
|
- archive_memento_uri
|
|
- effective_date
|
|
- supersedes
|
|
- adoption_context
|
|
- extraction_agent
|
|
- extraction_timestamp
|
|
- extraction_confidence
|
|
- extraction_notes
|
|
|
|
slot_usage:
|
|
statement_type:
|
|
required: true
|
|
description: |
|
|
Type of statement. Required to determine semantic interpretation.
|
|
- mission: Core purpose (why we exist)
|
|
- vision: Aspirational future (what we aim for)
|
|
- goal: Specific objectives (what we pursue)
|
|
- value: Guiding principles (how we work)
|
|
- motto: Memorable phrase (brand identity)
|
|
|
|
statement_text:
|
|
required: true
|
|
description: |
|
|
The actual statement text. Required - this is the core content.
|
|
Preserve original language and formatting.
|
|
|
|
source_url:
|
|
required: true
|
|
description: |
|
|
URL of the web page where statement was found. Required for provenance.
|
|
|
|
retrieved_on:
|
|
required: true
|
|
description: |
|
|
When the page was retrieved. Required for temporal provenance.
|
|
ISO 8601 format with timezone (UTC preferred).
|
|
|
|
rules:
|
|
- preconditions:
|
|
slot_conditions:
|
|
statement_type:
|
|
equals_string: "motto"
|
|
postconditions:
|
|
description: "Mottos should be brief - typically under 50 characters"
|
|
|
|
comments:
|
|
- "MissionStatement maps to org:purpose from W3C Organization Ontology"
|
|
- "Requires source_url and retrieved_on for provenance"
|
|
- "Strongly recommend xpath/css_selector + html_file for verification"
|
|
- "content_hash enables integrity checking"
|
|
- "archive_memento_uri ensures long-term source accessibility"
|
|
- "Supports tracking statement evolution via supersedes field"
|
|
- "statement_language uses ISO 639-1 codes (nl, en, de, etc.)"
|
|
|
|
see_also:
|
|
- "https://www.w3.org/TR/vocab-org/#org:purpose"
|
|
- "https://www.w3.org/TR/prov-o/"
|
|
- "https://wicg.github.io/scroll-to-text-fragment/"
|
|
- "https://www.w3.org/TR/SRI/"
|
|
|
|
examples:
|
|
- value:
|
|
statement_id: "https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/mission-2025"
|
|
statement_type: mission
|
|
statement_text: "Waar komt ons voedsel écht vandaan."
|
|
statement_language: nl
|
|
statement_summary: "Where does our food really come from."
|
|
source_url: "https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie"
|
|
retrieved_on: "2025-12-29T10:00:00Z"
|
|
page_section: "Onze Missie"
|
|
content_hash: "sha256-abc123..."
|
|
extraction_agent: "claude-opus-4.5"
|
|
extraction_confidence: 0.95
|
|
description: "Mission statement from Dutch agricultural museum"
|
|
|
|
- value:
|
|
statement_id: "https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/vision-2025"
|
|
statement_type: vision
|
|
statement_text: |
|
|
Het Landbouwmuseum Tiengemeten voelt zich onderdeel van een belangrijke
|
|
agrarische ontwikkeling, de mechanisatie tussen 1920 en 1955. De collectie
|
|
is relevant en de presentatie verbindt generaties.
|
|
statement_language: nl
|
|
source_url: "https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie"
|
|
retrieved_on: "2025-12-29T10:00:00Z"
|
|
page_section: "Onze visie"
|
|
content_hash: "sha256-def456..."
|
|
extraction_agent: "claude-opus-4.5"
|
|
extraction_confidence: 0.90
|
|
description: "Vision statement from Dutch agricultural museum"
|
|
|
|
- value:
|
|
statement_id: "https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/goals-2025"
|
|
statement_type: goal
|
|
statement_text: |
|
|
Onze ambitie en doelstellingen hebben wij geformuleerd rondom de volgende punten:
|
|
- Het Landbouwmuseum Tiengemeten laat de ontwikkeling van het boerenbedrijf
|
|
in de periode 1920 tot 1955 zien d.m.v. een prachtige collectie.
|
|
- Voor onze bezoekers een gewaardeerd en gastvrij museum te zijn.
|
|
- De collecties welke wij beheren toegankelijk maken voor nu en voor
|
|
volgende generaties.
|
|
statement_language: nl
|
|
source_url: "https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie"
|
|
retrieved_on: "2025-12-29T10:00:00Z"
|
|
page_section: "Doelstellingen"
|
|
extraction_agent: "claude-opus-4.5"
|
|
description: "Goals/objectives from Dutch agricultural museum"
|