Diagram sekwencji (sequence diagram) to diagram UML pokazujący interakcje między obiektami lub systemami w czasie: pionowe linie życia, poziome strzałki komunikatów, kolejność czytana z góry na dół. Najlepsze narzędzie, jakie znam, do dokumentowania integracji i wymiany przez API.
Analityk spotyka go przy projektowaniu i analizie integracji: kto woła kogo, w jakiej kolejności, co wraca w odpowiedzi i co się dzieje, gdy odpowiedź nie przychodzi. Deweloperzy myślą sekwencjami - jeśli umiesz je czytać i rysować, rozmowa o integracji skraca się o połowę.
W MediFlow diagram sekwencji opisał rezerwację wizyty: Portal → API grafików (sprawdź dostępność) → HIS (zablokuj slot) → bramka płatności (utwórz płatność dla wizyty komercyjnej) → silnik powiadomień (SMS). Najcenniejszy okazał się fragment alternatywny: co gdy HIS nie odpowie w 3 sekundy? Bez diagramu nikt tego pytania nie zadał - a stary HIS w MediFlow potrafił mleć zapytanie i 30 sekund w godzinach szczytu. Z tej rozmowy wyszło wymaganie kolejkowania i komunikatu „rezerwacja w trakcie potwierdzania".
Częsta pomyłka: traktowanie diagramu sekwencji jak modelu całego procesu biznesowego. Sekwencja pokazuje jeden scenariusz przebiegu - szczęśliwą ścieżkę albo konkretny wyjątek - a nie wszystkie warianty procesu z decyzjami i rolami. Do tego służy BPMN lub diagram aktywności. Druga: rysowanie sekwencji na poziomie kliknięć użytkownika zamiast komunikatów między systemami; wtedy diagram puchnie i nikt go nie czyta.