00 — Architettura modulare VDN
Versione 2.1.1 — Programma unico avviabile, compartimenti comunicanti.
Perché questa riorganizzazione
La piattaforma continua ad avviarsi da app.py, ma da V0.7.2 ogni argomento ha una cartella, una responsabilità e una documentazione propria. Questo prepara il passaggio successivo a moduli applicativi, API e server senza perdere la compatibilità delle versioni già collaudate.
Percorso guidato Verifica architettura modulare Collaudo versione
Regole di comunicazione tra compartimenti
- Il programma resta avviabile da app.py, ma la struttura è organizzata per compartimenti.
- Ogni modulo mantiene il proprio numero ufficiale, valido in Dashboard, percorso guidato, documentazione e prompt.
- I moduli comunicano tramite Database Centrale, funzioni core e VDN_SCAMBIO_DATI; non tramite duplicazioni locali.
- Le APP Cliente/Negozio/Scanner sono viste applicative distinte, ma leggono gli stessi dati centrali.
- Le future API dovranno rispettare gli stessi numeri modulo e gli stessi contratti dati.
Mappa moduli ufficiale
00Architettura modulare e documentazione
meta
Cartella: core
Mappa moduli, dipendenze, regole comunicazione e pacchetti migrazione.
01Dati base
modulo
Cartella: moduli/dati_base
Creazione dati demo, parametri globali, tabelle base e avvio diagnostico.
02Cliente reale e Conto Punti
modulo
Cartella: moduli/clienti_punti
Clienti, codice/QR, saldo Punti, movimenti e regole FLUSSO_07.
03Negozio reale
modulo
Cartella: moduli/negozi
Scheda Negozio, dati anagrafici, testi/materiali e configurazioni operative.
04Credito ricaricabile e ricariche/fatturazione
modulo
Cartella: moduli/credito
Credito unico Negozio, soglie, ricariche, rettifiche e comandi fatturazione.
05Fee 2% completa
modulo
Cartella: moduli/fee
Calcolo Fee, registro autonomo, controllo duplicati/mancanti ed export.
06Coupon/Omaggi operativi
modulo
Cartella: moduli/coupon
Coupon, validità, quantità, utilizzi, sconti, omaggi e integrazione vendite.
07APP Cliente simulata
app
Cartella: app_cliente
Vista Cliente: QR, saldo Punti, Coupon, Negozi, storico e segnalazioni.
08Segnalazione Negozi e premio Cliente
modulo
Cartella: moduli/segnalazioni
Segnalazioni, stati, premio 2000 Punti e collegamento adesione Negozio.
09Acquisizione Negozi
modulo
Cartella: moduli/acquisizione_negozi
Adesione diretta, da segnalazione e import Programma Agenti con dati unificati.
10VDN_SCAMBIO_DATI
modulo
Cartella: moduli/scambio_dati
INPUT/OUTPUT/ARCHIVIO/ERRORI, envelope JSON, idempotenza, import/export.
11APP Negozio simulata
app
Cartella: app_negozio
Vista Negoziante: vendite, Credito, Coupon, Punti, profilo e configurazioni.
12APP Scanner/POS e vendita Punti
app
Cartella: app_scanner_pos
Lettura QR/codice Cliente, vendita, ricevuta, controlli Punti/Credito.
13Vendite offline complete
modulo
Cartella: moduli/vendite_offline
Vendita fisica, annullo, rettifica e storico operazioni.
14Scalabilità grandi numeri
modulo
Cartella: moduli/scalabilita
Indici, paginazione, limiti UI/API, roadmap PostgreSQL e metriche.
15Stripe Connect
modulo
Cartella: moduli/stripe_connect
Onboarding Negozio, account simulato, capability e abilitazione vendite online.
16Vendite online simulate
modulo
Cartella: moduli/vendite_online
Ordini online, pagamento simulato, vendita tracciata e motore economico centrale.
17Prodotti/Servizi del Negozio
modulo
Cartella: moduli/prodotti_servizi
Catalogo, stati, verifica, IVA, giacenza e pubblicazione online.
18Controlli automatici di ammissibilità
modulo
Cartella: moduli/controlli_ammissibilita
Regole automatiche per Negozio, Cliente, Coupon, Prodotti/Servizi, Vendite e anomalie operative.
19Dashboard Admin completa
dashboard
Cartella: dashboard_admin
Pannello di controllo Sede/Admin con KPI, flussi, economia, anomalie e verifiche.
20API JSON simulate
api
Cartella: api
Endpoint JSON simulati per Cliente, Negozio, APP, Scanner/POS, Admin e scambio dati.
21APP collegate tramite API
app
Cartella: app_api
Collegamento APP Cliente, APP Negozio e APP Scanner/POS ai contratti JSON simulati.
22Collaudo integrato APP/API
test
Cartella: moduli/collaudo_integrato_app_api
Scenario end-to-end APP/API Cliente, Negozio, Scanner/POS, vendite e log.
23Ruoli/accessi simulati
sicurezza
Cartella: moduli/ruoli_accessi
Profili simulati, permessi per APP/Dashboard/API e cambio utente demo.
24Collaudo finale
test
Cartella: test_collaudo
Simulazione completa della piattaforma in ambiente PC locale: Cliente, Negozio, Agente, Scanner/POS, Dashboard/Admin, grafica comune e programmi satellite collegati in modalità demo.