Architecture Decision Record

Active theme: Light

← Sniðmát ákvörðunarskráa

{Titill þinn hér}

!!! info

**Staða**: { Lögð fram | Í rýni | Samþykkt |  Hafnað | Leyst af hólmi | Úrelt }

**Uppfært**: {YYYY-MM-DD}

Samantekt

{Þetta er „stjórnendasamantektin“ eða „lyftukynningin“ fyrir ADR. Í fáum hnitmiðuðum setningum (yfirleitt 2-4) skaltu setja skýrt fram kjarnavandamálið, spurninguna eða tækifærið sem þessi ADR tekur á. Láttu fylgja stuttan vísi að ákvörðuninni sem var tekin eða að áherslusviðinu. Markmiðið er að hjálpa lesendum að skilja fljótt um hvað þessi ADR snýst og ákveða hvort hún skipti þá máli, án þess að þurfa að lesa allt skjalið. Hugsaðu um þetta sem útdrátt úr tæknigrein eða mjög stutta inngang að aðalefninu.}

Drifkraftar

{Þessi kafli útskýrir hvers vegna þessi ákvörðun er tekin núna. Settu skýrt fram helstu hvata, þarfir eða vandamál sem knýja fram þessa arkitektúrákvörðun. Hugsaðu um undirliggjandi ástæður og þrýsting.}

  • {t.d. Við erum að þróa nýjan eiginleika/getu sem þarf…}

  • {t.d. Við þurfum að bæta afköst, aðgengi, minnka tæknilega skuld…}

  • {t.d. Endurgjöf frá notendum bendir til…}

  • {t.d. Núverandi nálgun setur þessar takmarkanir…}

Valkostir

{Hér skráirðu mismunandi valkosti sem þú ert að íhuga. Haltu þig við staðreyndir og forðastu skoðanir, næsti kafli fjallar um greininguna. Láttu fylgja hnitmiðaða lýsingu og tengla á viðeigandi skjölun eða dæmi.

Taktu með alla mikilvæga valkosti sem þú skoðaðir, jafnvel þótt þeir hafi á endanum ekki verið valdir. Markmiðið er að gefa lesendum skýran, hlutlausan skilning á hverjum valkosti áður en þú kafar í matið.}

{Titill valkosts 1}

{Lýstu valkostinum, gefðu samantekt, skráðu staðreyndir, gefðu tengla o.s.frv.}

{Titill valkosts n}

...

Greining valkosta

{Hér metur þú á gagnrýninn hátt hvern valkost sem settur var fram í kaflanum Valkostir. Fyrir hvern valkost skaltu veita jafnvægi í mynd af kostum hans, göllum og öðrum viðeigandi sjónarmiðum eða málamiðlunum. Vertu nákvæm(ur) og, þar sem hægt er, tengdu atriði þín aftur við Drifkrafta.

Íhugaðu þætti eins og:

  • Kostnað (þróun, rekstur, leyfi)

  • Flækjustig (útfærsla, viðhald, námsferill)

  • Áhættu (tæknileg, rekstrarleg, öryggi)

  • Samræmi við arkitektúrmeginreglur eða fyrirliggjandi staðla

  • Áhrif á afköst, stigstærð, nothæfi, viðhaldshæfni, öryggi o.s.frv.

Taktu með eins margar yfirlýsingar um kosti/galla/annað og þörf krefur. }

{Mat á valkosti 1}

  • Kostur: {Tiltekinn kostur eða ávinningur þessa valkosts.}

  • Galli: {Tiltekinn ókostur, áhætta eða kostnaður sem fylgir þessum valkosti.}

  • Annað: {Viðeigandi atriði sem er ekki beinlínis kostur eða galli.}

{Mat á valkosti n}

...

Meðmæli

{Hér setur þú skýrt fram lokaákvörðunina og nefnir berum orðum þann valkost sem var valinn. Útskýrðu í smáatriðum hvers vegna þessi valkostur var valinn. Þú ættir að orða skýrt hvernig valinn valkostur tekur best á Drifkröftunum og uppfyllir lykilkröfur eða leysir tilgreinda vandamálið.}

Afleiðingar

{Þessi kafli er valfrjáls.}

{Nú þegar ákvörðun hefur verið tekin, hverjar eru væntar niðurstöður og áhrif, bæði jákvæð og neikvæð? Hvaða þekktu takmarkanir, kostnað eða áhættu er verið að sætta sig við með því að taka þessa ákvörðun? Hvernig mun þessi ákvörðun hafa áhrif á ólíka hagsmunaaðila, önnur kerfi, þróunarvenjur, verklag í rekstri eða notendaupplifun?}

  • Kostur: {Tiltekin jákvæð niðurstaða eða ávinningur sem búist er við af þessari ákvörðun.}

  • Galli: {Tiltekinn ókostur, kostnaður eða áhætta sem sætt er við vegna þessarar ákvörðunar. }

  • Annað: {Afleiðing sem er ekki beinlínis kostur eða galli.}

Staðfesting

{Þessi kafli er valfrjáls.}

{Lýstu hvernig útfærsla þessarar ákvörðunar verður sannreynd og hvernig stöðugt samræmi verður tryggt. Þetta hjálpar til við að sýna fram á að ákvörðunin sé ekki aðeins fræðileg heldur verði framkvæmd og vöktuð af virkni.

Hvernig munt þú athuga að ákvörðunin hafi verið rétt útfærð? (t.d. kóðarýni, sérstök próf, sýnikennsla, jafningjarýni).

Hvernig verður fylgni við þessa ákvörðun viðhaldið yfir tíma? (t.d. sjálfvirkar athuganir, reglubundnar úttektir, uppfærslur á leiðbeiningum teymis, þjálfun).

Eru sérstakir mælikvarðar eða vísar sem sýna að ákvörðunin nái ætluðum jákvæðum útkomum? (t.d. afkastaviðmið, upptökuhlutfall, fækkun tiltekinna villna, endurgjafareinkunnir notenda).

Hver ber ábyrgð á að hafa eftirlit með þessu og hvað gerist ef ákvörðuninni er ekki fylgt?}

Frekari upplýsingar

{Þessi kafli er valfrjáls.}

{Notaðu þennan kafla til að veita hverjar viðbótarupplýsingar sem styðja ákvörðunina, bæta við samhengi eða leiðbeina framtíðaraðgerðum. Tenglar á aðrar ákvarðanir og úrræði gætu einnig birst hér.

Þú gætir stuttlega nefnt hverjir tóku þátt í ákvarðanatökunni og hvort/hvernig samstaða náðist. Þú gætir einnig viljað leggja til tímaramma eða tiltekna atburði sem gætu kallað á endurmat þessarar ákvörðunar í framtíðinni.}