System Map

One traversable diagram of the whole platform - pan, zoom, and drill into any stage. Click a node with a link icon to open its help article.

System breakdown
Drag to pan - wheel to zoom - arrow keys to pan - click a stage to drill in
Stages:

Platform stages (text outline)

  • Acquisition & Accession - Acquire, accession, donors
    • Acquisition - Library / archival intake
      • Order / request - Purchase or gift request
      • Receive - Mark items received
      • Method - Purchase / gift / loan
    • Accession record - Accession Management V2
      • Accession number - Auto-generated identifier
      • Scope & content - What was accessioned
      • Create record - Spawn archival description
    • Donors & source - Provenance origin
      • Donor actor - Person / organisation
      • Provenance chain - Custody history
      • Donor rights - Conditions of gift
  • Ingest / Scan - CSV / file batch, watched folders
    • Configure - Pick source / template
      • Source - CSV / folder / scan
      • Template - Entity + field set
    • Upload - CSV + files / scan capture
      • Files - CSV + digital objects
      • Watched folder - Auto-pick scan output
    • Map - Column -> field mapping
      • Columns - CSV header -> field
      • Defaults - Fixed / fallback values
    • Validate - File + metadata checks
      • File checks - Type / size / virus
      • Metadata checks - Required fields
    • AI steps - OCR / NER / summarize / scan
      • OCR / HTR - Text from images
      • NER - Entity extraction
      • Summarize - Scope-note draft
      • AI gateway - ai.theahg.co.za
    • Commit - Create records
      • Preview - Dry-run before write
      • Create - Write records + index
  • Description - ISAD(G) / RiC / Spectrum / CCO
    • ISAD(G) - Archival description
      • Identity - Reference / title / dates
      • Context - Creator / custody
      • Content - Scope / arrangement
      • Levels - Fonds -> item hierarchy
    • RiC - Records in Contexts
      • Entities - Record / agent / activity
      • Relations - rico:* predicates
      • Graph - JSON-LD / SPARQL
    • Spectrum - Museum procedures 5.1
      • Object entry - Object identification
      • Location - Movement control
      • Privacy - Compliance hooks
    • CCO / VRA - Cultural objects / works
      • Work - Work record
      • Image - Surrogate / view
    • Authorities - Actors, terms, places
      • Actors - ISAAR persons / bodies
      • Terms - Subjects / places
      • Resolve - Match / merge
    • Condition - Condition reports
      • Assessment - Condition grade
      • Photos - Condition images
  • Preservation - OAIS / PREMIS / fixity
    • OAIS ingest - AIP / SIP / DIP
      • SIP - Submission package
      • AIP - Archival package
      • DIP - Dissemination package
    • PREMIS - Preservation events
      • Events - Capture / migrate
      • Agents - Who / what acted
    • Fixity - Checksums / audits
      • Checksums - SHA / MD5 on ingest
      • Audits - Scheduled re-verify
    • 3D / media - 3D model preservation
      • Formats - glTF / PLY / splat
      • Derivatives - Web-ready surrogates
  • Search - Elasticsearch + semantic / KM
    • Elasticsearch - Index + advanced search
      • Indices - heratio_* indices
      • Reindex - ahg:es-reindex command
      • Analyzers - Tokenize / stem
    • Advanced - Facets / filters
      • Facets - Aggregated filters
      • Ancestor - lft/rgt subtree
    • Semantic - Vector / KM RAG
      • Vectors - Embeddings store
      • KM RAG - km.theahg.co.za
      • AI gateway - Embedding endpoint
    • Knowledge graph - Entity links
      • Entities - Records / actors / terms
      • Links - Typed relations
  • Display - GLAM browse, sector shows, IIIF / 3D / splat
    • GLAM browse - Card / grid / table
      • View modes - Card / grid / table / full
      • Facets - Refine results
    • Library - Library sector show
      • Bibliographic - MARC / item record
      • Holdings - Copies / availability
    • Museum - Museum sector show
      • Object - Spectrum object view
      • Location - Current location
    • Gallery - Gallery sector show
      • Work - CCO work view
      • Images - Views / surrogates
    • DAM - Digital asset show
      • Asset - Master + derivatives
      • Formats - Image / AV / docs
    • IIIF viewer - Mirador / OpenSeadragon
      • Mirador - Multi-image workspace
      • OpenSeadragon - Deep-zoom tiles
      • Cantaloupe - IIIF Image API 3.0
    • 3D / splat - 3D + Gaussian splat
      • 3D model - glTF mesh viewer
      • Splat - Gaussian splat scene
  • Exhibitions / Digital Twin - Exhibition builder + 3D walkthrough
    • Exhibition builder - Curate + landing page
      • Curate - Pick + order items
      • Layout - Landing-page design
      • Publish - Go live
    • Digital twin - 3D walkthrough
      • Scene - Interior walls / scale
      • Walkthrough - First-person navigation
    • Engage - Cart / marketplace
      • Cart - Add to cart
      • Reproduction - Order copies
  • AI Services - HTR / NER / condition / translate
    • NER - Entity extraction
      • Gateway - ai.theahg.co.za
      • Models - Ollama / vLLM
      • Provenance logged - Inference recorded
    • AI condition - Condition assessment
      • Gateway - ai.theahg.co.za
      • Vision model - Image assessment
      • Condition report - Feeds Description
    • Translate - Machine translation
      • Gateway - ai.theahg.co.za
      • MT engine - NLLB / adapter
      • Review - Human post-edit
    • Duplicates - Duplicate detection
      • Candidates - Similarity match
      • Merge - Resolve duplicates
    • AI provenance - Inference provenance
      • Record - Model / prompt / output
      • Trace - Audit / FOIA trail
      • Override - Human correction
  • APIs & Interoperability - IIIF, Linked Data, OAI, C2PA
    • REST / GraphQL - API v1 / v2 + GraphQL
      • API v1 - CRUD endpoints
      • API v2 - REST resources
      • API keys - Key + scope auth
    • IIIF API - Presentation + Image
      • Presentation - Manifests / collections
      • Image - Cantaloupe tiles
    • Linked Data - RiC JSON-LD / SPARQL
      • JSON-LD - RiC-O serialization
      • SPARQL - Graph query
    • OAI-PMH - Metadata harvesting
      • Formats - Dublin Core / EAD
      • Sets - Selective harvesting
    • C2PA - Content credentials
      • Manifest - Provenance assertions
      • Sign - Cryptographic seal
    • DOI - Persistent identifiers
      • Mint - Register DOI
      • Metadata - DataCite record
    • Federation - Federated search
      • Peers - Connected sources
      • Merge - Unified results
  • North Star - The vision - where Heratio is heading
    • World heritage graph - Open memory protocol
      • Graph API - JSON-LD / Turtle / RDF
      • OAI-PMH + sitemap - Harvestable
      • Bulk data - CSV / JSON-LD dumps
    • Race against loss - Capture what is at risk
      • At-risk register - Prioritised
      • Capture queue - Operator workflow
    • Reconstruct lost places - Walk what is gone
      • Rebuild montage - Assembly / time-lapse
      • Walkable twin - 3D walkthrough
    • Repatriation engine - Trace + virtual return
      • Displaced register - Origin vs holder
      • Virtual return - Experience it back
    • Truth anchor - Verifiable authenticity
      • Verify - Content credentials
      • Provenance trace - Full chain
      • Coverage - How much is signed
    • Talk to the culture - Corpus-grounded history
      • Ask the collection - Grounded answers
    • Generative scholarship - AI finds connections
      • Discoveries - Cross-collection links
    • Universal access - Every museum, every language
      • Read in your language - On-demand translation
      • Language preference - Remembered
    • Encyclopedic museum - Building-scale twin
      • Wayfinding - Take me to X
      • Building scale - Wings / floors (next)
Cross-cutting concerns: Auth / ACL Settings / Dropdowns Rights / ODRL

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