Passa al contenuto principale

Step 2 — Perimetro

Con i casi d'uso chiari, il passo successivo è mappare esattamente cosa tocca questo sviluppo: quali moduli, quali interfacce, quali dati. Il perimetro definisce i confini del lavoro e identifica i rischi di regressione.

Classificare le modifiche

Ogni elemento coinvolto rientra in una di tre categorie:

Pezzi nuovi — funzionalità, componenti o flussi completamente nuovi. Non esistono precedenti: richiedono progettazione da zero e attenzione particolare alla modellazione, perché gli errori qui non hanno storia da cui imparare.

Modifiche — cambiamenti a comportamenti o componenti esistenti che non alterano le interfacce pubbliche. Chi dipende da questi componenti non se ne accorge. Richiedono comunque analisi delle regressioni potenziali.

Breaking changes — modifiche che rompono la compatibilità con quanto già in uso: cambi di contratto API, rimozione di campi, variazioni nel comportamento atteso. Richiedono coordinamento immediato con i team dipendenti e una strategia di migrazione. Vanno portati all'attenzione di tutti al più presto — non sono necessariamente una cattiva notizia, ma nessuno deve esserne sorpreso. Il versioning renderà il cambiamento ufficiale con un bump MAJOR. Vedi regole/versionamento.

Identificare i sotto-moduli coinvolti

Un'unica feature tocca raramente un solo modulo. In questa fase si mappano tutti i sotto-moduli del sistema che vengono sfiorati dallo sviluppo — anche indirettamente — per capire dove cercare regressioni.

Feature X
├── Modulo Ordini → modifica diretta
├── Modulo Fatturazione → modifica indiretta (dipende da Ordini)
└── Modulo Notifiche → invariato, ma da verificare

Individuare le interfacce software coinvolte

Per ogni modulo identificato, elencare le interfacce che cambiano:

  • endpoint API esposti o consumati
  • eventi pubblicati o sottoscritti
  • job e processi schedulati
  • integrazioni con sistemi esterni

Questo è il momento in cui si scopre se ci sono dipendenze nascoste o contratti impliciti mai documentati.

Criterio di completamento

Il perimetro è definito quando si sa con precisione: cosa è nuovo, cosa cambia, cosa potrebbe rompersi e chi dipende da cosa.


Prossimo step: Step 3 — Modellazione dei Dati