Risorse — Glossario, prompt e checklist

Libreria

📋 I prompt del corso, pronti da copiare

1 · Farsi intervistare (inizio di ogni progetto)

Voglio creare [descrivi in una frase]. Non so programmare.
Fammi le domande necessarie per capire esattamente cosa mi serve,
una alla volta. Poi proponi: versione minima (MVP), elenco schermate
e cosa rimandare a dopo. Aspetta la mia conferma prima di costruire.

2 · Generare un sito (struttura completa)

[CONTESTO] Chi sono, che attività ho, per chi è il sito.
[OBIETTIVO] Cosa deve ottenere il sito (contatti? vendite? portfolio?).
[DETTAGLI] Sezioni nell'ordine, stile, colori, tono dei testi in italiano.
[VINCOLI] Un solo file HTML con CSS incluso, perfetto da smartphone,
testi realistici (niente lorem ipsum).

3 · Chiedere una modifica (una alla volta)

[Cosa non va, anche a sensazione: "la hero sembra vuota"]
[Cosa vorresti: "più impatto, titolo più grande, un bottone evidente"]
Modifica SOLO questo, non toccare il resto.

4 · Segnalare un bug (la formula del Modulo 5)

[AZIONE] Quando faccio...
[ATTESO] dovrebbe succedere...
[OSSERVATO] invece succede...
[INDIZI] errore dalla console: (incolla tutto)

Trova la causa e correggila. Spiegami in una frase cosa era rotto.

5 · Uscire da un loop

Abbiamo provato 3 volte lo stesso approccio e non funziona. Fermati.
Elenca 3 possibili cause DIVERSE da quelle già tentate, in ordine di
probabilità. Non modificare il codice finché non scelgo quale indagare.

6 · Login e database con permessi (Modulo 4)

Collega Supabase e:
1. Registrazione e login con email e password
2. Salva i dati nel database, collegati all'utente
3. Ogni utente vede e modifica SOLO i propri dati
4. Se non sono loggato, mostra la pagina di login

7 · Checklist di test su misura

Elenca 10 test manuali per questa app, ordinati per importanza,
con i passaggi esatti per eseguirli e cosa dovrei osservare
se tutto funziona.

8 · Audit di sicurezza

Fai una revisione di sicurezza dell'app: chiavi o segreti esposti nel
frontend, tabelle del database senza regole di accesso, dati degli utenti
non validati. Elenca i problemi in ordine di gravità e NON correggere
nulla finché non ti dico io.

Da stampare

✅ La checklist prima di pubblicare

Funziona?

Il percorso principale completo, dall'inizio alla fine
Campi cattivi: vuoti, testi lunghi, numeri strani, emoji
Doppio click su "Salva": niente duplicati
Ricarica pagina: dati e login ancora presenti
Provato da smartphone vero

È sicuro?

Test dei due account: ognuno vede solo il suo
Nessun segreto/chiave nel codice del frontend
Regole di accesso (RLS) su ogni tabella
https attivo (lucchetto nel browser)
Raccolgo solo i dati che servono davvero

Si capisce?

In 5 secondi si capisce cos'è e cosa fare
Stati vuoti con messaggi di benvenuto
Conferme dopo le azioni, indicatori di caricamento
Errori spiegati in italiano semplice
Una persona esterna l'ha provato senza aiuto

È al sicuro?

Versione salvata su GitHub (commit + push)
So tornare all'ultima versione funzionante
Messaggio di commit chiaro ("aggiunto login", non "fix")
Il deploy è collegato al repository (dal Modulo 6)

Glossario

📖 Le parole del vibe coding

Vibe coding: Costruire software descrivendo all'AI il risultato voluto in linguaggio naturale, valutando e iterando — senza scrivere codice a mano.
Prompt: Il messaggio che dai all'AI. La qualità del prompt determina la qualità del risultato (struttura: Contesto → Obiettivo → Dettagli → Vincoli).
LLM (Large Language Model): Il "motore" AI (Claude, GPT, Gemini): un modello che genera testo — e quindi codice — a partire dal tuo input.
Contesto (context window): La memoria di lavoro di una conversazione con l'AI. Se il progetto è lungo, l'AI può perdere pezzi: meglio una chat per obiettivo.
Allucinazione: Quando l'AI afferma con sicurezza cose inesistenti o dichiara riuscito ciò che non lo è. Antidoto: verificare sempre coi propri occhi.
Frontend: La parte visibile di un sito o app: pagine, bottoni, stili (HTML, CSS, JavaScript). La "sala del ristorante".
Backend: La logica invisibile lato server che elabora richieste e dati. La "cucina".
Database: Dove i dati vengono salvati in modo permanente (utenti, contenuti, ordini). La "dispensa".
Sito statico: Sito di sole pagine da guardare, senza login né dati salvati. Facile e gratis da pubblicare.
Web app: Applicazione che gira nel browser: utenti, dati salvati, interazione. Funziona anche da smartphone.
MVP (Minimum Viable Product): La versione più piccola di un prodotto che sia già utile. Si costruisce prima quella, poi si espande.
Deploy: Pubblicare il sito o l'app su internet. Con Netlify/Vercel/Lovable è questione di un click.
Hosting: Il servizio che tiene il tuo sito acceso e raggiungibile 24 ore su 24.
Dominio: L'indirizzo del tuo sito (tuosito.it). Si compra da un registrar per ~10-15 €/anno.
DNS: Il sistema che collega il dominio al server che ospita il sito. Si configura con 1-2 record copiati dal pannello dell'hosting.
Autenticazione (login): Il sistema con cui gli utenti si registrano e accedono. Con Supabase è pronta all'uso.
RLS (Row Level Security): Le regole del database che stabiliscono chi può vedere e modificare quali dati. Obbligatorie in ogni app con utenti.
API: Il modo in cui i software si parlano tra loro (la tua app che chiede dati a Supabase, ad esempio).
Chiave API / Secret: La "password" con cui la tua app usa un servizio. Mai nel frontend: va negli appositi "secrets" dello strumento.
Console del browser: Il pannello (F12) dove il browser scrive gli errori. La prima fonte di indizi per ogni bug.
Git: La "macchina del tempo" dei progetti: salva versioni (commit) e permette di tornare indietro.
GitHub: Il servizio dove i progetti Git vivono online: backup, storia, collaborazione, deploy automatici.
Repository (repo): La cartella di un progetto con tutta la sua storia di versioni.
Commit: Una "fotografia" del progetto in un momento preciso, con messaggio descrittivo. Piccolo e spesso.
CI/CD: La pubblicazione automatica: ogni versione salvata su GitHub va online da sola (es. GitHub → Vercel).
Micro-SaaS: Piccola app in abbonamento che risolve un problema specifico di una nicchia. La via lunga (e più ricca) della monetizzazione.