# JE1 - A cosa serve

# JE1.1 - Disegnare invece di programmare

**In una frase.** ADEnext è il motore con cui una funzione del gestionale si disegna a schermo, pezzo per pezzo, invece di scriverla come programma.

Una funzione del gestionale è quasi sempre fatta delle stesse cose: dei dati da leggere, una maschera dove scrivere i filtri, una tabella con i risultati, qualche regola. Scriverle ogni volta a mano vuol dire giorni di lavoro di un programmatore, e altri giorni a ogni modifica.

Con ADEnext quei pezzi si disegnano. Scegli i campi da un elenco, trascini, colleghi, salvi. Il disegno resta scritto in un archivio, e la pagina che l'utente apre lo rilegge ogni volta: se cambi il disegno, cambia la pagina.

<div drawio-diagram="2679"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/i-pezzi-del-motore-dal-catalogo-dei-dati-alla-pagina-che-lutente-apre.png" alt="I pezzi del motore: dal catalogo dei dati alla pagina che l&#039;utente apre"/></div>

*I pezzi del motore: dal catalogo dei dati alla pagina che l'utente apre*

Qui sotto un esempio vero, la ricerca dei comuni. Prima il disegno: quattro nodi collegati. Poi la pagina che ne esce, con i filtri sopra e la tabella sotto.

![Il disegno: all'apertura e a ogni ricerca, l'endpoint legge i comuni e li passa alla tabella](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-disegno-allapertura-e-a-ogni-ricerca-lendpoint-legge-i-comuni-e-li-passa-alla-tabella.png)

*Il disegno: all'apertura e a ogni ricerca, l'endpoint legge i comuni e li passa alla tabella*

![La pagina che ne esce: scrivi la provincia, premi Cerca, la tabella mostra i 45 comuni trovati](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-pagina-che-ne-esce-scrivi-la-provincia-premi-cerca-la-tabella-mostra-i-45-comuni-trovati.png)

*La pagina che ne esce: scrivi la provincia, premi Cerca, la tabella mostra i 45 comuni trovati*

<p class="callout success">**Cosa ci guadagni.**  
• **Una funzione nuova si disegna, non si programma.** Una ricerca con filtri, tabella e azioni nasce in sei passi guidati. Nessuno scrive codice, nessuno ricompila.  
• **Resta modificabile.** Aggiungere una colonna, cambiare un controllo, spostare un campo: riapri il disegno, cambi, salvi. Ogni salvataggio che cambia qualcosa lascia una versione, e si può tornare indietro.  
• **Le regole si scrivono una volta.** Form, tabelle, endpoint e flussi leggono lo stesso catalogo dei dati. Un controllo scritto sul form vale a schermo e vale anche sul server, con lo stesso messaggio. </p>

Questo libro segue l'ordine in cui i pezzi si incastrano: i dati, i form, le tabelle, gli endpoint, i flussi, le viste. Come il disegno diventa pagina è in [Dove sta nella mappa](https://gsdoc.genesyssoftware.eu/link/37824).

<p class="callout info">**Nota.** L'analisi dei dati con numeri e grafici ha il suo libro: JF - Analytics. Le stampe in PDF anche: JK - GPEnext.</p>

<p class="callout info">**Per chi sviluppa.** Il servizio è `backend/middleware/it_gsba_ade_next`. Nell'app web il motore è `frontend/ade-next/src`, in tre parti: `kernel` (modelli, regole, espressioni), `runtime` (form, tabelle, viste a schermo), `studio` (gli strumenti per disegnare).</p>

# JE1.2 - Cosa si può fare e cosa no

**In una frase.** Cosa ADEnext sa fare bene oggi, cosa fa solo in parte e cosa va ancora scritto a mano.

Prima di disegnare una funzione conviene sapere se il motore ci arriva. C'è un documento che lo dice riga per riga, e viene aggiornato ogni volta che il motore impara una cosa nuova. Questa pagina ne è il riassunto: per decidere davvero si guarda quello.

## Si può, ed è solido

- **Leggere dati**: scegliere i campi, filtrare con «e» e «oppure», ordinare, unire archivi collegati, contare e sommare per gruppi, tenere solo i gruppi che superano una soglia.
- **Form**: una ventina di tipi di campo, griglia a dodici colonne, riquadri, schede e passi, finestre di ricerca per scegliere un valore collegato.
- **Regole**: campi obbligatori, visibili o bloccati a condizione, controlli fra due campi. Valgono a schermo e sul server.
- **Tabelle**: tipi di colonna, colonne calcolate, filtri, gruppi, totali, colori a condizione, azioni di riga, esportazione.
- **Versioni**: form, tabelle, endpoint e flussi tengono la storia dei salvataggi.

## Si può, ma è giovane

- **Flussi**: condizioni, cicli, attese, attività affidate a una persona, avvio a orario. Funzionano e hanno i loro test. Molte parti non sono ancora state usate su dati veri di un cliente.
- **Scritture disegnate**: inserire, modificare e cancellare senza scrivere SQL. Restano spente finché l'installazione non le accende, archivio per archivio.
- **Grafici nelle viste**: cinque tipi (linee, barre, torta, ciambella, area).

## Non si può, per ora

- Domande annidate una dentro l'altra, se non scrivendo l'SQL a mano.
- Più scritture diverse dentro un solo endpoint. Si mettono in fila in un flusso.
- Un contenitore a schede dentro una vista.
- Piccoli programmi scritti a mano dentro una vista per trasformare i dati.
- Generare in un colpo solo il codice di molti archivi.

<p class="callout warning">**Attenzione.** Se la funzione che ti serve cade nel terzo elenco, non si forza il motore: quella parte si programma. Tutto il resto può restare disegnato.</p>

<p class="callout info">**Per chi sviluppa.** Nel documento ogni riga ha uno stato (`SUPPORTATO`, `PARZIALE`, `NO`) e il file che lo prova. Le diciture come «non eseguito su dati veri» vanno prese alla lettera.</p>

<p class="callout info">**Per approfondire.**  
• Capabilities del motore low-code — stato reale al 2026-11-14: `docs/low-code/capabilities.md`</p>

# JE1.3 - Dove sta nella mappa

**In una frase.** ADEnext è uno dei servizi delle Novità: sta dietro il Gateway e tiene i disegni in un archivio suo, le Schermate salvate.

Sapere dove sta aiuta a capire due cose: dove finisce quello che disegni, e perché una pagina disegnata mostra gli stessi dati di ogni altra pagina del gestionale.

<div drawio-diagram="2682"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/la-mappa-di-adswnext-con-accesi-adenext-e-il-suo-archivio-le-schermate-salvate.png" alt="La mappa di ADSWnext con accesi ADEnext e il suo archivio, le Schermate salvate"/></div>

*La mappa di ADSWnext con accesi ADEnext e il suo archivio, le Schermate salvate*

**Chi lo chiama.** Le pagine nuove, ogni volta che aprono una schermata disegnata: chiedono ad ADEnext com'è fatta. Lo chiamano anche gli strumenti per disegnare, quando salvi. La richiesta passa dal Gateway, come tutte.

**Chi chiama lui.** Il suo archivio, **Schermate salvate**: lì stanno i disegni e le loro versioni. E SIGEAnext, quando servono i dati: ADEnext decide cosa chiedere, SIGEAnext legge i Dati aziendali e rimanda le righe.

**Cosa vuol dire per te.** I disegni e i dati dell'azienda stanno in due archivi diversi. Cambiare un disegno non tocca un dato. E una pagina disegnata legge i dati dalla stessa strada delle altre: non ne esiste una copia.

<div drawio-diagram="2683"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/dal-disegno-alla-pagina-chi-disegna-salva-una-volta-la-pagina-rilegge-il-disegno-a-ogni-apertura.png" alt="Dal disegno alla pagina: chi disegna salva una volta, la pagina rilegge il disegno a ogni apertura"/></div>

*Dal disegno alla pagina: chi disegna salva una volta, la pagina rilegge il disegno a ogni apertura*

<p class="callout info">**Nota.** Per usare una pagina disegnata basta il tuo accesso di sempre. Per disegnare serve il livello Utente avanzato. I livelli sono spiegati nel libro JB - Accesso e permessi.</p>

<p class="callout info">**Per chi sviluppa.**  
• Il Gateway manda ad ADEnext le richieste che cominciano per `/api/ade`. Il servizio ascolta sulla porta 5080.  
• L'archivio sul server di prova si chiama ADENEXT2.  
• Le letture e le scritture disegnate le esegue SIGEAnext (`backend/business-logic/it_gsba_sigea_next`). I record che arrivano dal catalogo dell'Assistente dei dati li esegue lui.  
• Una vista pubblicata si apre per nome, all'indirizzo `/ade-next/app/<nome>`. </p>