Dal prompt al sito Yong Gan
Dal prompt al sito Yong Gan
In due giorni (16–17 luglio 2026) è nato un sito per una scuola di arti marziali — con area privata per le presenze — usando Cursor e prompt in italiano, senza un brief tecnico formale.
| Progetto | Yong Gan — sito pubblico + app presenze |
| Stack | Next.js · Tailwind · Neon · Auth.js · Vercel |
| Dominio | artemarzialecinovietnamita.it |
Questo tutorial raccoglie i prompt reali, in ordine.
Metodo di lavoro (riusabile)
- Proposta → OK → sviluppa — consiglio prima del codice
- Vincoli chiari — es. «non è un sito di associazione», «presenze sì ma senza link in menu»
- Allegati reali — Excel Golee, PDF, loghi, screenshot errori
- Locale prima, Vercel dopo — controllare senza pubblicare
- Iterazione visiva — correggere con screenshot, non solo a parole
- «Trova tu le parole» — lasciare all'AI i testi di tono
Fase 1 — App presenze
Obiettivo: registrare le presenze (lun–mer), importare gli atleti da Excel Golee, database Neon.
Prompt 1 — Idea e stack
Voglio realizzare un'app o un sito web per la registrazione di atleti ai corsi che frequentano dal lunedì al mercoledì. Ho la necessità di registrare la presenza. Posso farlo io da un'app oppure far registrare gli atleti tramite telefono. Ambiente Cursor. I dati arriveranno in Excel da Golee. Cosa consigli? Questo è quello che voglio sviluppare, come database useremo Neon. Cosa ne pensi? Riepilogo e aspetta OK per sviluppo.
Cosa è successo: Opzione A (dashboard admin), Next.js + Neon, roadmap senza codice.
Prompt 2 — Via allo sviluppo
OK sviluppa
(+ Excel Golee)
Cosa è successo: app con import, schermata oggi, corsi.
Prompt 3 — Adattamento import
Adattiamo import a questo formato
(+ secondo Excel)
Cosa è successo: parser con data nascita, CF, indirizzo, ecc.
Prompt 4–5 — Auth e ruoli
Come gestiamo il login degli istruttori. Solo admin può importare i dati. Proposta e aspetta OK.
Cosa è successo: Auth.js, ruoli admin/istruttore, account admin.
Prompt 6 — Prima pubblicazione
Prepariamo la pubblicazione su Vercel.
Cosa è successo: deploy live su Vercel.
Prompt 7–8 — Istruttori
Come inserisco gli istruttori?
Crea la pagina per inserirli.
Cosa è successo: pagina gestione utenti.
Prompt 9 — UI
Possiamo migliorarlo graficamente, è un po' troppo funereo.
Cosa è successo: tema chiaro, font nuovi.
Prompt 10 — CRUD allievi
Admin deve avere la possibilità di CRUD sugli allievi: prevediamo la gestione.
Cosa è successo: crea, modifica, disattiva, elimina, corsi.
Prompt 11 — WhatsApp
Nella scheda degli utenti sul cellulare metti la possibilità di inviare WhatsApp.
(+ screenshot)
Cosa è successo: bottone WA su allievi e oggi.
Prompt 12–13 — Dashboard atleta
Adesso dobbiamo fare la dashboard per ogni atleta: devo sapere le presenze e le assenze. Cosa proponi? Aspetta OK.
OK.
Cosa è successo: scheda atleta con totali, storico, filtri.
Prompt 14–15 — Meta e permessi
Fai un riepilogo dei prompt usati per fare un tutorial.
Pensi sia possibile far vedere la dashboard delle presenze anche agli istruttori?
Cosa è successo: primo tutorial + dashboard anche per istruttori.
Fase 2 — Sito pubblico della scuola
Da “tool interno” a sito Yong Gan, con le presenze integrate ma non in evidenza.
Prompt 16 — Struttura e filosofia
Questo è un dominio di arti marziali: puoi pensare a una struttura base dove prevedere Chi siamo, gli stili praticati, le armi e la filosofia della scuola. La parte presenze va tenuta. Non voglio un sito di un'associazione perché siamo già all'interno di un'altra associazione. La parte presenze va solo integrata. Sviluppa solo in locale, non pubblicare su Vercel per adesso. Ti allego qualcosa: Kung Fu, il logo ed altre conversazioni con Gemini. Fammi una proposta di come imposteresti il sito.
(+ testi scuola, logo, conversazione Gemini su «arte analogica»)
Lezione: vincolo forte («non associazione») + locale only = direzione chiara.
Prompt 17–18 — Dati e correzioni
Elenco armi: bastone lungo (Bong), Long Gian, Tham Thiet Gian… Orari: Kung Fu lun e merc 19:30–22:00 Propatria Milano; Tai Chi martedì 19:00–20:30. Contatto: 3351757593 · info@… Per le iscrizioni rivolgersi alla Propatria.
Correggi nelle armi: Tham Thien Gian… Il Long Gian (nunchaku) è un'arma diversa dal Bong.
Prompt 19–23 — Brand e header
Cambia il logo con questo.
Togli il link Presenze: lo lasciamo raggiungibile senza link.
Puoi togliere lo sfondo bianco dal logo…
Sostituisci il logo attuale nell'header…
Puoi aumentare la dimensione del logo nell'header?
Lezione: le presenze restano, ma senza link in menu — raggiungibili solo da chi sa l'URL.
Prompt 24–26 — «Arte Analogica»
[Bozza libro “L'Arte Analogica”] + PDF linee guida. Cosa ne pensi? Riepilogo e aspetta OK per sviluppo.
Quindi per sviluppare usi il PDF più il testo?
OK.
Lezione: dare il senso, lasciare all'AI le parole di tono.
Prompt 27 — Go live sito
OK pubblica su Vercel.
Fase 3 — Deploy, errori, hero
Prompt 28 e 35 — Crash middleware
500: INTERNAL_SERVER_ERROR
Code: MIDDLEWARE_INVOCATION_FAILED
(+ screenshot log Vercel)
Lezione: incolla l'errore intero (e i log). Il debug piattaforma si fa così.
Prompt 29–36 — Copertina e gerarchia
Usa questa immagine al posto dell'immagine centrale.
Si perde la parte sotto la foto, si può migliorare?
Non voglio che l'immagine prenda il sopravvento: forse è meglio che diventi lo sfondo?
Non si vede proprio lo sfondo. (+ screenshot)
Lezione: iterazione visiva con screenshot batte dieci paragrafi.
Fase 4 — Contatti, loghi, favicon
Prompt 37–38 — Contatti
Aggiungi contatti Propatria: Via Beato Angelico 2… Viale Romagna 16… Tel 02 70123080…
Nei Contatti, nella sezione tecnica, specifica che verranno date solo informazioni su ciò che si pratica e non di segreteria. Trova tu le parole.
Prompt 39–41 — Branding finale
Facciamo lo stemma dell'header più grande.
Aggiungiamo sulla destra nell'header il logo Propatria.
Aggiungiamo la favicon.
Cosa è stato ottenuto
Area privata (/presenze, /login, …)
- Login admin / istruttore
- Presenze giornaliere
- Import Excel Golee
- CRUD allievi · gestione utenti
- Dashboard atleta · WhatsApp
Sito pubblico
- Home, Chi siamo, Filosofia, Sintesi, Metodo, Stili, Armi, Pratica, Contatti
- Tone «arte analogica» (no marketing da associazione)
- Contatti Yong Gan (pratica) + Propatria (iscrizioni)
- Header: stemma Yong Gan + logo Propatria · favicon
Infrastruttura
- Neon · Auth.js · Vercel · dominio custom
Lezioni per chi replica
| Fai così | Perché |
|---|---|
| Scrivi in linguaggio naturale, anche con refusi | Conta la chiarezza del vincolo |
| Chiedi «proposta e aspetta OK» | Eviti direzioni sbagliate |
| Allega Excel, PDF, loghi, screenshot | Meglio di 10 paragrafi |
| Pubblica quando sei pronto | Meno rumore, più controllo |
| Incolla errori di piattaforma interi | Debug Vercel/middleware |
| Separa «cosa voglio» da «come scriverlo» | Es. «trova tu le parole» |
Flusso in sintesi
App presenze (Excel → auth → deploy)
→ Sito scuola (locale, vincolo «non associazione»)
→ Brand + testi analogici
→ Pubblica Vercel
→ Fix errori + hero + contatti + loghi
Yong Gan esiste perché i prompt erano chiari sui vincoli, ricchi di allegati, e disciplinati con aspetta OK.
Vedi il risultato
Il sito è online: www.artemarzialecinovietnamita.it