Ohranite sledljivost zahtev ob spremembah programske opreme

Opišite delovanje, ki ga lahko nekdo preveri

»Ustvarite sodoben izvoz podatkov strank« pušča pomembne odločitve odprte. Ne določa uporabnikov, zapisov, polj ali delovanja ob napaki. Agent mora vprašati ali predpostavljati. Nezabeležene predpostavke je pozneje težko pregledati.

Uporabite izmišljeno zahtevo z jasno mejo: vodja s preverjeno istovetnostjo lahko izvozi podatke aktivnih strank svoje organizacije. Izvoz vsebuje ID stranke in prikazno ime. Izključuje kontaktne podatke in arhivirane zapise. Uporabnik brez vloge vodje ne prejme izvoza.

Še vedno so potrebne odločitve o obliki, količini, odzivnem času in ravnanju ob napakah. Neznanke izrecno označite. Uporabna specifikacija razkrije negotovost, namesto da jo skrije v samozavestno besedilo.

Ločite zahteve od odločitev o izvedbi

Uporabnik potrebuje dovoljen nabor zapisov v uporabni obliki. Poizvedba v podatkovni zbirki, knjižnica in struktura končne točke so odločitve o izvedbi. Povežite jih z zahtevo, ne da bi vsako trenutno izbiro obravnavali kot trajno poslovno potrebo.

Pomembno odločitev zabeležite skupaj s kontekstom, alternativami in razlogom. Sinhroni izvoz je lahko na primer primeren za majhne količine. Večja količina lahko zahteva opravilo v ozadju in ločeno preverjanje avtorizacije prenosa.

Kjer je mogoče, zahtevo ohranite nespremenjeno, spremenjeno odločitev pa beležite z različico. To pomaga pregledovalcem ločiti drugačno izvedbo od drugačne obljube uporabnikom.

Ustvarite kratko verigo dokazil

Uporabite identifikatorje, ki med pregledi ostanejo razumljivi. V tem primeru lahko EXPORT-01 označuje mejo organizacije. Ime je ponazoritev in ne predpisan sistem številčenja.

Veriga mora kazati na dejanska dokazila. Ime testa, ki vsebuje ID zahteve, ne dokazuje, da jo njegova preverba preverja. Preglejte test in produkcijsko pot, ki jo preizkuša.

NIST SSDF daje kontekst za zahteve in preverjanje znotraj varnega razvoja. Sledljivost uporabite za preglednost teh dejavnosti in ne za ustvarjanje dokumentacije same zase. Preberite okvir.

Preglejte vpliv spremenjene predpostavke

Recimo, da poslovanje zdaj potrebuje podatke arhiviranih strank. Ta sprememba vpliva na več kot zastavico poizvedbe. Preverite pravila hrambe, avtorizacijo, pričakovano količino, pojasnila uporabnikom in pomen obstoječih poročil.

Prizadete dokumente in preverjanja označite za pregled. Ohranite prejšnjo odločitev, da lahko operativna ekipa pojasni starejšo izdajo. Zgodovine ne prepišite neopazno tako, da bi bila najnovejša zasnova videti neizogibna.

Agent lahko pomaga najti sklice in predlagati posodobitve. Odgovorne osebe morajo razrešiti nasprotujoče si zahteve in sprejeti spremenjeno delovanje. Seznam ujemajočih se datotek je izhodišče in ne popolna ocena vpliva.

Zapis naj ostane dovolj majhen za uporabo

Zabeležite odločitve, ki vplivajo na izvedbo, preverjanje in delovanje. Iste zahteve ne ponavljajte v številnih nepovezanih dokumentih. Prednost dajte povezavam do enega vzdrževanega vira.

Pred sprejetjem spremembe vprašajte, ali lahko pregledovalec sledi njenemu namenu do dejanskih dokazil. Pred začetkom delovanja vprašajte, ali lahko odgovorni za storitev najde ustrezno mejo in odločitev o obnovi. To sta praktična preizkusa uporabne sledljivosti.