System Breakdown

A four-level capability tree of the whole platform: Heratio, then each record type, then the functional aspects, then the concrete tools. Pan, zoom, and drill down level by level. Click a leaf with a link icon to open its help article.

View workflow System Map

Record types: Archival descriptions Actors / authorities Repositories Accessions Terms / subjects / places Museum objects Library items Digital objects Exhibitions / digital twin

Capabilities by record type (text outline)

Archival descriptions - ISAD(G) / RiC archival units
- Description - ISAD(G) / RiC fields
  - ISAD(G) fields - Identity / context / content
  - Levels - Fonds -> item hierarchy
  - RiC entities - Records in Contexts
  - Custom fields - Extra metadata
- Provenance - Custody and origin
  - Provenance chain - Chain of ownership
  - Custody history - Holdings over time
  - C2PA credentials - Content provenance assertions
- Condition - Condition reporting
  - Condition reports - Assessment + grade
  - Condition photos - Visual record
  - AI condition scan - Vision model assessment
- PII / Privacy - Privacy compliance
  - Field-level redaction - Hide sensitive values
  - DPIA / ROPA - Risk + processing record
  - Privacy compliance - Pluggable per-market
- AI - AI enrichment
  - HTR / OCR - Text from images
  - NER - Entity extraction
  - Summarize - Scope-note draft
  - AI provenance - Inference recorded
- Rights / ODRL - Access and reuse policy
  - ODRL policies - use / reproduce rules
  - Embargo - Time-limited access
  - ICIP - Indigenous cultural rights
- Relations - Links to other entities
  - Linked actors - Creators / subjects
  - Subjects / places - Indexed terms
  - RiC relations - rico:* predicates
- Digital objects - Attached media
  - Master + derivatives - Original + surrogates
  - IIIF deep-zoom - Mirador / Cantaloupe
  - 3D / splat - glTF mesh + Gaussian splat
- Search - Find and refine
  - Elasticsearch - heratio_informationobject
  - Advanced search - Facets + ancestor subtree
  - Semantic - Vector / KM RAG
- Preservation - OAIS / PREMIS / fixity
  - OAIS packages - SIP / AIP / DIP
  - PREMIS events - Preservation actions
  - Fixity - Checksums + audits
Actors / authorities - ISAAR persons, families, bodies
- Description - ISAAR(CPF) fields
  - Identity - Authorized form of name
  - History - Biography / administrative
  - Mandates - Functions / legal basis
- Authority control - Resolve and de-duplicate
  - Match / resolve - External authorities
  - Merge duplicates - Consolidate records
- Relations - Links and graph
  - Linked records - Created / referenced
  - Related actors - Hierarchical / associative
  - Knowledge graph - rico:* edges
- PII / Privacy - Living-person data
  - Field-level redaction - Hide personal data
  - Privacy compliance - Pluggable per-market
- Search - Find authorities
  - Elasticsearch - heratio_actor
  - Advanced search - Facets + filters
Repositories - ISDIAH holding institutions
- Description - ISDIAH fields
  - Identity - Institution name / type
  - Contact - Address / access
  - Services - Access + reproduction
- Relations - Holdings + staff
  - Held records - Repository holdings
  - Linked actors - Custodians / contacts
- Rights / ODRL - Repository policy
  - Access policy - Default reuse rules
- Search - Find institutions
  - Elasticsearch - heratio_repository
  - Advanced search - Facets + filters
Accessions - Acquisition records
- Description - Accession Management V2
  - Accession number - Auto-generated identifier
  - Scope & content - What was accessioned
  - Spawn record - Create archival description
- Provenance - Source and method
  - Donor / source - Person / organisation
  - Method - Purchase / gift / loan
  - Provenance chain - Custody history
- Rights / ODRL - Conditions of gift
  - Gift conditions - Donor restrictions
  - ODRL policy - Reuse rules
- Relations - What it produced
  - Created records - Spawned descriptions
  - Linked donor - Source actor
Terms / subjects / places - Taxonomies and thesauri
- Description - Term records
  - Preferred label - Authorized form
  - Scope note - Usage guidance
  - Alternates - Synonyms / variants
- Relations - Thesaurus structure
  - Broader / narrower - SKOS hierarchy
  - Related terms - Associative links
  - Indexed records - Where the term is used
- Search - Browse taxonomies
  - Elasticsearch - heratio_term
  - Taxonomy browse - Term hierarchy
- Places / GIS - Geospatial terms
  - Coordinates - Lat / long
  - Map view - Place on a map
Museum objects - Spectrum 5.1 procedures
- Description - Object identification
  - Object entry - Identification + number
  - Location - Movement control
  - Measurements - Dimensions / materials
- Condition - Condition checking
  - Condition reports - Spectrum assessment
  - Condition photos - Visual record
  - AI condition scan - Vision model
- Provenance - Ownership history
  - Provenance chain - Chain of ownership
  - Acquisition - How it was acquired
- PII / Privacy - Sensitive objects
  - Privacy compliance - Spectrum privacy hooks
  - ICIP - Indigenous cultural rights
- Digital objects - Object media
  - Images - Views / surrogates
  - 3D / splat - Captured object scan
- Relations - Loans + exhibitions
  - Loans - Inbound / outbound
  - Exhibitions - Displayed in
Library items - Bibliographic records
- Description - MARC / BIBFRAME / FRBR
  - Bibliographic - MARC item record
  - Holdings - Copies / availability
  - FRBR / BIBFRAME - Work / expression model
- Acquisition - Order and receive
  - Order / request - Purchase or gift
  - Receive - Mark items received
- Search - Discover items
  - Elasticsearch - Catalogue index
  - Z39.50 / SRU - External catalogue search
  - Advanced search - Facets + filters
- Digital objects - Full text + scans
  - Full text - PDF / e-book
  - IIIF deep-zoom - Page viewer
Digital objects - Digital asset management
- Description - Asset metadata
  - Technical metadata - Format / size / EXIF
  - Formats - Image / AV / docs
- Derivatives & viewers - Surrogates + display
  - Master + derivatives - Preservation + access
  - IIIF deep-zoom - Mirador / Cantaloupe
  - 3D / splat - glTF + Gaussian splat
  - AV streaming - Audio / video player
- AI - Media AI
  - HTR / OCR - Text from images
  - Metadata extraction - Auto-derived fields
  - Duplicate detection - Similarity match
- Rights / ODRL - Reuse + watermarks
  - ODRL policy - reproduce rules
  - Watermarks - Derivative protection
  - C2PA - Signed content credentials
- Preservation - Fixity + OCFL
  - Fixity - Checksums + audits
  - OCFL - Object storage layout
Exhibitions / digital twin - Curated shows + 3D walkthrough
- Description - Exhibition builder
  - Curate - Pick + order items
  - Layout - Landing-page design
  - Publish - Go live
- Digital twin - 3D walkthrough
  - Scene - Interior walls / scale
  - Walkthrough - First-person navigation
- Relations - Items on show
  - Exhibited items - Records / objects
  - Tour order - Sequence of stops
- Engagement - Cart + marketplace
  - Cart - Add to cart
  - Reproduction - Order copies

This breakdown is data-driven. To update it, edit packages/ahg-help/resources/data/system-breakdown.php.