{Tutaj wpisz tytuł}

!!! info

**Status**: { Zaproponowany | W przeglądzie | Zaakceptowany |  Odrzucony | Zastąpiony | Wycofany }

**Zaktualizowano**: {RRRR-MM-DD}

Podsumowanie

{To jest „streszczenie dla kadry zarządzającej” lub „elevator pitch” Twojego ADR. W kilku zwięzłych zdaniach (zwykle 2–4) jasno opisz główny problem, pytanie lub szansę, której dotyczy ten ADR. Dodaj krótką wskazówkę dotyczącą podjętej decyzji lub obszaru zainteresowania. Celem jest, aby czytelnicy szybko zrozumieli, czego dotyczy ten ADR, i zdecydowali, czy jest dla nich istotny, bez czytania całego dokumentu. Potraktuj to jak abstrakt artykułu naukowego lub bardzo krótkie wprowadzenie do głównego tematu.}

Czynniki

{W tej sekcji wyjaśnij, dlaczego ta decyzja jest podejmowana teraz. Jasno przedstaw główne motywacje, potrzeby lub problemy, które wymagają tej decyzji architektonicznej. Pomyśl o przyczynach i naciskach leżących u podstaw.}

• {np. Opracowujemy nową funkcję/możliwość, która wymaga...}

• {np. Musimy poprawić wydajność, dostępność, usunąć dług...}

• {np. Opinie użytkowników sugerują, że...}

• {np. Obecne podejście narzuca te ograniczenia...}

Opcje

{Tutaj wymień różne opcje, które rozważasz. Trzymaj się faktów i unikaj opinii, analizę omawia następna sekcja. Dołącz zwięzły opis oraz odnośniki do odpowiedniej dokumentacji lub przykładów.

Uwzględnij wszystkie istotne alternatywy, które badałeś, nawet jeśli ostatecznie nie zostały wybrane. Celem jest zapewnienie czytelnikom jasnego, bezstronnego zrozumienia każdej alternatywy, zanim przejdziesz do oceny.}

{Tytuł opcji 1}

{Opisz opcję, podaj podsumowanie, wymień fakty, dodaj odnośniki itd.}

{Tytuł opcji n}

...

Analiza opcji

{Tutaj krytycznie oceniasz każdą opcję przedstawioną w sekcji Opcje. Dla każdej opcji przedstaw wyważony obraz jej zalet, wad oraz innych istotnych kwestii lub kompromisów. Bądź konkretny i, gdy to możliwe, odnoś swoje uwagi do Czynników.

Rozważ aspekty takie jak:

• Koszt (rozwój, eksploatacja, licencje)

• Złożoność (wdrożenie, utrzymanie, krzywa uczenia się)

• Ryzyka (techniczne, operacyjne, bezpieczeństwa)

• Zgodność z zasadami architektury lub istniejącymi standardami

• Wpływ na wydajność, skalowalność, użyteczność, utrzymywalność, bezpieczeństwo itd.

Dodaj tyle stwierdzeń Zaleta/Wada/Inne, ile potrzeba. }

{Ocena opcji 1}

• Zaleta: {Konkretna przewaga lub korzyść tej opcji.}

• Wada: {Konkretna wada, ryzyko lub koszt związany z tą opcją.}

• Inne: {Istotna kwestia, która nie jest ściśle zaletą ani wadą.}

{Ocena opcji n}

...

Rekomendacja

{Tutaj jasno przedstaw ostateczną decyzję i wyraźnie wskaż wybraną opcję. Szczegółowo wyjaśnij, dlaczego wybrano tę opcję. Powinieneś jasno wyjaśnić, jak wybrana opcja najlepiej odpowiada na Czynniki i spełnia kluczowe wymagania lub rozwiązuje opisany problem.}

Konsekwencje

{Ta sekcja jest opcjonalna.}

{Skoro decyzja została podjęta, jakie są oczekiwane wyniki i skutki, zarówno pozytywne, jak i negatywne? Jakie znane ograniczenia, koszty lub ryzyka są akceptowane przez podjęcie tej decyzji? Jak ta decyzja wpłynie na różnych interesariuszy, inne systemy, praktyki programistyczne, procedury operacyjne lub doświadczenie użytkowników?}

• Zaleta: {Konkretny pozytywny wynik lub korzyść oczekiwana z tej decyzji.}

• Wada: {Konkretna zaakceptowana wada, koszt lub ryzyko wynikające z tej decyzji. }

• Inne: {Konsekwencja, która nie jest ściśle zaletą ani wadą.}

Potwierdzenie

{Ta sekcja jest opcjonalna.}

{Opisz, jak zostanie zweryfikowane wdrożenie tej decyzji i jak będzie zapewniana bieżąca zgodność. Pomaga to pokazać, że decyzja nie jest tylko teoretyczna, ale będzie aktywnie wprowadzana w życie i monitorowana.

Jak sprawdzisz, że decyzja została prawidłowo wdrożona? (np. przeglądy kodu, konkretne testy, demonstracje, przegląd koleżeński).

Jak przestrzeganie tej decyzji będzie utrzymywane w czasie? (np. automatyczne kontrole, okresowe audyty, aktualizacje wytycznych zespołu, szkolenia).

Czy są konkretne metryki lub wskaźniki, które pokażą, że decyzja osiąga zamierzone pozytywne rezultaty? (np. testy wydajności, wskaźniki przyjęcia, zmniejszenie liczby określonych błędów, oceny użytkowników).

Kto odpowiada za nadzór nad tym i co się dzieje, jeśli decyzja nie jest przestrzegana?}

Więcej informacji

{Ta sekcja jest opcjonalna.}

{Użyj tej sekcji, aby podać dodatkowe informacje, które wspierają decyzję, dodają kontekstu lub kierują przyszłymi działaniami. Mogą tu pojawić się też odnośniki do innych decyzji i zasobów.

Możesz krótko zaznaczyć, kto brał udział w procesie decyzyjnym oraz czy i jak osiągnięto konsensus. Możesz też zasugerować ramy czasowe lub konkretne zdarzenia, które mogą w przyszłości skłonić do ponownej oceny tej decyzji.}