Architecture Decision Record

Active theme: Light

← Otsusekirjete mallid

{Sisesta pealkiri siia}

!!! info

**Olek**: { Proposed | Under Review | Accepted |  Rejected | Superseded | Deprecated }

**Uuendatud**: {YYYY-MM-DD}

Kokkuvõte

{See on ADR-i "lühiaruanne" või "liftikõne". Sõnasta mõne täpse lausega (tavaliselt 2-4) selgelt keskne probleem, küsimus või võimalus, mida see ADR käsitleb. Anna lühike vihje tehtud otsuse või fookusvaldkonna kohta. Eesmärk on aidata lugejatel kiiresti aru saada, millest see ADR räägib ja kas see on neile asjakohane, ilma kogu dokumenti lugemata. Mõtle sellest kui tehnilise artikli kokkuvõttest või väga lühikesest sissejuhatusest põhiteemasse.}

Liikumapanevad jõud

{See jaotis selgitab, miks see otsus tehakse praegu. Tee selgeks, millised on peamised motivatsioonid, vajadused või probleemid, mis seda arhitektuuriotsust nõuavad. Mõtle aluseks olevatele põhjustele ja survele.}

  • {Näiteks: arendame uut funktsiooni/võimekust, mis nõuab ...}

  • {Näiteks: peame parandama jõudlust, ligipääsetavust, tegelema võlaga...}

  • {Näiteks: kasutajate tagasiside näitab, et...}

  • {Näiteks: praegune lähenemine seab piiranguid nagu...}

Valikud

{Siin loetled erinevad kaalutavad valikud. Püsi faktides ja väldi arvamusi; analüüs tuleb järgmises jaotises. Lisa lühikesed kirjeldused ja lingid asjakohasele dokumentatsioonile või näidetele.

Lisa kõik olulised uuritud alternatiivid, isegi kui neid lõpuks ei valitud. Eesmärk on anda lugejale selge, erapooletu arusaam igast alternatiivist, enne kui hindamine algab.}

{Valiku 1 pealkiri}

{Kirjelda valikut, anna kokkuvõte, loetle fakte, anna linke jne.}

{Valiku n pealkiri}

...

Valikute analüüs

{Siin hindad kriitiliselt iga jaotises Valikud esitatud valikut. Anna iga valiku kohta tasakaalustatud pilt eelistest, puudustest ja muudest asjakohastest kaalutlustest või kompromissidest. Ole konkreetne ja seo võimalusel Liikumapanevate jõududega.

Kaalu aspekte nagu:

  • Kulu (arendus, käitus, litsentsid)

  • Keerukus (teostus, hooldus, õppimiskõver)

  • Riskid (tehnilised, operatiivsed, turvalisus)

  • Vastavus arhitektuuripõhimõtetele või olemasolevatele standarditele

  • Mõju jõudlusele, skaleeritavusele, kasutatavusele, hooldatavusele, turvalisusele jne

Lisa nii palju plusse/miinuseid/muid väiteid, kui vaja. }

{Valiku 1 hindamine}

  • Pluss: {Selle valiku konkreetne eelis või kasu.}

  • Miinus: {Selle valikuga seotud konkreetne puudus, risk või kulu.}

  • Muu: {Asjakohane punkt, mis ei ole rangelt võttes ei pluss ega miinus.}

{Valiku n hindamine}

...

Soovitus

{Siin esitad selgelt lõpliku otsuse ja nimetad valitud valiku selgesõnaliselt. Selgita üksikasjalikult, miks see valik valiti. Tee selgeks, kuidas valitud valik kõige paremini käsitleb Liikumapanevaid jõude ning täidab põhinõudeid või lahendab kirjeldatud probleemi.}

Tagajärjed

{See jaotis on valikuline.}

{Nüüd, kui otsus on tehtud, millised on oodatavad tulemused ja mõjud, nii positiivsed kui negatiivsed? Milliseid teadaolevaid piiranguid, kulusid või riske selle otsusega aktsepteeritakse? Kuidas see otsus mõjutab erinevaid huvirühmi, teisi süsteeme, arendustavasid, käitusprotseduure või kasutajakogemusi?}

  • Pluss: {Selle otsuse konkreetne oodatav positiivne tulemus või kasu.}

  • Miinus: {Konkreetne puudus, kulu või risk, mida selle otsuse tulemusena aktsepteeritakse. }

  • Muu: {Tagajärg, mis ei ole rangelt võttes ei pluss ega miinus.}

Kinnitamine

{See jaotis on valikuline.}

{Visandage kõrgel tasemel, kuidas selle otsuse teostust kontrollitakse ja kuidas jätkuvat järgimist tagatakse. See aitab näidata, et otsus viiakse praktikasse ja seda jälgitakse ning see pole pelgalt teoreetiline.

Kuidas kinnitada, et otsus on õigesti teostatud? (nt koodiülevaatused, konkreetsed testid, demonstratsioonid, kolleegide ülevaatused).

Kuidas säilitatakse selle otsuse järgimine aja jooksul? (nt automaatsed kontrollid, perioodilised auditid, meeskonna juhiste uuendamine, koolitus).

Kas on konkreetseid mõõdikuid või näitajaid, mis näitavad, et otsus saavutab ettenähtud positiivsed tulemused? (nt jõudluse võrdlusalused, kasutuselevõtu määr, konkreetsete vigade vähenemine, kasutajate tagasiside hinded).

Kes vastutab selle järelevalve eest ja mis juhtub, kui otsust ei järgita?}

Lisateave

{See jaotis on valikuline.}

{Kasuta seda jaotist täiendava teabe andmiseks, mis toetab otsust, lisab konteksti või juhib tulevasi tegevusi. Siin võivad olla ka lingid teistele otsustele või ressurssidele.

Võid lühidalt märkida, kes otsustusprotsessis osales ja kas/kuidas konsensus saavutati. Võid ka soovitada ajavahemikku või konkreetseid sündmusi, mis võivad tulevikus käivitada selle otsuse uuesti hindamise.}