Diagrammi di validazione

Questi diagrammi sono fixture mantenibili. Provano la configurazione Mermaid, la validazione sintattica e la resa responsiva senza diventare documentazione operativa completa.

Flusso di pubblicazione della documentazione

flowchart LR
  A[Markdown italiano] --> B[Validazione repository]
  B --> C[MkDocs build --strict]
  C --> D[Output statico site]

Sequenza di validazione

sequenceDiagram
  autonumber
  actor Autore
  participant Repository
  participant CI
  Autore->>Repository: Propone Markdown e diagrammi
  Repository->>CI: Avvia la validazione
  CI->>CI: Controlla link, navigazione e Mermaid
  CI-->>Autore: Restituisce esito e difetti

Stato di una modifica documentale

stateDiagram-v2
  [*] --> Bozza
  Bozza --> Validata: controlli superati
  Validata --> InRevisione: Draft PR
  InRevisione --> Bozza: modifiche richieste
  InRevisione --> Integrata: merge di Fra
  Integrata --> [*]

Architettura e flusso dei dati

flowchart LR
  subgraph Autorita["Sorgenti autorevoli"]
    GH[GitHub Issues e Project]
    Repo[Repository]
    D1[(D1)]
  end
  subgraph Proiezione["Proiezione documentale"]
    MkDocs[MkDocs e Material]
    Browser[Portale statico]
  end
  Repo -->|Markdown stabile| MkDocs
  MkDocs --> Browser
  GH -. evidenza operativa, non copiata .-> Repo
  D1 -. stato runtime, non copiato .-> Repo