JA3 - Orientarsi

JA3.1 - A che punto siamo

In una frase. Cosa funziona già, cosa è scritto ma va ancora provato dal vivo, cosa manca. Stato al 17 novembre 2026.

Funziona

Visto funzionare.

Da provare dal vivo

Scritto e controllato, non ancora usato sul server vero.

Ancora da fare

Non c'è ancora.

Nota. Questa pagina invecchia in fretta. Quando cambia qualcosa si aggiorna la data in alto e si sposta la voce nel gruppo giusto. Ogni voce è spiegata nel libro del suo componente.

Per chi sviluppa. Lo stato di lavoro giorno per giorno è in docs/STATO.md. Gli avvisi per chi aggiorna il proprio ambiente sono in docs/AVVISI-SVILUPPATORI.md.

JA3.2 - Parole da sapere

In una frase. Le parole che tornano in tutta la raccolta, una riga ciascuna.

Ogni libro chiude con le parole del suo componente.

JA3.3 - Come leggere questa raccolta

In una frase. Come sono fatti i libri di ADSWnext, cosa vogliono dire i codici davanti ai titoli e come si leggono gli schemi.

Libri, capitoli, pagine

Ogni titolo comincia con un codice. Il codice dice il libro, il capitolo e la pagina, e tiene tutto nell'ordine in cui conviene leggere. Se cerchi una pagina di cui ti hanno detto il codice, scrivilo nella ricerca.

Ogni libro ha la stessa forma

  1. Si apre con «A cosa serve»: cosa fa il componente, cosa ci guadagni, dove sta nella mappa.
  2. In mezzo ci sono i capitoli su come si usa, con una schermata vera per ogni passo importante.
  3. Si chiude con «Se qualcosa non va» e con le parole da sapere.

In fondo alle pagine trovi due riquadri. «Per chi sviluppa» ha i dettagli tecnici: se non sei tecnico lo salti. «Per approfondire» dice quale guida più dettagliata esiste su quell'argomento.

Tre tipi di schema

La mappa con il componente acceso. È la mappa a strati con tutto spento tranne il componente del libro. Dice subito dove sei.

Esempio di «dove sta»: Gateway e Monitor servizi accesi sulla mappa

Esempio di «dove sta»: Gateway e Monitor servizi accesi sulla mappa

Chi parla con chi. Gli attori in alto, un passo per riga. Il numero dice l'ordine. La freccia tratteggiata è una risposta che torna indietro.

Esempio di «chi parla con chi»: entro e apro una pagina

Esempio di «chi parla con chi»: entro e apro una pagina

Blocchi e frecce. Per spiegare un meccanismo solo, senza il resto della mappa. Ne trovi uno in In tre frasi.

Nota. Gli schemi sono disegni draw.io. Chi ha il permesso di modificare la pagina li apre con un doppio clic, li cambia e li salva: non serve nessun altro programma.

Per chi sviluppa. La raccolta nasce dal repository, cartella docs/guide/adswnext. Le regole di scrittura sono in docs/guide/adswnext/STILE.md, i passi per pubblicare in docs/guide/adswnext/PUBBLICARE.md. Le guide tecniche di tutti i giorni restano in docs/guide.