Cum construiți un catalog al interfețelor dintre sisteme?

Question

IT Interview Practice · Accepted Answer

Construiți un **catalog de interfețe** ca inventar întreținut al contractelor dintre sisteme și al responsabililor lor. Acesta conectează diagrama arhitecturală la detaliile necesare echipelor pentru implementare, răspuns la incidente și planificarea schimbărilor.

## Începeți de la fluxurile de afaceri

Parcurgeți un proces real, precum onorarea comenzilor, și listați fiecare apel API, eveniment, transfer de fișiere și schimb de date programat. Includeți traseele mai puțin vizibile, precum exporturile de reconciliere și importurile manuale de recuperare.

Pentru fiecare interfață, înregistrați:

- Un identificator stabil, scopul de afaceri, producătorul, consumatorii și contactele responsabile.
- Direcția, transportul, endpoint-ul sau locația fișierului și legătura spre schema versionată.
- Responsabilitatea pentru date, identificatorii, clasificarea și mecanismul de acces, fără stocarea acreditărilor.
- Temporizarea sau programul, volumul așteptat, limitele payload-ului și așteptările de serviciu convenite.
- Regulile de timeout, reîncercare, duplicate, ordonare și tratare a erorilor, unde se aplică.
- Monitorizarea, escaladarea, politica de compatibilitate și dependențele dezafectării.

## Exemplu de înregistrare

Interfața IF-07 trimite confirmări de expediere din depozit către o platformă de comenzi la fiecare 15 minute. Depozitul răspunde de flux, iar platforma de comenzi de ingestie. Contractul definește identificatorul expedierii, versiunea schemei, numărul înregistrărilor și fișierul de confirmare. Confirmările lipsă sunt escaladate unei echipe de suport nominalizate.

Este mai util decât o săgeată numită „integrare”: echipa poate identifica dacă întârzierea unei actualizări de expediere este o problemă de transport, date respinse sau o execuție programată ratată.

## Mențineți fiabilitatea catalogului

Legați schemele și runbook-urile, în loc să le duplicați conținutul. Actualizați catalogul când se schimbă interfața și comparați-l periodic cu traficul observat și sarcinile programate. Un inventar static omite rapid conexiunile neoficiale.

## Capcană la interviu

O listă de endpoint-uri nu descrie singură un contract. Un răspuns puternic include semnificația de afaceri, responsabilitatea și comportamentul la eșec, alegând suficiente detalii pentru a rămâne întreținabil.

Începeți de la fluxurile de afaceri

Exemplu de înregistrare

Mențineți fiabilitatea catalogului

Capcană la interviu

Întrebări conexe