Sniðmát ákvörðunarskrár frá arc42

https://arc42.org/overview

1. Inngangur og markmið

Stutt lýsing á kröfunum, drifkröftum og útdráttur (eða samantekt) krafna. Þrjú (í mesta lagi fimm) gæðamarkmið arkitektúrsins sem hafa hæsta forgang hjá helstu hagsmunaaðilum. Tafla yfir mikilvæga hagsmunaaðila með væntingum þeirra til arkitektúrsins.

1.1 Yfirlit yfir kröfur

Innihald

Stutt lýsing á virkum kröfum, drifkröftum og útdráttur (eða samantekt) krafna. Tenglar á (vonandi fyrirliggjandi) kröfuskjöl, með upplýsingum um hvar þau er að finna.

Hvatning

Frá sjónarhóli notenda er kerfi búið til eða breytt til að bæta stuðning við viðskiptastarfsemi og/eða bæta gæði.

Form

Stutt textalýsing, líklega á töfluformi notkunartilvika. Ef kröfuskjöl eru til ætti þetta yfirlit að vísa í þau.

Hafðu þessa útdrætti eins stutta og mögulegt er. Finndu jafnvægi milli læsileika þessa skjals og hugsanlegrar tvítekningar miðað við kröfuskjölin.

1.2 Gæðamarkmið

Innihald

Þrjú (í mesta lagi fimm) helstu gæðamarkmið arkitektúrsins sem skipta mestu máli fyrir helstu hagsmunaaðila að séu uppfyllt. Við eigum í raun við gæðamarkmið fyrir arkitektúrinn. Ekki rugla þeim saman við markmið verkefnisins. Þau eru ekki endilega þau sömu. ISO 25010 staðallinn gefur gott yfirlit yfir möguleg áhugaefni.

Hvatning

Þú ættir að þekkja gæðamarkmið mikilvægustu hagsmunaaðilanna, því þau munu hafa áhrif á grundvallararkitektúrákvarðanir. Vertu mjög nákvæm(ur) um þessi gæði og forðastu tískuorð. Ef þú veist ekki sem arkitekt hvernig gæði vinnu þinnar verða metin …

Form

Tafla með mikilvægustu gæðamarkmiðunum og áþreifanlegum sviðsmyndum, raðað eftir forgangi.

1.3 Hagsmunaaðilar

Innihald

Skýrt yfirlit yfir hagsmunaaðila kerfisins, það er alla einstaklinga, hlutverk eða stofnanir sem

• ættu að þekkja arkitektúrinn

• þarf að sannfæra um arkitektúrinn

• þurfa að vinna með arkitektúrinn eða kóðann

• þurfa skjölun arkitektúrsins fyrir vinnu sína

• þurfa að taka ákvarðanir um kerfið eða þróun þess

Hvatning

Þú ættir að þekkja alla aðila sem koma að þróun kerfisins eða verða fyrir áhrifum af því. Annars gætirðu fengið óþægilegar óvæntar uppákomur síðar í þróunarferlinu. Þessir hagsmunaaðilar ákvarða umfang og smáatriðastig vinnu þinnar og niðurstaðna hennar.

Form

Tafla með heitum hlutverka, nöfnum einstaklinga og væntingum þeirra til arkitektúrsins og skjölunar hans.

2. Takmarkanir

Allt sem takmarkar teymi við hönnunar- og útfærsluákvarðanir eða ákvarðanir um tengd ferli. Geta stundum náð út fyrir einstök kerfi og gilda fyrir heilar stofnanir og fyrirtæki.

Innihald

Hver sú krafa sem takmarkar frelsi hugbúnaðararkitekta til hönnunar- og útfærsluákvarðana eða ákvarðana um þróunarferlið. Þessar takmarkanir ná stundum út fyrir einstök kerfi og gilda fyrir heilar stofnanir og fyrirtæki.

Hvatning

Arkitektar ættu að vita nákvæmlega hvar þeir hafa frelsi í hönnunarákvörðunum og hvar þeir verða að fylgja takmörkunum. Alltaf verður að taka á takmörkunum; þær geta þó verið samningsatriði.

Form

Einfaldar töflur yfir takmarkanir með skýringum. Ef þörf krefur geturðu skipt þeim í tæknilegar takmarkanir, skipulagslegar og pólitískar takmarkanir og venjur (t.d. leiðbeiningar um forritun eða útgáfustýringu, skjölunar- eða nafngiftavenjur)

3. Samhengi og umfang

Afmarkar kerfið þitt frá (ytri) samskiptaaðilum þess (nágrannakerfum og notendum). Tilgreinir ytri viðmót. Sýnt frá sjónarhorni viðskipta/sviðs (alltaf) eða tæknilegu sjónarhorni (valfrjálst)

Innihald

Umfang og samhengi kerfisins - eins og nafnið gefur til kynna - afmarkar kerfið þitt (það er umfang þitt) frá öllum samskiptaaðilum þess (nágrannakerfum og notendum, það er samhengi kerfisins). Það tilgreinir þannig ytri viðmótin.

Ef nauðsyn krefur skaltu greina viðskiptasamhengið (sviðssértæk inntök og úttök) frá tæknilega samhenginu (rásir, samskiptareglur, vélbúnaður).

Hvatning

Sviðsviðmótin og tæknilegu viðmótin við samskiptaaðila eru meðal mikilvægustu þátta kerfisins þíns. Gakktu úr skugga um að þú skiljir þau til fulls.

Form

• Ýmsar samhengismyndir

• Listar yfir samskiptaaðila og viðmót þeirra.

3.1 Viðskiptasamhengi

Innihald

Lýsing á öllum samskiptaaðilum (notendum, upplýsingatæknikerfum, …) með skýringum á sviðssértækum inntökum og úttökum eða viðmótum. Valfrjálst geturðu bætt við sviðssértækum sniðum eða samskiptareglum.

Hvatning

Allir hagsmunaaðilar ættu að skilja hvaða gögn eru skiptast á við umhverfi kerfisins.

Form

Alls konar skýringarmyndir sem sýna kerfið sem svartan kassa og tilgreina sviðsviðmótin við samskiptaaðila.

Að öðrum kosti (eða til viðbótar) geturðu notað töflu. Titill töflunnar er heiti kerfisins þíns, dálkarnir þrír innihalda heiti samskiptaaðilans, inntökin og úttökin.

3.2 Tæknilegt samhengi

Innihald

Tæknileg viðmót (rásir og flutningsmiðlar) sem tengja kerfið þitt við umhverfi þess. Auk þess varpa sviðssértækra inntaka/úttaka á rásirnar, það er skýring á því hvaða I/O notar hvaða rás.

Hvatning

Margir hagsmunaaðilar taka arkitektúrákvarðanir byggðar á tæknilegum viðmótum milli kerfisins og samhengis þess. Sérstaklega ákveða hönnuðir innviða eða vélbúnaðar þessi tæknilegu viðmót.

Form

T.d. UML-uppsetningarmynd sem lýsir rásum til nágrannakerfa, ásamt varpatöflu sem sýnir tengsl rása og inntaks/úttaks.

4. Lausnarstefna

Samantekt á grundvallarákvörðunum og lausnarstefnum sem móta arkitektúrinn. Getur falið í sér tækni, efsta stigs skiptingu, aðferðir til að ná helstu gæðamarkmiðum og viðeigandi skipulagsákvarðanir.

Innihald

Stutt samantekt og útskýring á grundvallarákvörðunum og lausnarstefnum sem móta arkitektúr kerfisins. Þar á meðal eru

• tækniákvarðanir

• ákvarðanir um efsta stigs skiptingu kerfisins, t.d. notkun arkitektúrmynsturs eða hönnunarmynsturs

• ákvarðanir um hvernig á að ná lykilgæðamarkmiðum

• viðeigandi skipulagsákvarðanir, t.d. val á þróunarferli eða að fela þriðju aðilum tiltekin verkefni.

Hvatning

Þessar ákvarðanir mynda hornsteina arkitektúrsins. Þær eru grunnur margra annarra ítarlegra ákvarðana eða útfærslureglna.

Form

Hafðu útskýringu þessara lykilákvarðana stutta.

Rökstyddu hvað þú ákvaðst og hvers vegna þú ákvaðst á þennan hátt, byggt á vandamálslýsingu þinni, gæðamarkmiðum og lykiltakmörkunum. Vísaðu í smáatriði í eftirfarandi köflum (kafli 5 fyrir uppbyggingarsmáatriði, kafli 8 fyrir þverlæg hugtök).

Þú gætir notað lista yfir lausnarnálganir eða töflu.

5. Sýn á byggingareiningar

Kyrrstæð skipting kerfisins, óhlutbundnar útgáfur af frumkóða, sýnd sem stigveldi hvítra kassa (sem innihalda svarta kassa), upp að viðeigandi smáatriðastigi.

Innihald

Sýn á byggingareiningar sýnir kyrrstæða skiptingu kerfisins í byggingareiningar (einingar, íhluti, undirkerfi, flokka, viðmót, pakka, söfn, ramma, lög, hluta, þrep, föll, fjölva, aðgerðir, gagnagerðir, …) ásamt ávirkni þeirra (tengslum, fylgni, …)

Þessi sýn er skyldubundin fyrir alla arkitektúrskjölun. Í líkingu við hús er þetta grunnteikningin.

Hvatning

Haltu yfirsýn yfir frumkóðann þinn með því að gera uppbyggingu hans skiljanlega með óhlutgervingu.

Þetta gerir þér kleift að eiga samskipti við hagsmunaaðila þína á óhlutbundnu stigi án þess að afhjúpa útfærsluatriði.

Form

Sýn á byggingareiningar er stigskipt safn svartra kassa og hvítra kassa (sjá mynd hér að neðan) og lýsingar á þeim.

5.1 Hvítur kassi: heildarkerfið

Hér lýsirðu skiptingu heildarkerfisins með eftirfarandi sniðmáti fyrir hvítan kassa. Það inniheldur

• yfirlitsmynd

• hvatningu fyrir skiptingunni

• lýsingar á svörtum kössum fyrir byggingareiningarnar sem eru innifaldar. Fyrir þetta bjóðum við þér valkosti:

  • notaðu eina töflu fyrir stutt og hagnýtt yfirlit yfir allar innifaldar byggingareiningar og viðmót þeirra

  • notaðu lista yfir lýsingar á svörtum kössum byggingareininganna samkvæmt sniðmátinu fyrir svartan kassa (sjá hér að neðan). Eftir því hvaða verkfæri þú velur gæti þessi listi verið undirkaflar (í textaskrám), undirsíður (í wiki) eða hreiðraðir þættir (í líkanaverkfæri).

  • (valfrjálst:) mikilvæg viðmót sem eru ekki útskýrð í sniðmátum fyrir svarta kassa byggingareiningar en eru mjög mikilvæg til að skilja hvíta kassann.

Þar sem svo margar leiðir eru til að tilgreina viðmót bjóðum við ekki sérstakt sniðmát fyrir þau.

Í besta falli kemstu af með dæmi eða einfaldar undirskriftir.

5.2 Stig 2

Hér geturðu tilgreint innri uppbyggingu (sumra) byggingareininga af stigi 1 sem hvítra kassa.

Þú þarft að ákveða hvaða byggingareiningar kerfisins eru nógu mikilvægar til að réttlæta svo ítarlega lýsingu. Vinsamlegast kjóstu mikilvægi fram yfir tæmandi umfjöllun. Tilgreindu mikilvægar, óvæntar, áhættusamar, flóknar eða breytilegar byggingareiningar. Slepptu venjulegum, einföldum, leiðinlegum eða stöðluðum hlutum kerfisins

5.2.1 Hvítur kassi fyrir byggingareiningu 1

Tilgreinir innri uppbyggingu byggingareiningar 1.

Notaðu sniðmátið fyrir hvítan kassa (sjá hér að ofan).

6. Sýn á keyrslu

Hegðun byggingareininga sem sviðsmyndir, sem ná yfir mikilvæg notkunartilvik eða eiginleika, samskipti við mikilvæg ytri viðmót, rekstur og stjórnun auk villu- og undantekningahegðunar.

Innihald

Sýn á keyrslu lýsir áþreifanlegri hegðun og samskiptum byggingareininga kerfisins í formi sviðsmynda af eftirfarandi sviðum:

• mikilvæg notkunartilvik eða eiginleikar: hvernig framkvæma byggingareiningar þau?

• samskipti við mikilvæg ytri viðmót: hvernig vinna byggingareiningar með notendum og nágrannakerfum?

• rekstur og stjórnun: ræsing, gangsetning, stöðvun

• villu- og undantekningasviðsmyndir

Athugasemd: Aðalviðmiðið við val á mögulegum sviðsmyndum (runum, vinnuflæði) er arkitektúrlegt mikilvægi þeirra. Ekki er mikilvægt að lýsa mörgum sviðsmyndum. Þú ættir frekar að skjalfesta dæmigert úrval.

Hvatning

Þú ættir að skilja hvernig (tilvik af) byggingareiningum kerfisins vinna starf sitt og eiga samskipti við keyrslu. Þú munt aðallega fanga sviðsmyndir í skjölun þinni til að miðla arkitektúrnum til hagsmunaaðila sem eru síður tilbúnir eða færir um að lesa og skilja kyrrstæðu líkönin (sýn á byggingareiningar, sýn á uppsetningu).

Form

Margar framsetningar eru til við að lýsa sviðsmyndum, t.d.

• númeraður listi yfir skref (á náttúrulegu máli)

• virknimyndir eða flæðirit

• runumyndir

• BPMN eða EPC (atburðaferlakeðjur)

• stöðuvélar

• o.s.frv.

6.n Keyrslusviðsmynd n (1, 2, 3, o.s.frv.)

Settu inn keyrslumynd eða textalýsingu á sviðsmyndinni.

Settu inn lýsingu á athyglisverðum þáttum samskipta milli tilvika byggingareininga sem sýnd eru á þessari mynd.

7. Sýn á uppsetningu

Tæknilegir innviðir með umhverfum, tölvum, örgjörvum og netuppbyggingu. Varpa (hugbúnaðar)byggingareininga á þætti innviða.

Innihald

Sýn á uppsetningu lýsir:

• tæknilegu innviðunum sem notaðir eru til að keyra kerfið þitt, með innviðaþáttum eins og landfræðilegum staðsetningum, umhverfum, tölvum, örgjörvum, rásum og netuppbyggingu auk annarra innviðaþátta og

• vörpun (hugbúnaðar)byggingareininga á þessa innviðaþætti.

Oft eru kerfi keyrð í mismunandi umhverfum, t.d. þróunarumhverfi, prófunarumhverfi, framleiðsluumhverfi. Í slíkum tilvikum ættirðu að skjalfesta öll viðeigandi umhverfi.

Skjalfestu sérstaklega sýn á uppsetningu þegar hugbúnaðurinn þinn er keyrður sem dreift kerfi með fleiri en einni tölvu, örgjörva, þjóni eða gámi, eða þegar þú hannar og smíðar eigin vélbúnaðarörgjörva og kubba.

Frá sjónarhóli hugbúnaðar nægir að fanga þá þætti innviða sem þarf til að sýna uppsetningu byggingareininganna þinna. Vélbúnaðararkitektar geta farið lengra og lýst innviðunum á hvaða smáatriðastigi sem þeir þurfa.

Hvatning

Hugbúnaður keyrir ekki án vélbúnaðar. Þessir undirliggjandi innviðir geta og munu hafa áhrif á kerfið þitt og/eða sum þverlæg hugtök. Þess vegna þarftu að þekkja innviðina.

Form

Kannski er efsta stigs uppsetningarmyndin þegar að finna í kafla 3.2 sem tæknilegt samhengi með þínum eigin innviðum sem EINUM svörtum kassa. Í þessum kafla stækkarðu þennan svarta kassa með frekari uppsetningarmyndum.

• UML býður upp á uppsetningarmyndir til að tjá þessa sýn. Notaðu þær, líklega með hreiðruðum myndum, þegar innviðir þínir eru flóknari.

• Þegar (vélbúnaðar)hagsmunaaðilar þínir kjósa aðrar tegundir mynda frekar en UML-uppsetningarmynd, leyfðu þeim að nota hvaða tegund sem getur sýnt hnúta og rásir innviðanna.

7.1 Innviðir stig 1

Lýstu (venjulega með samsetningu mynda, taflna og texta):

• dreifingu kerfisins þíns á marga staði, umhverfi, tölvur, örgjörva, .. auk líkamlegra tenginga á milli þeirra

• mikilvægum rökstuðningi eða hvatningu fyrir þessari uppsetningarbyggingu

• gæða- og/eða afkastaeiginleikum innviðanna

• vörpun hugbúnaðarafurða (byggingareininga) á þætti innviðanna

Fyrir mörg umhverfi eða valkvæmar uppsetningar skaltu afrita þann kafla arc42 fyrir öll viðeigandi umhverfi. **

7.2 Innviðir stig 2

Hér geturðu tekið með innri uppbyggingu (sumra) innviðaþátta af innviðastigi 1.

Vinsamlegast afritaðu uppbygginguna frá stigi 1 fyrir hvern valinn þátt.

8. Þverlæg hugtök

Heildarreglur og lausnarnálganir sem skipta máli í mörgum hlutum (→ þverlægt) kerfisins. Hugtök tengjast oft mörgum byggingareiningum. Taktu með ólík efni eins og sviðslíkön, arkitektúrmynstur og -stíla, reglur um notkun tiltekinnar tækni og útfærslureglur.

Innihald

Þessi kafli lýsir þverlægum hugtökum (starfsvenjum, mynstrum, reglum eða lausnarhugmyndum). Slík hugtök tengjast oft mörgum byggingareiningum. Þau geta náð yfir mörg ólík efni.

Hvatning

Hugtök mynda grunn að hugtakasamræmi (samkvæmni, einsleitni) arkitektúrsins. Þau eru því mikilvægt framlag til að ná innri gæðum kerfisins þíns.

Þetta er staðurinn í sniðmátinu sem við ætluðum fyrir samræmda lýsingu á slíkum hugtökum.

Mörg þessara hugtaka tengjast eða hafa áhrif á nokkrar byggingareiningar þínar.

Form

Formið getur verið breytilegt:

• hugtakagreinar með hvaða uppbyggingu sem er

• dæmi um útfærslur, einkum fyrir tæknileg hugtök

• þverlægir útdrættir úr líkönum eða sviðsmyndir með framsetningum arkitektúrsýna

Uppbygging þessa kafla

Veldu aðeins þau efni sem mest þörf er á fyrir kerfið þitt og gefðu hverju stig-2 fyrirsögn í þessum kafla (t.d. 8.1, 8.2 o.s.frv.).

• REYNDU EKKI að ná yfir öll efni fyrrnefndrar myndar.

Bakgrunnur

Sum efni innan kerfa varða oft margar byggingareiningar, vélbúnaðarþætti eða þróunarferli. Gæti verið auðveldara að miðla eða skjalfesta slík þverlæg efni á einum miðlægum stað, í stað þess að endurtaka þau í lýsingu viðkomandi byggingareininga, vélbúnaðarþátta eða þróunarferla.

Ákveðin hugtök gætu varðað alla þætti kerfis, önnur gætu aðeins skipt máli fyrir fáa.

9. Arkitektúrákvarðanir

Mikilvægar, dýrar, afdrifaríkar, umfangsmiklar eða áhættusamar arkitektúrákvarðanir ásamt rökstuðningi.

Innihald

Mikilvægar, dýrar, umfangsmiklar eða áhættusamar arkitektúrákvarðanir ásamt rökstuðningi. Með „ákvörðunum“ eigum við við að velja einn valkost út frá gefnum viðmiðum.

Notaðu dómgreind þína til að ákveða hvort skjalfesta eigi arkitektúrákvörðun hér í þessum miðlæga kafla eða hvort betra sé að skjalfesta hana staðbundið (t.d. innan sniðmáts hvíta kassans fyrir eina byggingareiningu). Forðastu tvítekna texta. Vísaðu í kafla 4, þar sem þú festir þegar á blað mikilvægustu ákvarðanir arkitektúrsins þíns.

Hvatning

Hagsmunaaðilar kerfisins þíns ættu að geta skilið og rakið ákvarðanir þínar.

Form

• ADR (arkitektúrákvörðunarskrá) fyrir hverja mikilvæga ákvörðun

• listi eða tafla, raðað eftir mikilvægi og afleiðingum eða

• ítarlegra í formi sérstakra kafla fyrir hverja ákvörðun

Bakgrunnur (um ADR)

Minni skjölunarbútar eru auðveldari að lesa, búa til og viðhalda. Þegar kemur að arkitektúrákvörðunum munu þróunarteymi oft:

• vita af ákvörðuninni, þar sem hún er sýnileg t.d. í frumkóða, en

• missa af hvatningunni að baki þeirri ákvörðun (sjá Nygard 2011)

Þess vegna ættirðu að skjalfesta nokkrar mikilvægar ákvarðanir ásamt hvatningu þeirra og rökum

Tillaga okkar varðandi ákvarðanir

Haltu safn arkitektúrlega mikilvægra ákvarðana, þeirra ákvarðana sem hafa áhrif á uppbyggingu, gæðaeiginleika, mikilvæga (einkum ytri) ávirkni og viðmót, eða smíðatækni (þökk sé Michael Nygard fyrir þessa tillögu).

10. Gæðakröfur

Gæðakröfur sem sviðsmyndir, með gæðatré til að veita yfirsýn á háu stigi. Mikilvægustu gæðamarkmiðin ættu að hafa verið lýst í kafla 1.2. (gæðamarkmið).

Innihald

Þessi kafli inniheldur allar viðeigandi gæðakröfur.

Mikilvægustu þessara krafna hafa þegar verið lýst í kafla 1.2. (gæðamarkmið), svo aðeins ætti að vísa í þær hér. Í þessum kafla 10 ættirðu einnig að fanga gæðakröfur af minna mikilvægi, sem skapa ekki mikla áhættu ef þær nást ekki til fulls (en gætu verið æskilegar).

Hvatning

Þar sem gæðakröfur munu hafa mikil áhrif á arkitektúrákvarðanir ættirðu að vita hvaða gæði eru raunverulega mikilvæg fyrir hagsmunaaðila þína, á sértækan og mælanlegan hátt.

Frekari upplýsingar

Sjá hið umfangsmikla Q42 gæðalíkan á https://quality.arc42.org.

10.1 Yfirlit yfir gæðakröfur

Innihald

Yfirlit eða samantekt gæðakrafna.

Hvatning

Oft rekumst við á tugi (eða jafnvel hundruð) ítarlegra gæðakrafna. Í þessum yfirlitskafla ættirðu að reyna að draga saman, t.d. með því að lýsa flokkum eða efnum (eins og ISO 25010:2023 eða Q42 leggja til

Ef þessar samantektarlýsingar eru þegar nákvæmar, nógu sértækar og mælanlegar geturðu sleppt kafla 10.2.

Form

Notaðu einfalda töflu þar sem hver lína inniheldur flokk eða efni og stutta lýsingu á gæðakröfunni. Að öðrum kosti geturðu notað hugarkort til að skipuleggja þessar gæðakröfur.

Í fræðiritum hefur einnig verið lýst hugmyndinni um gæðaeiginleikatré, sem setur almenna hugtakið „gæði“ sem rót og notar trélíka útfærslu hugtaksins „gæði“. [Bass+21] kynnti hugtakið „Quality Attribute Utility Tree“ í þessum tilgangi.

10.2 Gæðasviðsmyndir

Innihald

Gæðasviðsmyndir gera gæðakröfur áþreifanlegar og gera kleift að ákveða hvort þær séu uppfylltar (í merkingu samþykkisviðmiða). Gakktu úr skugga um að sviðsmyndir þínar séu sértækar og mælanlegar.

Tvær tegundir sviðsmynda eru sérstaklega gagnlegar:

• Notkunarsviðsmyndir (einnig kallaðar forritasviðsmyndir eða sviðsmyndir notkunartilvika) lýsa keyrsluviðbrögðum kerfisins við tiltekinni örvun. Þetta felur einnig í sér sviðsmyndir sem lýsa skilvirkni eða afköstum kerfisins. Dæmi: Kerfið bregst við beiðni notanda innan einnar sekúndu.

• Breytingasviðsmyndir lýsa æskilegum áhrifum breytingar eða viðbótar við kerfið eða nánasta umhverfi þess. Dæmi: Viðbótarvirkni er útfærð eða kröfur um gæðaeiginleika breytast, og fyrirhöfn eða tími breytingarinnar er mældur.

Form

Dæmigerðar upplýsingar fyrir ítarlegar sviðsmyndir eru eftirfarandi:

Í stuttu formi (æskilegt í Q42 líkaninu):

• Samhengi/Bakgrunnur: Hvers konar kerfi eða íhlutur, hvert er umhverfið eða aðstæður?

• Uppspretta/Örvun: Hver eða hvað hefur eða kveikir hegðun, viðbrögð eða aðgerð.

• Mælikvarði/Samþykkisviðmið: Viðbrögð sem fela í sér mælingu eða mælikvarða

Langa formið (æskilegt hjá SEI og [Bass+21]) er ítarlegra og inniheldur eftirfarandi upplýsingar:

• Auðkenni sviðsmyndar: Einkvæmt auðkenni sviðsmyndarinnar.

• Heiti sviðsmyndar: Stutt, lýsandi heiti sviðsmyndarinnar.

• Uppspretta: Einingin (notandi, kerfi eða atburður) sem kveikir sviðsmyndina.

• Örvun: Kveikjuatburðurinn eða aðstæðurnar sem kerfið verður að bregðast við.

• Umhverfi: Rekstrarsamhengið eða aðstæðurnar sem kerfið upplifir örvunina við.

• Afurð: Byggingareiningarnar eða aðrir þættir kerfisins sem örvunin hefur áhrif á.

• Viðbrögð: Útkoman eða hegðunin sem kerfið sýnir sem viðbrögð við örvuninni.

• Mæling viðbragða: Viðmiðin eða mælikvarðinn sem viðbrögð kerfisins eru metin eftir.

Sjá einnig

Frá janúar 2023 býður arc42 upp á hagnýtt gæðalíkan sem leggur til að merkja gæðakröfur með myllumerkjum eða merkjum eins og #flexible, #efficient, #usable, #operable, #testable, #secure, #safe, #reliable.

11. Áhætta og tæknileg skuld

Þekkt tæknileg áhætta eða tæknileg skuld. Hvaða hugsanleg vandamál eru innan eða í kringum kerfið? Hvað er þróunarteymið óánægt með?

Innihald

Listi yfir greinda tæknilega áhættu eða tæknilega skuld, raðað eftir forgangi

Hvatning

„Áhættustýring er verkefnastjórnun fyrir fullorðna“ (Tim Lister, Atlantic Systems Guild.)

Þetta ætti að vera einkunnarorð þín fyrir kerfisbundna uppgötvun og mat á áhættu og tæknilegri skuld í arkitektúrnum, sem stjórnendur sem hagsmunaaðilar (t.d. verkefnastjórar, vörueigendur) munu þurfa sem hluta af heildaráhættugreiningu og áætlanagerð um ráðstafanir.

Form

Listi yfir áhættu og/eða tæknilega skuld, líklega með tillögum að ráðstöfunum til að lágmarka, milda eða forðast áhættu eða minnka tæknilega skuld.