ci: run all 4 layers on every push

Removed conditional execution from Layer 2 and Layer 4. All layers now run on every push, PR, and schedule. Quality Gate requires all 4 layers to pass.
feat: add ontology mappings to LinkML schema and enhance entity resolution
2026-01-13 14:05:41 +01:00 · 2026-01-13 13:51:02 +01:00
464 changed files with 78913 additions and 2168 deletions
--- a/.forgejo/workflows/dspy-eval.yml
+++ b/.forgejo/workflows/dspy-eval.yml
@ -1,11 +1,11 @@
 # DSPy RAG Evaluation Workflow
 # Automated testing and evaluation for Heritage RAG system
 #
-# Layers:
+# All layers run on every push/PR:
 # - Layer 1: Fast unit tests (no LLM)
 # - Layer 2: DSPy module tests with LLM
 # - Layer 3: Integration tests (requires SSH tunnel to Oxigraph)
-# - Layer 4: Comprehensive evaluation (nightly)
+# - Layer 4: Comprehensive evaluation

 name: DSPy RAG Evaluation

@ -93,9 +93,6 @@ jobs:
    timeout-minutes: 20
    needs: unit-tests
    
-    # Run on PRs, scheduled runs, or manual triggers
-    if: github.event_name == 'pull_request' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
-    
    steps:
      - uses: https://github.com/actions/checkout@v4
      
@ -197,7 +194,7 @@ jobs:
          path: layer3-results.xml

  # ==========================================================================
-  # Layer 4: Comprehensive Evaluation (nightly only)
+  # Layer 4: Comprehensive Evaluation
  # ==========================================================================
  comprehensive-eval:
    name: Layer 4 - Comprehensive Evaluation
@ -205,9 +202,6 @@ jobs:
    timeout-minutes: 60
    needs: [unit-tests, dspy-module-tests, integration-tests]
    
-    # Only run on schedule or manual trigger with 'comprehensive'
-    if: github.event_name == 'schedule' || (github.event_name == 'workflow_dispatch' && github.event.inputs.evaluation_level == 'comprehensive')
-    
    steps:
      - uses: https://github.com/actions/checkout@v4
      
@ -295,7 +289,7 @@ jobs:
  quality-gate:
    name: Quality Gate
    runs-on: ubuntu-latest
-    needs: [unit-tests, dspy-module-tests, integration-tests]
+    needs: [unit-tests, dspy-module-tests, integration-tests, comprehensive-eval]
    if: always()
    
    steps:
@ -303,30 +297,35 @@ jobs:
        run: |
          echo "Checking quality gates..."
          
-          # Layer 1 (unit tests) is always required
+          # Layer 1 (unit tests) is required
          if [[ "${{ needs.unit-tests.result }}" != "success" ]]; then
-            echo "Layer 1 (Unit Tests) failed"
+            echo "❌ Layer 1 (Unit Tests) failed"
            exit 1
          fi
-          echo "Layer 1 (Unit Tests) passed"
+          echo "✅ Layer 1 (Unit Tests) passed"
          
-          # Layer 2 (DSPy module tests) required for PRs
-          if [[ "${{ github.event_name }}" == "pull_request" ]]; then
+          # Layer 2 (DSPy module tests) is required
          if [[ "${{ needs.dspy-module-tests.result }}" != "success" ]]; then
-              echo "Layer 2 (DSPy Module Tests) failed - required for PRs"
+            echo "❌ Layer 2 (DSPy Module Tests) failed"
            exit 1
          fi
-            echo "Layer 2 (DSPy Module Tests) passed"
-          fi
+          echo "✅ Layer 2 (DSPy Module Tests) passed"
          
-          # Layer 3 (integration tests) is warning-only for now
+          # Layer 3 (integration tests) is required
          if [[ "${{ needs.integration-tests.result }}" != "success" ]]; then
-            echo "Warning: Layer 3 (Integration Tests) failed - non-blocking"
-          else
-            echo "Layer 3 (Integration Tests) passed"
+            echo "❌ Layer 3 (Integration Tests) failed"
+            exit 1
          fi
+          echo "✅ Layer 3 (Integration Tests) passed"
+          
+          # Layer 4 (comprehensive evaluation) is required
+          if [[ "${{ needs.comprehensive-eval.result }}" != "success" ]]; then
+            echo "❌ Layer 4 (Comprehensive Evaluation) failed"
+            exit 1
+          fi
+          echo "✅ Layer 4 (Comprehensive Evaluation) passed"
          
          echo ""
          echo "============================================"
-          echo "  All required quality gates passed!"
+          echo "  All quality gates passed!"
          echo "============================================"
--- a/.opencode/rules/no-hallucinated-ontology-references.md
+++ b/.opencode/rules/no-hallucinated-ontology-references.md
@ -0,0 +1,316 @@
+# Rule 51: No Hallucinated Ontology References
+
+**Priority**: CRITICAL  
+**Scope**: All LinkML schema files (`schemas/20251121/linkml/`)  
+**Created**: 2025-01-13
+
+---
+
+## Summary
+
+All ontology references in LinkML schema files (`class_uri`, `slot_uri`, `*_mappings`) MUST be verifiable against actual ontology files in `/data/ontology/`. References to predicates or classes that do not exist in local ontology files are considered **hallucinated** and are prohibited.
+
+---
+
+## The Problem
+
+AI agents may suggest ontology mappings based on training data without verifying that:
+1. The ontology file exists in `/data/ontology/`
+2. The specific predicate/class exists within that ontology file
+3. The prefix is declared and resolvable
+
+This leads to schema files containing references like `dqv:value` or `adms:status` that cannot be validated or serialized to RDF.
+
+---
+
+## Requirements
+
+### 1. All Ontology Prefixes Must Have Local Files
+
+Before using a prefix (e.g., `prov:`, `schema:`, `org:`), verify the ontology file exists:
+
+```bash
+# Check if ontology exists
+ls data/ontology/ | grep -i "prov\|schema\|org"
+```
+
+**Available Ontologies** (as of 2025-01-13):
+
+| Prefix | File | Verified |
+|--------|------|----------|
+| `prov:` | `prov-o.ttl`, `prov.ttl` | ✅ |
+| `schema:` | `schemaorg.owl` | ✅ |
+| `org:` | `org.rdf` | ✅ |
+| `skos:` | `skos.rdf` | ✅ |
+| `dcterms:` | `dublin_core_elements.rdf` | ✅ |
+| `foaf:` | `foaf.ttl` | ✅ |
+| `rico:` | `RiC-O_1-1.rdf` | ✅ |
+| `crm:` | `CIDOC_CRM_v7.1.3.rdf` | ✅ |
+| `geo:` | `geo.ttl` | ✅ |
+| `sosa:` | `sosa.ttl` | ✅ |
+| `bf:` | `bibframe.rdf` | ✅ |
+| `edm:` | `edm.owl` | ✅ |
+| `premis:` | `premis3.owl` | ✅ |
+| `dcat:` | `dcat3.ttl` | ✅ |
+| `ore:` | `ore.rdf` | ✅ |
+| `pico:` | `pico.ttl` | ✅ |
+| `gn:` | `geonames_ontology.rdf` | ✅ |
+| `time:` | `time.ttl` | ✅ |
+| `locn:` | `locn.ttl` | ✅ |
+| `dqv:` | `dqv.ttl` | ✅ |
+| `adms:` | `adms.ttl` | ✅ |
+
+**NOT Available** (do not use without adding):
+
+| Prefix | Status | Alternative |
+|--------|--------|-------------|
+| `qudt:` | Only referenced in era_ontology.ttl | Use `hc:` with close_mappings annotation |
+
+### 2. Predicates Must Exist in Ontology Files
+
+Before using a predicate, verify it exists:
+
+```bash
+# Verify predicate exists
+grep -l "hasFrameRate\|frameRate" data/ontology/premis3.owl
+
+# Check specific predicate definition
+grep -E "premis:hasFrameRate|:hasFrameRate" data/ontology/premis3.owl
+```
+
+### 3. Use hc: Prefix for Domain-Specific Concepts
+
+When no standard ontology predicate exists, use the Heritage Custodian namespace:
+
+```yaml
+# CORRECT - Use hc: with documentation
+slots:
+  heritage_relevance_score:
+    slot_uri: hc:heritageRelevanceScore
+    description: Heritage sector relevance score (0.0-1.0)
+    annotations:
+      ontology_note: >-
+        No standard ontology predicate for heritage relevance scoring.
+        Domain-specific metric for this project.
+
+# WRONG - Hallucinated predicate
+slots:
+  heritage_relevance_score:
+    slot_uri: dqv:heritageScore  # Does not exist!
+```
+
+### 4. Document External References in close_mappings
+
+When a similar concept exists in an ontology we don't have locally, document it in `close_mappings` with a note:
+
+```yaml
+slots:
+  confidence_score:
+    slot_uri: hc:confidenceScore
+    close_mappings:
+      - dqv:value  # W3C Data Quality Vocabulary (not in local files)
+    annotations:
+      external_ontology_note: >-
+        dqv:value from W3C Data Quality Vocabulary would be semantically 
+        appropriate but ontology not included in project. See 
+        https://www.w3.org/TR/vocab-dqv/
+```
+
+---
+
+## Verification Workflow
+
+### Before Adding New Mappings
+
+1. **Check if ontology file exists**:
+   ```bash
+   ls data/ontology/ | grep -i "<ontology-name>"
+   ```
+
+2. **Search for predicate in ontology**:
+   ```bash
+   grep -l "<predicate-name>" data/ontology/*
+   ```
+
+3. **Verify predicate definition**:
+   ```bash
+   grep -B2 -A5 "<predicate-name>" data/ontology/<file>
+   ```
+
+4. **If not found**: Use `hc:` prefix with appropriate documentation
+
+### When Reviewing Existing Mappings
+
+Run validation script:
+
+```bash
+# Find all slot_uri references
+grep -r "slot_uri:" schemas/20251121/linkml/modules/slots/ | \
+  grep -v "hc:" | \
+  cut -d: -f3 | \
+  sort -u
+
+# Verify each prefix has a local file
+for prefix in prov schema org skos dcterms foaf rico; do
+  echo "Checking $prefix:"
+  ls data/ontology/ | grep -i "$prefix" || echo "  NOT FOUND!"
+done
+```
+
+---
+
+## Ontology Addition Process
+
+If a new ontology is genuinely needed:
+
+1. **Download the ontology**:
+   ```bash
+   curl -L -o data/ontology/<name>.ttl "<url>" -H "Accept: text/turtle"
+   ```
+
+2. **Update ONTOLOGY_CATALOG.md**:
+   ```bash
+   # Add entry to data/ontology/ONTOLOGY_CATALOG.md
+   ```
+
+3. **Verify predicates exist**:
+   ```bash
+   grep "<predicate>" data/ontology/<name>.ttl
+   ```
+
+4. **Update LinkML prefixes** in schema files
+
+---
+
+## Examples
+
+### CORRECT: Verified Mapping
+
+```yaml
+slots:
+  retrieval_timestamp:
+    slot_uri: prov:atTime  # Verified in data/ontology/prov-o.ttl
+    range: datetime
+```
+
+### CORRECT: Domain-Specific with External Reference
+
+```yaml
+slots:
+  confidence_score:
+    slot_uri: hc:confidenceScore  # HC namespace (always valid)
+    range: float
+    close_mappings:
+      - dqv:value  # External reference (documented, not required locally)
+    annotations:
+      ontology_note: >-
+        Uses HC namespace as dqv: ontology not in local files.
+        dqv:value would be semantically appropriate alternative.
+```
+
+### WRONG: Hallucinated Mapping
+
+```yaml
+slots:
+  confidence_score:
+    slot_uri: dqv:value  # INVALID - dqv: not in data/ontology/!
+    range: float
+```
+
+### WRONG: Non-Existent Predicate
+
+```yaml
+slots:
+  frame_rate:
+    slot_uri: premis:hasFrameRate  # INVALID - predicate not in premis3.owl!
+    range: float
+```
+
+---
+
+## Consequences of Violation
+
+1. **RDF serialization fails** - Invalid prefixes cause gen-owl errors
+2. **Schema validation errors** - LinkML validates prefix declarations
+3. **Broken interoperability** - External systems cannot resolve URIs
+4. **Data quality issues** - Semantic web tooling cannot process data
+
+---
+
+## PREMIS Ontology Reference (premis3.owl)
+
+**CRITICAL**: The PREMIS ontology is frequently hallucinated. ALL premis: references MUST be verified.
+
+### Valid PREMIS Classes
+
+```
+Action, Agent, Bitstream, Copyright, Dependency, EnvironmentCharacteristic,
+Event, File, Fixity, HardwareAgent, Identifier, Inhibitor, InstitutionalPolicy,
+IntellectualEntity, License, Object, Organization, OutcomeStatus, Person,
+PreservationPolicy, Representation, RightsBasis, RightsStatus, Rule, Signature,
+SignatureEncoding, SignificantProperties, SoftwareAgent, Statute,
+StorageLocation, StorageMedium
+```
+
+### Valid PREMIS Properties
+
+```
+act, allows, basis, characteristic, citation, compositionLevel, dependency,
+determinationDate, documentation, encoding, endDate, fixity, governs,
+identifier, inhibitedBy, inhibits, jurisdiction, key, medium, note,
+originalName, outcome, outcomeNote, policy, prohibits, purpose, rationale,
+relationship, restriction, rightsStatus, signature, size, startDate,
+storedAt, terms, validationRules, version
+```
+
+### Known Hallucinated PREMIS Terms (DO NOT USE)
+
+| Hallucinated Term | Correction |
+|-------------------|------------|
+| `premis:PreservationEvent` | Use `premis:Event` |
+| `premis:RightsDeclaration` | Use `premis:RightsBasis` or `premis:RightsStatus` |
+| `premis:hasRightsStatement` | Use `premis:rightsStatus` |
+| `premis:hasRightsDeclaration` | Use `premis:rightsStatus` |
+| `premis:hasRepresentation` | Use `premis:relationship` or `dcterms:hasFormat` |
+| `premis:hasRelatedStatementInformation` | Use `premis:note` or `adms:status` |
+| `premis:hasObjectCharacteristics` | Use `premis:characteristic` |
+| `premis:rightsGranted` | Use `premis:RightsStatus` class with `premis:restriction` |
+| `premis:rightsEndDate` | Use `premis:endDate` |
+| `premis:linkingAgentIdentifier` | Use `premis:Agent` class |
+| `premis:storageLocation` (lowercase) | Use `premis:storedAt` property or `premis:StorageLocation` class |
+| `premis:hasFrameRate` | Does not exist - use `hc:frameRate` |
+| `premis:environmentCharacteristic` (lowercase) | Use `premis:EnvironmentCharacteristic` (class) |
+
+### PREMIS Verification Commands
+
+```bash
+# List all PREMIS classes
+grep -E "owl:Class.*premis" data/ontology/premis3.owl | \
+  sed 's/.*v3\///' | sed 's/".*//' | sort -u
+
+# List all PREMIS properties
+grep -E "ObjectProperty|DatatypeProperty" data/ontology/premis3.owl | \
+  grep -oP 'v3/\K[^"]+' | sort -u
+
+# Verify a specific term exists
+grep -c "YourTermHere" data/ontology/premis3.owl
+```
+
+---
+
+## See Also
+
+- Rule 38: Slot Centralization and Semantic URI Requirements
+- Rule 50: Ontology-to-LinkML Mapping Convention
+- `/data/ontology/ONTOLOGY_CATALOG.md` - Available ontologies
+- `.opencode/rules/slot-ontology-mapping-reference.md` - Mapping reference
+
+---
+
+## Version History
+
+- **2025-01-13**: Added 7 more hallucinated PREMIS terms discovered during schema audit:
+  - `premis:hasRightsStatement`, `premis:hasRightsDeclaration`, `premis:hasRepresentation`
+  - `premis:hasRelatedStatementInformation`, `premis:rightsGranted`, `premis:rightsEndDate`
+  - `premis:linkingAgentIdentifier`
+- **2025-01-13**: Initial creation after discovering dqv:, adms:, qudt: references without local files
--- a/.opencode/rules/slot-ontology-mapping-reference.md
+++ b/.opencode/rules/slot-ontology-mapping-reference.md
@ -0,0 +1,359 @@
+# Slot Ontology Mapping Reference
+
+This document provides the complete ontology predicate mappings for all 970 LinkML slots that previously had the `hc:` (Heritage Custodian) prefix.
+
+## Overview
+
+| Category | Count | Primary Ontologies |
+|----------|-------|-------------------|
+| Provenance/Extraction | ~50 | `prov:`, `dcterms:` |
+| Confidence/Scores | ~62 | `dqv:`, `hc:` |
+| Boolean Flags | ~131 | `hc:`, `org:` |
+| Names/Descriptions | ~72 | `schema:`, `skos:`, `dcterms:` |
+| Types/Status | ~60 | `dcterms:`, `hc:` |
+| Identifiers | ~53 | `dcterms:`, `org:`, `schema:` |
+| URLs | ~24 | `schema:`, `foaf:`, `dcterms:` |
+| Dates/Times | ~22 | `schema:`, `prov:`, `dcterms:` |
+| Budget/Financial | ~22 | `schema:`, `hc:` |
+| Counts/Quantities | ~28 | `schema:`, `hc:` |
+| Relationships | ~30 | `org:`, `dcterms:`, `rico:` |
+| Language/Text | ~25 | `schema:`, `dcterms:`, `rdf:` |
+| Physical/Spatial | ~30 | `schema:`, `geo:`, `hc:` |
+| Audio/Video | ~30 | `schema:`, `dcterms:`, `hc:` |
+| **TOTAL** | **~639** | |
+
+---
+
+## 1. Provenance/Extraction Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `retrieval_timestamp` | `prov:atTime` | Timestamp of retrieval event |
+| `extraction_timestamp` | `prov:generatedAtTime` | When extraction result was created |
+| `archived_at` | `prov:generatedAtTime` | When archived copy was created |
+| `retrieval_method` | `prov:hadPlan` | The plan/procedure used for retrieval |
+| `generated_by` | `prov:wasGeneratedBy` | Activity that generated this entity |
+| `created_by_project` | `prov:wasAttributedTo` | Project agent responsible for creation |
+| `approved_by` | `prov:wasAttributedTo` | Agent who approved (with role qualifier) |
+| `asserted_by` | `prov:wasAttributedTo` | Agent who made the assertion |
+| `documented_by` | `prov:hadPrimarySource` | Primary source documentation |
+| `retrieved_by` | `prov:wasAssociatedWith` | Agent who performed retrieval |
+| `observed_entity` | `prov:entity` | Entity being observed |
+| `observer_name` | `prov:agent` | Observing agent |
+| `observer_type` | `prov:hadRole` | Role/type of observer |
+| `observer_affiliation` | `prov:actedOnBehalfOf` | Observer's affiliated organization |
+| `processing_status` | `hc:processingStatus` | Workflow status (domain-specific) |
+| `processing_duration_seconds` | `prov:value` | Duration value |
+| `processing_priority` | `hc:processingPriority` | Priority (domain-specific) |
+| `validation_status` | `hc:validationStatus` | Validation status (domain-specific) |
+| `backup_status` | `hc:backupStatus` | Backup status (domain-specific) |
+| `verified` | `prov:wasAttributedTo` | Verified by agent |
+
+---
+
+## 2. Confidence/Score Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `confidence` | `dqv:value` | W3C Data Quality Vocabulary |
+| `confidence_score` | `dqv:value` | Data quality measurement |
+| `likelihood_score` | `hc:likelihood_score` | Probabilistic assessment |
+| `heritage_relevance_score` | `hc:heritage_relevance_score` | Heritage domain metric |
+| `museum_search_score` | `hc:museum_search_score` | Template-specific relevance |
+| `library_search_score` | `hc:library_search_score` | Template-specific relevance |
+| `archive_search_score` | `hc:archive_search_score` | Template-specific relevance |
+| `collection_discovery_score` | `hc:collection_discovery_score` | Template-specific relevance |
+| `person_research_score` | `hc:person_research_score` | Template-specific relevance |
+| `location_browse_score` | `hc:location_browse_score` | Template-specific relevance |
+| `identifier_lookup_score` | `hc:identifier_lookup_score` | Template-specific relevance |
+| `organizational_change_score` | `hc:organizational_change_score` | Template-specific relevance |
+| `digital_platform_score` | `hc:digital_platform_score` | Template-specific relevance |
+| `general_heritage_score` | `hc:general_heritage_score` | Fallback template score |
+| `specificity_score` | `hc:specificity_score` | Schema design metric (Rule 37) |
+| `engagement_rate` | `hc:engagement_rate` | Analytics ratio metric |
+| `visitor_conversion_rate` | `hc:visitor_conversion_rate` | Analytics ratio metric |
+| `growth_rate` | `hc:growth_rate` | Temporal change rate |
+| `funding_rate` | `hc:funding_rate` | Funding rate metric |
+
+---
+
+## 3. Boolean Flag Slots (Selected Examples)
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `is_accredited` | `hc:isAccredited` | Domain-specific (close: schema:hasCredential) |
+| `is_active` | `hc:isActive` | Domain-specific (close: adms:status) |
+| `is_branch_of` | `org:unitOf` | **Direct match** to W3C Org |
+| `is_heritage_relevant` | `hc:isHeritageRelevant` | Core HC domain concept |
+| `is_public_facing` | `hc:isPublicFacing` | Close to schema:publicAccess |
+| `is_current_position` | `hc:isCurrentPosition` | Employment convenience flag |
+| `is_embeddable` | `hc:isEmbeddable` | Platform content policy |
+| `is_made_for_kid` | `hc:isMadeForKids` | Close to schema:isFamilyFriendly |
+
+**Note**: Most boolean flags use `hc:` prefix with `close_mappings` to related ontology terms, as standard ontologies rarely have boolean equivalents.
+
+---
+
+## 4. Name/Description Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `branch_name` | `schema:name` | Entity name |
+| `branch_description` | `schema:description` | Entity description |
+| `portal_name` | `schema:name` | Entity name |
+| `portal_description` | `schema:description` | Entity description |
+| `scheme_name` | `skos:prefLabel` | SKOS concept scheme |
+| `scheme_description` | `skos:definition` | SKOS definition |
+| `call_title` | `dcterms:title` | Formal document title |
+| `call_description` | `dcterms:description` | Formal document description |
+| `organization_name` | `schema:name` | Organization entity name |
+| `employer_name` | `schema:name` | Employer entity name |
+| `degree_name` | `schema:name` | Academic credential name |
+
+**Pattern**:
+- Entity names → `schema:name`
+- Entity descriptions → `schema:description`
+- Concept schemes → `skos:prefLabel` / `skos:definition`
+- Formal documents → `dcterms:title` / `dcterms:description`
+
+---
+
+## 5. Type/Status Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `storage_type` | `dcterms:type` | Type classification |
+| `branch_type` | `dcterms:type` | Type classification |
+| `content_type` | `dcterms:type` | Type classification |
+| `document_type` | `dcterms:type` | Type classification |
+| `heritage_type` | `dcterms:type` | Type classification |
+| `operational_status` | `hc:operationalStatus` | Status (close: adms:status) |
+| `portal_status` | `hc:portalStatus` | Status (close: adms:status) |
+| `project_status` | `hc:projectStatus` | Status (close: adms:status) |
+| `loan_status` | `hc:loanStatus` | Status (close: adms:status) |
+| `unesco_list_status` | `hc:unescoListStatus` | Heritage-specific status |
+
+**Pattern**:
+- Types → `dcterms:type` (with exact_mappings to `schema:additionalType`)
+- Status → `hc:*Status` (with close_mappings to `adms:status`)
+
+---
+
+## 6. Identifier Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `activity_id` | `dcterms:identifier` | General identifier |
+| `project_id` | `dcterms:identifier` | General identifier |
+| `branch_id` | `org:identifier` | Organizational unit |
+| `department_id` | `org:identifier` | Organizational unit |
+| `unit_id` | `org:identifier` | Organizational unit |
+| `video_id` | `schema:identifier` | Media context |
+| `device_id` | `schema:identifier` | Device context |
+| `scheme_id` | `adms:identifier` | Formal scheme |
+
+**Pattern**:
+- General → `dcterms:identifier`
+- Organizational → `org:identifier`
+- Web/Media → `schema:identifier`
+- Formal schemes → `adms:identifier`
+
+---
+
+## 7. URL Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `portal_url` | `schema:url` | Generic URL |
+| `repository_url` | `schema:url` | Generic URL |
+| `platform_url` | `schema:url` | Generic URL |
+| `recording_url` | `schema:contentUrl` | Media content URL |
+| `thumbnail_url` | `schema:contentUrl` | Media content URL |
+| `profile_image_url` | `schema:contentUrl` | Media content URL |
+| `homepage_web_address` | `foaf:homepage` | Primary homepage |
+| `vendor_url` | `foaf:homepage` | Vendor homepage |
+| `profile_url` | `foaf:page` | Page about entity |
+| `collection_web_address` | `foaf:page` | Page about collection |
+| `financial_document_url` | `dcterms:source` | Source document |
+| `rights_statement_url` | `dcterms:source` | Authoritative source |
+| `scheme_url` | `rdfs:seeAlso` | External reference |
+
+---
+
+## 8. Date/Time Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `actual_start` | `schema:startDate` | Event start |
+| `actual_end` | `schema:endDate` | Event end |
+| `planned_start` | `schema:startDate` | Planned start |
+| `planned_end` | `schema:endDate` | Planned end |
+| `fiscal_year_start` | `schema:startDate` | Period boundary |
+| `fiscal_year_end` | `schema:endDate` | Period boundary |
+| `chapters_generated_at` | `prov:generatedAtTime` | Generation timestamp |
+| `comment_published_at` | `schema:datePublished` | Publication timestamp |
+| `comment_updated_at` | `schema:dateModified` | Modification timestamp |
+| `start_time` | `schema:startTime` | Media timing |
+| `end_time` | `schema:endTime` | Media timing |
+| `start_seconds` | `schema:startTime` | Media timing (numeric) |
+| `end_seconds` | `schema:endTime` | Media timing (numeric) |
+| `programme_year` | `dcterms:date` | Single temporal point |
+
+---
+
+## 9. Budget/Financial Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `funding_amount` | `schema:fundingAmount` | **Direct match** |
+| `external_funding` | `hc:externalFunding` | Close to schema:fundingAmount |
+| `internal_funding` | `hc:internalFunding` | Close to fibo:MonetaryAmount |
+| `total_budget` | `hc:totalBudget` | Close to fibo:MonetaryAmount |
+| `operating_budget` | `hc:operatingBudget` | Close to fibo:OperatingExpense |
+| `preservation_budget` | `hc:preservationBudget` | Heritage domain-specific |
+| `total_revenue` | `hc:totalRevenue` | Close to fibo:Revenue |
+| `total_expense` | `hc:totalExpense` | Close to fibo:Expense |
+| `total_asset` | `hc:totalAsset` | Close to fibo:Asset |
+| `total_liability` | `hc:totalLiability` | Close to fibo:Liability |
+| `endowment_draw` | `hc:endowmentDraw` | Related to fibo:Endowment |
+
+**Note**: Only `funding_amount` has direct schema.org match. Other financial terms use `hc:` with FIBO close_mappings.
+
+---
+
+## 10. Count/Quantity Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `comment_count` | `schema:commentCount` | **Direct match** |
+| `word_count` | `schema:wordCount` | **Direct match** |
+| `character_count` | `schema:characterCount` | **Direct match** |
+| `visitor_count` | `hc:visitorCount` | Close to maximumAttendeeCapacity |
+| `follower_count` | `hc:followerCount` | Close to interactionStatistic |
+| `view_count` | `hc:viewCount` | Close to interactionStatistic |
+| `like_count` | `hc:likeCount` | Close to interactionStatistic |
+| `record_count` | `hc:recordCount` | Close to rico:hasExtent |
+| `objects_count` | `hc:objectsCount` | Close to crm:P57_has_number_of_parts |
+| `unique_face_count` | `hc:uniqueFaceCount` | Close to sosa:hasSimpleResult |
+
+---
+
+## 11. Relationship Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `aggregates_from` | `dcterms:references` | Data source reference |
+| `feeds_portal` | `dcterms:relation` | Generic data flow |
+| `provides_access_to` | `dcterms:references` | Resource reference |
+| `platform_of` | `org:unitOf` | Organizational unit |
+| `hosts_branch` | `org:hasUnit` | Organizational hosting |
+| `parent_department` | `org:subOrganizationOf` | Organizational hierarchy |
+| `parent_society` | `org:memberOf` | Membership relationship |
+| `parent_programme` | `rico:isOrWasPartOf` | Archival/temporal part-of |
+| `participating_custodian` | `org:hasMember` | Participation |
+| `refers_to_person` | `dcterms:references` | Entity reference |
+| `linked_to_collection` | `rico:isOrWasIncludedIn` | Archival inclusion |
+
+---
+
+## 12. Language/Text Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `nl`, `en`, `de`, `fr` | `rdf:value` | Language-tagged values |
+| `alpha_2`, `alpha_3` | `skos:notation` | Standardized codes |
+| `default_language` | `schema:inLanguage` | Content language |
+| `portal_language` | `schema:inLanguage` | Content language |
+| `available_caption_languages` | `schema:availableLanguage` | Available options |
+| `text_fragment` | `schema:text` | Text content |
+| `full_text` | `schema:text` | Text content |
+| `speech_text` | `schema:text` | Text content |
+
+---
+
+## 13. Physical/Spatial Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `building_floor_area_sqm` | `schema:floorSize` | **Direct match** |
+| `warehouse_floor_area_sqm` | `schema:floorSize` | **Direct match** |
+| `square_meters` | `schema:size` | Standard measurement |
+| `capacity_linear_meters` | `hc:capacityLinearMeters` | Archival standard (close: qudt) |
+| `temperature_min/max/target` | `hc:temperature*` | Preservation (close: qudt) |
+| `humidity_min/max/target` | `hc:humidity*` | Preservation (close: qudt) |
+| `geometry_type` | `geo:hasGeometry` | GeoSPARQL standard |
+| `from_location` | `schema:fromLocation` | **Direct match** |
+| `to_location` | `schema:toLocation` | **Direct match** |
+| `physical_location` | `schema:location` | **Direct match** |
+| `work_location` | `schema:workLocation` | **Direct match** |
+
+---
+
+## 14. Audio/Video Slots
+
+| Slot | slot_uri | Rationale |
+|------|----------|-----------|
+| `music_genre` | `schema:genre` | **Direct match** |
+| `live_broadcast_content` | `schema:isLiveBroadcast` | **Direct match** |
+| `subtitle_format` | `dcterms:format` | Format description |
+| `transcript_format` | `dcterms:format` | Format description |
+| `frame_rate` | `hc:frameRate` | Domain-specific (no standard equivalent) |
+| `snr_db` | `hc:signalToNoiseRatio` | Audio quality metric |
+| `diarization_*` | `hc:diarization*` | Speaker processing |
+| `music_*` | `hc:music*` | Music detection |
+| `speech_*` | `hc:speech*` | Speech detection |
+
+---
+
+## Summary: Ontology Usage Distribution
+
+| Ontology Prefix | Full Count | Primary Use Cases |
+|-----------------|------------|-------------------|
+| `hc:` | ~500+ | Domain-specific heritage concepts |
+| `schema:` | ~80 | Names, URLs, dates, counts, locations |
+| `dcterms:` | ~60 | Types, identifiers, formats, relations |
+| `prov:` | ~30 | Provenance, generation, attribution |
+| `org:` | ~20 | Organizational relationships |
+| `skos:` | ~15 | Concept schemes, notations, labels |
+| `foaf:` | ~10 | Homepage, page references |
+| `rico:` | ~5 | Archival relationships |
+| `geo:` | ~5 | Geographic/spatial |
+| `dqv:` | ~2 | Data quality measurements |
+| `adms:` | ~5 | Status, identifiers for assets |
+
+---
+
+## Implementation Notes
+
+### When to Use Standard Ontology Predicates
+
+Use standard predicates when:
+1. **Exact semantic match exists** (e.g., `schema:name`, `dcterms:identifier`)
+2. **Well-established patterns** (e.g., `schema:startDate/endDate`)
+3. **Interoperability is primary concern**
+
+### When to Use hc: Prefix
+
+Use domain-specific `hc:` prefix when:
+1. **No standard equivalent exists** (e.g., `hc:heritageRelevanceScore`)
+2. **Domain-specific semantics** (e.g., `hc:capacityLinearMeters`)
+3. **Boolean flags without standard equivalents**
+4. **Technical processing metrics** (e.g., `hc:diarizationConfidence`)
+
+### Required Close/Related Mappings
+
+When using `hc:` prefix, always include appropriate mappings:
+- `close_mappings`: Similar semantics, different scope
+- `related_mappings`: Conceptually related
+- `broad_mappings`: External term is narrower
+- `narrow_mappings`: External term is broader
+
+---
+
+## Version History
+
+- **2025-01-13**: Added dqv.ttl and adms.ttl ontologies; fixed premis:hasFrameRate reference
+- **2025-01-13**: Initial comprehensive mapping of 970 slots
+- Follows Rule 38 (Slot Centralization and Semantic URI)
+- Follows Rule 50 (Ontology-to-LinkML Mapping Convention)
+- Follows Rule 51 (No Hallucinated Ontology References)
--- a/AGENTS.md
+++ b/AGENTS.md
@ -1485,6 +1485,49 @@ classes:

 ---

+### Rule 51: No Hallucinated Ontology References
+
+**CRITICAL**: All ontology references (`class_uri`, `slot_uri`, `*_mappings`) MUST be verifiable against actual files in `/data/ontology/`.
+
+**The Problem**: AI agents may suggest predicates like `dqv:value` or `premis:hasFrameRate` without verifying they exist in local ontology files. This causes RDF serialization failures.
+
+**Available Ontologies** (verified 2025-01-13):
+
+| Prefix | File | Verified |
+|--------|------|----------|
+| `prov:` | `prov-o.ttl` | ✅ |
+| `schema:` | `schemaorg.owl` | ✅ |
+| `org:` | `org.rdf` | ✅ |
+| `skos:` | `skos.rdf` | ✅ |
+| `dcterms:` | `dublin_core_elements.rdf` | ✅ |
+| `foaf:` | `foaf.ttl` | ✅ |
+| `rico:` | `RiC-O_1-1.rdf` | ✅ |
+| `dqv:` | `dqv.ttl` | ✅ |
+| `adms:` | `adms.ttl` | ✅ |
+| `dcat:` | `dcat3.ttl` | ✅ |
+
+**Verification Workflow**:
+```bash
+# 1. Check ontology file exists
+ls data/ontology/ | grep -i "<prefix>"
+
+# 2. Search for predicate
+grep -l "<predicate>" data/ontology/*
+```
+
+**When No Standard Exists**: Use `hc:` prefix with documentation:
+```yaml
+slots:
+  heritage_relevance_score:
+    slot_uri: hc:heritageRelevanceScore  # Always valid
+    annotations:
+      ontology_note: "No standard ontology equivalent exists"
+```
+
+**See**: `.opencode/rules/no-hallucinated-ontology-references.md` for complete documentation
+
+---
+
 ## Appendix: Full Rule Content (No .opencode Equivalent)

 The following rules have no separate .opencode file and are preserved in full:
--- a/data/ontology/ONTOLOGY_CATALOG.md
+++ b/data/ontology/ONTOLOGY_CATALOG.md
@ -2,7 +2,7 @@

 This document catalogs all ontologies used in the GLAM Heritage Custodian project.

-**Last Updated**: 2025-11-30
+**Last Updated**: 2025-01-13

 ## Core Domain Ontologies

@ -76,6 +76,8 @@ This document catalogs all ontologies used in the GLAM Heritage Custodian projec
 | `dcat3.ttl` | DCAT (Data Catalog Vocabulary) | 3.0 | https://www.w3.org/TR/vocab-dcat-3/ | `dcat:` |
 | `schemaorg.owl` | Schema.org | 2024 | https://schema.org/ | `schema:` |
 | `vcard.rdf` | vCard Ontology | 4.0 | https://www.w3.org/TR/vcard-rdf/ | `vcard:` |
+| `dqv.ttl` | Data Quality Vocabulary | 2016-12 | https://www.w3.org/TR/vocab-dqv/ | `dqv:` |
+| `adms.ttl` | Asset Description Metadata Schema | 2015-07 | https://www.w3.org/TR/vocab-adms/ | `adms:` |

 ### Provenance & Temporal

--- a/data/ontology/adms.ttl
+++ b/data/ontology/adms.ttl
@ -0,0 +1,170 @@
+# deprecated - now maintained by Semic (see adms.var)
+
+@prefix dcterms: <http://purl.org/dc/terms/>.
+@prefix skos: <http://www.w3.org/2004/02/skos/core#>.
+@prefix foaf: <http://xmlns.com/foaf/0.1/>.
+@prefix owl: <http://www.w3.org/2002/07/owl#>.
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#>.
+@prefix xhv: <http://www.w3.org/1999/xhtml/vocab#>.
+@prefix xml: <http://www.w3.org/XML/1998/namespace>.
+@prefix voaf: <http://purl.org/vocommons/voaf#>.
+@prefix vcard: <http://www.w3.org/2006/vcard/ns#>.
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>.
+@prefix vann: <http://purl.org/vocab/vann/>.
+@prefix dcat: <http://www.w3.org/ns/dcat#>.
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>.
+@prefix wdrs: <http://www.w3.org/2007/05/powder-s#>.
+@prefix schema: <http://schema.org/> .
+@prefix adms: <http://www.w3.org/ns/adms#> .
+
+<http://www.w3.org/ns/adms> 	a voaf:Vocabulary, owl:Ontology;
+  voaf:specializes dcat:;
+  dcterms:title "Asset Description Metadata Schema (ADMS)"@en;
+  rdfs:label "Asset Description Metadata Schema (ADMS)"@en;
+	dcterms:abstract "ADMS is a profile of DCAT, used to describe semantic assets (or just 'Assets'), defined as highly reusable metadata (e.g. xml schemata, generic data models) and reference data (e.g. code lists, taxonomies, dictionaries, vocabularies) that are used for eGovernment system development."@en;
+	dcterms:creator [schema:affiliation <http://www.w3.org/data#W3C>;
+	  rdfs:seeAlso <http://philarcher.org/foaf.rdf#me>;
+  	foaf:homepage <http://www.w3.org/People/all#phila>;
+  	foaf:name "Phil Archer"] ,
+    [schema:affiliation [foaf:homepage <http://ies.jrc.ec.europa.eu/DE>; foaf:name "European Commission, Joint Research Centre "]; 
+  	rdfs:seeAlso <http://andrea-perego.name/foaf/#me>;
+	  foaf:homepage <http://andrea-perego.name/>;
+	  foaf:name "Andrea Perego"] ,
+    [rdfs:seeAlso <http://makxdekkers.com/makxdekkers.rdf#me>; foaf:homepage <http://makxdekkers.com/>;
+    	foaf:name "Makx Dekkers"];
+  foaf:maker[foaf:name "Government Linked Data WG, based on output from the ADMS Working Group"; foaf:homepage <http://www.w3.org/2011/gld/>];
+	dcterms:description """This is the RDF encoding of the Asset Description Metadata Schema, originally 
+    developed under the European Union's ISA Programme and further developed by the W3C Government Linked Data Working Group.
+    It re-uses terms from several other vocabularies, notably Dublin Core, with elements of SKOS, FOAF and more. """;
+	dcterms:modified "2013-05-24"^^xsd:date;
+  dcterms:modified "2013-09-16"^^xsd:date; # removed erroneous . chars before closing blank nodes
+  dcterms:modified "2013-12-21"^^xsd:date; # corrected URI of schema to http://www,w3.org/ns/adms (no #)
+  dcterms:modified "2015-07-22"^^xsd:date; # Added rdfs:Class to definition of adms:Asset
+	vann:preferredNamespacePrefix "adms";
+	vann:preferredNamespaceUri "http://www.w3.org/ns/adms#";
+	rdfs:comment "This file specifies the set of RDF classes and properties used in ADMS"@en;
+	wdrs:describedby <http://www.w3.org/TR/vocab-adms>.
+
+
+<http://www.w3.org/ns/adms#AssetRepository> dcterms:identifier "adms:AssetRepository";
+	a rdfs:Class;
+	rdfs:comment "An Asset Repository is a system or service that provides facilities for storage and maintenance of descriptions of Assets and Asset Distributions, and functionality that allows users to search and access these descriptions. An Asset Repository will typically contain descriptions of several Assets and related Asset Distributions."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "Asset Repository"@en;
+	rdfs:subClassOf dcat:Catalog.
+
+<http://www.w3.org/ns/adms#Asset> dcterms:identifier "adms:Asset";
+  a rdfs:Class;
+	rdfs:comment "An Asset is an abstract entity that reflects the intellectual content of the asset and represents those characteristics of the asset that are independent of its physical embodiment. This abstract entity combines the FRBR entities work (a distinct intellectual or artistic creation) and expression (the intellectual or artistic realization of a work). Assets can be versioned. Every time the intellectual content of an asset changes, the result is considered to be a new asset that can be linked to previous and next versions of the Asset. The physical embodiment of an Asset is called an Asset Distribution. A particular Asset may have zero or more Asset Distributions.."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "Asset"@en;
+	rdfs:subClassOf dcat:Dataset.
+
+<http://www.w3.org/ns/adms#AssetDistribution> dcterms:identifier "adms:AssetDistribution";
+	a rdfs:Class;
+	rdfs:comment "An Asset Distribution represents a particular physical embodiment of an Asset, which is an example of the FRBR entity manifestation (the physical embodiment of an expression of a work). An Asset Distribution is typically a downloadable computer file (but in principle it could also be a paper document) that implements the intellectual content of an Asset. A particular Asset Distribution is associated with one and only one Asset, while all Distributions of an Asset share the same intellectual content in different physical formats. Asset Distributions themselves are not versioned."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "Asset Distribution"@en;
+	rdfs:subClassOf dcat:Distribution.
+
+<http://www.w3.org/ns/adms#Identifier> dcterms:identifier "adms:Identifier";
+	a rdfs:Class;
+	rdfs:comment "This class is based on the UN/CEFACT Identifier complex type defined in See Section 5.8 of Core Components Data Type Catalogue Version 3.1 (http://www.unece.org/fileadmin/DAM/cefact/codesfortrade/CCTS/CCTS-DTCatalogueVersion3p1.pdf) In RDF this is expressed using the following properties: - the content string should be provided using skos:notation, datatyped with the identifier scheme (inclduing the version number if appropriate); - use dcterms:creator to link to a class describing the agency that manages the identifier scheme or adms:schemaAgency to provide the name as a literal. Although not part of the ADMS conceptual model, it may be useful to provide further properties to the Identifier class such as dcterms:created to provide the date on which the identifier was issued."^^rdf:XMLLiteral;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "Identifier"@en.
+
+<http://www.w3.org/ns/adms#identifier> dcterms:identifier "adms:identifier";
+	a rdf:Property, owl:ObjectProperty;
+	rdfs:comment "adms:identifier is used to link any resource to an instance of adms:Identifier which is its range. N.B. it is not appropriate to use dcterms:identifer to link to the Identifier class as its range is rdfs:Literal. ADMS uses this to provide any identifier for the Asset."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "identifier"@en;
+	rdfs:range <http://www.w3.org/ns/adms#Identifier>.
+
+<http://www.w3.org/ns/adms#includedAsset> dcterms:identifier "adms:includedAsset";
+	a rdf:Property, owl:ObjectProperty;
+	rdfs:comment "Links to an Asset that is contained in the Asset being described, e.g. when there are several vocabularies defined in a single document."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "included asset"@en;
+	rdfs:domain <http://www.w3.org/ns/adms#Asset>;
+	rdfs:range <http://www.w3.org/ns/adms#Asset>.
+
+<http://www.w3.org/ns/adms#interoperabilityLevel> dcterms:identifier "adms:interoperabilityLevel";
+	a rdf:Property, owl:ObjectProperty;
+	rdfs:comment "Links an Asset to its adms:InteroperabilityLevel. Since this is encoded using skos:Concept, that is the defined range for this property."@en;
+	rdfs:domain <http://www.w3.org/ns/adms#Asset>;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "interoperability level"@en;
+  rdfs:domain adms:Asset;
+	rdfs:range skos:Concept.
+
+<http://www.w3.org/ns/adms#last> dcterms:identifier "adms:last";
+	a rdf:Property, owl:ObjectProperty;
+	rdfs:comment "A link to the current or latest version of the Asset."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "last"@en;
+	rdfs:subPropertyOf xhv:last.
+
+<http://www.w3.org/ns/adms#next> dcterms:identifier "adms:next";
+	a rdf:Property,	owl:ObjectProperty;
+	rdfs:comment "A link to the next version of the Asset."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "next"@en;
+	rdfs:subPropertyOf xhv:next.
+
+<http://www.w3.org/ns/adms#prev> dcterms:identifier "adms:prev";
+	a rdf:Property,	owl:ObjectProperty;
+	rdfs:comment "A link to the previous version of the Asset."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "prev"@en;
+	rdfs:subPropertyOf xhv:prev.
+
+<http://www.w3.org/ns/adms#representationTechnique> dcterms:identifier "adms:representationTechnique";
+	a rdf:Property,	owl:ObjectProperty;
+	rdfs:comment "Links an adms:AssetDistribution to a skos:Concept that is its adms:RepresentationTechnique."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "representation technique"@en;
+	rdfs:range skos:Concept.
+
+<http://www.w3.org/ns/adms#sample> dcterms:identifier "adms:sample";
+	a rdf:Property, owl:ObjectProperty;
+	rdfs:comment "Links to a sample of an Asset (which is itself an Asset)."@en;
+	rdfs:domain <http://www.w3.org/ns/adms#Asset>;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "sample"@en;
+	rdfs:range <http://www.w3.org/ns/adms#Asset>.
+
+<http://www.w3.org/ns/adms#schemeAgency> dcterms:identifier "adms:schemeAgency";
+	a rdf:Property,	owl:DatatypeProperty;
+	rdfs:comment "The name of the agency responsible for issuing the identifier"@en;
+	rdfs:domain <http://www.w3.org/ns/adms#Identifier>;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "scheme agency"@en;
+	rdfs:range rdfs:Literal.
+
+
+<http://www.w3.org/ns/adms#status> dcterms:identifier "adms:status";
+	a rdf:Property,	owl:ObjectProperty;
+	rdfs:comment "Links to the status of the Asset or Asset Distribution in the context of a particular workflow process. Since Status is defined using a skos:Concept, that is the defined range for this property."^^rdf:XMLLiteral;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "status"@en;
+	rdfs:range skos:Concept.
+
+<http://www.w3.org/ns/adms#supportedSchema> dcterms:identifier "adms:supportedSchema";
+	a rdf:Property,	owl:ObjectProperty;
+	rdfs:comment "A schema according to which the Asset Repository can provide data about its content, e.g. ADMS"@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "supported schema"@en;
+	rdfs:range adms:Asset.
+
+<http://www.w3.org/ns/adms#translation> dcterms:identifier "adms:translation";
+	a rdf:Property,	owl:ObjectProperty;
+	rdfs:comment "Links Assets that are translations of each other."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "translation"@en.
+
+<http://www.w3.org/ns/adms#versionNotes> dcterms:identifier "adms:versionNotes";
+	a rdf:Property,	owl:DatatypeProperty;
+	rdfs:comment "A description of changes between this version and the previous version of the Asset."@en;
+	rdfs:isDefinedBy <http://www.w3.org/TR/vocab-adms>;
+	rdfs:label "version info"@en;
+	rdfs:range rdfs:Literal.
--- a/data/ontology/dqv.ttl
+++ b/data/ontology/dqv.ttl
@ -0,0 +1,186 @@
+@prefix rdf:     <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix owl:     <http://www.w3.org/2002/07/owl#> .
+@prefix dcterms: <http://purl.org/dc/terms/> .
+@prefix xsd:     <http://www.w3.org/2001/XMLSchema#> .
+@prefix vann:    <http://purl.org/vocab/vann/> .
+@prefix foaf:    <http://xmlns.com/foaf/0.1/> .
+@prefix rdfs:    <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix qb:      <http://purl.org/linked-data/cube#> .
+@prefix daq:     <http://purl.org/eis/vocab/daq#> .
+@prefix voaf:    <http://purl.org/vocommons/voaf#> .
+@prefix oa:      <http://www.w3.org/ns/oa#> .
+@prefix duv:     <http://www.w3.org/ns/duv#> .
+@prefix skos:    <http://www.w3.org/2004/02/skos/core#> .
+
+@prefix dqv:     <http://www.w3.org/ns/dqv#> .
+
+############################
+### Metadata section #######
+############################
+<http://www.w3.org/ns/dqv> a voaf:Vocabulary;
+    dcterms:title "Data Quality Vocabulary"@en;
+    dcterms:description "The Data Quality Vocabulary (DQV) is seen as an extension to DCAT to cover the quality of the data, how frequently is it updated, whether it accepts user corrections, persistence commitments etc. When used by publishers, this vocabulary will foster trust in the data amongst developers."@en;
+    vann:preferredNamespaceUri "http://www.w3.org/ns/dqv#";
+    vann:preferredNamespacePrefix "dqv";
+    foaf:homepage <http://www.w3.org/TR/vocab-dqv/> ;
+    dcterms:created "2015-12-17"^^xsd:date;
+    dcterms:modified "2016-08-26"^^xsd:date;
+    dcterms:modified "2016-12-15"^^xsd:date;
+    dcterms:publisher <http://www.w3.org/data#W3C>;
+    dcterms:type <http://purl.org/adms/assettype/Ontology>;
+    dcterms:creator [foaf:name "Antoine Isaac"], [foaf:name "Riccardo Albertoni"] ;
+    dcterms:contributor [foaf:name "Jeremy Debattista"], [foaf:name "Makx Dekkers"],  [foaf:name "Christophe Guéret"], [foaf:name "Deirdre Lee"], [foaf:name "Nandana Mihindukulasooriya"], [foaf:name "Amrapali Zaveri"] .
+
+######################
+### Classes here #####
+######################
+
+dqv:QualityMeasurement a owl:Class, rdfs:Class ;
+  rdfs:label "Quality Measurement"@en ;
+  rdfs:comment "Represents the evaluation of a given dataset (or dataset distribution) against a specific quality metric."@en ;
+  owl:equivalentClass daq:Observation;
+  vann:usageNote "The unit of measure in quality measurement should be specified through the property sdmx-attribute:unitMeasure as recommended by RDF Data Cube. The Ontology of units of Measure (OM) by Rijgersberg Et Al provides a list of HTTP dereferenceable unit of measures, which can be exploited as values for sdmx-attribute:unitMeasure."@en ;
+  rdfs:subClassOf qb:Observation .
+
+dqv:Metric a owl:Class, rdfs:Class;
+  rdfs:label "Metric"@en ;
+  rdfs:comment "Represents a standard to measure a quality dimension. An observation (instance of dqv:QualityMeasurement) assigns a value in a given unit to a Metric."@en ;
+  owl:equivalentClass daq:Metric .
+
+dqv:Dimension a owl:Class, rdfs:Class ;
+  rdfs:label "Dimension"@en ;
+  rdfs:comment "Represents criteria relevant for assessing quality. Each quality dimension must have one or more metric to measure it. A dimension is linked with a category using the dqv:inCategory property."@en ;
+  rdfs:subClassOf skos:Concept ;
+  owl:equivalentClass daq:Dimension .
+
+dqv:Category a owl:Class, rdfs:Class ;
+  rdfs:label "Category"@en ;
+  rdfs:comment "Represents a group of quality dimensions in which a common type of information is used as quality indicator."@en ;
+  rdfs:subClassOf skos:Concept ;
+  owl:equivalentClass daq:Category .
+
+dqv:QualityMeasurementDataset a owl:Class, rdfs:Class ;
+  rdfs:label "Quality Measurement Dataset"@en ;
+  rdfs:comment "Represents a dataset of quality measurements, evaluations of one or more datasets (or dataset distributions) against specific quality metrics."@en ;
+  rdfs:subClassOf qb:DataSet ;
+  owl:equivalentClass daq:QualityGraph .
+
+dqv:QualityPolicy a owl:Class, rdfs:Class ;
+  rdfs:label "Quality Policy"@en ;
+  rdfs:comment "Represents a policy or agreement that is chiefly governed by data quality concerns."@en ;
+  .
+
+dqv:QualityAnnotation a owl:Class, rdfs:Class ;
+  rdfs:label "Quality Annotation"@en ;
+  rdfs:comment "Represents quality annotations, including ratings, quality certificates or feedback that can be associated to datasets or distributions. Quality annotations must have one oa:motivatedBy statement with an instance of oa:Motivation (and skos:Concept) that reflects a quality assessment purpose. We define this instance as dqv:qualityAssessment."@en ;
+  rdfs:subClassOf oa:Annotation ;
+  owl:equivalentClass
+    [ rdf:type owl:Restriction ;
+      owl:onProperty oa:motivation ;
+      owl:hasValue dqv:qualityAssessment
+    ] .
+
+dqv:QualityCertificate a owl:Class, rdfs:Class ;
+  rdfs:label "Quality Certificate"@en ;
+  rdfs:comment "An annotation that associates a resource (especially, a dataset or a distribution) to another resource (for example, a document) that certifies the resource's quality according to a set of quality assessment rules."@en ;
+  rdfs:subClassOf dqv:QualityAnnotation.
+
+dqv:UserQualityFeedback a owl:Class, rdfs:Class ;
+  rdfs:label "User Quality feedback"@en ;
+  rdfs:comment "Represents feedback that users have on the quality of datasets or distributions. Besides dqv:qualityAssessment, which is the motivation required by all quality annotations, one of the predefined instances of oa:Motivation should be indicated as motivation to distinguish among the different kinds of feedback, e.g., classifications, questions."@en ;
+  rdfs:subClassOf dqv:QualityAnnotation, duv:UserFeedback .
+
+dqv:QualityMetadata a owl:Class, rdfs:Class ;
+  rdfs:label "Quality Metadata"@en ;
+  rdfs:comment "Represents quality metadata, it is defined to group quality certificates, policies, measurements and annotations under a named graph."@en ;
+  rdfs:subClassOf <http://www.w3.org/2004/03/trix/rdfg-1/Graph> ;
+  vann:usageNote "QualityMetadata containers do not necessary include all types of quality statements DQV can support. Implementers decide the granularity of containment. In the current version of DQV, we also leave open the choice of the containment technique. Implementers can use (RDF) graph containment. They may also use an appropriate property of their choice — for example (a subproperty of) dcterms:hasPart — to link instances of dqv:QualityMetadata with instances of other DQV classes."@en
+.
+
+
+
+###########################
+### Properties here #######
+###########################
+
+dqv:isMeasurementOf a rdf:Property, qb:DimensionProperty ;
+  rdfs:label "is measurement of"@en ;
+  rdfs:comment "Indicates the metric being observed."@en ;
+  rdfs:domain qb:Observation ;
+  rdfs:range dqv:Metric ;
+  owl:equivalentProperty daq:metric .
+
+# this property is still defined in the qb: namespace, the re-definition is therefore commented for now
+# dqv:dataSet a rdf:Property ;
+#  rdfs:label "data set"@en ;
+#  rdfs:comment "Indicates the dataset to which a quality measure (which is an RDF Data Cube observation) belongs."@en ;
+#  rdfs:domain qb:Observation ;
+#  rdfs:range qb:DataSet .
+
+dqv:computedOn a rdf:Property, qb:DimensionProperty ;
+  rdfs:label "computed on"@en ;
+  rdfs:comment "Refers to the resource (e.g., a dataset, a linkset, a graph, a set of triples) on which the quality measurement is performed. In the DQV context, this property is generally expected to be used in statements in which objects are instances of dcat:Dataset or dcat:Distribution."@en ;
+  rdfs:domain dqv:QualityMeasurement ;
+  rdfs:range  rdfs:Resource ; #introduced for compatibility with RDF Data Cube
+  owl:equivalentProperty daq:computedOn;
+  owl:inverseOf dqv:hasQualityMeasurement .
+
+dqv:value a rdf:Property, qb:MeasureProperty, owl:DatatypeProperty ;
+  rdfs:label "value"@en ;
+  rdfs:comment "Refers to values computed by metric."@en ;
+  rdfs:domain dqv:QualityMeasurement ;
+  owl:equivalentProperty daq:value .
+
+dqv:expectedDataType a rdf:Property ;
+  rdfs:label "expected data type"@en ;
+  rdfs:comment "Represents the expected data type for metric's observed value (e.g. xsd:boolean, xsd:double etc...)"@en ;
+  rdfs:domain dqv:Metric ;
+  rdfs:range xsd:anySimpleType ;
+  owl:equivalentProperty daq:expectedDataType .
+
+dqv:inCategory a rdf:Property ;
+  rdfs:label "in category"@en ;
+  rdfs:comment "Represents the category a dimension is grouped in."@en ;
+  rdfs:domain dqv:Dimension ;
+  rdfs:range dqv:Category ;
+  owl:inverseOf daq:hasDimension ;
+  vann:usageNote "Categories are meant to systematically organize dimensions. The Data Quality Vocabulary defines no specific cardinality constraints for dqv:inCategory, since distinct quality frameworks might have different perspectives over a dimension. A dimension may therefore be associated to more than one category. However, those who define new quality metrics should try to avoid this as much as possible and assign only one category to the dimensions they define."@en .
+
+dqv:inDimension a rdf:Property ;
+  rdfs:label "in dimension"@en ;
+  rdfs:comment "Represents the dimensions a quality metric, certificate and annotation allow a measurement of."@en ;
+  rdfs:range dqv:Dimension ;
+  vann:usageNote "Dimensions are meant to systematically organize metrics, quality certificates and quality annotations. The Data Quality Vocabulary defines no specific cardinality constraints for dqv:inDimension, since distinct quality frameworks might have different perspectives over a metric. A metric may therefore be associated to more than one dimension. However, those who define new quality metrics should try to avoid this as much as possible and assign only one dimension to the metrics they define. More than one dimension can be indicated for each quality annotation or certificate."@en .
+
+[ owl:inverseOf daq:hasMetric]  rdfs:subPropertyOf dqv:inDimension .
+
+dqv:hasQualityMeasurement a rdf:Property ;
+  rdfs:label "has quality measurement"@en ;
+  rdfs:comment "Refers to the performed quality measurements. Quality measurements can be performed to any kind of resource (e.g., a dataset, a linkset, a graph, a set of triples). However, in the DQV context, this property is generally expected to be used in statements in which subjects are instances of dcat:Dataset or dcat:Distribution."@en ;
+  rdfs:range dqv:QualityMeasurement ;
+  owl:inverseOf dqv:computedOn .
+
+dqv:hasQualityMetadata a rdf:Property ;
+  rdfs:label "has quality metadata"@en ;
+  rdfs:comment "Refers to a grouping of quality information such as certificates, policies, measurements and annotations as a named graph. Quality information represented in such a grouping can pertain to any kind of resource (e.g., a dataset, a linkset, a graph, a set of triples). However, in the DQV context, this property is generally expected to be used in statements in which subjects are instances of dcat:Dataset or dcat:Distribution."@en ;
+  rdfs:range dqv:QualityMetadata .
+
+dqv:hasQualityAnnotation a rdf:Property ;
+  rdfs:label "has quality annotation"@en ;
+  rdfs:comment "Refers to a quality annotation. Quality annotation can be applied to any kind of resource, e.g., a dataset, a linkset, a graph, a set of triples. However, in the DQV context, this property is generally expected to be used in statements in which subjects are instances of dcat:Dataset or dcat:Distribution."@en ;
+  rdfs:range dqv:QualityAnnotation ;
+  rdfs:subPropertyOf [ owl:inverseOf oa:hasTarget] .
+
+###########################
+### Instances here #######
+###########################
+
+dqv:qualityAssessment a oa:Motivation ;
+  skos:prefLabel "Quality assessment"@en ;
+  skos:definition "Motivation that must be specified for quality annotations."@en ;
+  vann:usageNote  "Whenever DQV implementers need to extend the motivations for quality annotations, they should follow the instructions provided by the Web Annotation Data Model, and the concepts in the extension should be defined as specializations of dqv:qualityAssessment."@en ;
+  skos:broader oa:assessing .
+
+dqv:precision a dqv:Dimension ;
+  skos:prefLabel "Precision"@en ;
+  skos:definition "Precision is a quality dimension, which refers to the recorded level of details. It represents the exactness of a measurement or description. It is equivalent the notion of Precision from ISO 25012."@en .
--- a/frontend/public/ontology/RiC-O_1-1.rdf
+++ b/frontend/public/ontology/RiC-O_1-1.rdf
--- a/frontend/public/ontology/schemaorg.owl
+++ b/frontend/public/ontology/schemaorg.owl
--- a/frontend/public/schemas/20251121/linkml/manifest.json
+++ b/frontend/public/schemas/20251121/linkml/manifest.json
@ -1,5 +1,5 @@
 {
-  "generated": "2026-01-13T00:48:37.685Z",
+  "generated": "2026-01-13T12:50:30.701Z",
  "schemaRoot": "/schemas/20251121/linkml",
  "totalFiles": 2886,
  "categoryCounts": {
--- a/frontend/public/schemas/20251121/linkml/modules/classes/CertificationEntry.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/CertificationEntry.yaml
@ -21,7 +21,23 @@ default_range: string

 classes:
  CertificationEntry:
-      description: Professional certification
+      description: >-
+        A professional certification record documenting credentials held by
+        heritage professionals, including certification name, issuing
+        organization, and date obtained.
+        
+        Ontology mapping rationale:
+        - class_uri is schema:EducationalOccupationalCredential because this
+          represents a professional certification/credential with issuer and date
+        - close_mappings includes schema:Certification (schema.org pending)
+        - related_mappings includes prov:Entity for provenance and
+          schema:Organization for the issuing body
+      class_uri: schema:EducationalOccupationalCredential
+      close_mappings:
+        - schema:Certification
+      related_mappings:
+        - prov:Entity
+        - schema:Organization
      attributes:
        name:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/Container.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/Container.yaml
@ -1,6 +1,13 @@
 id: https://nde.nl/ontology/hc/class/Container
 name: Container
 title: Heritage Custodian Data Container
+
+prefixes:
+  linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
+  prov: http://www.w3.org/ns/prov#
+  schema: http://schema.org/
+
 imports:
 - linkml:types
 - ./Jurisdiction
@ -32,26 +39,27 @@ imports:
 classes:
  Container:
    tree_root: true
-    description: 'Root container class for Heritage Custodian data instances.
-
+    description: >-
+      Root container class for Heritage Custodian data instances.
      Provides tree_root for LinkML instance validation.
      
-
      This container supports all primary entity types for batch validation:
-
      - Core custodian entities (Custodian, observations, names, legal statuses)
-
      - Place and collection aspects (CustodianPlace, CustodianCollection)
-
      - Organizational structures (OrganizationalStructure)
-
      - Reconstruction activities (ReconstructionActivity)
-
      - Registration entities (Jurisdiction, TradeRegister, RegistrationAuthority, RegistrationNumber)
-
      - Standards ecosystem (StandardsOrganization, Standard, AllocationAgency, IdentifierFormat)
      
-      '
+      Ontology mapping rationale:
+      - class_uri is prov:Collection because this is a container aggregating
+        multiple heritage custodian entities for validation purposes
+      - This is a TECHNICAL class for LinkML validation (tree_root: true)
+        and should be EXCLUDED from UML visualizations per Rule 4
+      - related_mappings includes schema:Dataset as this aggregates data records
+    class_uri: prov:Collection
+    related_mappings:
+      - schema:Dataset
    attributes:
      has_or_had_custodian:
        range: Custodian
--- a/frontend/public/schemas/20251121/linkml/modules/classes/CurrentPosition.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/CurrentPosition.yaml
@ -12,6 +12,7 @@ prefixes:
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
+  org: http://www.w3.org/ns/org#

 imports:
  - linkml:types
@ -21,7 +22,25 @@ default_range: string

 classes:
  CurrentPosition:
-      description: Current job position
+      description: >-
+        Current job position held by a heritage professional, capturing
+        job title, company/organization name, duration in role, and start
+        date. Used to track professional affiliations with heritage
+        institutions.
+        
+        Ontology mapping rationale:
+        - class_uri is schema:Role because this represents a role/position
+          held by a person at an organization with temporal properties
+        - close_mappings includes org:Membership from W3C Organization
+          ontology for organizational membership relationships
+        - related_mappings includes schema:Organization for the employer
+          and prov:Entity for provenance
+      class_uri: schema:Role
+      close_mappings:
+        - org:Membership
+      related_mappings:
+        - schema:Organization
+        - prov:Entity
      attributes:
        title:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/CustodianSourceFile.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/CustodianSourceFile.yaml
@ -43,12 +43,25 @@ default_range: string

 classes:
  CustodianSourceFile:
-      description: 'Root class representing the complete structure of a custodian YAML
-        file.
+      description: >-
+        Root class representing the complete structure of a custodian YAML
+        file, serving as the tree_root for LinkML validation. Aggregates
+        all enrichment data including original entry, Google Maps, Wikidata,
+        web claims, museum register, and other source data with full
+        provenance tracking.
        
-        This is the tree_root for validation.
-
-        '
+        Ontology mapping rationale:
+        - class_uri is prov:Entity because this represents a complete data
+          record/file that aggregates multiple enrichment sources
+        - close_mappings includes prov:Bundle as this bundles multiple
+          provenance-tracked data elements
+        - related_mappings includes schema:Dataset as this is essentially
+          a structured dataset file
+      class_uri: prov:Entity
+      close_mappings:
+        - prov:Bundle
+      related_mappings:
+        - schema:Dataset
      tree_root: true
      attributes:
        original_entry:
--- a/frontend/public/schemas/20251121/linkml/modules/classes/DuplicateEntry.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/DuplicateEntry.yaml
@ -12,6 +12,7 @@ prefixes:
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
+  owl: http://www.w3.org/2002/07/owl#

 imports:
  - linkml:types
@ -21,7 +22,23 @@ default_range: string

 classes:
  DuplicateEntry:
-      description: Reference to a duplicate institution entry
+      description: >-
+        Reference to a duplicate institution entry, documenting the label,
+        source index, filename, and reason for duplicate identification.
+        Used for deduplication tracking and entity resolution audit trails.
+        
+        Ontology mapping rationale:
+        - class_uri is prov:Entity because this documents an identified
+          duplicate entity with metadata about the duplication
+        - close_mappings includes owl:sameAs conceptually as this identifies
+          equivalent entities
+        - related_mappings includes prov:Derivation as duplicate detection
+          derives from source data comparison
+      class_uri: prov:Entity
+      close_mappings:
+        - owl:sameAs
+      related_mappings:
+        - prov:Derivation
      attributes:
        label:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/ExaSearchMetadata.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/ExaSearchMetadata.yaml
@ -21,7 +21,23 @@ default_range: string

 classes:
  ExaSearchMetadata:
-      description: Metadata from EXA search operations
+      description: >-
+        Metadata from EXA search operations, capturing tool used, timestamp,
+        source URL, extraction agent, method, and notes. Documents the
+        provenance of data retrieved through EXA web search API.
+        
+        Ontology mapping rationale:
+        - class_uri is prov:Activity because this documents a search/extraction
+          activity performed at a specific time by a specific agent
+        - close_mappings includes schema:SearchAction as this represents a
+          search operation
+        - related_mappings includes prov:Entity as the activity produces
+          entity outputs
+      class_uri: prov:Activity
+      close_mappings:
+        - schema:SearchAction
+      related_mappings:
+        - prov:Entity
      attributes:
        tool:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/GooglePhoto.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/GooglePhoto.yaml
@ -21,7 +21,22 @@ default_range: string

 classes:
  GooglePhoto:
-      description: Google Places API photo data
+      description: >-
+        Photo metadata from Google Places API including reference string, dimensions,
+        and URL. Represents image resources associated with heritage institution
+        place listings.
+        
+        Ontology mapping rationale:
+        - class_uri is schema:ImageObject because this represents image content with
+          dimensions (height, width) and URL - the core properties of ImageObject
+        - close_mappings includes schema:Photograph as a more specific image type
+        - related_mappings includes prov:Entity as this is data retrieved from an
+          external API with provenance implications
+      class_uri: schema:ImageObject
+      close_mappings:
+        - schema:Photograph
+      related_mappings:
+        - prov:Entity
      attributes:
        photo_reference:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/InvalidWebClaim.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/InvalidWebClaim.yaml
@ -12,6 +12,8 @@ prefixes:
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
+  rdf: http://www.w3.org/1999/02/22-rdf-syntax-ns#
+  dqv: http://www.w3.org/ns/dqv#

 imports:
  - linkml:types
@ -21,7 +23,23 @@ default_range: string

 classes:
  InvalidWebClaim:
-      description: Invalid claim with validation reason
+      description: >-
+        A web claim that failed validation, preserving the original extracted
+        data along with the validation failure reason and rule violated.
+        Used for audit trails and quality assessment of extraction processes.
+        
+        Ontology mapping rationale:
+        - class_uri is rdf:Statement because this represents a claim/assertion
+          that was made but found to be invalid - the statement structure is
+          preserved even though the content failed validation
+        - close_mappings includes dqv:QualityAnnotation as this documents a
+          quality issue with extracted data
+        - related_mappings includes prov:Entity for provenance tracking
+      class_uri: rdf:Statement
+      close_mappings:
+        - dqv:QualityAnnotation
+      related_mappings:
+        - prov:Entity
      attributes:
        claim_type:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/LayoutMetadata.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/LayoutMetadata.yaml
@ -21,7 +21,23 @@ default_range: string

 classes:
  LayoutMetadata:
-      description: Metadata about page layout extraction
+      description: >-
+        Metadata about page layout extraction from archived web pages,
+        including page count, archive path, and extraction timestamp.
+        Documents the structural analysis of archived website content.
+        
+        Ontology mapping rationale:
+        - class_uri is prov:Entity because this is metadata generated from
+          a layout extraction activity with provenance properties
+        - close_mappings includes schema:DataCatalog as this documents
+          structural data about pages
+        - related_mappings includes prov:Activity as this metadata results
+          from an extraction activity
+      class_uri: prov:Entity
+      close_mappings:
+        - schema:DataCatalog
+      related_mappings:
+        - prov:Activity
      attributes:
        page_count:
          range: integer
--- a/frontend/public/schemas/20251121/linkml/modules/classes/MediaAppearanceEntry.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/MediaAppearanceEntry.yaml
@ -21,7 +21,23 @@ default_range: string

 classes:
  MediaAppearanceEntry:
-      description: Media appearance (TV, radio, documentary, etc.)
+      description: >-
+        Record of a media appearance such as TV broadcast, radio interview,
+        documentary feature, or podcast episode. Tracks broadcast details
+        including network, air date, and description of the appearance.
+        
+        Ontology mapping rationale:
+        - class_uri is schema:BroadcastEvent because this represents a broadcast
+          occurrence with temporal properties (air_date) and publisher (network)
+        - close_mappings includes schema:Event as a general event type
+        - related_mappings includes schema:MediaObject for the underlying content
+          and prov:Entity for provenance tracking
+      class_uri: schema:BroadcastEvent
+      close_mappings:
+        - schema:Event
+      related_mappings:
+        - schema:MediaObject
+        - prov:Entity
      attributes:
        title:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/MergeNote.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/MergeNote.yaml
@ -12,6 +12,7 @@ prefixes:
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
+  skos: http://www.w3.org/2004/02/skos/core#

 imports:
  - linkml:types
@ -21,7 +22,25 @@ default_range: string

 classes:
  MergeNote:
-      description: Note about a merge operation between duplicate entries
+      description: >-
+        Documentation of a merge operation between duplicate entries, recording
+        the source entry identifier, merge date, and reason (e.g., duplicate
+        Wikidata ID, same place ID). Essential for entity resolution audit
+        trails.
+        
+        Ontology mapping rationale:
+        - class_uri is prov:Entity because this documents a merge operation
+          result with full provenance (source, date, reason)
+        - close_mappings includes skos:note as this is essentially a note
+          documenting a change
+        - related_mappings includes prov:Activity as merging is an activity
+          and prov:Derivation for the derivation relationship
+      class_uri: prov:Entity
+      close_mappings:
+        - skos:note
+      related_mappings:
+        - prov:Activity
+        - prov:Derivation
      attributes:
        source:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/PatternClassification.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/PatternClassification.yaml
@ -12,6 +12,8 @@ prefixes:
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
+  skos: http://www.w3.org/2004/02/skos/core#
+  dqv: http://www.w3.org/ns/dqv#

 imports:
  - linkml:types
@ -21,7 +23,24 @@ default_range: string

 classes:
  PatternClassification:
-      description: Classification pattern details
+      description: >-
+        Classification pattern details documenting the method (e.g., regex
+        pattern matching), confidence score, and timestamp of a classification
+        operation. Used to track how entities were automatically categorized.
+        
+        Ontology mapping rationale:
+        - class_uri is skos:Concept because classification assigns conceptual
+          categories to entities based on pattern matching
+        - close_mappings includes dqv:QualityMeasurement as the confidence score
+          represents a quality assessment
+        - related_mappings includes prov:Activity as classification is an
+          algorithmic activity and prov:Entity for the result
+      class_uri: skos:Concept
+      close_mappings:
+        - dqv:QualityMeasurement
+      related_mappings:
+        - prov:Activity
+        - prov:Entity
      attributes:
        method:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/PhotoMetadata.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/PhotoMetadata.yaml
@ -22,7 +22,23 @@ default_range: string

 classes:
  PhotoMetadata:
-      description: Google Maps photo metadata
+      description: >-
+        Metadata about photos from Google Maps including dimensions and author
+        attributions. Extends basic photo information with creator/contributor
+        tracking.
+        
+        Ontology mapping rationale:
+        - class_uri is schema:ImageObject because this represents image metadata
+          with standard properties (name, height, width)
+        - close_mappings includes schema:Photograph for photographic content
+        - related_mappings includes prov:Entity for provenance tracking and
+          schema:MediaObject as a broader media type
+      class_uri: schema:ImageObject
+      close_mappings:
+        - schema:Photograph
+      related_mappings:
+        - prov:Entity
+        - schema:MediaObject
      attributes:
        name:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/PublicationEntry.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/PublicationEntry.yaml
@ -12,6 +12,8 @@ prefixes:
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
+  bf: http://id.loc.gov/ontologies/bibframe/
+  dcterms: http://purl.org/dc/terms/

 imports:
  - linkml:types
@ -21,7 +23,26 @@ default_range: string

 classes:
  PublicationEntry:
-      description: Academic or professional publication
+      description: >-
+        An academic or professional publication record, capturing bibliographic
+        metadata including title, publisher, year, and description. Used to
+        document scholarly works associated with heritage professionals or
+        institutions.
+        
+        Ontology mapping rationale:
+        - class_uri is schema:ScholarlyArticle because this represents academic
+          publications with standard bibliographic properties
+        - close_mappings includes bf:Work (BIBFRAME work entity) and
+          dcterms:BibliographicResource for library/bibliographic contexts
+        - related_mappings includes schema:CreativeWork as a broader creative
+          work type and prov:Entity for provenance
+      class_uri: schema:ScholarlyArticle
+      close_mappings:
+        - bf:Work
+        - dcterms:BibliographicResource
+      related_mappings:
+        - schema:CreativeWork
+        - prov:Entity
      attributes:
        title:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/ReferenceLink.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/ReferenceLink.yaml
@ -21,7 +21,21 @@ default_range: string

 classes:
  ReferenceLink:
-      description: URL reference from source
+      description: >-
+        A URL reference from a source document, representing a hyperlink to
+        related or supporting information. Simple link structure with label
+        containing the URL.
+        
+        Ontology mapping rationale:
+        - class_uri is schema:WebPage because this represents a reference to
+          a web resource via URL
+        - close_mappings includes schema:URL as this is essentially a URL reference
+        - related_mappings includes prov:Entity for provenance tracking
+      class_uri: schema:WebPage
+      close_mappings:
+        - schema:URL
+      related_mappings:
+        - prov:Entity
      attributes:
        label:
          range: uri
--- a/frontend/public/schemas/20251121/linkml/modules/classes/RejectedGoogleMapsData.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/RejectedGoogleMapsData.yaml
@ -21,7 +21,24 @@ default_range: string

 classes:
  RejectedGoogleMapsData:
-      description: Rejected Google Maps data preserved for audit trail
+      description: >-
+        Rejected Google Maps data preserved for audit trail, documenting
+        place data that was fetched but rejected due to validation failures
+        (e.g., country mismatch). Includes place ID, name, address, coordinates,
+        expected vs returned country, and timestamps.
+        
+        Ontology mapping rationale:
+        - class_uri is prov:Entity because this is data preserved for
+          audit purposes with full provenance
+        - close_mappings includes prov:InvalidatedEntity as this data was
+          explicitly rejected/invalidated
+        - related_mappings includes schema:Place as the underlying data
+          describes a geographic place
+      class_uri: prov:Entity
+      close_mappings:
+        - prov:InvalidatedEntity
+      related_mappings:
+        - schema:Place
      attributes:
        place_id:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/RelatedYoutubeVideo.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/RelatedYoutubeVideo.yaml
@ -21,7 +21,24 @@ default_range: string

 classes:
  RelatedYoutubeVideo:
-      description: Related YouTube video about the institution from external channels
+      description: >-
+        A YouTube video related to a heritage institution, published by an
+        external channel. Captures video metadata including ID, URL, title,
+        channel name, and the type of relationship (news coverage, documentary,
+        interview, etc.).
+        
+        Ontology mapping rationale:
+        - class_uri is schema:VideoObject because this represents video content
+          with standard video properties (URL, title, publisher/channel)
+        - close_mappings includes schema:MediaObject as a broader media type
+        - related_mappings includes schema:CreativeWork for the creative content
+          aspect and prov:Entity for provenance tracking
+      class_uri: schema:VideoObject
+      close_mappings:
+        - schema:MediaObject
+      related_mappings:
+        - schema:CreativeWork
+        - prov:Entity
      attributes:
        video_id:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/ResearchSourceData.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/ResearchSourceData.yaml
@ -21,7 +21,25 @@ default_range: string

 classes:
  ResearchSourceData:
-      description: Structured data from a research source
+      description: >-
+        Structured data from WHOIS research sources including domain registrant
+        information (name, address, city, state, country, postal code),
+        organization, contact details (email, phone), and domain lifecycle
+        dates (creation, update, expiration, registration). Used for
+        institutional identity verification.
+        
+        Ontology mapping rationale:
+        - class_uri is prov:Entity because this is structured data extracted
+          from a WHOIS research source with provenance implications
+        - close_mappings includes schema:Organization as the data primarily
+          describes organizational registrant information
+        - related_mappings includes prov:PrimarySource as WHOIS is an
+          authoritative data source
+      class_uri: prov:Entity
+      close_mappings:
+        - schema:Organization
+      related_mappings:
+        - prov:PrimarySource
      attributes:
        registrant_name:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/ReviewsSummary.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/ReviewsSummary.yaml
@ -21,7 +21,21 @@ default_range: string

 classes:
  ReviewsSummary:
-      description: Breakdown of reviews by star rating
+      description: >-
+        Breakdown of reviews by star rating (1-5 stars), showing the count
+        of reviews at each rating level. Provides aggregate review statistics
+        for heritage institutions from platforms like Google Maps.
+        
+        Ontology mapping rationale:
+        - class_uri is schema:AggregateRating because this represents
+          aggregated review statistics with count breakdowns by rating
+        - close_mappings includes schema:Rating as this involves rating data
+        - related_mappings includes prov:Entity for provenance tracking
+      class_uri: schema:AggregateRating
+      close_mappings:
+        - schema:Rating
+      related_mappings:
+        - prov:Entity
      attributes:
        5_star:
          range: integer
--- a/frontend/public/schemas/20251121/linkml/modules/classes/UnescoIchElement.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/UnescoIchElement.yaml
@ -12,6 +12,7 @@ prefixes:
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
+  skos: http://www.w3.org/2004/02/skos/core#

 imports:
  - linkml:types
@ -22,7 +23,23 @@ default_range: string

 classes:
  UnescoIchElement:
-      description: Single UNESCO ICH element
+      description: >-
+        A UNESCO Intangible Cultural Heritage (ICH) element, representing
+        traditions, practices, or cultural expressions inscribed on UNESCO
+        lists. Captures ICH ID, name, list type, inscription year, whether
+        multinational, URL, and description.
+        
+        Ontology mapping rationale:
+        - class_uri is skos:Concept because ICH elements are conceptual
+          categories in UNESCO's intangible heritage classification system
+        - close_mappings includes schema:Thing as ICH elements are identifiable
+          things with names and descriptions
+        - related_mappings includes prov:Entity for provenance tracking
+      class_uri: skos:Concept
+      close_mappings:
+        - schema:Thing
+      related_mappings:
+        - prov:Entity
      attributes:
        unesco_ich_id:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/classes/WebArchiveFailure.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/WebArchiveFailure.yaml
@ -21,7 +21,24 @@ default_range: string

 classes:
  WebArchiveFailure:
-      description: Failed archive attempt record
+      description: >-
+        Record of a failed web archive attempt, documenting the URL that could
+        not be archived, the failure reason, archivability status, and retry
+        history. Essential for audit trails and troubleshooting extraction
+        pipelines.
+        
+        Ontology mapping rationale:
+        - class_uri is prov:Entity because this is a data record documenting
+          a failed activity - the failure itself is an entity with provenance
+        - close_mappings includes prov:InvalidatedEntity as the archive attempt
+          was invalidated/failed
+        - related_mappings includes schema:Action as the underlying archiving
+          action that failed
+      class_uri: prov:Entity
+      close_mappings:
+        - prov:InvalidatedEntity
+      related_mappings:
+        - schema:Action
      attributes:
        url:
          range: uri
--- a/frontend/public/schemas/20251121/linkml/modules/classes/WebClaimsBlock.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/WebClaimsBlock.yaml
@ -25,7 +25,23 @@ default_range: string

 classes:
  WebClaimsBlock:
-      description: Claims extracted from archived websites
+      description: >-
+        Container for claims extracted from archived websites, including valid
+        claims, removed invalid claims, validation metadata, and layout
+        integration status. Serves as a collection of web observations with
+        full provenance tracking.
+        
+        Ontology mapping rationale:
+        - class_uri is prov:Collection because this aggregates multiple WebClaim
+          entities extracted from the same source archive
+        - close_mappings includes schema:Collection as a general collection type
+        - related_mappings includes prov:Entity as this block is itself an entity
+          with extraction timestamp and provenance
+      class_uri: prov:Collection
+      close_mappings:
+        - schema:Collection
+      related_mappings:
+        - prov:Entity
      attributes:
        extraction_timestamp:
          range: datetime
--- a/frontend/public/schemas/20251121/linkml/modules/classes/WebCollection.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/classes/WebCollection.yaml
@ -12,6 +12,7 @@ prefixes:
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
+  dcmitype: http://purl.org/dc/dcmitype/

 imports:
  - linkml:types
@ -21,7 +22,24 @@ default_range: string

 classes:
  WebCollection:
-      description: A collection documented on a heritage institution website
+      description: >-
+        A collection documented on a heritage institution website, such as
+        oral history recordings, photograph archives, or document collections.
+        Captures collection metadata including name, description, URL, type,
+        item count, and total hours for audio/video content.
+        
+        Ontology mapping rationale:
+        - class_uri is dcmitype:Collection because this represents a curated
+          aggregation of heritage items documented on an institutional website
+        - close_mappings includes schema:Collection for web-discoverable collections
+        - related_mappings includes prov:Entity for provenance tracking and
+          schema:CreativeWork as collections contain creative works
+      class_uri: dcmitype:Collection
+      close_mappings:
+        - schema:Collection
+      related_mappings:
+        - prov:Entity
+        - schema:CreativeWork
      attributes:
        name:
          range: string
--- a/frontend/public/schemas/20251121/linkml/modules/slots/activity_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/activity_id.yaml
@ -4,12 +4,16 @@ title: Activity Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  activity_id:
-    description: "[AUTO-GENERATED STUB] Activity Id"
+    description: 'Unique identifier for an activity. Mapped to dcterms:identifier
+      as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:activityId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/admin_office_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/admin_office_id.yaml
@ -4,12 +4,16 @@ title: Admin Office Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  admin_office_id:
-    description: "[AUTO-GENERATED STUB] Admin Office Id"
+    description: 'Unique identifier for an administrative office. Mapped to
+      dcterms:identifier as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:adminOfficeId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/agenda_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/agenda_id.yaml
@ -4,12 +4,16 @@ title: Agenda Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  agenda_id:
-    description: "[AUTO-GENERATED STUB] Agenda Id"
+    description: 'Unique identifier for an agenda. Mapped to dcterms:identifier
+      as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:agendaId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/annex_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/annex_id.yaml
@ -4,12 +4,16 @@ title: Annex Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  annex_id:
-    description: "[AUTO-GENERATED STUB] Annex Id"
+    description: 'Unique identifier for an annex. Mapped to dcterms:identifier
+      as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:annexId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/appraisal_notes.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/appraisal_notes.yaml
@ -5,11 +5,18 @@ prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  appraisal_notes:
-    description: "[AUTO-GENERATED STUB] Appraisal Notes"
+    description: >-
+      Notes on the appraisal process or valuation of archival/heritage materials.
+      
+      Maps to skos:note for general documentation notes about a resource.
    range: string
-    slot_uri: hc:appraisalNotes
+    slot_uri: skos:note
+    close_mappings:
+      - dcterms:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/arrangement_notes.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/arrangement_notes.yaml
@ -5,11 +5,18 @@ prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  arrangement_notes:
-    description: "[AUTO-GENERATED STUB] Arrangement Notes"
+    description: >-
+      Notes on the arrangement or organization of archival materials.
+      
+      Maps to skos:note for general documentation notes about resource organization.
    range: string
-    slot_uri: hc:arrangementNotes
+    slot_uri: skos:note
+    close_mappings:
+      - dcterms:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/assertion_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/assertion_id.yaml
@ -4,12 +4,16 @@ title: Assertion Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  assertion_id:
-    description: "[AUTO-GENERATED STUB] Assertion Id"
+    description: 'Unique identifier for an assertion. Mapped to dcterms:identifier
+      as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:assertionId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/auxiliary_place_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/auxiliary_place_id.yaml
@ -4,12 +4,16 @@ title: Auxiliary Place Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  auxiliary_place_id:
-    description: "[AUTO-GENERATED STUB] Auxiliary Place Id"
+    description: 'Unique identifier for an auxiliary place. Mapped to dcterms:identifier
+      as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:auxiliaryPlaceId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/auxiliary_platform_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/auxiliary_platform_id.yaml
@ -4,12 +4,16 @@ title: Auxiliary Platform Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  auxiliary_platform_id:
-    description: "[AUTO-GENERATED STUB] Auxiliary Platform Id"
+    description: 'Unique identifier for an auxiliary digital platform. Mapped to
+      dcterms:identifier as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:auxiliaryPlatformId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/base_surname.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/base_surname.yaml
@ -10,48 +10,31 @@ imports:
 - linkml:types
 slots:
  base_surname:
-    slot_uri: hc:baseSurname
-    description: 'Family name WITHOUT prefixes, used for alphabetical sorting.
-
+    slot_uri: pnv:baseSurname
+    description: >-
+      Family name WITHOUT prefixes, used for alphabetical sorting.

      In Dutch naming conventions, surnames with prefixes (tussenvoegsels) like
-
      "van", "de", "van der", etc. are sorted by the main surname element,
-
      ignoring the prefix.

-
      This property captures just the sortable surname component:

-
      Examples:
-
      - "de Vries" → base_surname: "Vries" (sorts under V)
-
      - "van den Berg" → base_surname: "Berg" (sorts under B)
-
      - "van der Waals" → base_surname: "Waals" (sorts under W)
-
-      - "in ''t Veld" → base_surname: "Veld" (sorts under V)
-
+      - "in 't Veld" → base_surname: "Veld" (sorts under V)

      Equivalent to BioDes:geslachtsnaam in Dutch heritage standards.

-
      IMPORTANT: Belgian Dutch and some international conventions may sort
-
      by the full surname including prefix. In those cases, use the full
-
      surname here or handle sorting differently in your application.

-
      For surnames without prefixes, base_surname equals the full surname:
-
      - "Jansen" → base_surname: "Jansen"
-
      - "Bakker" → base_surname: "Bakker"
-
-      '
    range: string
    exact_mappings:
      - pnv:baseSurname
@ -64,4 +47,4 @@ slots:
    comments:
      - >-
        pnv:baseSurname is from Person Name Vocabulary (https://w3id.org/pnv#).
-      Uses hc: namespace since pnv is not a core ontology in this schema.
+        Uses pnv: namespace directly as the primary slot_uri.
--- a/frontend/public/schemas/20251121/linkml/modules/slots/binding_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/binding_description.yaml
@ -4,13 +4,18 @@ title: Binding Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  binding_description:
-    description: 'Detailed description of binding (decorations, tooling, condition).
+    description: >-
+      Detailed description of binding (decorations, tooling, condition).
      
-      '
+      Maps to dcterms:description for physical characteristics of bound materials.
    range: string
-    slot_uri: hc:bindingDescription
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/bold_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/bold_id.yaml
@ -4,15 +4,20 @@ title: Bold Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  bold_id:
-    description: 'Barcode of Life Data System (BOLD) record ID.
+    description: 'Barcode of Life Data System (BOLD) record ID. Mapped to
+      dcterms:identifier as the standard property for external identifiers.

      Links to DNA barcode data.

      '
    range: string
-    slot_uri: hc:boldId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/branch_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/branch_description.yaml
@ -4,24 +4,24 @@ title: Branch Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  branch_description:
-    description: 'Free-text description of this organizational branch.
+    description: >-
+      Free-text description of this organizational branch.
      
+      Maps to dcterms:description for organizational unit descriptions.
      
      Include:
-
      - Mission/purpose of branch
-
      - Services provided
-
      - Collections managed
-
      - Relationship to main organization
-
-      '
    range: string
-    slot_uri: hc:branchDescription
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/branch_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/branch_id.yaml
@ -4,15 +4,20 @@ title: Branch Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  branch_id:
-    description: 'Unique identifier for this organizational branch.
+    description: 'Unique identifier for this organizational branch. Mapped to
+      dcterms:identifier as the standard property for resource identifiers.

      Format: URI following NDE Heritage Custodian ontology conventions.

      '
    range: uriorcurie
-    slot_uri: hc:branchId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/branch_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/branch_name.yaml
@ -4,19 +4,20 @@ title: Branch Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  branch_name:
-    description: 'Official name of this organizational branch.
+    description: >-
+      Official name of this organizational branch.
      
-
-      SKOS: prefLabel for preferred name.
-
-
-      This is the formal name of the branch as used in official documents.
-
-      '
+      Ontology mapping: skos:prefLabel is the standard SKOS property for 
+      preferred human-readable labels. This is the formal name of the 
+      branch as used in official documents.
    range: string
-    slot_uri: hc:branchName
+    slot_uri: skos:prefLabel
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/branch_office_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/branch_office_description.yaml
@ -4,24 +4,24 @@ title: Branch Office Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  branch_office_description:
-    description: 'Free-text description of this branch office.
+    description: >-
+      Free-text description of this branch office.
      
+      Maps to dcterms:description for location/office descriptions.

      Include:
-
      - Services offered at this location
-
      - Target audience/community served
-
      - Distinguishing features from main location
-
      - Access information
-
-      '
    range: string
-    slot_uri: hc:branchOfficeDescription
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/branch_office_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/branch_office_id.yaml
@ -4,15 +4,20 @@ title: Branch Office Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  branch_office_id:
-    description: 'Unique identifier for this branch office.
+    description: 'Unique identifier for this branch office. Mapped to
+      dcterms:identifier as the standard property for resource identifiers.

      Format: URI following NDE Heritage Custodian ontology conventions.

      '
    range: uriorcurie
-    slot_uri: hc:branchOfficeId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/branch_office_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/branch_office_name.yaml
@ -4,19 +4,20 @@ title: Branch Office Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  branch_office_name:
-    description: 'Name of this branch office.
-
-
-      SKOS: prefLabel for preferred name.
-
+    description: >-
+      Name of this branch office.
      
+      Ontology mapping: skos:prefLabel is the standard SKOS property for 
+      preferred human-readable labels.
      Typically includes parent organization name + branch location/function.
-
-      '
    range: string
-    slot_uri: hc:branchOfficeName
+    slot_uri: skos:prefLabel
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/budget_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/budget_description.yaml
@ -4,13 +4,18 @@ title: Budget Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  budget_description:
-    description: 'Narrative description of budget scope, priorities, and key allocations.
+    description: >-
+      Narrative description of budget scope, priorities, and key allocations.
      
-      '
+      Maps to dcterms:description for financial resource descriptions.
    range: string
-    slot_uri: hc:budgetDescription
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/budget_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/budget_name.yaml
@ -4,22 +4,23 @@ title: Budget Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  budget_name:
-    description: 'Name/title for this budget.
+    description: >-
+      Name/title for this budget document.
      
+      Maps to dcterms:title as a formal title for a financial planning resource.

      **Examples**:
-
      - "Rijksmuseum Operating Budget FY2024"
-
      - "Noord-Hollands Archief Annual Budget 2024-2025"
-
      - "Wallace Collection Capital Plan 2024-2028"
-
-      '
    range: string
-    slot_uri: hc:budgetName
+    slot_uri: dcterms:title
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/call_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/call_description.yaml
@ -4,11 +4,18 @@ title: Call Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  call_description:
    range: string
-    description: Detailed description of the funding call and its objectives
-    slot_uri: hc:callDescription
+    description: >-
+      Detailed description of the funding call and its objectives.
+      
+      Maps to dcterms:description for grant/funding opportunity descriptions.
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/call_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/call_id.yaml
@ -4,6 +4,8 @@ title: Call Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
@ -11,9 +13,12 @@ slots:
  call_id:
    identifier: true
    range: uriorcurie
-    description: 'Unique identifier for this funding call.
+    description: 'Unique identifier for this funding call. Mapped to dcterms:identifier
+      as the standard property for resource identifiers.

      Format: https://nde.nl/ontology/hc/call/{issuing-org-slug}/{call-code}

      '
-    slot_uri: hc:callId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/call_identifier.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/call_identifier.yaml
@ -4,6 +4,8 @@ title: Call Identifiers Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
@ -11,5 +13,8 @@ slots:
  call_identifier:
    range: uriorcurie
    multivalued: true
-    description: External identifiers (EU Funding & Tenders ID, etc.)
-    slot_uri: hc:callIdentifiers
+    description: 'External identifiers (EU Funding & Tenders ID, etc.). Mapped to
+      dcterms:identifier as the standard property for resource identifiers.'
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/call_short_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/call_short_name.yaml
@ -4,15 +4,17 @@ title: Call Short Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  call_short_name:
    range: string
-    description: 'Short name or official code for the call.
+    description: >-
+      Short name or official code for the call.
      
+      Ontology mapping: skos:altLabel is the standard SKOS property for 
+      alternative labels including abbreviations and codes.
      Often used in EU Funding & Tenders portal.
-
-      '
-    slot_uri: hc:callShortName
+    slot_uri: skos:altLabel
--- a/frontend/public/schemas/20251121/linkml/modules/slots/call_title.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/call_title.yaml
@ -4,15 +4,20 @@ title: Call Title Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  call_title:
    range: string
-    description: 'Official title of the funding call.
+    description: >-
+      Official title of the funding call.
      
+      Ontology mapping: dcterms:title is the Dublin Core property for 
+      the name given to a resource.
      Should match documentation exactly for discoverability.
-
-      '
-    slot_uri: hc:callTitle
+    slot_uri: dcterms:title
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/call_url.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/call_url.yaml
@ -4,11 +4,16 @@ title: Call Url Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  schema: http://schema.org/
+  foaf: http://xmlns.com/foaf/0.1/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  call_url:
    range: uri
-    description: Official call documentation or application portal URL
-    slot_uri: hc:callUrl
+    description: 'Official call documentation or application portal URL. Mapped to
+      schema:url as the standard property for web addresses.'
+    slot_uri: schema:url
+    close_mappings:
+      - foaf:page
--- a/frontend/public/schemas/20251121/linkml/modules/slots/capacity_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/capacity_description.yaml
@ -4,18 +4,20 @@ title: Capacity Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  capacity_description:
-    description: 'Free-text description of storage capacity.
-
+    description: >-
+      Free-text description of storage capacity.
      
+      Maps to dcterms:description for qualitative capacity descriptions.
      Use when precise measurements not available or when capacity
-
      is better described qualitatively.
-
-      '
    range: string
-    slot_uri: hc:capacityDescription
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/category_note.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/category_note.yaml
@ -4,11 +4,18 @@ title: Category Notes Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  category_note:
-    description: Notes specific to this category assessment
+    description: >-
+      Notes specific to this category assessment.
+      
+      Maps to skos:note for documentation notes about classification decisions.
    range: string
-    slot_uri: hc:categoryNotes
+    slot_uri: skos:note
+    close_mappings:
+      - dcterms:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/certainty_note.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/certainty_note.yaml
@ -4,13 +4,18 @@ title: Certainty Notes Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  certainty_note:
-    description: 'Explanation of certainty assessment.
+    description: >-
+      Explanation of certainty assessment.
      
-      '
+      Maps to skos:note for documentation notes about confidence/certainty levels.
    range: string
-    slot_uri: hc:certaintyNotes
+    slot_uri: skos:note
+    close_mappings:
+      - dcterms:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/chapter_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/chapter_description.yaml
@ -4,28 +4,24 @@ title: chapter_description slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  chapter_description:
-    description: 'Optional detailed description of chapter content.
-
-
-      Schema.org: description for chapter details.
-
+    description: >-
+      Optional detailed description of chapter content.
      
+      Maps to dcterms:description (aligns with Schema.org description).
      Longer-form description than title. May include:
-
      - Topics covered
-
      - Featured artworks
-
      - Key points discussed
      
-
      Not all platforms display chapter descriptions.
-
-      '
    range: string
-    slot_uri: hc:chapterDescription
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/chapter_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/chapter_id.yaml
@ -4,15 +4,15 @@ title: chapter_id slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  chapter_id:
-    description: 'Unique identifier for this chapter.
-
-
-      Dublin Core: identifier for unique identification.
+    description: 'Unique identifier for this chapter. Mapped to dcterms:identifier
+      as the standard property for unique identification.


      **Format**: Platform-specific or UUID
@ -23,4 +23,6 @@ slots:

      '
    range: string
-    slot_uri: hc:chapterId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/chapter_thumbnail_url.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/chapter_thumbnail_url.yaml
@ -4,15 +4,15 @@ title: chapter_thumbnail_url slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  schema: http://schema.org/
+  foaf: http://xmlns.com/foaf/0.1/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  chapter_thumbnail_url:
-    description: 'URL to thumbnail image for this chapter.
-
-
-      Schema.org: thumbnailUrl for preview image.
+    description: 'URL to thumbnail image for this chapter. Mapped to schema:thumbnailUrl
+      as the specific Schema.org property for preview images.


      **Platform Behavior**:
@ -26,4 +26,6 @@ slots:

      '
    range: uri
-    slot_uri: hc:chapterThumbnailUrl
+    slot_uri: schema:thumbnailUrl
+    close_mappings:
+      - foaf:thumbnail
--- a/frontend/public/schemas/20251121/linkml/modules/slots/chapter_title.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/chapter_title.yaml
@ -4,32 +4,28 @@ title: chapter_title slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  chapter_title:
-    description: 'Title of the chapter as displayed to viewers.
-
-
-      Schema.org: name for the chapter''s title.
+    description: >-
+      Title of the chapter as displayed to viewers.
      
+      Ontology mapping: dcterms:title is the Dublin Core property for 
+      the name given to a resource, applicable to video chapters.

      **Best Practices**:
-
      - Keep titles concise (under 50 characters)
-
      - Use descriptive, meaningful titles
-
      - Avoid timestamps in title (redundant)

-
      **Auto-Generated Titles**:
-
      - YouTube AI: Often generic ("Introduction", "Main Content")
-
      - May need manual refinement for heritage content
-
-      '
    range: string
-    slot_uri: hc:chapterTitle
+    slot_uri: dcterms:title
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/claim_note.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/claim_note.yaml
@ -4,11 +4,18 @@ title: claim_notes slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  claim_note:
    range: string
-    description: Notes about this specific claim extraction
-    slot_uri: hc:claimNotes
+    description: >-
+      Notes about this specific claim extraction.
+      
+      Maps to skos:note for documentation notes about data extraction process.
+    slot_uri: skos:note
+    close_mappings:
+      - dcterms:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/cms_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/cms_id.yaml
@ -4,12 +4,15 @@ title: Cms Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  cms_id:
-    description: 'Unique identifier for this CMS instance/deployment.
+    description: 'Unique identifier for this CMS instance/deployment. Mapped to
+      dcterms:identifier as the standard property for resource identifiers.

      Format: URI following NDE Heritage Custodian ontology conventions.

@ -22,4 +25,6 @@ slots:

      '
    range: uriorcurie
-    slot_uri: hc:cmsId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/cms_product_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/cms_product_name.yaml
@ -4,37 +4,30 @@ title: Cms Product Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  schema: http://schema.org/
+  skos: http://www.w3.org/2004/02/skos/core#
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  cms_product_name:
-    description: 'Name of the CMS software product.
-
-
-      Schema.org: name for the software application name.
+    description: >-
+      Name of the CMS software product.
      
+      Ontology mapping: schema:name is the Schema.org property for the 
+      name of an item, specifically applicable to software applications.

      Examples:
-
      - "CollectiveAccess"
-
      - "MuseumPlus"
-
      - "Adlib"
-
      - "TMS (The Museum System)"
-
      - "ArchivesSpace"
-
      - "MAIS-Flexis"
-
      - "Omeka S"
-
      - "DSpace"
-
      - "ResourceSpace"
-
-      '
    range: string
-    slot_uri: hc:cmsProductName
+    slot_uri: schema:name
+    close_mappings:
+      - skos:prefLabel
--- a/frontend/public/schemas/20251121/linkml/modules/slots/collection_discovery_score.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/collection_discovery_score.yaml
@ -12,6 +12,8 @@ title: Collection Discovery Score Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  sosa: http://www.w3.org/ns/sosa/
+  prov: http://www.w3.org/ns/prov#

 default_prefix: hc

@ -20,8 +22,15 @@ imports:

 slots:
  collection_discovery_score:
-    slot_uri: hc:collectionDiscoveryScore
+    slot_uri: sosa:hasSimpleResult
    range: float
    minimum_value: 0.0
    maximum_value: 1.0
-    description: Specificity score for collection exploration
+    description: >-
+      Specificity score for collection exploration.
+      
+      **Ontology mapping**: Uses sosa:hasSimpleResult because this is a
+      computed relevance score from search/retrieval algorithms acting as
+      observation systems.
+    close_mappings:
+    - prov:value
--- a/frontend/public/schemas/20251121/linkml/modules/slots/collection_type_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/collection_type_description.yaml
@ -4,16 +4,18 @@ title: Collection Type Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  collection_type_description:
-    description: 'Definition of this collection type.
+    description: >-
+      Definition of this collection type.
      
-
-      SKOS: definition for formal definition.
-
-      '
+      Maps to skos:definition for formal definition of a controlled vocabulary term.
    range: string
-    slot_uri: hc:collectionTypeDescription
+    slot_uri: skos:definition
+    close_mappings:
+      - dcterms:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/collection_type_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/collection_type_id.yaml
@ -4,13 +4,18 @@ title: Collection Type Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  collection_type_id:
-    description: 'Unique identifier for this collection type.
+    description: 'Unique identifier for this collection type. Mapped to
+      dcterms:identifier as the standard property for resource identifiers.

      '
    range: uriorcurie
-    slot_uri: hc:collectionTypeId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/collection_type_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/collection_type_name.yaml
@ -4,16 +4,16 @@ title: Collection Type Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  collection_type_name:
-    description: 'Preferred name for this collection type.
+    description: >-
+      Preferred name for this collection type.
      
-
-      SKOS: prefLabel for primary term.
-
-      '
+      Ontology mapping: skos:prefLabel is the standard SKOS property for 
+      the primary lexical label of a concept.
    range: string
-    slot_uri: hc:collectionTypeName
+    slot_uri: skos:prefLabel
--- a/frontend/public/schemas/20251121/linkml/modules/slots/comment_author_channel_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/comment_author_channel_id.yaml
@ -4,11 +4,16 @@ title: Comment Author Channel Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  comment_author_channel_id:
-    description: Platform channel/account ID of author
+    description: 'Platform channel/account ID of author. Mapped to dcterms:identifier
+      as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:commentAuthorChannelId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/comment_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/comment_id.yaml
@ -4,11 +4,16 @@ title: Comment Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  comment_id:
-    description: Unique identifier for the comment
+    description: 'Unique identifier for the comment. Mapped to dcterms:identifier
+      as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:commentId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/complex_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/complex_name.yaml
@ -4,13 +4,19 @@ title: Complex Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  complex_name:
-    description: 'Name of the complex/ensemble if applicable.
+    description: >-
+      Name of the complex/ensemble if applicable.
      
-      '
+      Ontology mapping: skos:prefLabel is the standard SKOS property for 
+      preferred human-readable labels.
    range: string
-    slot_uri: hc:complexName
+    slot_uri: skos:prefLabel
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/condition_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/condition_id.yaml
@ -4,15 +4,20 @@ title: Condition Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  condition_id:
-    description: 'Unique identifier for this condition observation.
+    description: 'Unique identifier for this condition observation. Mapped to
+      dcterms:identifier as the standard property for resource identifiers.

      Format: URI following NDE Heritage Custodian ontology conventions.

      '
    range: uriorcurie
-    slot_uri: hc:conditionId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/confidence.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/confidence.yaml
@ -3,12 +3,15 @@ name: confidence_slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  sosa: http://www.w3.org/ns/sosa/
+  prov: http://www.w3.org/ns/prov#
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_range: string
 slots:
  confidence:
-    slot_uri: hc:confidence
+    slot_uri: sosa:hasSimpleResult
    description: 'Confidence score for AI-generated content.


@ -32,6 +35,11 @@ slots:

      - < 0.7: Low, flag for human verification

+
+      **Ontology mapping**: Uses sosa:hasSimpleResult because AI/ML models
+      act as sensors producing observation results. The confidence score is
+      the simple (scalar) result of a classification/detection observation.
+
      '
    range: float
    minimum_value: 0.0
--- a/frontend/public/schemas/20251121/linkml/modules/slots/confidence_score.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/confidence_score.yaml
@ -2,10 +2,11 @@ id: https://nde.nl/ontology/hc/slot/confidence_score
 name: confidence_score_slot
 prefixes:
  hc: https://nde.nl/ontology/hc/
+  sosa: http://www.w3.org/ns/sosa/
  prov: http://www.w3.org/ns/prov#
 slots:
  confidence_score:
-    slot_uri: hc:confidenceScore
+    slot_uri: sosa:hasSimpleResult
    range: float
    minimum_value: 0.0
    maximum_value: 1.0
@ -22,11 +23,13 @@ slots:
      Range: 0.0 (low confidence) to 1.0 (high confidence)


-      PROV-O Extension: prov:confidence for activity quality assessment.
+      **Ontology mapping**: Uses sosa:hasSimpleResult because the confidence
+      score is a computed observation result from an automated quality assessment
+      process acting as a "sensor" observing methodology quality.

      '
-    related_mappings:
+    close_mappings:
    - prov:value
    comments:
    - prov:confidence does not exist as a PROV-O predicate
-    - Use prov:value for generic value assertions in PROV-O context
+    - Use sosa:hasSimpleResult as primary; prov:value as close mapping
--- a/frontend/public/schemas/20251121/linkml/modules/slots/confidence_value.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/confidence_value.yaml
@ -1,14 +1,22 @@
 id: https://nde.nl/ontology/hc/slot/confidence_value
 name: confidence_value_slot
+prefixes:
+  linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
+  sosa: http://www.w3.org/ns/sosa/
+  prov: http://www.w3.org/ns/prov#
+  rdf: http://www.w3.org/1999/02/22-rdf-syntax-ns#
 slots:
  confidence_value:
-    slot_uri: rdf:value
+    slot_uri: sosa:hasSimpleResult
    range: float
    minimum_value: 0.0
    maximum_value: 1.0
    description: 'Numeric confidence score (0.0-1.0).

-      RDF: value for literal content.
+
+      **Ontology mapping**: Uses sosa:hasSimpleResult because this is a computed
+      observation result. rdf:value and prov:value are close/broad mappings.

      '
    close_mappings:
--- a/frontend/public/schemas/20251121/linkml/modules/slots/content_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/content_id.yaml
@ -4,12 +4,15 @@ title: Content Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  content_id:
-    description: 'Unique identifier for this content item.
+    description: 'Unique identifier for this content item. Mapped to dcterms:identifier
+      as the standard property for resource identifiers.


      Format varies by platform:
@ -25,4 +28,6 @@ slots:

      '
    range: string
-    slot_uri: hc:contentId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/content_title.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/content_title.yaml
@ -13,20 +13,17 @@ imports:
 default_prefix: hc
 slots:
  content_title:
-    slot_uri: hc:contentTitle
-    description: 'Title or label for this text content.
-
-
-      Dublin Core: title for content name.
+    slot_uri: dcterms:title
+    description: >-
+      Title or label for this text content.
      
+      Ontology mapping: dcterms:title is the Dublin Core property for 
+      the name given to a resource.

      Examples:
-
      - "Rijksmuseum Tour - Full Transcript"
-
      - "Dutch Subtitles - Auto-generated"
-
      - "Scene Annotations - CV Model v2.1"
-
-      '
    range: string
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/copy_note.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/copy_note.yaml
@ -4,14 +4,19 @@ title: Copy Notes Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  copy_note:
-    description: 'Notes specific to this copy (imperfections, special features).
+    description: >-
+      Notes specific to this copy (imperfections, special features).
      
-      '
+      Maps to skos:note for item-specific documentation notes.
    range: string
    multivalued: true
-    slot_uri: hc:copyNotes
+    slot_uri: skos:note
+    close_mappings:
+      - dcterms:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/dealer_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/dealer_name.yaml
@ -4,13 +4,19 @@ title: Dealer Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  schema: http://schema.org/
+  foaf: http://xmlns.com/foaf/0.1/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  dealer_name:
-    description: 'Art dealer name (for DEALER_SALE events).
+    description: >-
+      Art dealer name (for DEALER_SALE events).
      
-      '
+      Ontology mapping: foaf:name is the FOAF property for a person or 
+      organization's name.
    range: string
-    slot_uri: hc:dealerName
+    slot_uri: foaf:name
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/degree_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/degree_name.yaml
@ -4,15 +4,20 @@ title: Degree Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  schema: http://schema.org/
+  skos: http://www.w3.org/2004/02/skos/core#
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  degree_name:
-    description: 'Full degree name as displayed on LinkedIn.
+    description: >-
+      Full degree name as displayed on LinkedIn.
      
+      Ontology mapping: schema:name is the Schema.org property for the 
+      name of an item.
      May include degree type, field, and specialization combined.
-
-      '
    range: string
-    slot_uri: hc:degreeName
+    slot_uri: schema:name
+    close_mappings:
+      - skos:prefLabel
--- a/frontend/public/schemas/20251121/linkml/modules/slots/departement_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/departement_name.yaml
@ -4,13 +4,19 @@ title: Departement Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  departement_name:
-    description: 'Name of the département this archive serves.
+    description: >-
+      Name of the département this archive serves.
      
-      '
+      Ontology mapping: skos:prefLabel is the standard SKOS property for 
+      preferred human-readable labels.
    range: string
-    slot_uri: hc:departementName
+    slot_uri: skos:prefLabel
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/department_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/department_description.yaml
@ -4,16 +4,18 @@ title: Department Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  department_description:
-    description: 'Description of the department''s purpose, scope, and activities.
+    description: >-
+      Description of the department's purpose, scope, and activities.
      
-
-      Dublin Core: description for free-text description.
-
-      '
+      Maps to dcterms:description for organizational unit free-text descriptions.
    range: string
-    slot_uri: hc:departmentDescription
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/department_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/department_id.yaml
@ -4,15 +4,20 @@ title: Department Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  department_id:
-    description: 'Unique identifier for this department.
+    description: 'Unique identifier for this department. Mapped to
+      dcterms:identifier as the standard property for resource identifiers.

      Format: URI following NDE Heritage Custodian ontology conventions.

      '
    range: uriorcurie
-    slot_uri: hc:departmentId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/department_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/department_name.yaml
@ -4,21 +4,20 @@ title: Department Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  department_name:
-    description: 'Official name of the department.
+    description: >-
+      Official name of the department.
      
-
-      SKOS: prefLabel for preferred lexical label.
-
-
-      Should be the formal name as used in official documents,
-
-      organizational charts, and governance records.
-
-      '
+      Ontology mapping: skos:prefLabel is the standard SKOS property for 
+      preferred human-readable labels. Should be the formal name as used 
+      in official documents, organizational charts, and governance records.
    range: string
-    slot_uri: hc:departmentName
+    slot_uri: skos:prefLabel
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/device_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/device_id.yaml
@ -4,15 +4,22 @@ title: Device Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
+  sosa: http://www.w3.org/ns/sosa/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  device_id:
-    description: 'Unique identifier for this IoT device or device network.
+    description: 'Unique identifier for this IoT device or device network. Mapped to
+      dcterms:identifier as the standard property for resource identifiers.

      Format: URI following NDE Heritage Custodian ontology conventions.

      '
    range: uriorcurie
-    slot_uri: hc:deviceId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
+      - sosa:Sensor
--- a/frontend/public/schemas/20251121/linkml/modules/slots/device_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/device_name.yaml
@ -4,16 +4,20 @@ title: Device Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  device_name:
-    description: 'Human-readable name for this IoT device or network.
-
+    description: >-
+      Human-readable name for this IoT device or network.
      
+      Ontology mapping: skos:prefLabel is the standard SKOS property for 
+      preferred human-readable labels.
      Should be descriptive of location and purpose.
-
-      '
    range: string
-    slot_uri: hc:deviceName
+    slot_uri: skos:prefLabel
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/diarization_confidence.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/diarization_confidence.yaml
@ -4,11 +4,21 @@ title: Diarization Confidence Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  sosa: http://www.w3.org/ns/sosa/
+  prov: http://www.w3.org/ns/prov#
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  diarization_confidence:
-    description: Diarization confidence (0.0-1.0)
+    description: >-
+      Diarization confidence (0.0-1.0).
+      
+      **Ontology mapping**: Uses sosa:hasSimpleResult because speaker diarization
+      models act as sensors producing observation results.
    range: float
-    slot_uri: hc:diarizationConfidence
+    minimum_value: 0.0
+    maximum_value: 1.0
+    slot_uri: sosa:hasSimpleResult
+    close_mappings:
+    - prov:value
--- a/frontend/public/schemas/20251121/linkml/modules/slots/diarization_speaker_id.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/diarization_speaker_id.yaml
@ -4,11 +4,16 @@ title: Diarization Speaker Id Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  diarization_speaker_id:
-    description: Anonymous speaker identifier (spk_001, spk_002, etc.)
+    description: 'Anonymous speaker identifier (spk_001, spk_002, etc.). Mapped to
+      dcterms:identifier as the standard property for resource identifiers.'
    range: string
-    slot_uri: hc:diarizationSpeakerId
+    slot_uri: dcterms:identifier
+    close_mappings:
+      - schema:identifier
--- a/frontend/public/schemas/20251121/linkml/modules/slots/diarization_speaker_label.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/diarization_speaker_label.yaml
@ -4,11 +4,19 @@ title: Diarization Speaker Label Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  rdfs: http://www.w3.org/2000/01/rdf-schema#
+  foaf: http://xmlns.com/foaf/0.1/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  diarization_speaker_label:
-    description: Optional identified name or role
+    description: >-
+      Optional identified name or role for speaker in audio diarization.
+      
+      Maps to rdfs:label as a human-readable identifier for a speaker segment.
+      May represent a name ("Dr. Smith") or role ("Narrator", "Interviewer").
    range: string
-    slot_uri: hc:diarizationSpeakerLabel
+    slot_uri: rdfs:label
+    close_mappings:
+      - foaf:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/digital_confidence.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/digital_confidence.yaml
@ -4,11 +4,16 @@ title: Digital Confidence Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  digital_confidence:
-    description: Digital proficiency confidence level
+    description: >-
+      Digital proficiency confidence level.
+      
+      **Ontology mapping**: Uses skos:notation because this is a categorical
+      proficiency level from a controlled vocabulary, not a numeric score.
    range: string
-    slot_uri: hc:digitalConfidence
+    slot_uri: skos:notation
--- a/frontend/public/schemas/20251121/linkml/modules/slots/digital_platform_score.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/digital_platform_score.yaml
@ -12,6 +12,8 @@ title: Digital Platform Score Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  sosa: http://www.w3.org/ns/sosa/
+  prov: http://www.w3.org/ns/prov#

 default_prefix: hc

@ -20,8 +22,15 @@ imports:

 slots:
  digital_platform_score:
-    slot_uri: hc:digitalPlatformScore
+    slot_uri: sosa:hasSimpleResult
    range: float
    minimum_value: 0.0
    maximum_value: 1.0
-    description: Specificity score for digital systems queries
+    description: >-
+      Specificity score for digital systems queries.
+      
+      **Ontology mapping**: Uses sosa:hasSimpleResult because this is a
+      computed relevance score from search/retrieval algorithms acting as
+      observation systems.
+    close_mappings:
+    - prov:value
--- a/frontend/public/schemas/20251121/linkml/modules/slots/diocese_name.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/diocese_name.yaml
@ -4,15 +4,20 @@ title: Diocese Name Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  diocese_name:
-    description: 'Name of the diocese whose records are held.
+    description: >-
+      Name of the diocese whose records are held.
      
+      Ontology mapping: skos:prefLabel is the standard SKOS property for 
+      preferred human-readable labels.
      Example: Diocese of Utrecht, Diocese of Münster
-
-      '
    range: string
-    slot_uri: hc:dioceseName
+    slot_uri: skos:prefLabel
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/document_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/document_description.yaml
@ -4,15 +4,19 @@ title: Document Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  document_description:
-    description: 'Narrative description of the articles, including key provisions
-
+    description: >-
+      Narrative description of the document articles, including key provisions
      and any notable characteristics.
      
-      '
+      Maps to dcterms:description for document resource descriptions.
    range: string
-    slot_uri: hc:documentDescription
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/frontend/public/schemas/20251121/linkml/modules/slots/document_title.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/document_title.yaml
@ -4,24 +4,25 @@ title: Document Title Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  document_title:
-    description: 'Official title of the document.
+    description: >-
+      Official title of the document.
      
+      Ontology mapping: dcterms:title is the Dublin Core property for 
+      the name given to a resource, specifically applicable to documents.

      **Examples**:
-
      - "Statuten Stichting Rijksmuseum"
-
      - "Akte van oprichting Stichting Noord-Hollands Archief"
-
      - "Articles of Association of The Wallace Collection"
-
      - "Satzung des Deutschen Museums"
-
-      '
    range: string
-    slot_uri: hc:documentTitle
+    slot_uri: dcterms:title
+    close_mappings:
+      - schema:name
--- a/frontend/public/schemas/20251121/linkml/modules/slots/education_center_description.yaml
+++ b/frontend/public/schemas/20251121/linkml/modules/slots/education_center_description.yaml
@ -4,24 +4,24 @@ title: Education Center Description Slot
 prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
+  dcterms: http://purl.org/dc/terms/
+  schema: http://schema.org/
 imports:
 - linkml:types
 default_prefix: hc
 slots:
  education_center_description:
-    description: 'Free-text description of this education center.
+    description: >-
+      Free-text description of this education center.
      
+      Maps to dcterms:description for educational facility descriptions.

      Include:
-
      - Educational mission
-
      - Types of programs offered
-
      - Facilities available
-
      - Target audiences
-
-      '
    range: string
-    slot_uri: hc:educationCenterDescription
+    slot_uri: dcterms:description
+    close_mappings:
+      - schema:description
--- a/Show more
+++ b/Show more