Članki / Zahteve in specifikacije

Zahteve in specifikacije: kako urediti odločitve in spremembe

O zahtevah se je lažje pogovarjati, če zabeležite, kaj potrebujete, zakaj je to pomembno in kako boste preverili rezultat. Upravljanje zahtev in specifikacij ohranja te odločitve uporabne med napredovanjem dela.

Kaj upravljate poleg dokumenta?

Dokument je le eden od načinov za beleženje odločitve. Vedeti morate tudi, katere točke so dogovorjene, katere so še vedno predlogi, kdo bo odgovarjal na vprašanja in kaj se spremeni ob spremembi posamezne točke. Tako preprečite, da bi delo potekalo na podlagi različnih razlag iste zahteve.

Enak pristop lahko pomaga pri razvoju aplikacij, notranjih orodjih, pogojih izdelka in operativnih pravilih. Začnite z eno funkcijo ali potekom dela, namesto da bi poskušali dokumentirati vse naenkrat.

Povežite cilj, zahtevo, specifikacijo in merila sprejemljivosti

Ekipe te izraze uporabljajo na različne načine. V tem primeru zahteva opisuje potreben rezultat ali omejitev, specifikacija beleži dogovorjeno vedenje, merila za sprejem pa pojasnjujejo, kako ga preveriti. O teh pomenih se dogovorite z ljudmi, s katerimi sodelujete.

Cilj: zmanjšati ročno prepisovanje

Postopek mesečnega poročanja trenutno vključuje ročno prepisovanje zapisov. Namen izvoza je olajšati to delo.

Zahteva: izvozite zapise, potrebne za poročilo

Zaposleni mora izvoziti zapise za izbrani mesec v okviru dostopa, za katerega ima dovoljenje.

Specifikacija: določite datoteko in njeno vedenje

Dogovorite se o stolpcih, vrstnem redu, kodiranju besedila, obliki datuma, ravnanju ob praznih rezultatih in napakah. To so odločitve za ta primer, ne splošne privzete nastavitve.

Merila sprejemljivosti: poskrbite, da bo rezultat preverljiv

Pripravite zapise z znanimi datumi in dovoljenji, izvedite izvoz in primerjajte rezultat z dogovorjenim.

Od cilja do meril za sprejem Odpri ReqSpec AI

Za vsako postavko napišite eno preverljivo zamisel

Izraz, kot je »Naj bo izvoz priročen«, pušča pomembne odločitve odprte. Ločite izbiro obdobja, izbiro izhodnih polj, obravnavo primerov brez zadetkov in preverjanje dostopa, če je mogoče te postavke neodvisno spreminjati ali preverjati.

Namesto besed, kot sta »hitro« ali »preprosto«, uporabite konkretne pogoje. Če je cilj odzivnega časa pomemben, poleg številke zabeležite tudi obremenitev, okolje in metodo merjenja. Nedoločene vrednosti jasno označite kot nedoločene.

Prej: »Dovolite izvoz CSV.«

Po izboljšavi: »Izvozi izbrani mesec z dogovorjenimi stolpci in vrstnim redom razvrščanja. Prazne rezultate in preverjanja dostopa opredeli kot ločene postavke.«

Popravljeno besedilo opredeljuje izbire, o katerih je treba doseči dogovor, ter olajša dodeljevanje in pregledovanje dela. Pred izvedbo so še vedno potrebne konkretne opredelitve polj.

Majhen nabor polj za začetek

ID, naslov in opis

Vsaki postavki dodelite trajen ID, na primer REQ-001. Navedite predmet, pogoj in pričakovani rezultat. Trajen ID omogoča sklicevanje na postavko tudi po spremembi naslova.

Razlog in vir

Zabeležite težavo, ki jo element rešuje, in njegov izvor, na primer pogovor, zahtevo ali podporni dokument.

Prednost in obseg

Ločite, kaj je potrebno za to izdajo in kaj lahko počaka. Pojasnite razlog za prednostno obravnavo; vsem postavkam ne dodelite najvišje prednosti.

Odgovorna oseba in stanje odločitve

Zabeležite, kdo bo pojasnil postavko in ali je osnutek, v pregledu ali dogovorjena. Izvajalec in potrjevalec sta lahko različni osebi.

Merila sprejemljivosti in povezane informacije

Element povežite z ustreznimi specifikacijami, zasnovami, nalogami in zapisi preverjanja. Ko se zahteve spremenijo, te povezave posodobite.

Primer: tri zahteve za mesečni izvoz CSV

Sledi ponazoritveni primer. Imena polj in vedenje je treba dogovoriti glede na izdelek, ki ga razvijate; primer ni popolna specifikacija za vsako funkcijo izvoza.

REQ-001: zapisi za izbrani mesec

Primer specifikacije: uporabite izbrani mesec v dogovorjenem poslovnem časovnem pasu ter izvozite ID, datum zapisa in naslov v UTF-8, razvrščeno najprej po datumu in nato po ID. Primer sprejemnega merila: trije ustrezni zapisi ustvarijo eno vrstico z glavo in natanko te tri vrstice podatkov, brez zapisov iz drugih mesecev.

REQ-002: ni ujemajočih se zapisov

Primer specifikacije: izvozite dogovorjeno vrstico z glavami, tudi če ni ustreznih zapisov. Primer sprejemnega preizkusa: prazen preskusni nabor podatkov ustvari datoteko s to glavo in brez podatkovnih vrstic. Če želite namesto datoteke sporočilo, se dogovorite o takšnem drugačnem vedenju in ga dokumentirajte.

REQ-003: dostop se preveri pred izvozom

Primer specifikacije: uporabniki brez dovoljenja za izvoz ne morejo ustvariti datoteke, zapisi zunaj dovoljenega obsega pa niso vključeni. Primeri sprejemnih preizkusov morajo zajemati uporabnika brez dovoljenja za izvoz in uporabnika z omejenim dostopom do zapisov.

Uporabite hierarhijo, ne da bi izgubili posamezne odločitve

Postavke razvrstite v skupine glede na namen ali funkcijo, nato pa pod ustrezno skupino dodajte podrobne pogoje. Na primer: Poročanje → Mesečni izvoz CSV → Ciljni zapisi / Oblika datoteke / Prazni rezultati / Dostop. Ozadje in odprta vprašanja zapišite v opombe, namesto da bi jih združili v eno dolgo zahtevo.

Če en pogoj vpliva na več funkcij, ohranite jasno sklicevanje na dogovorjeno različico, namesto da bi v vsak razdelek kopirali različne različice. Pred spremembo preverite, katere nadaljnje specifikacije in točke preverjanja so od njega odvisne.

Dogovor, izvedbo in preverjanje obravnavajte ločeno

»Dogovorjeno« pomeni, da je bila vsebina sprejeta za predvideni obseg. To ne pomeni, da je funkcija že implementirana. »Implementirano« ne potrjuje, da so dogovorjena merila za sprejem izpolnjena ali da je funkcija že izdana. Te razlike naj ostanejo vidne, tudi če uporabljate preprost seznam stanj.

Preglejte običajni primer, prazne ali manjkajoče vnose, dovoljenja in zunanje napake, kjer je to pomembno. Določite, katera dokazila boste hranili, kdo jih bo preverjal in kdo lahko zaključi nerešeno vprašanje.

Zabeležite spremembo in njen vpliv, preden jo obravnavate kot dogovorjeno

Nova zahteva ostane predlog, dokler se odgovorne osebe ne dogovorijo, kako jo bodo obravnavale. Zabeležite razlog za spremembo, prizadete ID-je ter vpliv na delo, datume, specifikacije in preverjanje. Razmislite tudi, ali sprememba velja za zapise ali uporabnike, ki funkcijo že uporabljajo.

Po odločitvi posodobite trenutno specifikacijo in obvestite prizadete osebe. Če morate pojasniti, kaj se je spremenilo, shranite prejšnjo dogovorjeno različico ali opombo o spremembi. Ne predpostavljajte, da orodje samodejno beleži vse odobritve in popravke.

Izberite mesto, ki ga lahko sproti posodabljate

Za majhen seznam lahko zadostuje dokument ali preglednica v skupni rabi. Ko so razprava, izvedba in preverjanje razporejeni po več orodjih, izberite glavni vir in nanj povežite povezano gradivo. Pomembno je, da lahko vsi prepoznajo trenutno dogovorjeno vsebino.

Uporabite AI za osnutek in nato potrdite odločitve

UI lahko pomaga našteti možne zahteve, urediti osnutek in predlagati manjkajoča vprašanja. V pozivu ločite potrjena dejstva od predpostavk in zahtevajte, naj nedoločene vrednosti ostanejo v obliki vprašanj. Rezultat preglejte z ljudmi, ki poznajo predvideno uporabo.

V ReqSpec AI lahko zahteve in specifikacije organizirate hierarhično ter uporabljate AI za pomoč pri ustvarjanju, urejanju in preverjanju. Postavite usmerjeno vprašanje, na primer »Kateri pogoji za prazne rezultate še niso določeni?« Vsak odgovor obravnavajte kot predlog, ki ga je treba preveriti glede na zabeleženo vsebino, ne kot dokaz odobritve ali popolnosti.

Začnite z eno funkcijo in enim pregledom

Izberite eno funkcijo, navedite potrebne rezultate, dodelite elementom ID-je ter dodajte merila za sprejem in odprta vprašanja. Enkrat jih preglejte z ustrezno osebo, nato pa zabeležite odločitve in naslednjo odgovorno osebo. Majhna, redno vzdrževana zbirka je uporabnejša od obsežnega dokumenta, ki ga nihče ne posodablja.

Nadaljnje branje

NASA: Kako napisati dobro zahtevo

NASA: Upravljanje zahtev

Organizirajte zahteve in specifikacije z ReqSpec AI

ReqSpec AI omogoča preprosto urejanje zahtev in specifikacij na telefonu ter spletu. Oglejte si funkcije na strani aplikacije.