Table of Contents
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:
sudo apt update && sudo apt full-upgrade -y
- 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 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.
journalctl -xe
o file
.log
).
- 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
