Architecture Decision Record

Active theme: Light

← Erabaki-erregistroen txantiloiak

Jeff Tyree eta Art Akermanen erabaki-erregistroaren txantiloia

Hau da "Architecture Decisions: Demystifying Architecture" by Jeff Tyree and Art Akerman, Capital One Financial artikuluan argitaratutako arkitektura-erabakien deskribapen-txantiloia.

  • Arazoa (Issue): Deskribatu jorratzen ari zaren arkitektura-diseinuko arazoa, zergatik jorratzen ari zaren arazo hori orain inolako galderarik utzi gabe. Ikuspegi minimalista jarraituz, bizi-zikloko puntu desberdinetan jorratu beharreko arazoak soilik jorratu eta dokumentatu.

  • Erabakia (Decision): Adierazi argi arkitekturaren norabidea, hau da, hautatu duzun jarrera.

  • Egoera (Status): Erabakiaren egoera, adibidez zain, erabakia edo onartua.

  • Taldea (Group): Taldekatze sinple bat erabil dezakezu —adibidez integrazioa, aurkezpena, datuak eta abar— erabaki-multzoa antolatzen laguntzeko. Arkitektura-ontologia sofistikatuago bat ere erabil dezakezu, esaterako John Kyaruzi eta Jan van Katwijk-ena, gertaera, egutegia eta kokapena bezalako kategoria abstraktuagoak dituena. Adibidez, ontologia hau erabiliz, sistemak informazioa behar duen gertaerei dagozkien erabakiak gertaera kategoriaren azpian taldekatuko zenituzke.

  • Hipotesiak (Assumptions): Deskribatu argi erabakia hartzen ari zaren ingurunearen azpiko hipotesiak —kostua, egutegia, teknologia eta abar—. Kontuan izan ingurunearen murriztapenek (hala nola onartutako teknologia-estandarrek, enpresa-arkitekturak, ohiko ereduek eta abar) aztertzen dituzun alternatibak mugatu ditzaketela.

  • Murriztapenak (Constraints): Jaso aukeratutako alternatibak (erabakiak) ingurunean ezar ditzakeen murriztapen gehigarriak.

  • Jarrerak (Positions): Zerrendatu aztertu dituzun jarrerak (aukera bideragarriak edo alternatibak). Askotan azalpen luzeak behar dituzte, batzuetan baita ereduak eta diagramak ere. Hau ez da zerrenda exhaustiboa. Hala ere, ez duzu nahi azken berrikuspenean "Pentsatu al duzu...?" galdera entzutea; horrek sinesgarritasuna galtzea eta beste arkitektura-erabaki batzuk zalantzan jartzea dakar. Atal honek, gainera, besteen iritziak entzun dituzula ziurtatzen laguntzen du; beste iritziak esplizituki adierazteak haien defendatzaileak zure erabakian sartzen laguntzen du.

  • Arrazoibidea (Argument): Azaldu zergatik aukeratu duzun jarrera bat, besteak beste ezarpen-kostua, jabetza-kostu osoa, merkaturatzeko denbora eta beharrezko garapen-baliabideen eskuragarritasuna bezalako gaiak barne. Hau, ziurrenik, erabakia bera bezain garrantzitsua da.

  • Ondorioak (Implications): Erabaki batek ondorio asko ditu, REMAP metaereduak adierazten duen bezala. Adibidez, erabaki batek beste erabaki batzuk hartzeko beharra sor dezake, eskakizun berriak sortu edo lehendik daudenak aldatu; ingurunean murriztapen gehigarriak ezarri; bezeroekin irismena edo egutegia berriro negoziatzea eskatu; edo langileen prestakuntza gehigarria behar izan. Zure erabakiaren ondorioak argi ulertzeak eta adierazteak oso eraginkorra izan daiteke adostasuna lortzeko eta arkitekturaren exekuziorako ibilbide-orria sortzeko.

  • Lotutako erabakiak (Related decisions): Agerikoa da erabaki asko lotuta daudela; hemen zerrenda ditzakezu. Hala ere, praktikan ikusi dugu trazabilitate-matrize bat, erabaki-zuhaitzak edo metaereduak baliagarriagoak direla. Metaereduak baliagarriak dira erlazio konplexuak diagrama bidez erakusteko (esaterako Rose ereduak).

  • Lotutako eskakizunak (Related requirements): Erabakiak negozioak gidatuak izan behar dira. Erantzukizuna erakusteko, esleitu zure erabakiak helburuei edo eskakizunei esplizituki. Lotutako eskakizun horiek hemen zerrenda ditzakezu, baina erosoagoa dela ikusi dugu trazabilitate-matrize bati erreferentzia egitea. Arkitektura-erabaki bakoitzak eskakizun bakoitza betetzeko duen ekarpena ebalua dezakezu, eta, ondoren, eskakizuna erabaki guztien artean zein ondo betetzen den. Erabaki batek eskakizun bat betetzen laguntzen ez badu, ez hartu erabaki hori.

  • Lotutako artefaktuak (Related artifacts): Zerrendatu erabaki honek eragiten dien arkitektura-, diseinu- edo irismen-dokumentuak.

  • Lotutako printzipioak (Related principles): Enpresak adostutako printzipio multzo bat badu, ziurtatu erabakia horietako batekin edo gehiagorekin koherentea dela. Horrek domeinuen edo sistemen arteko lerrokatzea ziurtatzen laguntzen du.

  • Oharrak (Notes): Erabakitze-prozesuak aste batzuk iraun ditzakeenez, baliagarria iruditu zaigu sozializazio-prozesuan taldeak eztabaidatzen dituen oharrak eta arazoak jasotzea.