Mantis Bug Tracker

Mantis Bug Tracker è una piattaforma open source di gestione di anomalie e problemi software, utilizzata per tenere traccia degli errori e delle richieste di correzione dei clienti. In questo documento sono descritte le istruzioni per la registrazione e l'accesso alla piattaforma, nonché le funzionalità che permettono di gestire le segnalazioni di anomalie e di monitorare l'avanzamento del processo di correzione del problema.

La gestione delle anomalie in un software di bug tracking come Mantis prevede un flusso di lavoro standardizzato che permette di monitorare l'avanzamento della correzione di un problema software. Il flusso di lavoro prevede i seguenti passaggi:

1. Creazione della segnalazione: l'utente che riscontra un problema software crea una segnalazione nel sistema di bug tracking, descrivendo il problema riscontrato e le eventuali azioni che hanno portato al verificarsi del problema.
2. Assegnazione della segnalazione: la segnalazione viene assegnata a un membro del team di sviluppo, che si occuperà di analizzare il problema e di valutare la sua criticità.
3. Analisi del problema: il membro del team di sviluppo assegnato alla segnalazione analizza il problema riscontrato, provando a riprodurlo e a individuare la causa del problema.
4. Risoluzione del problema: una volta individuata la causa del problema, il membro del team di sviluppo si occupa di correggere il problema e di testare la soluzione proposta.
5. Verifica della correzione: una volta corretto il problema, il membro del team di sviluppo verifica che la correzione abbia effettivamente risolto il problema.
6. Chiusura della segnalazione: una volta verificato che il problema è stato corretto, la segnalazione viene chiusa.

Il sistema di bug tracking permette di tenere traccia dell'avanzamento delle segnalazioni, mostrando lo stato di ogni segnalazione (aperta, in corso, risolta, chiusa) e il membro del team di sviluppo assegnato alla segnalazione. In questo modo, ogni membro del team di sviluppo può monitorare l'avanzamento della correzione dei problemi software e intervenire tempestivamente in caso di necessità. Le notifiche sugli stati di avanzamento della segnalazione avvengono attraverso delle mail ai membri del team che fanno parte dello stesso progetto.

Per la registrazione alla piattaforma Mantis di Tesy Software, è necessario:

1. Richiedere la registrazione al proprio referente Tesy, che provvederà a creare un nuovo account dedicato.
   Dovrà essere fornito un indirizzo mail per la registrazione.
   Per convenzione, il nome utente sarà del tipo <nome>.<cognome> (es.: mario.rossi, michela.bianchi, ecc.), tutto in minuscolo.
   Una volta completata l'operazione si riceverà una mail con le istruzioni per la creazione della password personalizzata e l'accesso.

Una volta completata la registrazione sarà possibile accedere al proprio account attraverso le proprie credenziali.

Una volta completato l'accesso al proprio account, si avrà accesso alla dashboard di Mantis, che permette di effettuare una serie di operazioni.
Il layout e la disponibilità dei comandi potrebbe variare in base al *ruolo* assegnato dall'amministratore del progetto.
Generalmente viene impostato di base il ruolo di “segnalatore”: questo ruolo permette di aprire e gestire le nuove segnalazioni, provvedendo ai cambi di stato (nuova, da discutere, risolta, chiusa) e di assegnazione (all'utente destinato alla risoluzione della segnalazione, generalmente l'amministratore del progetto o il referente Tesy)

L'interfaccia di Mantis permette inoltre di visualizzare, ordinare, ricercare e gestire tutte le segnalazioni pubbliche del team relative al progetto di cui l'utente fa parte.

Per creare una nuova anomalia/segnalazione é sufficiente selezionare l'opzione Nuova anomalia in altro a destra, nella toolbar di Mantis, oppure dal menù verticale a scomparsa sulla sinistra.

Nel caso non ci siano progetti selezionati, é possibile selezionare a priori il progetto di cui la nuova segnalazione farà parte, altrimenti la segnalazione verrà associata al progetto di default.

Si aprirà quindi l'interfaccia per l'inserimento e l'invio dei dati relativi alla nuova segnalazione.
Dovranno essere compilati tutti i campi obbligatori (*) prima dell'invio della segnalazione

Categoria

Riproducibilità

Gravità

Priorità

Assegna a

Riassunto

Descrizione

Passaggi per riprodurre l'anomalia

Ulteriori informazioni

Carica File

Invia Anomalia

Generalmente la compilazione di una segnalazione deve seguire alcune regole per permettere al team di sviluppo di poter, autonomamente e in qualsiasi momento, replicare il problema segnalato.
Questo si riassume in alcune convenzioni da seguire per facilitare il compito del team di sviluppo:

1. Una segnalazione deve far riferimento ad una sola anomalia.
   Evitare di compilare la classica “lista della spesa”, ovvero una unica segnalazione con la descrizione di più anomalie.
2. Completare l'anomalia con tutte le informazioni possibili, integrando possibilmente con allegati tipo screen-shots, ordini di Metron (file rit), tavole dxf/dwg, modelli 3D, o in genere tutte le informazioni per descrivere e poter replicare il problema.
3. Esporre anche il flusso necessario a riprodurre il problema: spesso infatti alcuni bug emergono perché si utilizza un diverso “modus operandi” rispetto il flusso canonico o quello utilizzato per i test.
4. Essere chiari e concisi nella descrizione: chi dovrà risolvere la segnalazione non è detto che sia “familiare” con l'ambiente di utilizzo del segnalatore.
   Pertanto, nell'esposizione, ci si dovrà porre nella condizione come quella di spiegare il problema ad un “estraneo”.
5. Utilizzare e sfruttare le caratteristiche offerte da Mantis, per organizzare al meglio le segnalazioni: ad esempio in caso di anomalie simili, come ad esempio il caso di elementi diversi che presentano la stessa criticità o che dipendono una dall'altra, è possibile “collegare” le due segnalazioni tramite una relazione. Questo permette allo sviluppatore di fare i test necessari e ridurre i tempi di verifica.
6. Eventualmente, aggiungere all'anomalia gli utenti del progetto a cui devono arrivare le notifiche via mail (es capo-progetto, responsabile, ecc.)

Nella gestione di segnalazione, tutte le azioni, come i cambi di stato o di assegnazione, oltre ad essere notificati via mail ai principali attori (segnalatore, sviluppatore o altri membri supervisor), vengono anche memorizzate sequenzialmente in modo da poter esporre in modo chiaro nel thread la cronostoria della segnalazione.

Il flusso generalmente si compone in:

• Segnalatore → nuova / assegnazione
• Sviluppatore → riconoscimento/conferma/discussione
• Segnalatore → assegnazione/discussione
• Sviluppatore → risoluzione
• Segnalatore → chiusura

Ad ogni notifica viene aggiunta una nota numerata nel thread, disponibile nel box Attività:

Nel box Storia dell'anomalia viene invece riportata la crono-storia delle attività e dei cambi di stato.