TranskribatorTranskribator
Jak vytvořit ADR ze záznamu architektonické diskuse
Zachovejte důvod volby

Jak vytvořit ADR ze záznamu architektonické diskuse

ADR zachycuje jedno významné architektonické rozhodnutí: kontext, varianty, výběr, důsledky a stav. Přepis pomůže dohledat argumenty. Technickou správnost potvrdí účastníci.

Tým Transkribator5 min čtení
ZDROJADRKontext a rozhodující faktoryZvažované variantyVolba a odůvodněníDůsledky a přezkumOD SLOV K VÝSLEDKŮM
Práce se skutečným záznamemNázorný výukový příkladŠablona ke zkopírování
Zachovejte důvod volby

Jak vytvořit Architecture Decision Record ze záznamu diskuse

ADR zachycuje jedno významné architektonické rozhodnutí: kontext, varianty, výběr, důsledky a stav. Přepis pomůže dohledat argumenty. Technickou správnost potvrdí účastníci.

Přepis umožňuje ověřit formulace a zachovává kontext, výhrady i sled argumentů. Konečnou podobu určí autor a nechá ji zkontrolovat účastníky.

Postup

Sestavte ADR krok za krokem

  1. Zvolte jedno rozhodnutí

    Každé samostatné architektonické rozhodnutí zaznamenejte zvlášť.

  2. Popište kontext

    Zapište faktory a omezení, kvůli kterým bylo rozhodnutí potřeba.

  3. Porovnejte varianty

    U každé varianty uchovejte hlavní výhody, nevýhody a důvody zamítnutí.

  4. Uveďte důsledky

    Sepište přínosy, náklady, nová omezení, rizika a podmínku přezkumu.

Rozbor příkladu

Výukový příklad: úložiště zvukových souborů

Následuje smyšlený výukový příklad. Názvy, podmínky a výsledky slouží jen k vysvětlení metody.

Úryvek z výukového záznamu · 12:40
„Objektové úložiště vyjde pro archiv levněji, ale budeme potřebovat samostatný mechanismus dočasných odkazů.“

Kontext: nahrávky jsou velké, přístup má vypršet a vydávání odkazů je potřeba řídit. Volba padla na objektové úložiště. Vedle ceny záleží na škálovatelnosti a modelu přístupu.

Mezi důsledky uveďte práci a rizika: dočasné odkazy, kontrolu platnosti, protokolování a zkoušky selhání. Pokud se změní předpoklad o ceně, nové ADR může nahradit předchozí a zachovat historii.

Kontext a rozhodující faktoryZvažované variantyVolba a odůvodněníDůsledky a přezkum
ADR zachycuje volbu i důvody, které k ní vedly
ČástUžitečný zápisNevhodný příklad
KontextVelké soubory a omezený přístupPotřebujeme nové úložiště
VariantyObjektové / souborové úložištěVybrali jsme to nejlepší
RozhodnutíObjektové z důvodů A a BRozhodl architekt
DůsledkyDočasné odkazy a monitoringŽádné nevýhody
Připravená šablona

Šablona ADR

Zkopírujte šablonu a vyplňte ji podle konkrétní nahrávky. Domněnky označujte jako hypotézy.

Šablona pro vlastní práciOznačte a zkopírujte
Název a stav:
Datum a účastníci:
Kontext a omezení:
Zvažované varianty:
Rozhodnutí a důvody:
Důsledky, rizika a podmínka přezkumu:
Kontrola výsledku

Čtyři kontroly před odesláním

  • Záznam se týká jednoho rozhodnutí.
  • Kontext obsahuje skutečná omezení.
  • Varianty a důvody zamítnutí jsou uvedené.
  • Je uvedena nevýhoda i podmínka přezkumu.
DiskuseZaznamenejte všechny argumentyKontextSepište faktory a variantyRozhodnutíZapište volbu a stavHistorieNové ADR propojte s předchozím
Od nahrávky k ověřitelnému, použitelnému dokumentu
Časté otázky

Podívejme se na podrobnosti

Lze upravit přijaté ADR?

Překlepy lze opravit. Změněné rozhodnutí zapište do nového ADR s odkazem na předchozí.

Musí být přepis uložen vedle ADR?

Odkaz na interní zdroj a časová značka zpravidla stačí k ověření sporné formulace.

Pokračujte v práci s nahrávkou