Decyzje potrzebuja pamieci
Architektura robi sie droga, kiedy decyzje zostaja w spotkaniach, watkach czatu i prywatnych zalozeniach. ADR trzyma powod, trade-off i konsekwencje blisko wyboru.
Dobry rekord nie zastepuje osadu. Zachowuje tyle kontekstu, zeby przyszly osad byl tanszy.
Praktyczny format
ADR powinien byc krotki: kontekst, decyzja, konsekwencje, odrzucone alternatywy i linki do dowodow. Celem nie jest ceremonia, tylko pamiec zespolu.
Status: zaakceptowane
Kontekst: uslugi wymagaja autoryzacji per tenant
Decyzja: tenant checks w serwisach aplikacyjnych i filtrach bazy
Konsekwencje: prostszy review path, jawne testy, mniej ryzyka wycieku danychRytm przegladu, ktory przezyje delivery
Rekord ma sens tylko wtedy, kiedy ma rytm. Przegladaj go podczas designu, linkuj z pull requestow i otwieraj ponownie po incydentach albo zmianach produktowych.
| Trigger | Akcja | Wlasciciel |
|---|---|---|
| Nowa granica | Utworz ADR | Tech lead |
| Incydent | Sprawdz zalozenia | Service owner |
| Migracja | Oznacz stare decyzje | Grupa architektury |