# JK6.2 - Il catalogo dei modelli base

**In una frase.** I modelli base sono i modelli standard, uguali per tutte le installazioni: arrivano in un pacchetto che GPEnext carica da solo all'avvio.

Chi installa ADSWnext non deve ridisegnare fatture e bolle. Trova i modelli standard già pronti, e quando ne esce una versione nuova la riceve senza perdere le proprie modifiche.

<p class="callout warning">**Attenzione.** Sul server di prova il catalogo non è ancora caricato: il meccanismo c'è, il pacchetto è da mettere al suo posto.</p>

## Come funziona

1. **Chi mantiene i modelli standard li pubblica** e ne esporta il catalogo: un solo file, con un numero di versione.
2. **Il file si mette in una cartella del server**, quella indicata nell'installazione.
3. **All'avvio GPEnext lo legge.** Se il contenuto è diverso dall'ultimo caricato, aggiorna i modelli base. Se è lo stesso, non fa niente.
4. **Le personalizzazioni restano.** Chi ha una copia personalizzata di un modello base la tiene. Sulla copia compare l'avviso che c'è un aggiornamento disponibile, oppure obbligatorio.

## Cosa c'è dentro

Il pacchetto porta i modelli base **pubblicati** (mai le bozze), le loro versioni, gli schemi dei dati, i file di esempio e le immagini che i modelli usano.

## Cosa controllare

- **Cartella vuota o file assente**: nessun modello base, ma il servizio parte lo stesso.
- **File alterato o incompleto**: GPEnext se ne accorge e non parte. Va rimesso il file giusto.
- **Quale catalogo è caricato**: il servizio lo dice (versione, quando è stato caricato, quanti modelli).

<p class="callout info">**Per chi sviluppa.**  
• Il file si chiama `catalogo-gpe.json.gz` e sta nella cartella indicata da `GPE_CATALOGO_DIR`.  
• Il controllo è un'impronta del contenuto: all'avvio viene ricalcolata e confrontata con quella dichiarata.  
• Stato: `GET /api/gpe/catalogo/stato`. Esportazione, solo per lo staff: `POST /api/gpe/catalogo/esporta`.  
• Codice: nel servizio `backend/middleware/it_gsba_gpe_next`, pacchetto «catalogo». </p>

<p class="callout info">**Per approfondire.**  
• Catalogo dei modelli base di GPE-NEXT: `docs/gpe-next/CATALOGO.md`</p>