Architecture Decision Record

Active theme: Light

← Šablony záznamů rozhodnutí

{Zde uveďte název}

!!! info

**Stav**: { Navrhované | V revizi | Přijaté |  Zamítnuté | Nahrazené | Zastaralé }

**Aktualizováno**: {RRRR-MM-DD}

Shrnutí

{Toto je „manažerské shrnutí“ neboli „elevator pitch“ vašeho ADR. V několika stručných větách (obvykle 2–4) jasně uveďte základní problém, otázku nebo příležitost, kterou toto ADR řeší. Přidejte krátkou nápovědu k učiněnému rozhodnutí nebo k oblasti zaměření. Cílem je pomoci čtenářům rychle pochopit, o čem toto ADR je, a rozhodnout, zda je pro ně relevantní, aniž by museli číst celý dokument. Představte si to jako abstrakt odborné práce nebo velmi stručný úvod do hlavního tématu.}

Faktory

{Tato sekce vysvětluje, proč se toto rozhodnutí činí nyní. Jasně formulujte hlavní motivace, potřeby nebo problémy, které toto architektonické rozhodnutí vyžadují. Přemýšlejte o základních důvodech a tlacích.}

  • {např. Vyvíjíme novou funkci/schopnost, která potřebuje...}

  • {např. Musíme zlepšit výkon, přístupnost, odstranit dluh...}

  • {např. Zpětná vazba uživatelů naznačuje, že...}

  • {např. Současný přístup ukládá tato omezení...}

Možnosti

{Zde uvádíte různé možnosti, které zvažujete. Držte se faktů a vyhněte se názorům, analýzu pokrývá další sekce. Uveďte stručný popis, odkazy na relevantní dokumentaci nebo příklady.

Zahrňte všechny významné alternativy, které jste prozkoumali, i když nakonec nebyly zvoleny. Cílem je poskytnout čtenářům jasné, nestranné pochopení každé alternativy, než se ponoříte do hodnocení.}

{Název možnosti 1}

{Popište možnost, uveďte shrnutí, vyjmenujte fakta, uveďte odkazy atd.}

{Název možnosti n}

...

Analýza možností

{Zde kriticky hodnotíte každou možnost uvedenou v sekci Možnosti. U každé možnosti poskytněte vyvážený pohled na její výhody, nevýhody a další relevantní úvahy nebo kompromisy. Buďte konkrétní a pokud možno své body vztahujte zpět k Faktorům.

Zvažte aspekty jako:

  • Náklady (vývoj, provoz, licencování)

  • Složitost (implementace, údržba, křivka učení)

  • Rizika (technická, provozní, bezpečnostní)

  • Soulad s architektonickými principy nebo stávajícími standardy

  • Dopad na výkon, škálovatelnost, použitelnost, udržovatelnost, bezpečnost atd.

Uveďte tolik tvrzení Výhoda/Nevýhoda/Jiné, kolik je potřeba. }

{Hodnocení možnosti 1}

  • Výhoda: {Konkrétní výhoda nebo přínos této možnosti.}

  • Nevýhoda: {Konkrétní nevýhoda, riziko nebo náklad spojený s touto možností.}

  • Jiné: {Relevantní bod, který není striktně výhodou ani nevýhodou.}

{Hodnocení možnosti n}

...

Doporučení

{Zde jasně uvádíte konečné rozhodnutí a výslovně pojmenujete zvolenou možnost. Podrobně vysvětlete, proč byla tato možnost zvolena. Měli byste jasně formulovat, jak zvolená možnost nejlépe řeší Faktory a splňuje klíčové požadavky nebo řeší uvedený problém.}

Důsledky

{Tato sekce je volitelná.}

{Nyní, když bylo rozhodnutí učiněno, jaké jsou očekávané výsledky a dopady, pozitivní i negativní? Jaká známá omezení, náklady nebo rizika jsou přijímána učiněním tohoto rozhodnutí? Jak toto rozhodnutí ovlivní různé zainteresované strany, jiné systémy, vývojové postupy, provozní postupy nebo uživatelský zážitek?}

  • Výhoda: {Konkrétní pozitivní výsledek nebo přínos očekávaný z tohoto rozhodnutí.}

  • Nevýhoda: {Konkrétní přijatá nevýhoda, náklad nebo riziko vyplývající z tohoto rozhodnutí. }

  • Jiné: {Důsledek, který není striktně výhodou ani nevýhodou.}

Potvrzení

{Tato sekce je volitelná.}

{Nastiňte, jak bude ověřena implementace tohoto rozhodnutí a jak bude zajištěn trvalý soulad. Pomáhá to prokázat, že rozhodnutí není jen teoretické, ale bude aktivně uváděno do praxe a sledováno.

Jak ověříte, že bylo rozhodnutí správně implementováno? (např. revize kódu, specifické testy, demonstrace, vzájemná revize).

Jak bude dodržování tohoto rozhodnutí udržováno v čase? (např. automatizované kontroly, pravidelné audity, aktualizace pokynů týmu, školení).

Existují konkrétní metriky nebo ukazatele, které ukážou, že rozhodnutí dosahuje zamýšlených pozitivních výsledků? (např. výkonnostní benchmarky, míra přijetí, snížení specifických chyb, skóre zpětné vazby uživatelů).

Kdo je za dohled odpovědný a co se stane, pokud se rozhodnutí nedodržuje?}

Další informace

{Tato sekce je volitelná.}

{Použijte tuto sekci k poskytnutí doplňujících informací, které rozhodnutí podporují, přidávají kontext nebo vedou budoucí kroky. Mohou se zde objevit i odkazy na další rozhodnutí a zdroje.

Můžete stručně uvést, kdo se na rozhodovacím procesu podílel a zda/jak bylo dosaženo konsensu. Můžete také navrhnout časový rámec nebo konkrétní události, které by mohly v budoucnu vyvolat přehodnocení tohoto rozhodnutí.}