glam/LEGAL_RESPONSIBILITY_COLLECTION_QUICKSTART.md
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

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