====== Introduzione ======

Questa guida definisce lo standard operativo per il testing software su piattaforme Ufficio Linux. L'obiettivo è garantire che ogni segnalazione sia basata su un ambiente "vanilla" (pulito), aggiornato e isolato, eliminando variabili esterne come configurazioni utente pregresse o conflitti di dipendenze.

===== Requisiti dell'Ambiente di Test =====

Per evitare il fenomeno del "sul mio PC funziona", i test devono essere eseguiti esclusivamente su Macchine Virtuali (VM) aggiornate.

===== Scelta dell'Hypervisor =====

  * **VirtualBox:** Consigliato per test cross-platform rapidi grazie alle Guest Additions.
  * **KVM/QEMU (virt-manager):** Standard per performance quasi native su host Linux.
  * **VMware Workstation/Player:** Alternativa per ambienti enterprise.

===== Procedura di Setup della VM (Stato Pulito) =====

  - **Installazione OS:** Installare le Distribuzioni Linux di Ufficio Zero.
  - **Minimal Setup:** Non installare software superfluo.
  - **Aggiornamento:** Eseguire sempre:
    <code>
sudo apt update && sudo apt full-upgrade -y
    </code>
  - **Snapshot (Fondamentale):** Prima di installare il software da testare, creare uno **Snapshot** chiamato "CLEAN_STATE".
    //Nota: Ogni sessione di test deve partire dal ripristino di questo snapshot.//

===== Segnalazione pacchetti difettosi UZL =====

Per segnalare app già rilasciate attraverso i mirror di Ufficio Zero che non funzionano più o che vanno in errore oppure pb derivanti da software base già installato loggarsi sul portale [[https://bugs.ufficiozero.org|Portale segnalazione interno]], se non si ha accesso scrivere in privato a Julian per farsi creare utenza.

===== Struttura del Report di Test (.ods) =====

I risultati devono essere salvati in un file di foglio elettronico OpenDocument (ODS) con le seguenti colonne obbligatorie:

^ Intestazione Colonna ^ Descrizione ^ Esempio ^
| **id_bug** | Identificatore univoco (formato BUG_00X) | BUG_001 |
| **descrizione_bug** | Titolo sintetico e autoesplicativo del problema | Crash all'apertura del menu "Impostazioni" |
| **passaggi_per_riprodurlo** | Elenco numerato dei passi per replicare il problema | 1. Avviare app; 2. Cliccare su 'File'; 3. Selezionare 'Esci' |
| **versione_software** | Versione esatta del pacchetto o commit Git | v2.4.1-stable o hash [a1b2c3d] |
| **data_test** | Data di esecuzione del test (AAAA-MM-GG) | 2026-04-10 |
| **foto_test** | Screenshot del problema | foto.png |

===== Protocollo Operativo di Segnalazione =====

==== 1. Fase di Verifica ====

  * Ripristinare la VM allo stato **CLEAN_STATE**.
  * Installare il software in prova.
  * Eseguire i passaggi che hanno portato al bug.
  * **Regola d'oro:** Se il bug non si presenta sulla VM pulita ma si presenta sul tuo host, il bug è relativo alla configurazione locale e non va segnalato come bug software.

==== 2. Documentazione ====

In caso di bug confermato:

  - Acquisire uno screenshot o un breve video (screencast) dell'errore.
  - Estrarre i log di sistema o dell'applicazione (es. <code>journalctl -xe</code> o file <code>.log</code>).
  - Inserire i dati nel file ODS seguendo lo schema sopra riportato o modificando opportunamente.

==== 3. Pulizia ====

Al termine della sessione, spegnere la VM e scartare le modifiche (o ripristinare lo snapshot) per garantire che il prossimo test parta da una base vergine, ma ricordandosi di aggiornare sempre.

==== Copyright ====
Aggiungersi al fondo per ulteriori modifiche:
  * Release: 05/2026
  * Autore: Lorenzo DM
  * inserimento link portale bug interno: Julian