kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/CustodianArchive.yaml
kempersc 0d5d48568d refactor(schema): centralize slot definitions per Rule 38 
- Remove slot_uri, description, mappings from slot_usage sections
- Move these properties to centralized slot files in modules/slots/
- Keep only class-specific overrides in slot_usage (required, inlined, examples)
- Update 1,499 centralized slot files with enriched definitions
- Clean 188 class files

Violations fixed:
- slot_uri in slot_usage: 1,676 → 0
- description in slot_usage: 2,287 → 0 (moved to centralized)

Schema still validates: 816 classes, 2028 slots, 127 enums
2026-01-11 23:27:17 +01:00

376 lines
18 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/CustodianArchive
name: custodian_archive_class
title: CustodianArchive Class
imports:
- linkml:types
- ./Custodian
- ./CustodianObservation
- ./ReconstructionActivity
- ./TimeSpan
- ./OrganizationalStructure
- ./CollectionManagementSystem
- ./Storage
- ../enums/ArchiveProcessingStatusEnum
- ../slots/has_or_had_access_restriction
- ../slots/storage_location
- ./ReconstructedEntity
- ./CurrentArchive
- ../slots/has_accession_number
- ./CustodianArchiveRecordSetTypes
- ../slots/has_or_had_holds_record_set_type
- ./CollectionType
- ../slots/type_scope
- ../slots/has_accession_date
- ../slots/has_accumulation_end_date
- ../slots/has_accumulation_start_date
- ../slots/appraisal_notes
- ../slots/has_archive_description
- ../slots/has_archive_name
- ../slots/arrangement_notes
- ../slots/has_or_had_assigned_processor
- ../slots/creating_agency
- ../slots/has_or_had_custodian_type
- ../slots/estimated_extent
- ../slots/id
- ../slots/lifecycle_phase_type
- ../slots/managing_unit
- ../slots/processing_completed_date
- ../slots/processing_priority
- ../slots/processing_started_date
- ../slots/processing_status
- ../slots/refers_to_custodian
- ../slots/specificity_annotation
- ../slots/successor_collection
- ../slots/template_specificity
- ../slots/has_or_had_tracked_in_cm
- ../slots/transfer_to_collection_date
- ../slots/valid_from
- ../slots/valid_to
- ../slots/was_derived_from
- ../slots/was_generated_by
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
- ../slots/has_appraisal_note
- ../slots/has_arrangement_note
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
dcterms: http://purl.org/dc/terms/
rico: https://www.ica.org/standards/RiC/ontology#
prov: http://www.w3.org/ns/prov#
time: http://www.w3.org/2006/time#
org: http://www.w3.org/ns/org#
premis: http://www.loc.gov/premis/rdf/v3/
skos: http://www.w3.org/2004/02/skos/core#
wd: http://www.wikidata.org/entity/
classes:
CustodianArchive:
is_a: ReconstructedEntity
class_uri: rico:RecordSet
slots:
- has_or_had_access_restriction
- has_accession_date
- has_accession_number
- has_accumulation_end_date
- has_accumulation_start_date
- appraisal_notes
- has_archive_description
- has_archive_name
- arrangement_notes
- has_or_had_assigned_processor
- creating_agency
- has_or_had_custodian_type
- estimated_extent
- has_or_had_holds_record_set_type
- id
- lifecycle_phase_type
- managing_unit
- processing_completed_date
- processing_priority
- processing_started_date
- processing_status
- refers_to_custodian
- specificity_annotation
- storage_location
- successor_collection
- template_specificity
- has_or_had_tracked_in_cm
- transfer_to_collection_date
- valid_from
- valid_to
- was_derived_from
- was_generated_by
description: "Represents OPERATIONAL ARCHIVES created by a heritage custodian through its\ndaily activities that are NOT\
\ YET integrated into the formal heritage collection\n(CustodianCollection).\n\n**CRITICAL DISTINCTION - THREE-TIER\
\ RECORDS LIFECYCLE**:\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│ CustodianAdministration\
\ │\n│ ════════════════════════ \
\ │\n│ ACTIVE records in daily use │\n│ - Current correspondence, invoices,\
\ personnel files │\n│ - Digital files on shared drives │\n│ - Email\
\ systems, databases │\n│ - Actively referenced and modified \
\ │\n│ - Managed by business units, NOT archives │\n└─────────────────────────────────────────────────────────────────────┘\n\
\ ↓\n (Retention period ends, \n transferred to archives)\n\
\ ↓\n┌─────────────────────────────────────────────────────────────────────┐\n│ CustodianArchive\
\ (THIS CLASS) │\n│ ════════════════════════════ \
\ │\n│ INACTIVE records awaiting archival processing │\n│ - Transferred from administration\
\ to archives │\n│ - In BACKLOG - may wait DECADES for processing │\n│ -\
\ Basic accession-level description only │\n│ - NOT searchable by researchers (no finding\
\ aid) │\n│ - Tracked in CMS for inventory purposes │\n│ - May undergo\
\ appraisal, arrangement, description │\n└─────────────────────────────────────────────────────────────────────┘\n\
\ ↓\n (Archival processing complete,\n finding aid\
\ created)\n ↓\n┌─────────────────────────────────────────────────────────────────────┐\n\
│ CustodianCollection │\n│ ════════════════════════ \
\ │\n│ PROCESSED heritage collection │\n│ - Full finding\
\ aid available │\n│ - Searchable by researchers \
\ │\n│ - Arranged and described per archival standards │\n│ - Integrated into institution's\
\ public collection │\n│ - Managed as cultural heritage │\n└─────────────────────────────────────────────────────────────────────┘\n\
```\n\n**WHY THIS MATTERS**:\n\nArchival institutions (national archives, municipal archives, corporate archives)\n\
create their OWN operational records through daily activities:\n- Correspondence with depositors\n- Acquisition documentation\n\
- Conservation reports\n- Staff files\n- Financial records\n- Research request logs\n\nThese institutional records are\
\ DISTINCT from the heritage collections they manage.\nA national archive managing 17th-century municipal records ALSO\
\ has its own\n20th-21st century operational archives that may take decades to process.\n\n**TEMPORAL REALITY**:\n\n\
Processing backlogs are measured in DECADES, not months:\n- Large national archives: 30-50 year backlogs common\n- Government\
\ transfers: Often 20+ years before processing\n- Corporate archives: Legacy records may wait indefinitely\n\n**RiC-O\
\ ALIGNMENT**:\n\n- **rico:RecordSet**: Primary class for archival aggregations\n- **rico:hasAccumulationDate**: When\
\ records were accumulated (created/received)\n- **rico:hasAccumulator**: Agent that accumulated the records\n- **rico:Activity**:\
\ Processing activities (appraisal, arrangement, description)\n\n**RELATIONSHIP TO OTHER CLASSES**:\n\n- **CustodianAdministration**:\
\ Active records → transfers TO CustodianArchive\n- **CustodianCollection**: Processed archives → CustodianArchive transfers\
\ TO this\n- **CollectionManagementSystem**: Tracks CustodianArchive for inventory\n- **Storage**: Physical location\
\ of unprocessed archives\n- **OrganizationalStructure**: Unit responsible for processing\n\n**RELATIONSHIP TO LIFECYCLE\
\ TYPE CLASSES**:\n\nCustodianArchive (this class) is an INSTANCE class representing actual\noperational archives. It\
\ can be TYPED using lifecycle phase classifications:\n\n- **CurrentArchive** (Q3621648): Active records in daily use\n\
\ - skos:broaderTransitive links CustodianArchive → CurrentArchive type\n- **DepositArchive** (Q244904): Intermediate/semi-current\
\ records\n- **HistoricalArchive** (Q3621673): Permanent archival records\n\nUse `lifecycle_phase_type` slot to classify\
\ by lifecycle position.\n"
exact_mappings:
- rico:RecordSet
close_mappings:
- rico:RecordResource
- premis:IntellectualEntity
related_mappings:
- rico:hasAccumulationDate
- rico:Activity
- crm:E78_Curated_Holding
slot_usage:
id:
identifier: true
required: true
has_archive_name:
range: string
required: true
has_archive_description:
range: string
required: false
has_accession_number:
range: string
required: true
examples:
- value: 2024-0001
description: Sequential accession number
- value: NA-2024-GOV-0156
description: National Archives government transfer
has_accession_date:
range: date
required: true
examples:
- value: '2024-01-15'
description: Records accessioned January 2024
has_accumulation_start_date:
range: date
required: false
has_accumulation_end_date:
range: date
required: false
creating_agency:
range: string
required: false
examples:
- value: Director's Office
description: Executive correspondence
- value: Conservation Department
description: Treatment reports and documentation
processing_status:
range: ArchiveProcessingStatusEnum
required: true
examples:
- value: UNPROCESSED
description: In backlog awaiting processing
- value: IN_DESCRIPTION
description: Finding aid being created
processing_priority:
range: string
required: false
examples:
- value: HIGH
description: Researcher demand for these records
- value: LOW
description: No immediate need, stable condition
estimated_extent:
range: string
required: false
examples:
- value: 25 linear meters
description: Physical extent
- value: 500 GB, ~50,000 files
description: Digital extent
storage_location:
range: Storage
multivalued: true
required: false
has_or_had_tracked_in_cm:
range: CollectionManagementSystem
multivalued: true
required: false
has_or_had_assigned_processor:
range: string
required: false
examples:
- value: Dr. Maria van den Berg
description: Senior archivist assigned
processing_started_date:
range: date
required: false
examples:
- value: '2024-03-01'
description: Processing started March 2024
processing_completed_date:
range: date
required: false
examples:
- value: '2024-09-15'
description: Processing completed September 2024
transfer_to_collection_date:
range: date
required: false
examples:
- value: '2024-10-01'
description: Transferred to collection October 2024
successor_collection:
range: uriorcurie
required: false
examples:
- value: https://nde.nl/ontology/hc/collection/rm-director-correspondence-2010-2020
description: Collection derived from this archive after processing
has_or_had_access_restriction:
range: string
required: false
examples:
- value: Closed - Contains personnel files with personal data
description: Privacy restriction
has_appraisal_note:
range: string
required: false
examples:
- value: Retained all policy files; destroyed duplicate copies and routine correspondence per retention schedule RS-2020-05
description: Appraisal decisions documented
has_arrangement_note:
range: string
required: false
examples:
- value: Maintained original order by correspondent. Created 5 series by function. Rehoused into acid-free folders
and boxes.
description: Arrangement decisions documented
managing_unit:
range: OrganizationalStructure
required: false
refers_to_custodian:
range: Custodian
required: true
was_derived_from:
range: CustodianObservation
multivalued: true
required: false
was_generated_by:
range: ReconstructionActivity
required: false
valid_from:
range: date
required: false
valid_to:
range: date
required: false
lifecycle_phase_type:
range: uriorcurie
required: false
examples:
- value: wikidata:Q244904
description: Deposit archive / semi-current records
- value: wikidata:Q3621648
description: Current archive / active records
has_or_had_custodian_type:
equals_expression: '["hc:ArchiveOrganizationType"]'
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
comments:
- Represents operational archives BEFORE integration into CustodianCollection
- Processing backlogs commonly span DECADES in archival institutions
- Distinct from CustodianAdministration (active records) and CustodianCollection (processed)
- RiC-O rico:RecordSet as primary ontology class
- PROV-O prov:hadDerivation links to successor CustodianCollection (NOT rico:hasSuccessor which is for Agents)
- Tracks full processing lifecycle from accession to transfer
see_also:
- https://www.ica.org/standards/RiC/ontology#RecordSet
- https://nde.nl/ontology/hc/class/CustodianAdministration
- https://nde.nl/ontology/hc/class/CustodianCollection
- https://nde.nl/ontology/hc/enum/ArchiveProcessingStatusEnum
examples:
- value:
id: https://nde.nl/ontology/hc/archive/rm/2024-0001
archive_name: Rijksmuseum Director's Correspondence 2010-2020
archive_description: Incoming and outgoing correspondence of the museum director including policy discussions, loan
requests, and exhibition planning.
accession_number: RM-2024-0001
accession_date: '2024-01-15'
has_accumulation_start_date: '2010-01-01'
has_accumulation_end_date: '2020-12-31'
creating_agency: Director's Office
processing_status: UNPROCESSED
processing_priority: MEDIUM
estimated_extent: 12 linear meters (48 boxes)
access_restrictions: Restricted - Contains sensitive correspondence
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Unprocessed director's correspondence awaiting archival processing
- value:
id: https://nde.nl/ontology/hc/archive/na/2015-gov-0234
archive_name: Ministry of Finance Records 1990-2005
archive_description: Financial policy records, budget documentation, and ministerial correspondence transferred under
government archives law.
accession_number: NA-2015-GOV-0234
accession_date: '2015-06-01'
has_accumulation_start_date: '1990-01-01'
has_accumulation_end_date: '2005-12-31'
creating_agency: Ministry of Finance
processing_status: IN_ARRANGEMENT
processing_priority: HIGH
estimated_extent: 85 linear meters
assigned_processor: Dr. Jan de Vries
processing_started_date: '2024-01-10'
appraisal_notes: Retained all policy files; weeded duplicate copies per retention schedule.
refers_to_custodian: https://nde.nl/ontology/hc/nl-na
description: Government records in active processing (9 years after accession)
CustodianArchiveRecordSetType:
description: 'A rico:RecordSetType for classifying collections held by CustodianArchive custodians.
'
is_a: CollectionType
class_uri: rico:RecordSetType
slots:
- type_scope
see_also:
- CustodianArchive
- rico:RecordSetType
annotations:
custodian_types: '["hc:ArchiveOrganizationType"]'
linked_custodian_type: CustodianArchive
dual_class_pattern: collection_type
specificity_score: 0.7
specificity_rationale: Type taxonomy class.
specificity_annotation_timestamp: '2026-01-06T00:26:29.676176Z'
specificity_annotation_agent: opencode-claude-sonnet-4
template_specificity: '{"archive_search": 0.2, "museum_search": 0.75, "library_search": 0.75, "collection_discovery":
0.75, "person_research": 0.75, "location_browse": 0.75, "identifier_lookup": 0.75, "organizational_change": 0.75,
"digital_platform": 0.75, "general_heritage": 0.75}'
Reference in a new issue View git blame Copy permalink