Schemi¶
Gli schemi vivono dentro il repo, in due formati aperti:
- Mermaid (file
.md): GitHub li disegna da solo, si modificano come testo e lo storico git mostra ogni cambiamento. Li uso per gli schemi di processo. - Excalidraw (file
.excalidraw): per gli schemi "fatti a mano", come il foglietto. Si aprono su excalidraw.com (File → Apri) o con l'estensione Excalidraw di VS Code. Sono generati dascripts/genera_excalidraw.py: si modifica lo script e si rigenera.
GitHub non mostra l'anteprima dei file .excalidraw, quindi accanto a ogni sorgente c'è il suo export .svg, generato da scripts/esporta_excalidraw_svg.js. Il flusso è: modifico lo script Python (o il file su excalidraw.com) → rigenero l'SVG → commit.
Nota: nell'export il carattere "a mano" di Excalidraw può essere sostituito da un carattere standard, se il visualizzatore non lo carica.
| Schema | Formato | Modulo |
|---|---|---|
| Le 6 caselle del machine learning | Mermaid | M03 |
| Il foglietto (SVG) | Excalidraw | M03 |
| Anatomia della chatbot | Mermaid | M05 |
| L'app intorno al modello | Mermaid | M07 |
| Chatbot vs agente | Mermaid | M10 |