guida_testing
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
guida_testing [2026/04/13 08:40] lorenzodm |
guida_testing [2026/04/23 12:04] (current) team [Copyright] |
||
|---|---|---|---|
| Line 3: | Line 3: | ||
| 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. | 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 === | + | ===== 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. | Per evitare il fenomeno del "sul mio PC funziona", i test devono essere eseguiti esclusivamente su Macchine Virtuali (VM) aggiornate. | ||
| - | === Scelta dell'Hypervisor === | + | ===== 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) === | + | * **VirtualBox:** Consigliato per test cross-platform rapidi grazie alle Guest Additions. |
| - | # '''Installazione OS:''' Installare le Distribuzioni Linux di Ufficio Zero. | + | * **KVM/QEMU (virt-manager):** Standard per performance quasi native su host Linux. |
| - | # '''Minimal Setup:''' Non installare software superfluo. | + | * **VMware Workstation/Player:** Alternativa per ambienti enterprise. |
| - | # '''Aggiornamento:''' Eseguire sempre: | + | |
| - | #: <code>sudo apt update && sudo apt full-upgrade -y</code> | + | ===== Procedura di Setup della VM (Stato Pulito) ===== |
| - | # '''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.'' | + | - **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) ===== | ||
| - | === Struttura del Report di Test (.ods) === | ||
| I risultati devono essere salvati in un file di foglio elettronico OpenDocument (ODS) con le seguenti colonne obbligatorie: | I risultati devono essere salvati in un file di foglio elettronico OpenDocument (ODS) con le seguenti colonne obbligatorie: | ||
| - | {| class="wikitable" | + | ^ Intestazione Colonna ^ Descrizione ^ Esempio ^ |
| - | ! 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" | |
| - | | '''id_bug''' || Identificatore univoco (formato BUG_00X) || BUG_001 | + | | **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] | |
| - | | '''descrizione_bug''' || Titolo sintetico e autoesplicativo del problema || Crash all'apertura del menu "Impostazioni" | + | | **data_test** | Data di esecuzione del test (AAAA-MM-GG) | 2026-04-10 | |
| - | |- | + | | **foto_test** | Screenshot del problema | foto.png | |
| - | | '''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 ==== | + | ===== Protocollo Operativo di Segnalazione ===== |
| - | === 1. Fase di Verifica === | + | ==== 1. Fase di Verifica ==== |
| - | * Ripristinare la VM allo stato '''CLEAN_STATE'''. | + | |
| - | * Installare il software in prova. | + | * Ripristinare la VM allo stato **CLEAN_STATE**. |
| - | * Eseguire i passaggi che hanno portato al bug. | + | * Installare il software in prova. |
| - | * '''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. | + | * 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 ==== | ||
| - | === 2. Documentazione === | ||
| In caso di bug confermato: | 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 === | + | - 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. | 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 | ||
guida_testing.1776062407.txt.gz · Last modified: 2026/04/13 08:40 by lorenzodm
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution 4.0 International
