Template Library (Documentale)

La Template Library gestisce i template DOCX/ODT/PDF usati da SafeOps e dai motori documentali.
Consente di versionare i template, aprirli in Collabora, scaricarli e archiviare versioni obsolete.

Scopo

• Centralizzare i template per tenant e servizio.
• Tenere uno storico di versioni.
• Permettere modifica collaborativa in Collabora.
• Evitare sovrascritture accidentali.

Permessi

• Admin / Operatore Admin: gestione completa (crea, upload versioni, archivia).
• Tecnici: sola lettura (download, apertura in editor).
• Super Admin (IDS): vede e modifica tutti i tenant.

Struttura storage (MinIO)

Ogni versione viene salvata in un percorso standard:

templates/<servizio>/<codice_template>/<versione>/<file.docx>

Esempio:

templates/ras/ras_master/v34/RAS_master_v34.docx

Flusso operativo

1. Crea Template
2. Inserisci servizio, codice, nome.
3. Carica Versione
4. Versione (es. v34).
5. Upload del file.
6. Opzioni:
   • Imposta come versione attiva.
   • Segna precedenti come obsolete.
7. Apri in Collabora
8. Da “Versioni” → “Apri”.
9. Download
10. Da “Versioni” → “Download”.
11. Archivia
12. Archivia il template (non più attivo ma storico disponibile).

Versioning

• Ogni upload crea una nuova versione.
• Una sola versione è attiva per template.
• Le versioni obsolete rimangono accessibili (storico).
• È possibile eliminarle (soft delete).

Consigli

• Usa codici versione consistenti (v1, v2, v34).
• Non sovrascrivere file già versionati.
• Per modifiche rapide usa Collabora, per refactor complessi scarica e ricarica.

Note tecniche

• I template sono salvati in MinIO, tracciati in DB.
• L’apertura in Collabora genera un link WOPI temporaneo.
• I template non entrano nel flusso “Documenti cliente”.