# AerariumChain DPAC T2 Generator · Guida rapida

Questa guida è dentro l'app ed è anche il contesto che un assistente AI riceve quando si collega
all'app o legge un'esportazione diagnostica. La guida completa per gli utenti con licenza è su
https://docs.aerariumchain.com/it/dpac-t2-packager/.

Il software è concesso in licenza. Si usa solo con un account AerariumChain HUB e una licenza attiva,
nei limiti del contratto di licenza accettato all'installazione. Copia, decompilazione e reverse
engineering non sono consentiti.

## 1. A cosa serve

L'app crea e verifica i **pacchetti T2** per la Digital Library (DPAC): l'aggiornamento del pacchetto
T1 già ingerito per la stessa opera. Un T2 contiene il METS aggiornato, i paradati (Relazione di setup e
Relazione di elaborazione), i dati grezzi di acquisizione e, a scelta, le immagini già presenti nel T1.

### Gigapixel

Per le opere con un T1 gigapixel (materiale HQ di D.PaC) l'app crea il T2 gigapixel: il METS del T1 con
il nuovo stato di aggiornamento, i paradati (Relazione di setup e Relazione di elaborazione dell'immagine)
e, come dati grezzi, le immagini di input del fotomosaico in RAW DNG con lo scatto del ColorChecker, scaricate
dall'hub. Lo stato di aggiornamento e il nome delle cartelle si impostano in Impostazioni → Pacchetti T2 gigapixel.

## 2. Accesso e licenza

All'avvio l'app chiede l'accesso con l'account AerariumChain HUB. La stessa sessione serve per i dati
dell'hub: non c'è un secondo login. In alto sono indicati il titolare della licenza e la scadenza.
Quando la licenza scade o viene sospesa, l'app si blocca e mostra a chi rivolgersi.

## 3. Creare un pacchetto

1. Scegliere hive e opera dall'hub e il tipo di T2 (3D o gigapixel): l'app recupera il METS del T1, l'identificativo DPAC e le schede.
2. Controllare i dati di identificazione (cantiere, lotto, PK, titolo).
3. Generare o allegare i paradati.
4. Scegliere i dati grezzi: export dal progetto di scansione, file o cartella, formato originale, oppure nessun dato grezzo.
5. Scegliere la destinazione e avviare. L'app verifica il pacchetto e produce lo ZIP, il certificato e il pacchetto di verifica.

Con **Batch** si creano i T2 di più opere di un cantiere, una alla volta.

## 4. Cartella di output

```
<destinazione>/CANTIERE_LOTTO_PK_T2/
  CANTIERE_LOTTO_PK_T2.zip               la consegna per la Digital Library
  CANTIERE_LOTTO_PK_T2_CERTIFICATO.pdf   certificato di verifica
  CANTIERE_LOTTO_PK_T2_VERIFICA.zip      pacchetto di verifica per il quality check
  CANTIERE_LOTTO_PK_T2/                  la consegna non zippata
  CANTIERE_LOTTO_PK_T2_VERIFICA/         la verifica non zippata
```

Il pacchetto di verifica contiene il rapporto dei controlli, le impronte MD5 e SHA-256 dello ZIP e
l'inventario dei file.

## 5. Verificare un pacchetto

Si indica una cartella o uno ZIP, anche ricevuto da un fornitore. L'app controlla struttura, METS,
identificativi, presenza e integrità di ogni file dichiarato. **Un errore blocca lo ZIP; un avviso no.**

| Messaggio | Cosa fare |
|---|---|
| Il METS non è un T2 | un T1 va caricato con il flusso T1 |
| Identificativo DPAC assente o diverso | prendere l'identificativo dall'hub (ultimo T1 non respinto) |
| Paradati assenti | generare o allegare le due relazioni |
| Dati grezzi solo segnaposto (avviso) | scegliere una modalità per i dati grezzi |
| File mancante o diverso | ricostruire il pacchetto; se è un file del T1, il T1 usato non è quello ingerito |
| File non del tipo dichiarato | file corrotto o rinominato |
| File non dichiarati (avviso) | rimuoverli o ricostruire |

## 6. Aggiornamenti e assistenza

Gli aggiornamenti arrivano dall'hub e si installano dall'app. **Chiedi assistenza** invia una richiesta
al team AerariumChain con le ultime righe del log.

## 7. Supporto AI

In **Collega ad AI** si esporta una diagnostica in Markdown da incollare in un assistente, oppure si
collega l'app a Claude Code o Claude Desktop come connettore MCP locale.

## 8. Problemi frequenti

- **Accesso negato o licenza non attiva**: verificare l'account e chiedere al referente della licenza.
- **Pannelli vuoti**: la sessione dell'hub è scaduta; rifare l'accesso.
- **Errore ricostruendo un pacchetto**: la cartella era aperta in un'altra finestra; riprovare.
- **Export dei dati grezzi rifiutato per dimensione**: ridurre la dimensione dalle opzioni dei dati grezzi.