Raport de bug care impune soluția în loc să descrie problema
„Puneți min=1 pe câmpul de cantitate” e o propunere de cod, nu un raport de bug. Descrie comportamentul greșit (cantitatea −1 e acceptată și totalul devine negativ) și ce cere cerința; cum se repară decide programatorul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un raport de bug răspunde la trei întrebări: ce ai făcut, ce s-a întâmplat, ce trebuia să se întâmple. Când testerul scrie direct soluția („adăugați validare în JavaScript”, „schimbați > cu >=”), raportul nu mai spune problema. Programatorul vede o sarcină tehnică, nu un defect, și poate aplica exact soluția cerută fără să observe că problema reală e în altă parte (de exemplu validarea lipsește și pe server, nu doar în pagină).
În plus, soluția propusă poate fi greșită sau incompletă. Un atribut min=1 în pagină nu oprește o cerere trimisă direct către server.
Dacă ai o idee despre cauză, e utilă, dar pune-o la final, separat („Observație: posibil lipsește validarea pe server”). Titlul, rezultatul așteptat și cel obținut descriu comportamentul.
De ce apare: cauzele frecvente
1Titlul e o cerință de implementare
Titlu: Puneți min=1 pe input-ul de cantitateTitlu: Coș: cantitatea negativă este acceptată, totalul devine negativTitlul corect descrie efectul, pe care îl poate verifica oricine. Titlul greșit descrie o modificare de cod.
2Rezultatul așteptat descrie codul
Rezultat așteptat: programatorul adaugă validare în JavaScriptRezultat așteptat: cantitatea −1 e respinsă cu mesaj; se acceptă doar 1–10 (R7)Rezultatul așteptat vine din cerință și descrie ce vede utilizatorul, nu cum se construiește.
Corectează greșeala, direct în pagină
Raportul BUG-1 spune doar ce cod să schimbe programatorul. Reprodu problema în Aplicația (Mouse wireless în coș, cantitatea −1), apoi rescrie titlul, rezultatul așteptat și rezultatul obținut ca să descrie comportamentul: ce s-a întâmplat cu cantitatea și totalul și ce cere R7.
Indiciu
Titlul și rezultatul obținut trebuie să spună că valoarea negativă e acceptată; rezultatul așteptat, ce valori permite R7.
Reparația
Reprodu problema și descrie comportamentul.
1. În Aplicația: adaugă Mouse wireless, deschide Coșul și scrie cantitatea -1: totalul devine negativ. 2. Deschide BUG-1 și schimbă:
- Titlu: Coș: cantitatea negativă este acceptată, totalul devine negativ
- Rezultat așteptat: Cantitatea -1 este respinsă cu un mesaj; se acceptă doar valori întregi de la 1 la 10 (R7)
- Rezultat obținut: Cantitatea -1 este acceptată, iar totalul devine negativ 3. Salvează.
De ce merge
Raportul rescris descrie un defect verificabil: o acțiune, un efect vizibil și regula încălcată. Programatorul decide cum îl repară și, având comportamentul descris, verifică și locurile pe care soluția propusă le-ar fi ratat (validarea pe server, alte câmpuri de cantitate).
La retestare, rezultatul așteptat din R7 îți spune ce să verifici: −1, 0 și 11 respinse, 1 și 10 acceptate, indiferent cum a fost scris codul.
Alte forme ale mesajului
Bug report suggests a fixSolution instead of problem in bug reportBug report written as a task
Cum o eviți pe viitor
- Descrie comportamentul observat, nu modificarea de cod pe care o crezi necesară.
- Ia rezultatul așteptat din cerință (aici R7), nu din implementare.
- Dacă ai o ipoteză despre cauză, scrie-o separat, la final, ca observație.
- Citește titlul: dacă începe cu un verb la imperativ („puneți”, „schimbați”), e o sarcină, nu un bug.
Întrebări frecvente
Nu e util să propun o soluție dacă o știu?
Poate fi util, ca observație separată. Dar raportul trebuie să stea în picioare și fără ea: problema descrisă clar rămâne valabilă chiar dacă soluția ta nu e cea potrivită.
Ce fac dacă soluția e evidentă, de exemplu o greșeală de scriere?
Scrie textul afișat și textul corect. E tot o descriere a problemei, iar soluția reiese singură.
Greșeli înrudite
Rezultat așteptat scris din presupuneri, nu din cerință Dacă scrii rezultatul așteptat după cum crezi tu că ar trebui să meargă („reducerea e de 20 lei”), raportul poate fi greșit chiar dacă bug-ul e real. Calculează rezultatul așteptat din cerință (R8: 10% din subtotal) și trece referința la ea. Titlu de bug vag („Nu merge căutarea”) Un titlu ca „Nu merge căutarea” nu spune unde, ce și în ce condiții, așa că bug-ul nu poate fi triat, căutat sau deosebit de altele. Scrie titlul după formula: unde + ce se întâmplă + condiția, de exemplu „Căutare: „laptop” cu litere mici nu găsește „Laptop UltraBook””. Uitate valorile 0 și negative la câmpurile numerice La cantitate, sumă sau vârstă, 0 și numerele negative sunt clase invalide pe care testerii le sar des, iar aplicația le acceptă: produs cu 0 bucăți rămas în coș, total negativ. Încearcă mereu 0, -1 și o valoare zecimală în orice câmp numeric. Învață Testare manuală de la zero, cu exerciții la fiecare lecție
Curs Testare manuală (QA): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.
