Diagrammi C4¶

Il progetto documenta l'architettura usando il modello C4 di Simon Brown, con 3 livelli di astrazione.

Livello 1 — Context¶

Vista d'insieme: il sistema e i suoi attori esterni.

C4Context
    title Spring Boot From Scratch — Context

    Person(student, "Studente", "Sviluppatore junior-mid che impara Spring Boot")
    Person(developer, "Dev contributor", "Contribuisce a feature/fix")
    System(sbfs, "Spring Boot From Scratch", "Applicazione di esempio + percorso didattico")
    System_Ext(github, "GitHub", "Hosting repo + Pages")
    System_Ext(maven, "Maven Central", "Dipendenze")

    Rel(student, sbfs, "Clona, esegue, modifica")
    Rel(developer, sbfs, "Apre PR")
    Rel(sbfs, maven, "Scarica dipendenze")
    Rel(student, github, "Legge docs su Pages")

Livello 2 — Container¶

(Disponibile dallo step 03 in poi, quando viene introdotto PostgreSQL.)

Livello 3 — Component¶

(Disponibile dallo step 04, dopo l'introduzione del service layer.)

Sorgente Structurizr DSL¶

I diagrammi sono mantenuti come codice (Structurizr DSL) in docs/c4/workspace.dsl per garantire che restino sincronizzati con la realtà del codice. Il rendering avviene via Structurizr Lite in locale.