Passa al contenuto principale

Step 1 — Dominio

Il dominio si tocca per primo. Le entity, le migration e i vincoli del database sono la fondamenta su cui poggia tutto il resto — business logic e UI dipendono da questa stabilità.

Cosa fare​

1. Apportare le modifiche al dominio​

Implementare le entity e le configurazioni EF emerse dalla modellazione in analisi tecnica. Seguire le regole descritte in regole/entity-framework e regole/dominio:

  • nomi dall'Ubiquitous Language, senza abbreviazioni né traduzioni
  • constraint e chiavi esterne dichiarati nel modello, non gestiti applicativamente
  • migration con nome descrittivo che racconta la decisione di dominio
  • nessuna rinomina, nessuna rimozione — solo aggiunte e deprecazioni

2. Scrivere il primo test di integrazione​

Appena il dominio è definito, si scrive almeno un test di integrazione che verifichi il funzionamento base. Non deve coprire tutta la business logic — quella viene nel passo successivo — ma deve garantire che il modello sia corretto: che le migration vengano applicate, che i constraint funzionino, che le relazioni siano navigabili.

[Fact]
public async Task CreaOrdine_PersistsCorrectly()
{
    // Arrange: database reale con migration applicate
    await using var context = CreateDbContext();
    var cliente = new Cliente { Nome = "Acme Srl" };
    context.Clienti.Add(cliente);
    await context.SaveChangesAsync();

    // Act
    var ordine = new Ordine { ClienteId = cliente.Id, Numero = "ORD-001" };
    context.Ordini.Add(ordine);
    await context.SaveChangesAsync();

    // Assert
    var saved = await context.Ordini.FindAsync(ordine.Id);
    Assert.NotNull(saved);
    Assert.Equal("ORD-001", saved!.Numero);
}

3. Verificare che i test esistenti non si rompano​

Le modifiche al dominio non devono rompere i test preesistenti. La CI lo verifica automaticamente, ma è buona pratica girare la suite localmente prima di aprire un commit — specialmente se si toccano entità con molte dipendenze.

Quando il dominio è stabile​

Il dominio è stabile quando:

  • le migration sono applicate e i test di dominio passano
  • nessun test preesistente è rotto
  • le breaking changes, se presenti, sono state comunicate

Da questo momento business logic e UI possono procedere in parallelo.

Prossimo step: Step 2 — Business Logic