Żomm ir-rekwiżiti traċċabbli hekk kif jinbidel is-software
LestOrbot riżultat għall-utent mad-deċiżjonijiet, il-kriterji ta' aċċettazzjoni, l-implimentazzjoni u l-evidenza. Aġġorna l-konnessjonijiet meta jinbidlu s-suppożizzjonijiet.
Ippubblikat minn TaigaKif niktbu
Iċċekkja kemm fhimtL-ispeċifikazzjoni tinbidel wara li jkunu tħejjew l-arkitettura u t-testijiet. X'għandu jiġri?Agħmel l-eżerċizzju
X'se titgħallem
- Ikteb rekwiżit verifikabbli b'konfini espliċiti.
- Segwi rekwiżit fil-bidla u fil-kontrolli tagħha.
- Identifika dokumenti dipendenti li jiġu affettwati minn suppożizzjoni mibdula.
Iddeskrivi mġiba li xi ħadd jista’ jivverifika
‘Oħloq esportazzjoni moderna tad-data tal-klijenti’ tħalli deċiżjonijiet importanti miftuħa. Ma tiddefinixxix l-utenti, ir-rekords, il-fields jew l-imġiba f’każ ta’ ħsara. Aġent irid jew jistaqsi jew jagħmel suppożizzjonijiet. Suppożizzjonijiet mhux irreġistrati huma diffiċli biex jiġu riveduti aktar tard.
Uża rekwiżit fittizju b’konfini ċari: maniġer awtentikat jista’ jesporta d-data tal-klijenti attivi mill-organizzazzjoni tiegħu stess. L-esportazzjoni fiha l-ID tal-klijent u l-isem li jidher. Teskludi d-dettalji tal-kuntatt u r-rekords arkivjati. Utent mingħajr ir-rwol ta’ maniġer ma jirċievi ebda esportazzjoni.
Dan għadu jeħtieġ deċiżjonijiet dwar il-format, il-volum, il-ħin tar-rispons u l-immaniġġjar tal-ħsarat. Immarka espliċitament dak li mhux magħruf. Speċifikazzjoni utli turi l-inċertezza minflok taħbiha fi kliem kunfidenti.
Issepara r-rekwiżiti mill-għażliet tal-implimentazzjoni
L-utent jeħtieġ sett permess ta’ rekords f’format li jista’ jintuża. Il-query tad-database, il-librerija u l-istruttura tal-endpoint huma għażliet tal-implimentazzjoni. Orbthom mar-rekwiżit mingħajr ma tittratta kull għażla attwali bħala ħtieġa permanenti tan-negozju.
Irreġistra deċiżjoni b’konsegwenzi importanti flimkien mal-kuntest, l-alternattivi u r-raġuni tagħha. Pereżempju, esportazzjoni sinkrona tista’ tkun adattata għal volumi żgħar. Volum akbar jista’ jeħtieġ job fl-isfond u kontroll separat tal-awtorizzazzjoni għat-tniżżil.
Żomm ir-rekwiżit stabbli fejn possibbli filwaqt li żżomm verżjonijiet tad-deċiżjoni mibdula. Dan jgħin lil min jirrevedi x-xogħol jiddistingwi implimentazzjoni differenti minn wegħda differenti lill-utenti.
Oħloq katina qasira ta’ evidenza
Uża identifikaturi li jibqgħu jinftiehmu fir-reviżjonijiet. F’dan l-eżempju, EXPORT-01 jista’ jidentifika l-konfini tal-organizzazzjoni. L-isem huwa illustrattiv, mhux sistema obbligatorja ta’ numerazzjoni.
| Konnessjoni | Eżempju |
|---|---|
| Rekwiżit | EXPORT-01: rekords fl-organizzazzjoni tal-maniġer biss |
| Deċiżjoni tad-disinn | Infurza s-sħubija fuq is-server, mhux fil-browser |
| Implimentazzjoni | PR tbiddel il-query u r-rotta tal-awtorizzazzjoni |
| Verifika | Talba għal rekords ta’ organizzazzjoni oħra tiġi miċħuda |
| Evidenza tar-rilaxx | Ir-riżultat tal-kontroll jidentifika l-commit u l-artifact aċċettati |
Il-katina trid tindika evidenza reali. Isem ta’ test li fih l-ID tar-rekwiżit ma jipprovax li l-kundizzjoni tat-test tiċċekkja dak ir-rekwiżit. Spezzjona t-test u r-rotta tal-produzzjoni li jittestja.
L-SSDF tan-NIST jipprovdi kuntest għar-rekwiżiti u l-verifika fi żvilupp sigur. Uża t-traċċabbiltà biex dawn l-attivitajiet ikunu jistgħu jiġu spezzjonati, minflok tipproduċi dokumentazzjoni biss għall-fini tagħha stess. Aqra l-qafas.
Irrevedi l-impatt ta’ suppożizzjoni mibdula
Supponi li n-negozju issa jeħtieġ klijenti arkivjati. Dik il-bidla taffettwa aktar minn flag fil-query. Iċċekkja r-regoli taż-żamma, l-awtorizzazzjoni, il-volum mistenni, l-ispjegazzjonijiet lill-utenti u t-tifsira tar-rapporti eżistenti.
Immarka d-dokumenti u l-kontrolli affettwati għal reviżjoni. Żomm id-deċiżjoni preċedenti biex operatur ikun jista’ jispjega rilaxx eqdem. Tiktebx mill-ġdid l-istorja mingħajr ma tgħid biex l-aħħar disinn jidher inevitabbli.
Aġent jista’ jgħin isib referenzi u jipproponi aġġornamenti. Il-persuni responsabbli jridu jsolvu rekwiżiti li ma jaqblux u jaċċettaw l-imġiba mibdula. Lista ta’ fajls li jaqblu hija punt minn fejn tibda, mhux valutazzjoni sħiħa tal-impatt.
Żomm ir-rekord żgħir biżżejjed biex jintuża
Irreġistra d-deċiżjonijiet li jaffettwaw l-implimentazzjoni, il-verifika u l-operazzjoni. Evita li tirrepeti l-istess rekwiżit f’ħafna dokumenti mhux konnessi. Ippreferi links għal sors wieħed li jinżamm aġġornat.
Qabel taċċetta bidla, staqsi jekk il-persuna li tirrevedi x-xogħol tistax issegwi l-għan tagħha sal-evidenza reali. Qabel tħaddimha, staqsi jekk il-persuna responsabbli għas-servizz tistax issib il-konfini u d-deċiżjoni tal-irkupru rilevanti. Dawn huma testijiet prattiċi ta’ traċċabbiltà utli.
Agħmel l-eżerċizzju
Ikteb rekwiżit biex maniġer jesporta d-data tal-klijenti attivi. Inkludi l-utenti permessi, il-konfini tal-organizzazzjoni, il-fields, l-imġiba f'każ ta' ħsara u kundizzjoni li tista' titkejjel għat-tlestija. Orbtu ma' test u rilaxx fittizji. Imbagħad ibdel ir-rekwiżit biex jinkludi klijenti arkivjati u elenka d-deċiżjonijiet affettwati.
Niżżel il-folja tax-xogħol (Markdown)Jekk tneħħi din l-għażla, tħassar il-progress kollu ssejvjat f'dan il-browser.
Il-progress jibqa' f'dan il-browser. Ebda kont, ebda traċċar.
Sorsi u qari ieħor
- NIST: Secure Software Development Framework ↗
- Google Engineering Practices: What to look for in a code review ↗