Eterna PreIngest

Jerry Malmström (Admin)

Ett verktyg med öppen källkod som gör det enklare att leverera digitalt material till ETERNA

Bakgrund

Vi har tillsammans med kunder diskuterat hur vi undviker att alla utvecklar sin egen lösning för preingest och istället skapar en "basplatta" att kunna bygga vidare på.

Detta är en start och en möjlighet att forma en ny produkt tillsammans som kan underlätta framtida preingest.

Hur det fungerar

Du beskriver dina metadata-fält i ett schema — plattformen sköter resten:

record:
  metadataType: "arende"
  label:
    sv: "Ärende"

recordFields:
  - name: arendenummer
    type: string
    required: true

  - name: status
    type: enumeration
    values: ["Aktiv", "Avslutad"]

Systemet läser schemat vid uppstart, genererar automatiskt de ETERNA config-filer (overlay) som behövs för din metadata-typ, och exponerar ett REST API som accepterar metadata + filer, paketerar dem som E-ARK SIP och levererar direkt till ETERNA.

Arkitektur

schema.yaml (din konfiguration)
      │
      ▼
eterna-ingest-service :8082   ← REST API
      │
      ▼
eterna-sip-commons            ← Paketering + ETERNA-klient
      │
      ▼
ETERNA                        ← AIP skapas i arkivet

Moduler

Modul	Typ	Beskrivning
`eterna-sip-commons`	Java-bibliotek	ETERNA-klient, SIP-paketering, retry-logik
`eterna-ingest-service`	Spring Boot	Konfigurerbart REST API + overlay-generering
`eterna-ingest-ui`	React	Webbgränssnitt för manuell inleverans

Funktioner

Schemadrivet — inga kodändringar behövs för nya metadata-typer
Automatisk overlay-generering — ETERNA-konfigurationen skapas och distribueras vid uppstart
Fältvalidering — string, date, enumeration m.fl., med flerspråkiga felmeddelanden
Inbyggd retry-logik — tillfälliga nätverksfel hanteras transparent
Exempelscheman medföljer — ärendehantering, EAD 2002, EAD 3

Använda som bibliotek

Om du vill integrera direkt i en befintlig Spring Boot-applikation:

<dependency>
    <groupId>se.eterna</groupId>
    <artifactId>eterna-sip-commons</artifactId>
    <version>1.0.0-SNAPSHOT</version>
</dependency>

Auto-konfigurationen registrerar EternaClient, IngestService, SipPackager m.fl. så fort eterna.url är satt.

Status och bidrag

Projektet är under aktiv utveckling. Källkod, issues och PR välkomnas.
Projektets repo och dokumentation: https://github.com/ETERNA-earkiv/eterna-preingest