Percorso guidato causa-effetto

Causa: il programma è cresciuto e deve essere leggibile per compartimenti, non come blocco monolitico.

00.1 Architettura modulare 00.2 Verifica architettura

Effetto: ogni argomento mantiene numero, cartella, documentazione e responsabilità proprie.

Causa: senza dati demo coerenti le verifiche successive non sono ripetibili.

01.1 Crea dati demo 01.2 Crea demo Punti

Effetto: DB pronto per Cliente, Negozio, Coupon, Credito e vendite.

Causa: ogni vendita deve essere collegata a un Cliente identificabile con codice e QR.

02.1 Archivio Clienti 02.2 Conto Punti Clienti 02.3 Verifica Clienti

Effetto: il Cliente può usare/generare Punti e presentarsi con QR.

Causa: il Negozio deve avere scheda e collegamenti economici coerenti.

03.1 Schede Negozi 03.2 Credito Negozi 03.3 Verifica Negozi

Effetto: il Negozio è pronto per Credito, Fee, Coupon e vendite.

Causa: il modello economico usa Credito unico del Negozio, soglie e ricarica automatica.

04.1 Credito ricaricabile 04.2 Ricariche/Fatturazione 04.3 Verifica Credito 04.4 Verifica Ricariche/Fatturazione

Effetto: sotto soglia viene generata ricarica automatica con comando fatturazione simulato.

Causa: ogni vendita tracciata deve produrre una Fee autonoma e verificabile.

05.1 Registro Fee 2% 05.2 Export Fee 05.3 Verifica Fee

Effetto: Fee collegata a vendita e movimento Credito, senza duplicati.

Causa: il Coupon deve essere controllato prima di entrare nella vendita.

06.1 Coupon per Negozio 06.2 Coupon operativi 06.3 Verifica Coupon

Effetto: lo sconto riduce l’importo o l’omaggio viene registrato.

Causa: prima della vendita il Cliente deve vedere saldo, QR, Coupon e Negozi.

07.1 APP Cliente 07.2 Verifica APP Cliente

Effetto: il Cliente è pronto a presentarsi con QR, Punti e Coupon.

Causa: il Cliente può proporre un Negozio, ma il premio non deve essere assegnato subito.

08.1 Segnalazioni Negozi 08.2 Verifica Segnalazioni/Premi

Effetto: dopo adesione validata il Cliente segnalatore riceve 2000 Punti = 20€.

Controllo: il premio resta DA_ASSEGNARE finché lo stato non diventa ADERITO.

Causa: adesione diretta, segnalazione Cliente e Programma Agenti devono produrre gli stessi dati Negozio.

09.1 Acquisizione Negozi 09.2 Adesione diretta/segnalazione 09.3 Programma Agenti 09.4 Verifica Acquisizione

Effetto: Negozio reale con pratica, pagamento adesione simulato, Credito iniziale, Coupon, materiali e messaggio VDN_SCAMBIO_DATI.

Causa: i programmi devono scambiarsi dati con JSON standard e tracciato.

10.1 VDN_SCAMBIO_DATI 10.2 Genera export 10.3 Verifica Scambio Dati

Effetto: INPUT/OUTPUT/ARCHIVIO/ERRORI, log, envelope e idempotenza sono verificabili.

Causa: il Negoziante deve controllare vendite, Credito, Coupon, profilo e Punti.

11.1 APP Negozio 11.2 Verifica APP Negozio

Effetto: il Negozio è pronto a registrare o verificare le operazioni prodotte dal POS.

Causa: Scanner/POS collega Cliente, Negozio, Coupon, Punti e importo vendita.

12.1 APP Scanner/POS 12.2 Vendita Punti operativa 12.3 Verifica Scanner/POS

Effetto: la vendita genera movimenti Punti, Credito, Coupon e Fee 2%.

Causa: il flusso fisico deve gestire vendita, annullo, rettifica e ricevuta.

13.1 Vendite offline 13.2 Nuova vendita offline 13.3 Verifica vendite offline

Effetto: vendita fisica completa e tracciata senza cancellare lo storico.

Causa: il progetto deve crescere fino ad almeno 20.000 attività e 2.000.000 Clienti.

14.1 Scalabilità 14.2 Verifica scalabilità

Effetto: indici, limiti UI/API, paginazione, metriche e roadmap PostgreSQL sono documentati.

Causa: prima delle vendite online il Negozio deve poter ricevere pagamenti e bonifici.

15.1 Stripe Connect 15.2 Verifica Stripe Connect

Effetto: il Negozio diventa ATTIVO e vendite_online_abilitate = SI.

Controllo: pagamenti attivi, bonifici attivi, card_payments e transfers devono essere tutti attivi.

Causa: dopo Stripe Connect si può simulare l’acquisto online dalla piattaforma, senza usare ancora pagamenti reali.

16.1 Vendite online 16.2 Nuovo ordine online 16.3 Verifica vendite online

Effetto: ordine online confermato con pagamento simulato, vendita tracciata, Coupon/Punti, Fee 2%, Credito e registri aggiornati.

Controllo: il Negozio deve avere Stripe Connect ATTIVO e vendite_online_abilitate = SI.

Causa: prima di vendere online/offline il catalogo deve avere dati uniformi, verificabili e collegati al Negozio.

17.1 Catalogo Prodotti/Servizi 17.2 Nuovo Prodotto/Servizio 17.3 Verifica Prodotti/Servizi

Effetto: prodotti e servizi hanno categoria, prezzo, IVA, giacenza, stato verifica, pubblicazione online e collegamento al Negozio.

Controllo: gli elementi vendibili online richiedono Negozio abilitato con Stripe Connect.

Causa: con molti Negozi, Clienti e prodotti servono controlli automatici prima della revisione manuale.

18.1 Controlli automatici 18.2 Esegui controlli demo 18.3 Verifica controlli

Effetto: Negozi, Clienti, Coupon, Prodotti/Servizi e Vendite vengono classificati come AMMESSO, DA_VERIFICARE o NON_AMMESSO.

Controllo: i casi DA_VERIFICARE/NON_AMMESSO restano aperti per Admin/Sede.

Causa: la Sede/Admin deve vedere in un punto unico KPI, economia, flussi, anomalie e controlli.

19.1 Dashboard Admin 19.2 Stato flussi 19.3 Economia 19.4 Verifica Dashboard

Effetto: le attività operative e le anomalie sono leggibili in forma direzionale, senza cercarle nei singoli moduli.

Controllo: KPI, flussi, economia, anomalie, export e verifica dedicata devono risultare disponibili.

Causa: APP, moduli e futuro server devono parlare con contratti JSON stabili e verificabili.

20.1 API simulate 20.2 Documentazione API 20.3 Verifica API JSON

Effetto: Cliente, Negozio, Scanner/POS, vendite, scambio dati e Dashboard hanno endpoint JSON simulati e log tracciato.

Controllo: envelope JSON, endpoint, paginazione, idempotenza e log API devono risultare PASSA.

Causa: le APP devono consumare contratti JSON stabili, invece di dipendere da letture dirette del DB.

21.1 APP via API 21.2 Cliente via API 21.3 Negozio via API 21.4 Verifica APP/API

Effetto: APP Cliente, APP Negozio e Scanner/POS risultano collegati agli endpoint API simulati e tracciati in log.

Controllo: envelope JSON, payload Cliente/Negozio/Scanner e tabella collegamenti devono risultare PASSA.

Causa: dopo aver collegato le APP alle API serve una prova end-to-end ripetibile.

22.1 Collaudo integrato 22.2 Esegui scenari 22.3 Verifica integrata

Effetto: APP Cliente, APP Negozio, Scanner/POS, catalogo online e Dashboard risultano coerenti con i payload API.

Controllo: tabella collaudo_integrato_app_api, log APP/API ed envelope JSON devono risultare PASSA.

Causa: prima della produzione servono profili e permessi coerenti per APP, Dashboard e API.

23.1 Ruoli/accessi 23.2 Verifica ruoli/accessi

Effetto: Cliente, Negozio, Scanner/POS, Agente e Admin/Sede hanno permessi simulati e controllabili.

Controllo: ruoli_accessi_simulati e permessi minimi per area devono risultare PASSA.

Causa: alla fine serve un controllo complessivo e ripetibile.

24.1 Verifica FLUSSO_07 24.2 Collaudo versione 24.3 Verifica collaudo finale 24.4 Collaudo generale PC V0.8.0 24.5 Verifica generale PC 24.6 Grafica/Satelliti 24.7 Autotest

Effetto: la versione è accettabile solo se il collaudo finale passa, le pagine /verifica-* sono coerenti e la roadmap server è pronta.