L'IA può aiutare a creare un negozio online personalizzato, ma un negozio funzionante richiede prezzi autorevoli lato server, gestione delle scorte, raccolta dei pagamenti ospitata, webhook firmati, dati degli ordini protetti e vere policy aziendali. Questa guida Adios resta in modalità test e si ferma prima di pagamenti reali o modifiche in produzione.
↗ Variante, valuta, prezzo e stock appartengono al catalogo.
↳ /cart
02Ricalcola sul server.
CASA / MODALITÀ TEST
Due tazze. Un carrello.
Procedi al pagamento
2 × EUR 18.00Subtotal: EUR 36.00
↗ Non fidarti di prezzi o totali inviati dal browser.
↳ fornitore di pagamento / test
03Lascia la raccolta del pagamento al fornitore.
CASA / MODALITÀ TEST
Solo pagamento di test.
Conferma simulata
Mode: sandboxNo real charge
↗ Tornare alla pagina di successo non dimostra il pagamento.
↳ /orders/DEMO-42
04Lascia che l’evento verificato aggiorni l’ordine.
CASA / MODALITÀ TEST
Ordine confermato.
Vedi ordine
DEMO-42 · paid (test)Duplicate event → ignored
↗ Un evento di pagamento produce una transizione dell’ordine.
L’esempio è un catalogo fittizio di articoli per la casa con varianti, stock, carrello, checkout di test ospitato, cronologia e amministrazione protetta. Il percorso illustra il comportamento con dati simulati; l’implementazione richiede tutti i test prima dei pagamenti reali. Esplora altri modi per creare con l'IA su Adios.
Esempio pratico / Negozio per la casa in modalità test
La parte difficile inizia dopo “Aggiungi al carrello”.
In questo esempio, due tazze costano 36 EUR prima di spedizione o imposte applicabili. Il browser invia ID e quantità; il server legge prezzi e disponibilità attuali. Il fornitore gestisce poi il checkout di test.
ADIOS / Dal carrello all’ordineEsempio illustrativo
Carrello del clienteID prodotti + quantitàMUG-01 × 2
Catalogo sul serverPrezzo e stock attuali2 × EUR 18 = EUR 36
Checkout ospitatoFornitore di pagamento / modalità test
Webhook verificatoFirma + deduplicazione degli eventi
Il registro della tua attività
DEMO-42Pagato (test)
Tazza in gres × 2EUR 36
Evento di pagamentoevt_demo_42
Inventario12 → 10
Cosa modifica l’ordine?
✓
Un evento di pagamento verificato.
Registra l’evento del fornitore una sola volta, poi aggiorna insieme ordine e inventario.
↩
L’URL di ritorno serve solo a navigare.
Mantieni l’ordine in sospeso finché il server non verifica il pagamento.
01
Separa i tre stati.
Un carrello è un’intenzione, un pagamento è un evento del fornitore e un ordine è il tuo registro commerciale. Conserva gli identificatori che li collegano. Verifica la firma dell’evento prima di cambiare lo stato del pagamento e non segnare mai un ordine pagato solo per un redirect del browser.
02
Prova errori e ripetizioni.
Prova checkout annullato, sessione scaduta, firma non valida, evento ripetuto e acquisti simultanei dell’ultimo articolo. Definisci quando riservare e liberare lo stock. Registra separatamente i problemi di evasione perché un ordine pagato non scompaia in silenzio.
03
Prepara le operazioni prima della modalità reale.
Definisci come lo staff trova ordini, rimborsa, corregge indirizzi e contatta clienti. Separa l’amministrazione dalla cronologia del cliente. Verifica spedizioni, imposte, resi e assistenza per i tuoi mercati prima dei pagamenti reali.
Il percorso mostra cambiamenti di stato con dati fittizi. Non collega un fornitore, crea ordini né verifica un deployment commerciale reale. I prompt seguenti aiutano a costruire e testare la tua implementazione.
Registra i dati autorevoli dei prodotti, le scorte, i paesi, la valuta, le spedizioni, le imposte, i rimborsi, la privacy, l'assistenza e la modalità di test del fornitore.
Elenca i valori di test e rivedi dominio, prezzi, evasione degli ordini, politiche, email, migrazione, backup, integrità, log e ripristino della versione precedente.
Mantieni la modalità di test finché tutti i criteri del prodotto sono soddisfatti e tutte le decisioni del proprietario sono state prese, poi approva esplicitamente ogni modifica in produzione.
MODALITÀ TEST — Questa guida usa esempi simulati e prompt per pagamenti di test. Completa l’integrazione del fornitore e i test di errore nel tuo progetto prima di attivare pagamenti reali.
Esempio di negozio / Articoli per la casa in modalità di test
Un sistema di acquisto, oltre la griglia generata dei prodotti
Le verifiche iniziano dopo il pulsante Aggiungi al carrello: prezzi calcolati dal server, limiti delle scorte, checkout ospitato, eventi firmati, ordini idempotenti e amministrazione privata.
Totali e limiti delle scorte verificati dal server.
03
Checkout
Flusso ospitato dal fornitore in modalità di test.
04
Ordini
Gli eventi firmati creano ogni ordine una sola volta.
00
Prima di scrivere il prompt
Prendi le decisioni commerciali prima di generare il checkout
Il codice non può decidere dove vendi, come calcoli le imposte, quanto costa la spedizione o quali resi accetti. Registra queste decisioni, o segnale come ancora aperte, prima che l'agente lavori sui pagamenti.
INPUT / 01
Dati autorevoli dei prodotti
Definisci prodotti, varianti, prezzi, valuta, regole sulle scorte e la fonte autorevole di ciascun valore.
INPUT / 02
Limiti dell'evasione degli ordini
Annota i paesi di spedizione, le tariffe, gli impegni di consegna, il comportamento delle scorte e il contatto per l'assistenza.
INPUT / 03
Confini dei pagamenti
Usa il checkout ospitato e la modalità di test del fornitore. Non raccogliere né memorizzare direttamente i dati della carta nell'app.
INPUT / 04
Obblighi verso i clienti
Verifica imposte, rimborsi, resi, privacy, termini, prodotti vietati e assistenza prima di mettere il negozio online.
Un negozio è un'app full-stack. Se è il tuo primo progetto, completa creare la tua prima app con l'IA prima di aggiungere denaro e dati dei clienti.
01
Politiche prima del pagamento
Pianifica l'intero acquisto di test e i suoi confini commerciali
Compila ogni campo con una decisione effettiva oppure scrivi «decisione necessaria». L'agente deve segnalare i requisiti mancanti relativi a imposte, spedizioni, rimborsi, privacy e fornitore prima di modificare i file.
Prompt per pianificare il negozio
Aiutami a pianificare un piccolo negozio online in questo spazio di lavoro Adios. Non modificare ancora i file.
Informazioni sul negozio:
- Nome del negozio: [NOME]
- Cliente: [CLIENTE]
- Tipi di prodotti: [PRODOTTI]
- Varianti: [TAGLIA, COLORE O ALTRE OPZIONI]
- Regola per le scorte: [MONITORATE, PRODUZIONE SU ORDINAZIONE O NON MONITORATE]
- Paesi serviti: [PAESI]
- Valuta: [VALUTA]
- Fornitore di pagamenti: [FORNITORE IN MODALITÀ DI TEST]
- Modalità di spedizione: [REGOLA]
- Gestione delle imposte: [REGOLA O DECISIONE ANCORA NECESSARIA]
- Politica su rimborsi e resi: [POLITICA REALE O DECISIONE ANCORA NECESSARIA]
Esamina il repository, la configurazione del database, l'autenticazione, i test, la route del controllo di integrità e adios.yaml. Pianifica il negozio di test completo più semplice possibile, includendo catalogo, dettaglio prodotto, carrello, passaggio al checkout, eventi di pagamento firmati, ordini, scorte e amministrazione protetta.
Elenca le decisioni che devo ancora prendere su imposte, spedizioni, rimborsi, privacy, assistenza clienti, prodotti vietati e requisiti del fornitore di pagamenti. Attendi la mia approvazione prima di modificare i file.
Cosa contiene una risposta utile
Un percorso completo di acquisto di prova
Fonti autorevoli per prodotti, prezzi e scorte
Transizioni degli stati di ordini e pagamenti
Un elenco di decisioni aziendali irrisolte
02
Costruisci in modalità test
Genera catalogo, carrello, passaggio al checkout e stato degli ordini
Questo prompt mantiene i calcoli dei prezzi sul server, usa il checkout ospitato, verifica gli eventi firmati e include i test degli eventi duplicati nello sviluppo.
Prompt per creare il negozio
Crea la versione di prova approvata del negozio online. Non abilitare pagamenti reali e non distribuire in produzione.
Requisiti:
- Conserva framework attuale, gestore di pacchetti, route di integrità, test e file di distribuzione Adios.
- Salva prodotti, varianti, scorte, carrelli e ordini nel database configurato, con relazioni chiare e migrazioni reversibili dove supportate.
- Calcola prezzi e scorte sul server. Non fidarti dei totali inviati dal browser.
- Usa l'SDK ufficiale attuale del provider di pagamenti e il checkout di prova ospitato. Non raccogliere né memorizzare dati grezzi delle carte.
- Verifica i webhook firmati, gestisci gli eventi duplicati in modo idempotente e registra una cronologia chiara degli stati degli ordini.
- Proteggi le route amministrative e applica i permessi sul server.
- Mantieni i segreti di pagamenti, database, email e sessioni fuori dal codice sorgente ed elenca i nomi delle relative variabili di ambiente.
- Aggiungi stati utili per caricamento, carrello vuoto, prodotti esauriti, pagamento rifiutato, checkout annullato e conferma dell'ordine.
- Usa prodotti di esempio chiaramente indicati come fittizi. Non inventare recensioni, scarsità, sconti, certificazioni o promesse di consegna.
- Aggiungi test per calcolo dei prezzi, limiti delle scorte, autorizzazione, rifiuto di firme webhook non valide, eventi duplicati e percorso ideale dell'ordine.
- Esegui il formattatore, il lint, i test e la compilazione di produzione esistenti.
Fornisci file modificati, modello dati, modello degli stati degli ordini, evidenze dei test, segreti Adios necessari e un percorso di test preciso in Preview. Non distribuire.
Cosa contiene una risposta utile
Totali e scorte gestiti dal server
Checkout ospitato dal fornitore in modalità di test
Eventi di pagamento verificati e idempotenti
Amministrazione protetta e ordini privati
Prova il percorso cliente
Un piccolo negozio da provare.
Scegli una finitura, aggiungi una tazza e prova un acquisto simulato. Questo esempio funziona nel browser senza effettuare pagamenti reali.
FORM & FIELDCASA / DEMOCarrello (0)
Per i rituali quotidiani.GRES / 01
La collezione quotidiana
Tazza in gres
EUR 18 / 350 ml
Checkout di prova
Carrello→Checkout→Ordine
Il tuo carrello aspetta qualcosa di bello.
Tazza in gres× 0
SubtotaleEUR 0
Subtotale di esempio prima di spedizione e imposte.
Esempio nel browser · Nessun addebito reale
03
Prova errori e richieste ripetute
Verifica il percorso di acquisto oltre il checkout riuscito
I test utili riguardano pagamenti rifiutati e annullati, dati manomessi, eventi duplicati, accessi non autorizzati e prodotti esauriti. Questo prompt richiede prove per ciascun caso.
Prompt per verificare il negozio
Verifica l'intero percorso di acquisto del negozio in modalità test. Correggi solo i problemi confermati e non distribuire.
Testa:
- navigazione tra i prodotti e selezione di varianti valide;
- calcoli di prezzo, valuta, quantità e scorte;
- carrelli vuoti, scaduti, manomessi e con prodotti esauriti;
- eventi di checkout riusciti, rifiutati, annullati e ripetuti;
- firme webhook non valide e webhook validi duplicati;
- creazione degli ordini e aggiornamento delle scorte esattamente una volta;
- impossibilità per un cliente di accedere all'ordine privato di un altro cliente;
- impossibilità per un utente non autenticato di accedere all'amministrazione;
- assenza nei log di dati delle carte, credenziali e informazioni personali non necessarie; e
- formattatore, lint, test, compilazione e controlli di integrità.
Fornisci un risultato per ogni caso, i rischi residui e i passaggi manuali che devo eseguire con gli strumenti di test del provider.
Cosa contiene una risposta utile
Un risultato registrato per ogni caso di errore
Ordini e scorte aggiornati una sola volta
Accesso privato dei clienti e all'amministrazione
Istruzioni per gli strumenti di test del fornitore
04
Separa il codice dagli obblighi
Prepara la decisione sull'idoneità alla produzione senza andare online
L'ultimo prompt distingue le prove tecniche dalle scelte su imposte, evasione degli ordini, privacy, assistenza e politiche che solo il proprietario del negozio può approvare.
Prompt per la revisione del rilascio del negozio
Prepara questo negozio per decidere se è pronto per la produzione. Non passare alle credenziali dei pagamenti reali e non distribuire.
Verifica il dominio di produzione, la fonte autorevole per prodotti e prezzi, la valuta, il comportamento delle scorte, le regioni e le tariffe di spedizione, la decisione sulle imposte, la politica sui rimborsi, l'informativa sulla privacy, i termini, il contatto per l'assistenza, le email degli ordini, l'URL del webhook, i nomi dei segreti, la migrazione del database, i backup, la route del controllo di integrità, i log e il piano di ripristino della versione precedente.
Distingui i controlli tecnici superati dalle decisioni commerciali o legali che restano sotto la mia responsabilità. Elenca tutti i valori della modalità di test e i segnaposto da sostituire. Fermati e attendi l'approvazione esplicita prima di qualsiasi pagamento reale o modifica in produzione.
Cosa contiene una risposta utile
Prove tecniche separate dalle decisioni del proprietario
Tutti i valori della modalità di test e i segnaposto elencati
Note su migrazione, backup, webhook, integrità e ripristino della versione precedente
Nessuna modifica alle credenziali reali o alla distribuzione
T
Testa il risultato
Una compilazione riuscita è l'inizio della revisione
Apri Preview ed esegui personalmente i percorsi utente importanti. Chiedi evidenze all'agente, ma non confondere il suo riepilogo con la tua approvazione.
TEST / 01
Importi e scorte
Il server ricalcola prezzo, valuta, quantità, sconti e scorte prima del checkout.
I carrelli vuoti, scaduti, manomessi o con prodotti esauriti vengono rifiutati, indicando un passo successivo utile.
Un evento di pagamento valido crea l'ordine e il movimento delle scorte esattamente una volta.
TEST / 02
Eventi di pagamento
Le firme non valide vengono rifiutate e i webhook validi duplicati non causano danni.
Gli eventi di test riusciti, rifiutati, annullati, ritardati e ripetuti hanno risultati espliciti.
I dati della carta, i segreti del fornitore e i dati personali non necessari non finiscono nel codice sorgente o nei log.
TEST / 03
Accesso e operazioni
I clienti non possono leggere gli ordini privati di altri clienti e gli estranei non possono accedere all'amministrazione.
Il comportamento di migrazioni, backup, email degli ordini, integrità, log e ripristino della versione precedente è noto.
Il proprietario ha preso le decisioni sugli obblighi relativi a imposte, spedizioni, rimborsi, privacy, termini, assistenza e prodotti.
Punto di approvazione umana
Mantieni il negozio in modalità di test finché ogni criterio ha un responsabile
Questa guida si ferma intenzionalmente prima dei pagamenti reali. Completa il percorso di test del fornitore, risolvi le decisioni commerciali e legali, sostituisci ogni valore di test e ottieni l'approvazione esplicita prima di indicizzare o pubblicare la guida al negozio come verificata.
01Registra i test di pagamenti riusciti, rifiutati e annullati, eventi duplicati, firme non valide e prodotti esauriti.
02Verifica che ordini e scorte vengano aggiornati una sola volta e che le route private consentano l'accesso solo ai rispettivi proprietari.
03Prendi le decisioni su imposte, spedizioni, rimborsi, privacy, termini, assistenza, email, backup e ripristino della versione precedente.
04Elenca e sostituisci ogni ID, URL e nome delle credenziali della modalità di test, oltre a ogni segnaposto nei contenuti.
05Approva separatamente le modifiche ai pagamenti reali e alla produzione; una compilazione riuscita non equivale a un'approvazione.
?
Domande prima di iniziare
Cosa promette questa guida e quali sono i suoi limiti
L'IA può creare un negozio online funzionante, oltre a una simulazione?+
Può aiutarti a generare un negozio personalizzato funzionante, ma le prove devono includere prezzi lato server, scorte, checkout ospitato, eventi firmati, ordini idempotenti, dati protetti, test e politiche reali. Una griglia di prodotti e un'animazione del carrello non bastano.
Perché la guida richiede il checkout ospitato?+
Con il checkout ospitato, è il fornitore di pagamenti a raccogliere direttamente i dati della carta, anziché la tua applicazione. L'app deve comunque proteggere i segreti del fornitore, verificare gli eventi firmati, gestire in sicurezza le ripetizioni e amministrare correttamente lo stato degli ordini.
Chi è responsabile di imposte, spedizioni, rimborsi e privacy?+
Il proprietario del negozio resta responsabile di quelle decisioni commerciali e legali. L'IA può implementare le regole approvate e segnalare le scelte mancanti, ma non può decidere quali obblighi si applicano né approvarli al tuo posto.
L’animazione dimostra un’integrazione di pagamento funzionante?+
No. L’animazione è una simulazione educativa. Per validare il negozio, collega un fornitore in modalità test e verifica catalogo, pagamento, eventi firmati, ordini, stock, accessi e recupero nell’implementazione reale.
Parti da uno spazio di lavoro verificabile
Invia il primo prompt ad Adios, poi approva il piano.