Package Manager (.eap) & Registry Remoto

I Package EasyEA (.eap) sono archivi modulari e versionabili che contengono tutto il necessario per adottare un framework o una libreria architetturale in un unico pacchetto: tassonomie, elementi di riferimento, attributi tipizzati, stereotipi, schemi grafici e viste business pre-configurate.

L’Admin Hub include un vero e proprio App Store architetturale collegato a un Registry remoto sicuro.

1. Il Package Repository Registry & Verifica SHA-256

All’interno di Admin Hub ➔ Gestione Package, puoi esplorare il catalogo remoto sincronizzato con il file index.json di EasyEA:

graph LR
    Reg[Remote Package Registry index.json] --> Down[Download Archivio .eap]
    Down --> SHA[Verifica Integrità Checksum SHA-256]
    SHA --> Inst[Installazione 1-Click nel Workspace Attivo]

Verifica Integrità Criptografica: Prima dell’applicazione nel database, ogni archivio .eap scaricato viene validato confrontando il checksum calcolato con l’hash SHA-256 ufficiale pubblicato nel manifest del registry.
Installazione 1-Click: Inietta istantaneamente le entità del framework nel database senza riavviare il server.
Disinstallazione & Purge Sicuro: Rimuove ordinatamente gli elementi del package preservando le relazioni personalizzate create dagli utenti, oppure esegue il purge completo su richiesta.

2. Anatomia di un Package `.eap`

Un file .eap è un archivio compresso contenente una cartella standardizzata:

my-custom-package.eap (ZIP Archive)
├── manifest.json              # Metadati, versione, compatibilità, autore e dipendenze
├── metamodel_extensions.json   # Attributi custom, stereotipi e regole di validazione
├── seed_elements.json         # Catalogo elementi precaricati con relative proprietà
├── seed_relationships.json    # Relazioni ArchiMate formali tra gli elementi seed
├── seed_schemas.json          # Diagrammi e schemi grafici inclusi
└── seed_views.json            # Viste business e cruscotti executive personalizzati

Il file `manifest.json`

{
  "package_id": "corporate-fintech-core",
  "version": "1.4.0",
  "name": "Corporate FinTech Domain Model",
  "author": "Enterprise Architecture CoE",
  "min_easyea_version": "1.0.0",
  "description": "Libreria canonica per sistemi di pagamento PSD2, Open Banking e Core Banking",
  "sha256": "8f4e2c1a9b3d5e7f...",
  "dependencies": [
    "bian-v12-banking"
  ]
}

3. Creazione di Package con Package Builder CLI

EasyEA include una suite di script Python (tools/*_package_builder/) per consentire ai team di architettura di costruire automaticamente package .eap partendo da fogli Excel, specifiche OpenAPI o repository Git:

# Esempio: Generazione del package aziendale personalizzato
python3 tools/custom_package_builder/build_package.py \
  --source-dir ./domains/insurance-core \
  --output ./dist/corporate-insurance-core-v1.0.0.eap \
  --compute-checksum

Lo script valida la correttezza del manifest, verifica che tutti gli ID degli elementi siano univoci e calcola l’hash SHA-256 pronto per essere pubblicato sul registry interno della tua azienda.