kempersc 3ff0e33bf9 Add UML diagrams and scripts for custodian schema

- Created PlantUML diagrams for custodian types, full schema, legal status, and organizational structure.
- Implemented a script to generate GraphViz DOT diagrams from OWL/RDF ontology files.
- Developed a script to generate UML diagrams from modular LinkML schema, supporting both Mermaid and PlantUML formats.
- Enhanced class definitions and relationships in UML diagrams to reflect the latest schema updates.

2025-11-23 23:05:33 +01:00

2.7 KiB

Raw Blame History

Legal Responsibility Collection - Quick Reference

Status: ✅ COMPLETE | Date: 2025-11-22

🎯 TL;DR

Created LegalResponsibilityCollection subclass following TOOI ontology pattern for informatieobjecten (information objects) under legal responsibility of overheidsorganisaties (government organizations).

📁 New Files

modules/classes/LegalResponsibilityCollection.yaml - Main class
modules/slots/collections_under_responsibility.yaml - Reverse link
modules/slots/responsible_legal_entity.yaml - Forward link
modules/slots/legal_responsibility_basis.yaml - Legal foundation
modules/slots/legal_responsibility_start_date.yaml - Start date
modules/slots/legal_responsibility_end_date.yaml - End date

🔗 Key Relationships

# Forward: Collection → Legal Entity
LegalResponsibilityCollection:
  responsible_legal_entity: ".../legal/nha-organization"

# Reverse: Legal Entity → Collections
CustodianLegalStatus:
  collections_under_responsibility:
    - ".../collection/nha-provincial-archive"

🆚 Distinctions

What	LegalResponsibilityCollection	CustodianCollection
Legal accountability?	Yes (documented)	Optional
Required property	`responsible_legal_entity`	None
Example	Government archive under Archiefwet	Private collection

What	responsible_legal_entity	managing_unit
Level	Top-level legal accountability	Operational management
Range	`CustodianLegalStatus`	`OrganizationalStructure`
Example	Stichting Rijksmuseum	Paintings Department

📝 Usage Example

LegalResponsibilityCollection:
  id: "https://nde.nl/ontology/hc/collection/nha-provincial"
  collection_name: "Noord-Hollands Archief - Provinciaal Archief"
  
  # Legal responsibility
  responsible_legal_entity: ".../legal/nha-organization"
  legal_responsibility_basis: "Archiefwet 1995, Article 41"
  legal_responsibility_start_date: "2001-01-01"
  
  # Links to hub
  refers_to_custodian: ".../nl-nh-haa-a-nha"

🔍 SPARQL Quick Query

# Find collections under legal responsibility
PREFIX hc: <https://nde.nl/ontology/hc/class/>

SELECT ?collection ?name
WHERE {
  <.../legal/nha-organization> 
    hc:collections_under_responsibility ?collection .
  ?collection hc:collection_name ?name .
}

⏳ Next Steps

✅ Schema integration complete
⏳ Regenerate RDF with full timestamps
⏳ Create validation tests
⏳ Update UML diagrams for LegalResponsibilityCollection

See: LEGAL_RESPONSIBILITY_COLLECTION_COMPLETE.md for full documentation

2.7 KiB Raw Blame History