Rejestr decyzji inżynierskich: dlaczego wybraliśmy to rozwiązanie?

Dlaczego dane odświeżano w nocy

Zespół zbudował aplikację raportową z nocnym importem danych, bo odbiorcy potrzebowali raportu rano, a system źródłowy udostępniał plik po zakończeniu dnia. Częstsze pobieranie rozważano, ale przy tych założeniach nie było potrzebne. Po pewnym czasie pojawia się prośba, żeby raport wspierał pracę w ciągu dnia.

Nowy programista widzi nocne zadanie i może uznać, że wystarczy uruchamiać je częściej. W zapisie decyzji znajdzie powód wyboru i ograniczenie źródła danych, więc zespół omawia właściwą zmianę: odbiorcy potrzebują świeższych danych, ale trzeba ustalić, czy źródło potrafi je dostarczyć. Inżynier dopisuje, które założenie przestało odpowiadać pracy użytkowników. Nowa decyzja wskazuje poprzednią i wyjaśnia powód zmiany.

Ile to kosztuje i kiedy się zwraca

Rachunek liczy pracę wokół sprawy: szukanie, czytanie, pisanie i przekazywanie. Zostaje czas na sprawdzenie wyniku, w scenariuszu 25% dzisiejszej pracy. Przed wyceną mierzymy oba czasy na 20 do 100 sprawach, które zespół już obsłużył, w teście za 0 zł trwającym 5 dni roboczych.

Przy zmianie narzędzia potrzebne są uzasadnienia wraz z odnośnikami do projektów, materiałów i późniejszych decyzji, więc eksport musi zachować te powiązania.

Kiedy wystarczy dokument w wiki

AWS opisuje Architectural Decision Records jako sposób zachowania decyzji o architekturze wraz z kontekstem i konsekwencjami, a gdy założenia się zmieniają, nowy zapis zastępuje wcześniejszy. Jeśli zespół ma kilka decyzji w jednym projekcie, wystarczy wspólny szablon i odnośnik z zadania. Obecna wiki albo tracker może zapewniać wyszukiwanie, etykiety i połączenia między stronami. Rozszerzenie przydaje się, gdy zapisy są dobre, ale trudno połączyć je z pracą w kilku repozytoriach. Zapis decyzji pomaga też przy pracy z asystentem kodowania, na przykład Codexem, a człowiek ocenia, czy dawne założenia nadal obowiązują.

Od czego zacząć

Pierwszy zakres obejmuje jeden zespół i przejście od zmienianego elementu do jego uzasadnienia. Na rozmowę przynieś decyzję, której uzasadnienie trzeba było ostatnio odtwarzać, i opis, gdzie zespół jej szukał. Takie wdrożenie budujemy w ramach aplikacji AI. Na bezpłatną analizę wystarczy opis jednej sprawy z ostatnich tygodni i narzędzi, w których się toczyła. Nie trzeba przesyłać poufnych dokumentów, a plan na piśmie dostajesz w 2 dni robocze.