- 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.
98 lines
2.7 KiB
Markdown
98 lines
2.7 KiB
Markdown
# 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
|
|
|
|
1. **`modules/classes/LegalResponsibilityCollection.yaml`** - Main class
|
|
2. **`modules/slots/collections_under_responsibility.yaml`** - Reverse link
|
|
3. **`modules/slots/responsible_legal_entity.yaml`** - Forward link
|
|
4. **`modules/slots/legal_responsibility_basis.yaml`** - Legal foundation
|
|
5. **`modules/slots/legal_responsibility_start_date.yaml`** - Start date
|
|
6. **`modules/slots/legal_responsibility_end_date.yaml`** - End date
|
|
|
|
---
|
|
|
|
## 🔗 Key Relationships
|
|
|
|
```yaml
|
|
# 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
|
|
|
|
```yaml
|
|
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
|
|
|
|
```sparql
|
|
# 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
|
|
|
|
1. ✅ Schema integration complete
|
|
2. ⏳ Regenerate RDF with full timestamps
|
|
3. ⏳ Create validation tests
|
|
4. ⏳ Update UML diagrams for LegalResponsibilityCollection
|
|
|
|
---
|
|
|
|
**See**: `LEGAL_RESPONSIBILITY_COLLECTION_COMPLETE.md` for full documentation
|