Saglabājiet prasību izsekojamību, mainoties programmatūrai

Aprakstiet darbību, ko var pārbaudīt

„Izveidot modernu klientu eksportu“ atstāj būtiskus lēmumus atvērtus. Tas nenosaka lietotājus, ierakstus, laukus vai darbību kļūmes gadījumā. Aģentam vai nu jājautā, vai jāizdara pieņēmumi. Nereģistrētus pieņēmumus vēlāk ir grūti pārskatīt.

Izmantojiet izdomātu prasību ar skaidru robežu: autentificēts vadītājs var eksportēt aktīvos klientus no savas organizācijas. Eksports satur klienta ID un parādāmo vārdu. Tas neietver kontaktinformāciju un arhivētos ierakstus. Lietotājs bez vadītāja lomas eksportu nesaņem.

Vēl vajag lēmumus par formātu, apjomu, atbildes laiku un kļūmju apstrādi. Skaidri atzīmējiet nezināmo. Noderīga specifikācija atklāj nenoteiktību, nevis paslēpj to pārliecinošā tekstā.

Atdaliet prasības no īstenošanas izvēlēm

Lietotājam vajag atļautu ierakstu kopu lietojamā formātā. Datubāzes vaicājums, bibliotēka un galapunkta struktūra ir īstenošanas izvēles. Saistiet tās ar prasību, neuzskatot katru pašreizējo izvēli par pastāvīgu biznesa vajadzību.

Reģistrējiet būtisku lēmumu kopā ar kontekstu, alternatīvām un pamatojumu. Piemēram, sinhrons eksports var derēt nelielam apjomam. Lielāks apjoms var prasīt fona uzdevumu un atsevišķu lejupielādes autorizācijas pārbaudi.

Kur iespējams, saglabājiet prasību nemainīgu, vienlaikus versējot mainīto lēmumu. Tas palīdz pārskatītājiem atšķirt citu īstenojumu no cita solījuma lietotājiem.

Izveidojiet īsu pierādījumu ķēdi

Izmantojiet identifikatorus, kas paliek saprotami pārskatīšanā. Šajā piemērā EXPORT-01 var identificēt organizācijas robežu. Nosaukums ir ilustratīvs, nevis obligāta numerācijas sistēma.

Ķēdei jānorāda uz īstiem pierādījumiem. Testa nosaukums ar prasības ID nepierāda, ka testa nosacījums to pārbauda. Pārbaudiet testu un produkcijas koda ceļu, ko tas izpilda.

NIST SSDF sniedz kontekstu prasībām un pārbaudēm drošā izstrādē. Izmantojiet izsekojamību, lai šīs darbības varētu pārbaudīt, nevis radītu dokumentāciju pašas dokumentācijas dēļ. Lasiet ietvaru.

Pārskatiet mainīta pieņēmuma ietekmi

Pieņemsim, ka biznesam tagad vajag arī arhivētos klientus. Šī izmaiņa ietekmē vairāk nekā vaicājuma karodziņu. Pārbaudiet glabāšanas noteikumus, autorizāciju, gaidāmo apjomu, lietotāju skaidrojumus un esošo pārskatu nozīmi.

Atzīmējiet ietekmētos dokumentus un pārbaudes pārskatīšanai. Saglabājiet iepriekšējo lēmumu, lai ekspluatācijas speciālists varētu izskaidrot vecāku laidienu. Klusējot nepārrakstiet vēsturi, lai jaunākais risinājums izskatītos neizbēgams.

Aģents var palīdzēt atrast atsauces un piedāvāt atjauninājumus. Atbildīgajiem jāatrisina pretrunīgās prasības un jāpieņem mainītā darbība. Atbilstošo failu saraksts ir sākuma punkts, nevis pilns ietekmes novērtējums.

Saglabājiet ierakstu pietiekami nelielu lietošanai

Reģistrējiet lēmumus, kas ietekmē īstenošanu, pārbaudi un ekspluatāciju. Neatkārtojiet vienu prasību daudzos nesaistītos dokumentos. Dodiet priekšroku saitēm uz vienu uzturētu avotu.

Pirms izmaiņas pieņemšanas jautājiet, vai pārskatītājs var izsekot tās nolūku līdz faktiskajiem pierādījumiem. Pirms ekspluatācijas jautājiet, vai par pakalpojumu atbildīgais var atrast attiecīgo robežu un atjaunošanas lēmumu. Tie ir praktiski noderīgas izsekojamības testi.