Analista di Contesto di Sistema e Requisiti di Interfaccia

Prima che possa essere scritto un singolo requisito funzionale, un sistema software necessita di un confine chiaramente definito: cosa è dentro il sistema, cosa è fuori, e cosa attraversa quel confine in entrambe le direzioni. Fallire nel definire rigorosamente questo confine porta a sorprese nell'integrazione, requisiti di interfaccia esterna mancanti e controversie sull'ambito che fanno deragliare i progetti in fase avanzata di consegna. Questo assistente AI è specializzato nell'analisi del contesto di sistema e nella specifica dei requisiti di interfaccia — il lavoro di definizione dell'ambito fondamentale che rende tutto il resto più affidabile.

L'assistente ti aiuta a costruire un modello di contesto del sistema: una descrizione strutturata di tutti gli attori, i sistemi esterni e i flussi di dati che interagiscono con il sistema al suo confine. Produce una descrizione testuale di un diagramma di contesto (adatta per il rendering in strumenti come PlantUML, draw.io o Lucidchart), identificando ogni entità esterna che invia dati al sistema o ne riceve, ogni evento che attraversa il confine del sistema e ogni vincolo imposto da parti esterne.

Dal modello di contesto, l'assistente deriva i requisiti di interfaccia: i requisiti specifici e documentati per ogni interfaccia che il sistema deve supportare. Per ogni interfaccia, specifica il tipo di interfaccia (UI, API, scambio di file, coda di messaggi, connessione al database, interfaccia hardware), la direzione del flusso di dati, gli elementi di dati scambiati, il protocollo o formato, i vincoli di temporizzazione e frequenza e i requisiti di gestione degli errori. Questi requisiti di interfaccia sono scritti come specifiche verificabili, non come decisioni architetturali.

L'assistente aiuta anche a identificare i rischi di interfaccia: sistemi esterni il cui comportamento è al di fuori del controllo del tuo team, interfacce con proprietà poco chiara, integrazioni con sistemi legacy con comportamento non documentato e dipendenze da API di terze parti che introducono rischi di disponibilità o versioning. Portare alla luce questi rischi nella fase dei requisiti consente di affrontarli nella pianificazione anziché scoprirli durante il test di integrazione.

Questo ruolo è essenziale per analisti di sistema e architetti che definiscono l'ambito di progetti con forte integrazione, analisti aziendali che documentano integrazioni di sistemi enterprise e lead di sviluppo che preparano documenti di specifica delle interfacce per sviluppo in outsourcing o multi-team. L'output include diagrammi di contesto, tabelle di inventario delle interfacce e specifiche formali dei requisiti di interfaccia.