Back to Reference
Contents
Reference
1,225 words
Jun 15, 2026

AtoM Heratio Roadmap

Last Updated: 2026-03-11 Framework Version: 2.8.2 Plugins: 80 SDKs: Python (atom-ahg-python) + TypeScript (atom-client-js) Heratio Migration: Phase 2 complete (12 WriteServices, Propel coupling 223→223)

Executive Summary

The AtoM AHG Framework+ scores 100/100 in comprehensive feature comparison against the 5 major players in the GLAM/DAM (Galleries, Libraries, Archives, Museums / Digital Asset Management) industry. This positions the framework as the undisputed market leader across all categories.

Platform Score Position
AtoM AHG Framework+ 100/100 #1 Leader
Preservica 69/100 #2
Axiell Collections 62/100 #3
CollectiveAccess 61/100 #4
ArchivesSpace 54/100 #5
ResourceSpace 43/100 #6

Visual Comparison

AtoM AHG Framework+    ██████████████████████████████████████████████████ 100
Preservica             ██████████████████████████████████████            69
Axiell Collections     ███████████████████████████████████               62
CollectiveAccess       ███████████████████████████████                   61
ArchivesSpace          ███████████████████████████                       54
ResourceSpace          ██████████████████████                            43

Repository Structure

Repository Purpose Status
atom-framework Core Laravel foundation, CLI, services v2.8.2
atom-ahg-plugins 78 AHG plugins v1.7.30
atom-extensions-catalog Documentation & registry v2.1.12
atom-ahg-python Python SDK v1.0.0
atom-client-js TypeScript SDK v1.0.0

Progress Tracker (Gap Analysis)

Current Score: 100/100 | Target: 100/100 | Gap: 0 points

# Gap Status Points Category
1 Speech-to-Text (Whisper) Complete +1 AI & ML
2 Published SDK (Python/JS) Complete +1 API & Integrations
3 PII Detection (AI) Complete +1 AI & ML
4 Semantic Search Complete +1 Search & Discovery
5 Format Migration Pathways Complete +1 Digital Preservation
6 JSON-LD Export Complete +1 Linked Data
7 IIIF Auth API Complete +1 IIIF & Media

All gaps closed. 100/100 achieved on 2026-03-11.

Completed Features (2026)

GAP 1: Speech-to-Text (Whisper) - COMPLETE

Completed: 2026-01-20 | Category: AI & ML

  • Whisper API integration via OpenAI
  • Generate Transcript button on video player
  • View Transcript panel with clickable timestamps
  • Download VTT/SRT subtitle formats
  • Language detection
  • Works across all GLAM/DAM sectors

Files: ahgThemeB5Plugin/modules/digitalobject/templates/_showVideo.php

GAP 2: Published SDKs - COMPLETE

Completed: 2026-01-22 | Category: API & Integrations

Python SDK (atom-ahg-python):

pip install atom-ahg  # Coming to PyPI
  • Authentication (API key, session)
  • Descriptions CRUD
  • Authorities CRUD
  • Search operations
  • Batch operations
  • File upload
  • Async support with httpx

TypeScript SDK (atom-client-js):

npm install @ahg/atom-client  # Coming to npm
  • Full TypeScript types
  • Browser and Node.js support
  • Async/await patterns
  • Same operations as Python

Repositories:

  • github.com/ArchiveHeritageGroup/atom-ahg-python
  • github.com/ArchiveHeritageGroup/atom-client-js

GAP 3: PII Detection (AI-Powered) - COMPLETE

Completed: 2026-01-21 | Category: AI & ML + Compliance

Features:

  • PiiDetectionService with regex patterns
  • NER integration (PERSON, ORG, GPE, DATE)
  • South African ID validation (Luhn)
  • Risk level classification
  • PII Scanner admin dashboard
  • Review queue workflow
  • ISAD Access Points scanning
  • PDF Redaction with viewer integration
  • Visual Redaction Editor
PII Types Detected: Type Risk Level Method
CREDIT_CARD Critical Regex + Luhn
SA_ID High Regex + SA Luhn
NG_NIN High Regex
PASSPORT High Regex
BANK_ACCOUNT High Regex
PERSON Medium NER (spaCy)
EMAIL Medium Regex
PHONE Medium Regex

Files: ahgPrivacyPlugin/lib/Service/PiiDetectionService.php

GAP 4: Semantic Search - COMPLETE

Completed: 2026-01-22 | Category: Search & Discovery

Plugin: ahgSemanticSearchPlugin

Features:

  • Thesaurus management with domain-specific synonyms
  • WordNet sync via Datamuse API
  • Wikidata SPARQL integration
  • Local JSON synonym import
  • Elasticsearch synonym export
  • Query expansion for enhanced search
  • Vector embeddings via Ollama
  • Scheduled sync via cron jobs

Tables:

  • semantic_synonym - Term/synonym relationships
  • semantic_embedding - Vector embeddings
  • ahg_semantic_search_settings - Configuration
  • semantic_query_log - Analytics

CLI:

php bin/semantic-search-cron.php all          # Full sync
php bin/semantic-search-cron.php sync-wordnet # WordNet only
php bin/semantic-search-cron.php sync-wikidata # Wikidata only
php bin/semantic-search-cron.php update-embeddings # Embeddings
php bin/semantic-search-cron.php export-es    # ES export

GAP 5: Format Migration Pathways - COMPLETE

Completed: 2026-03-11 | Category: Digital Preservation

Plugin: ahgPreservationPlugin

Implementation:

  • MigrationPathwayService (507 lines) — pathway CRUD, recommendation engine, format assessment
  • MigrationPlanService (743 lines) — plan lifecycle (draft → approved → in_progress → completed), batch processing
  • 47 seed migration pathways across 5 tool families (ImageMagick, FFmpeg, Ghostscript, LibreOffice, Pandoc)
  • 32 PRONOM-registered format entries with risk levels
  • Format obsolescence tracking with urgency levels (critical, high, medium, low)
  • 5 database tables: preservation_migration_pathway, preservation_format_obsolescence, preservation_migration_plan, preservation_migration_plan_object, preservation_format
  • Admin UI at /admin/preservation/conversion
  • CLI: php bin/atom preservation:migration --pathways|--obsolescence|--assess|--tools|--stats
Migration Pathway Coverage: Category Pathways Tools
Image → TIFF 7 routes ImageMagick
PDF → PDF/A 7 routes Ghostscript
Office → PDF/A 5 routes LibreOffice
Audio → FLAC/WAV 5 routes FFmpeg
Video → MP4/MKV 5 routes FFmpeg

GAP 6: JSON-LD Export - COMPLETE

Completed: 2026-03-11 | Category: Linked Data

Plugin: ahgMetadataExportPlugin

Implementation:

  • SchemaOrgExporter (636 lines) — maps ISAD(G) to Schema.org types (ArchiveComponent, Collection, Photograph, etc.)
  • AbstractRdfExporter — base class supporting JSON-LD, Turtle, RDF/XML, N-Triples output
  • RicoExporter — Records in Contexts (RIC-O) JSON-LD
  • BibframeExporter — BIBFRAME JSON-LD for library data
  • LinkedDataContentNegotiationFilter — Accept: application/ld+json → automatic 303 redirect
  • CORS headers, Vary: Accept, Link: rel="alternate" on HTML pages
  • EasyRDF integration for parsing and serialization
Endpoints: Route Format
/{slug}.jsonld Information object (Schema.org)
/repository/{slug}.jsonld Repository (Schema.org)
/actor/{slug}.jsonld Actor (Schema.org)
/sitemap-ld.xml Linked data sitemap

SEO Integration: SchemaOrgService in ahgThemeB5Plugin (680 lines) generates <script type="application/ld+json"> tags with CSP nonce on every public page.

GAP 7: IIIF Auth API - COMPLETE

Completed: 2026-03-11 | Category: IIIF & Media

Plugin: ahgIiifPlugin

Standard: IIIF Authentication API 1.0

Implementation:

  • IiifAuthService (478 lines) — token management, access checks, 3-tier hierarchy
  • 4 auth profiles: login, clickthrough, kiosk (IP-based), external (SSO)
  • SHA-256 hashed token storage with HttpOnly/Secure/SameSite cookies
  • 3-level access hierarchy: object → repository → ancestor inheritance (MPTT, up to 20 levels)
  • Degraded access support (thumbnail-only with configurable width)
  • Manifest-level integration — auth service blocks injected into IIIF manifests
  • Comprehensive audit logging (iiif_auth_access_log)
  • Token cleanup for expired sessions
Endpoints: Route Purpose
/iiif/auth/login/:service Login flow
/iiif/auth/token/:service Token issuance
/iiif/auth/logout/:service Logout + token revocation
/iiif/auth/confirm/:service Clickthrough confirmation
/iiif/auth/check/:id Access check API
/admin/iiif-auth Admin dashboard
/admin/iiif-auth/protect Protect resource
/admin/iiif-auth/unprotect Remove protection

Database Tables: iiif_auth_service, iiif_auth_token, iiif_auth_resource, iiif_auth_repository, iiif_auth_access_log

Overall Ratings by Category

Category AtoM AHG ArchivesSpace Preservica CollectiveAccess ResourceSpace Axiell
Core Archives 10 9 6 7 2 9
Digital Preservation 10 5 10 4 3 2
API & Integrations 10 8 9 6 6 7
AI & ML 10 2 9 2 6 2
IIIF & Media 10 4 8 6 4 7
Compliance & Security 10 5 8 4 5 6
Museum Standards 10 2 1 9 1 10
Data Migration 10 8 8 8 6 8
Public Access 10 7 7 7 8 7
Linked Data 10 4 3 8 2 4
TOTAL 100/100 54/100 69/100 61/100 43/100 62/100

Unique Advantages (No Competitor Has)

Feature Plugin Description
Self-Healing Preservation ahgPreservationPlugin Automatic fixity repair from backup
RiC with Fuseki ahgRicExplorerPlugin Full Records in Contexts with SPARQL
3D IIIF Manifests ahg3DModelPlugin IIIF 3.0 for 3D models with AR
Multi-Jurisdiction Privacy ahgPrivacyPlugin 7 privacy frameworks in one plugin
Traditional Knowledge Labels ahgExtendedRightsPlugin Local Contexts integration
Getty Auto-Linking ahgMuseumPlugin Confidence-scored vocabulary matching
SHACL Validation ahgRicExplorerPlugin RiC shape validation
Mobile Condition Capture ahgConditionPlugin Field assessments with photo upload
Integrated E-Commerce ahgCartPlugin PayFast/Stripe in archives
Heritage Accounting ahgHeritageAccountingPlugin GRAP 103, IPSAS 45, FRS 102, GASB 34

Plugin Inventory (80 Plugins)

Core Required (Locked)

Plugin Purpose
ahgThemeB5Plugin Bootstrap 5 theme
ahgSecurityClearancePlugin Security classification

Sector-Specific

Plugin Purpose
ahgLibraryPlugin MARC-inspired cataloging
ahgMuseumPlugin CCO/SPECTRUM/CIDOC-CRM
ahgGalleryPlugin Gallery/exhibition management
ahgDAMPlugin Digital Asset Management

AI & Advanced

Plugin Purpose
ahgNerPlugin Named Entity Recognition
ahgSemanticSearchPlugin Semantic search, thesaurus, embeddings
ahgMetadataExtractionPlugin EXIF/IPTC/XMP extraction
ahg3DModelPlugin 3D viewer with AR
ahgRicExplorerPlugin Records in Contexts

Preservation & Conservation

Plugin Purpose
ahgPreservationPlugin Fixity, PRONOM, SIP/AIP/DIP
ahgConditionPlugin Condition assessment
ahgProvenancePlugin Chain of custody

Compliance

Plugin Purpose
ahgPrivacyPlugin Multi-jurisdiction privacy
ahgAuditTrailPlugin Comprehensive logging
ahgHeritageAccountingPlugin Heritage asset accounting
ahgExtendedRightsPlugin RightsStatements.org, TK Labels
ahgRightsPlugin PREMIS rights

Research & Access

Plugin Purpose
ahgResearchPlugin Reading room, researcher portal
ahgAccessRequestPlugin Access request workflow
ahgRequestToPublishPlugin Publication requests

Commerce & Operations

Plugin Purpose
ahgCartPlugin Shopping cart, payments
ahgVendorPlugin Vendor management
ahgDonorAgreementPlugin Donor tracking
ahgLoanPlugin Object loan management

Data & Integration

Plugin Purpose
ahgAPIPlugin REST API v2
ahgDataMigrationPlugin Import/export tools
ahgMigrationPlugin Data migration
ahgReportBuilderPlugin Custom reports
ahgBackupPlugin Automated backups

User Experience

Plugin Purpose
ahgDisplayPlugin Display profiles, ZoomPan
ahgFavoritesPlugin User bookmarks
ahgFeedbackPlugin User feedback
ahgIiifCollectionPlugin IIIF collections
ahgSpectrumPlugin SPECTRUM 5.0

Ingestion & Import

Plugin Purpose
ahgIngestPlugin OAIS-aligned 6-step ingest wizard
ahgDataMigrationPlugin GLAM/DAM CSV import/export

Administration

Plugin Purpose
ahgSettingsPlugin Centralized settings hub
ahgJobsManagePlugin Background job management
ahgMenuManagePlugin Menu/navigation management
ahgStaticPagePlugin Static page management
ahgInformationObjectManagePlugin Information object management

Browse & Discovery

Plugin Purpose
ahgDisplayPlugin GLAM display profiles, ZoomPan
ahgSearchPlugin Advanced search
ahgUiOverridesPlugin UI overrides, viewer dispatch
ahgAccessionManagePlugin Accession browse
ahgActorManagePlugin Actor browse, autocomplete
ahgDonorManagePlugin Donor browse
ahgRepositoryManagePlugin Repository browse
ahgRightsHolderManagePlugin Rights holder browse
ahgStorageManagePlugin Physical storage browse
ahgTermTaxonomyPlugin Term & taxonomy browse

Compliance Support

Privacy Regulations

Jurisdiction Regulation Status
South Africa POPIA, PAIA Full
European Union GDPR Full
United Kingdom UK GDPR Full
Canada PIPEDA Full
Nigeria NDPA Full
Kenya DPA Full
California CCPA Full

Heritage Accounting Standards

Standard Region
GRAP 103 South Africa
IPSAS 45 International
FRS 102 United Kingdom
GASB 34 USA State/Local
FASAB USA Federal
AASB 116 Australia
PSAB/PS 3150 Canada

Milestones

Milestone Score Date
Initial Framework 94/100 2026-01-01
Speech-to-Text 95/100 2026-01-20
PII Detection 96/100 2026-01-21
SDKs + Semantic Search 97/100 2026-01-22
Format Migration + JSON-LD + IIIF Auth 100/100 2026-03-11

Document History

Date Version Changes
2026-01-20 1.0 Initial analysis
2026-01-20 1.5 Speech-to-Text complete (95/100)
2026-01-21 1.6 PII Detection complete (96/100)
2026-01-22 2.0 SDKs created, Semantic Search plugin, renamed to ROADMAP.md (97/100)
2026-02-13 3.0 Updated to 78 plugins, Heratio migration status, ahgIngestPlugin
2026-03-11 4.0 100/100 achieved — Format Migration Pathways, JSON-LD Export, IIIF Auth API confirmed complete. 80 plugins.

The Archive and Heritage Group (Pty) Ltd https://theahg.co.za