Passa al contenuto principale

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.

Attenzione. Sul server di prova il catalogo non è ancora caricato: il meccanismo c'è, il pacchetto è da mettere al suo posto.

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).

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».

Per approfondire.
• Catalogo dei modelli base di GPE-NEXT: docs/gpe-next/CATALOGO.md