Jak zbudować katalog interfejsów między systemami?

Question

IT Interview Practice · Accepted Answer

Zbuduj **katalog interfejsów** jako utrzymywaną ewidencję kontraktów między systemami oraz ich właścicieli. Łączy diagram architektury ze szczegółami potrzebnymi do implementacji, obsługi incydentów i planowania zmian.

## Zacznij od przepływów biznesowych

Przejdź przez rzeczywisty proces, na przykład realizację zamówienia, i wypisz każde wywołanie API, zdarzenie, transfer pliku i zaplanowaną wymianę danych. Uwzględnij mniej widoczne ścieżki, jak eksporty uzgodnieniowe i ręczne importy naprawcze.

Dla każdego interfejsu zapisz:

- Stabilny identyfikator, cel biznesowy, producenta, odbiorców i odpowiedzialne osoby kontaktowe.
- Kierunek, transport, endpoint lub lokalizację pliku oraz link do wersjonowanego schematu.
- Odpowiedzialność za dane, identyfikatory, klasyfikację i mechanizm dostępu, bez przechowywania poświadczeń.
- Wymagania czasowe lub harmonogram, oczekiwany wolumen, limity payloadu i uzgodnione oczekiwania usługowe.
- Reguły timeoutów, ponowień, duplikatów, kolejności i obsługi błędów, gdzie mają zastosowanie.
- Monitorowanie, eskalację, politykę zgodności i zależności przy wycofywaniu.

## Przykładowy wpis

Interfejs IF-07 wysyła potwierdzenia wysyłki z magazynu do platformy zamówień co 15 minut. Magazyn odpowiada za strumień, platforma za przyjmowanie danych. Kontrakt określa identyfikator wysyłki, wersję schematu, liczbę rekordów i plik potwierdzenia. Brak potwierdzeń eskaluje się do wskazanego zespołu wsparcia.

To bardziej użyteczne niż strzałka „integracja”: pozwala ustalić, czy opóźniona aktualizacja wynika z awarii transportu, odrzuconych danych czy pominiętej zaplanowanej operacji.

## Utrzymuj wiarygodność katalogu

Linkuj schematy i instrukcje operacyjne zamiast kopiować ich treść. Aktualizuj katalog po zmianach interfejsu i okresowo porównuj z obserwowanym ruchem oraz zadaniami harmonogramu. Statyczna ewidencja szybko pomija nieoficjalne połączenia.

## Pułapka na rozmowie

Sama lista endpointów nie opisuje kontraktu. Mocna odpowiedź obejmuje znaczenie biznesowe, odpowiedzialność i zachowanie podczas awarii, dobierając poziom szczegółowości możliwy do utrzymania.

Zacznij od przepływów biznesowych

Przykładowy wpis

Utrzymuj wiarygodność katalogu

Pułapka na rozmowie

Powiązane pytania