iWon — Piano evolutiva

1. Executive summary

iWon è oggi un sistema funzionale ma strutturalmente limitato: copre processi complessi (preventivi, distinte, produzione, rilievi, integrazione Odoo) ma è cresciuto come monolite difficile da evolvere. L’evolutiva richiesta non è una serie di patch: è un rifacimento strutturale su una nuova piattaforma, organizzata in due macro-moduli interconnessi.

Macro-modulo	Responsabilità
Commerciale	Clienti, commesse, preventivi, configurazione guidata della tenda, fattibilità tecnico-commerciale
Produzione	Attivato dopo conferma preventivo: rilievi, dettagli tecnici, distinte, lavorazioni, operatori, avanzamento MES

Benefici attesi

Riduzione errori grazie a workflow guidati e regole di compatibilità
Separazione netta tra ciò che serve al commerciale e ciò che serve alla produzione
Cataloghi e formule configurabili, non hardcoded per ogni modello tenda
Integrazione Odoo più governata e tracciabile
Test automatici sulle formule per validare le regole prima dell’uso operativo

Nota metodologica

Ogni modulo e sotto-modulo verrà analizzato, sviluppato e affinato insieme al cliente e ai responsabili di reparto. L’obiettivo è trasformare il know-how operativo in funzionalità mirate, validate e realmente utilizzabili nel lavoro quotidiano — non consegnare un software generico da adattare dopo.

2. Stato attuale e criticità

2.1 Cosa fa oggi iWon

L’applicazione attuale è un monolite (un solo deployable) che gestisce:

Area	Funzionalità presenti
Commerciale	Ordini, preventivi, righe tenda, listini, export PDF/XLS
Catalogo	Modelli tenda, accessori, kit motorizzazione, componenti, tessuti, colori
Produzione	Schedule per reparto (plastica, ferro, alluminio, tessuti), distinte BOM/BOF, vista operatore
Misure	PWA presa misure con sync offline, conferma fasi
Integrazioni	Odoo (anagrafiche, componenti, export ordini), OptCut (tracciati taglio via CSV)
Amministrazione	Utenti, ruoli, permessi granulari per reparto

Il flusso operativo è riconoscibile: preventivo → preorder → presa misure → conferma → pianificazione → assemblaggio. Il dominio di settore è ben modellato.

2.2 Criticità strutturali

Criticità	Impatto
Logica accoppiata in pochi file grandi (es. controller preventivo ~1000 righe)	Ogni modifica richiede analisi end-to-end, alto rischio regressioni
Nessuna API separata: tutto via route web + sessioni	Impossibile separare frontend e backend, difficile evolvere l’interfaccia
Frontend datato (Vue 2, pattern Blade + istanza Vue per pagina)	UX limitata, manutenzione costosa
Formule e regole distribuite tra codice PHP, configurazione DB e UI	Difficile aggiungere modelli tenda o varianti senza sviluppo custom
Test automatici quasi assenti (1 test unitario su calcoli tessuto)	Nessuna rete di sicurezza su modifiche a formule e flussi
Flussi produzione con punti non finalizzati (TODO su sync misure, conferma, preorder)	Comportamento runtime potenzialmente incoerente con il processo atteso
Dipendenze da librerie del fornitore precedente (griglie admin, Odoo, menu)	Lock-in tecnico su componenti non standard

2.3 Limiti operativi emersi dall’uso quotidiano

Dagli appunti 2026 emergono problemi concreti che confermano la necessità di un rifacimento:

Formule errate o mancanti (magneti, catenella, sartoria pacchetto, staffe)
Componenti non associabili per variante modello tenda
Accessori scelti a parte non compaiono in produzione
Note e allegati non tracciati correttamente
Associazioni componenti condizionali (motore + supporto → disco diverso) non gestite
Usabilità insufficiente (click su riga, filtri, navigazione post-salvataggio)

Questi non sono solo bug: indicano che il modello attuale non supporta la complessità reale del dominio senza interventi manuali continui.

3. Visione della nuova piattaforma

3.1 Principi architetturali

La nuova piattaforma separa chiaramente:

Interfaccia utente: guidata, responsive (tablet), diversa per ruolo e reparto
Logiche applicative: organizzate per macro-modulo (Commerciale / Produzione)
Regole, decisioni e formule: cataloghi, vincoli, compatibilità, calcoli
Dati e storico: tracciabilità completa di preventivi, versioni, rilievi, distinte
Integrazioni esterne: Odoo, macchine taglio, magazzino

Non si tratta di aggiungere funzionalità al monolite esistente, ma di costruire una piattaforma dove ogni layer può evolvere in modo indipendente.

3.2 Approccio dinamico

Le tipologie di tenda, i kit motorizzazione, gli accessori e le regole di compatibilità non verranno mappati uno per uno nel codice. Si prevede un sistema a:

cataloghi configurabili (modelli, varianti, componenti, famiglie, tessuti, colori)
regole di compatibilità (dimensioni, colore, modello, variante, rullo, tessuto)
vincoli (obbligatorio/facoltativo, quantità min/max, range, non addebitato, non prelevabile)
formule (quantità, detrazioni, compensazioni, costi, lavorazioni)
workflow guidato (l’interfaccia propone solo scelte coerenti)

Il configuratore segue un processo decisionale: ogni scelta restringe le successive. Le regole sono definite tramite cataloghi, vincoli e compatibilità configurabili — non con logiche fisse per ogni tenda.

Esempio: selezione kit motorizzazione su modello tenda

Caso reale: tenda a rullo Ø 47 mm. Il commerciale non sceglie motore, staffe o adattatori uno per uno: il wizard propone solo le combinazioni valide in base a modello, variante e dimensioni.

Configurazione a monte (amministratore / responsabile tecnico)

Elemento	Regola configurata
Modello tenda	Rullo Ø 47 mm — larghezza ammessa 400–3500 mm
Varianti	Oscurante, Decorativa — con tessuti, accessori e kit motorizzazione diversi
Kit motorizzazione	Associati al modello con filtri su variante e range larghezza
Oscurante
Kit MU35 standard	Compatibile: Oscurante, larghezza 0–3000 mm
Kit MU35 heavy	Compatibile: Oscurante, larghezza 2500–3500 mm
Decorativa
Kit MU28 decorativo	Compatibile: Decorativa, larghezza 0–2200 mm
Kit MU32 decorativo	Compatibile: Decorativa, larghezza 1800–2800 mm
Famiglia staffe (produzione)	Min 2 — risoluzione automatica in base a larghezza e supporti scelti
Adattatori rullo	Scelti in produzione in base a motore + diametro rullo (es. R47 → kit adattatori dedicato)

Esempio: percorso wizard commerciale

flowchart TD Start[Inizio configurazione tenda] --> Modello["Modello: Rullo Ø 47 mm"] Modello --> Variante{Variante tenda} Variante -->|Oscurante| DimO["Dimensioni: es. 2800 x 2200 mm"] Variante -->|Decorativa| DimD["Dimensioni: es. 2000 x 2000 mm"] DimO --> KitO{Kit motorizzazione compatibili} KitO -->|Larghezza 2800 mm| KitMU35["Kit MU35 standard"] KitO -->|Larghezza 3200 mm| KitMU35H["Kit MU35 heavy"] DimD --> KitD{Kit motorizzazione compatibili} KitD -->|Larghezza 2000 mm| KitMU28["Kit MU28 decorativo"] KitD -->|Larghezza 2400 mm| KitMU32["Kit MU32 decorativo"] KitMU35 --> Colore[Colore tenda] KitMU35H --> Colore KitMU28 --> Colore KitMU32 --> Colore Colore --> Accessori[Accessori principali: fondale, binario, filoguidatura] Accessori --> FineComm["Preventivo: prodotto vendibile definito"] FineComm --> Produzione["Produzione: staffe, adattatori, dischi, consumabili risolti dalle regole"]

Cosa vede il commerciale vs cosa risolve la produzione

Fase	Commerciale sceglie	Sistema risolve in automatico (produzione)
Modello + variante	Rullo 47, Oscurante	Parametri produzione: compensazione L/H, aria rullo
Dimensioni	2800 × 2200 mm	Filtra kit disponibili; esclude MU35 heavy se fuori range
Kit motorizzazione	MU35 standard	Motore MU35, supporti compatibili, adattatori R47
Colore	Bianco	Varianti articolo Odoo: MU528.B, TE008.B, ecc.
Accessori	Fondale, binario	Componenti tecnici derivati, staffe per range larghezza
—	Non sceglie staffa	Staffa da 55 → formula 99/106 mm (validata con casi campione)
—	Non sceglie disco motore	MU35 + supporti TE067 → disco nero; con piastre → disco SP
Modello + variante	Rullo 47, Decorativa	Tessuti e accessori del catalogo decorativo
Dimensioni	2000 × 2000 mm	Propone MU28 e MU32; esclude kit oscurante
Kit motorizzazione	MU28 decorativo	Motore MU28, supporti e adattatori R47 per linea decorativa
Dimensioni	2400 × 2100 mm	Propone MU32 decorativo (range 1800–2800 mm)
Kit motorizzazione	MU32 decorativo	Motore MU32, componenti kit decorativo dedicati

Sia per oscurante sia per decorativa il commerciale sceglie il kit motorizzazione tra quelli compatibili con variante e dimensioni; la produzione completa poi staffe, adattatori e componenti derivati.

Questo esempio mostra come un solo modello tenda generi percorsi diversi senza sviluppo custom: le regole sono configurate una volta e il wizard guida l’utente verso scelte coerenti.

3.3 Architettura logica

flowchart TB Utenti[Utenti e reparti] --> Interfaccia[Interfaccia guidata] Interfaccia --> Commerciale[Modulo Commerciale] Interfaccia --> Produzione[Modulo Produzione] Commerciale --> RegoleDecisioni[Regole e decisioni] Produzione --> RegoleDecisioni RegoleDecisioni --> Dati[Dati e storico] Commerciale --> Integrazioni[Integrazioni esterne] Produzione --> Integrazioni Integrazioni --> Odoo[Odoo] Integrazioni --> Macchine[Macchine e file produzione]

4. Macro-modulo Commerciale

Gestisce tutto ciò che precede la conferma del preventivo e la fattibilità tecnico-commerciale.

4.1 Sottoaree

Sottoarea	Funzionalità
Anagrafiche clienti	Sync con Odoo (ricerca, import, associazione), listini e scontistica personalizzati, allineamento periodico dati
Commesse	Creazione, template commessa, associazione cliente, storico
Preventivi	Creazione, template preventivo, duplica, archivia, versionamento
Configuratore tenda	Wizard guidato: modello, variante, dimensioni, colore, kit motorizzazione, accessori principali, filoguidatura, magneti, caratteristiche generali
Fattibilità e revisione	Controllo tenda per tenda: fattibilità tecnica, coerenza prezzi, esito (approvato / respinto / da rivedere), percentuale avanzamento
Gestione cliente	Invio preventivo, trattativa (scontistica con revisione), accettazione/rifiuto (totale o parziale)
Documenti	PDF preventivo, allegati, note, storico modifiche

4.2 Cosa vede e fa il commerciale

Il commerciale configura la tenda attraverso un wizard guidato: ogni scelta abilita o limita le successive in base a regole configurate. Non deve conoscere tutte le combinazioni tecniche.

Scelte del commerciale:

Modello tenda e variante (oscurante, decorativa, accoppiata, ecc.)
Dimensioni (larghezza, altezza)
Colore
Kit motorizzazione
Accessori principali (fondale, binario, filoguidatura, magneti)
Caratteristiche generali

Cosa NON fa il commerciale:

Scelta della staffa specifica
Selezione componenti tecnici derivati (disco motore, ruota, corona in base a rullo)
Dettagli di consumabili, viti, bulloni
Compensazioni e detrazioni produttive

Questi dettagli vengono risolti automaticamente dalle regole di configurazione o completati in fase produzione.

4.3 Workflow stati preventivo

Stato	Descrizione
Bozza	Venditore salva in bozza
Creato	Preventivo salvato, in attesa di revisione
In revisione	Revisore controlla tenda per tenda
Controllato	Tutte le tende verificate
Inviato al cliente	Preventivo approvato e inviato
In trattativa	Scontistica aggiuntiva con revisione
Accettato / Rifiutato	Esito cliente (totale o parziale → nuovo preventivo)

Il sistema mostra: approvato X%, N tende rifiutate per fattibilità, M per incoerenza prezzi.

5. Macro-modulo Produzione

Si attiva dopo conferma/accettazione del preventivo. Trasforma il prodotto vendibile in prodotto realizzabile.

5.1 Sottoaree

Sottoarea	Funzionalità
Attivazione produzione	Passaggio da preventivo confermato, registrazione acconto/contratto
Configurazione tecnica	Risoluzione dettagli produttivi: staffe, componenti specifici, varianti colore articolo, accessori tecnici, consumabili
Rilievo misure	App offline per rilievo misure e note testuali; sincronizzazione al ripristino della connessione; storico rilievi; possibili variazioni da validare
Distinta materiali (BOM)	Per singola tenda (es. SX100 123 TN1), non per intera commessa
Calcoli produzione	Sartoria, taglio (plastica, alluminio, tessuto tecnico), saldatura, assemblaggio
Lavorazioni	Linee produttive, attività per modello tenda, dipendenze tra fasi, vincoli a cascata
Operatori	Account dedicati, presa in carico lavorazione, aggiornamento stati, richiesta assistenza
Prelievo materiali	Notifica a Odoo/magazzino, distinzione componenti prelevabili e non
Output macchina	File CSV per tagliatori (OptCut), tracciati per reparto
Dashboard produzione	Stato tende, avanzamento, storico

5.2 Fasi rilievo misure e sblocco produzione

Ogni fase di rilievo sblocca lavorazioni specifiche:

Fase rilievo	Effetto
Conferma colore	Notifica automatica a magazzino Odoo
Misura larghezza	Sblocca taglio binari/profili
Misura altezza	Sblocca preparazione tessuti
Dimensione teatrino	Sblocca assemblaggio tenda

Esempio: flusso lavorazioni con dipendenze

Schema di riferimento per una tenda a rullo con tessuto tecnico (taglieria OptCut) e binario in alluminio. Le fasi di rilievo sbloccano le lavorazioni; alcune lavorazioni dipendono da altre (es. assemblaggio solo dopo taglio e sartoria completati).

flowchart TB subgraph rilievi [Fasi rilievo misure] R1[1. Conferma colore] R2[2. Misura larghezza] R3[3. Misura altezza] R4[4. Dimensione teatrino] end subgraph sblocco [Lavorazioni sbloccate] L0[Notifica magazzino Odoo] L1[Taglio profili binario - alluminio] L2[Taglio tessuto tecnico - OptCut] L3[Sartoria - cucitura telo] L4[Saldatura componenti] L5[Assemblaggio tenda] L6[Controllo e chiusura] end R1 --> L0 R2 --> L1 R3 --> L2 R3 --> L3 R4 --> L5 L1 --> L5 L2 --> L3 L3 --> L5 L4 --> L5 L5 --> L6 R2 -.->|genera CSV| OptCut[File taglio macchina] L1 -.->|genera CSV| OptCut

Legenda del flusso

Lavorazione	Sbloccata da	Dipende da	Reparto
Notifica magazzino Odoo	Conferma colore	—	Integrazione
Taglio profili binario	Misura larghezza	—	Taglio alluminio
Taglio tessuto tecnico	Misura altezza	—	Taglio tessuti / OptCut
Sartoria	Misura altezza	Taglio tessuto (se tecnico)	Sartoria
Saldatura	Configurazione tecnica	—	Saldatura
Assemblaggio tenda	Dimensione teatrino	Taglio binario, sartoria, saldatura	Assemblaggio
Controllo e chiusura	Assemblaggio completato	Assemblaggio	Produzione

Il responsabile produzione vede per ogni tenda quali lavorazioni sono disponibili, in attesa o bloccate. Gli operatori possono prendere in carico solo le lavorazioni i cui prerequisiti sono soddisfatti. Le dipendenze e i reparti sono configurabili per modello tenda (es. tenda a pacchetto senza OptCut: la sartoria parte direttamente dopo il rilievo altezza).

5.3 Stati produzione

Rilevo misure (fase 1–4), pianificato, errore in produzione, mancanza merce, in esecuzione, finito, richiesta assistenza.

Il responsabile produzione vede tutte le tende di preventivi confermati e può modificare gli stati. Gli operatori prendono in carico le singole lavorazioni (con eventuali aggregazioni generate dal sistema o su scelta dell’operatore).

5.4 Calcoli di produzione

Basati sul foglio calcoli-produzione.numbers:

Area	Output
Sartoria	Larghezza, altezza, H luce, H finita, teatrino, compensazione, scarto, quantità cadute — PDF esportabile
Taglio	Profili, tondini, tessuti tecnici — per categoria (plastica, alluminio, ferro, tessuto tecnico)
Saldatura	Come taglio, macchinari diversi
Assemblaggio	Come precedenti, macchinari diversi

Ogni lavorazione include: area, descrizione, task con macchinario, componenti/accessori da prelevare (inclusi consumabili).

6. Regole, decisioni e configuratore

6.1 Concetto

L’approccio non prevede logiche fisse per ogni tenda, ma un insieme di regole e decisioni organizzato in un processo decisionale con due livelli:

Livello	Uso
Commerciale	Guida la composizione vendibile: scelte comprensibili, vincoli visibili, errori segnalati
Produzione	Completa la configurazione tecnica: componenti derivati, detrazioni, quantità, distinta

6.2 Struttura delle regole (esempio)

Cataloghi base
  ├── Modelli tenda (con varianti, parametri produzione, range dimensioni)
  ├── Kit motorizzazione (componenti, famiglie, vincoli)
  ├── Accessori (con componenti aggregati, famiglie, obblighi min/max)
  ├── Fondali, binari, filoguidatura, steccatura, magneti
  ├── Tessuti (tecnico → taglieria, comune → sartoria)
  ├── Componenti (da Odoo, con tipologia: componente, profilo, consumabile, catenella, filo, ecc.)
  ├── Colori e varianti colore articolo (MU629.B, MU629.N, MU629.R9010O)
  └── Costi orari e listini

Regole e vincoli
  ├── Compatibilità (modello × variante × dimensione × colore × rullo)
  ├── Obbligatorietà (famiglia staffa: min 2, famiglia giunti: max 1)
  ├── Range applicabilità (staffe 0–1000mm, kit motorizzazione per diametro rullo)
  ├── Condizioni (motore MU35 + supporti TE067 → disco nero; + piastre → disco SP)
  ├── Non addebitato al cliente (staffe, viti in produzione ma non in preventivo)
  └── Non prelevabile (escluso da lista magazzino verticale)

Formule
  ├── Quantità (fissa, per metro, perimetro, area, per caduta × tondino)
  ├── Detrazioni e compensazioni (aria, aria rullo, scarto, compensazione L/H)
  ├── Costi (componenti + tessuto al m² + manodopera in minuti × costo orario)
  └── Lavorazioni e distinta materiali

6.3 UI configuratore

Wizard commerciale: step sequenziali, solo opzioni valide mostrate, segnalazione conflitti
Pannello amministrazione: creazione/modifica cataloghi, regole, vincoli, formule
Simulatore formule: test in tempo reale con input e confronto risultato atteso (vedi sezione 9)

6.4 Gestione componenti da Odoo

Passo	Azione
Import	Da anagrafica prodotti Odoo (codice, nome, descrizione, prezzo)
Accettazione	Utente conferma range applicabilità, prezzo, flag non addebitato
Sync notturno	Check modifiche Odoo → notifica responsabile → aggiorna/archivia/crea nuovo
Varianti colore	Mappatura codice base + suffisso colore (B, N, A, R+RAL)
Policy archiviazione	Componente aggiornato: vecchio visibile su modelli esistenti, nuovo su modelli futuri

6.5 Diagramma processo decisionale

flowchart LR CataloghiBase[Cataloghi base] --> Regole[Regole e vincoli] Regole --> WizardCommerciale[Wizard commerciale] Regole --> ConfigProduzione[Configurazione produzione] WizardCommerciale --> PreventivoValido[Preventivo validabile] ConfigProduzione --> Formule[Formule produzione] Formule --> RisultatoCalcolato[Risultato calcolato] CasiCampione[Casi campione validati] --> RisultatoAtteso[Risultato atteso] RisultatoCalcolato --> Verifica{Confronto} RisultatoAtteso --> Verifica Verifica -->|OK| FormulaValidata[Formula validata] Verifica -->|Errore| RevisioneRegola[Revisione regola] RevisioneRegola --> Regole

7. Workflow target

7.1 Flusso operativo generale

flowchart LR Cliente[Cliente] --> Commessa[Commessa] Commessa --> Preventivo[Preventivo] Preventivo --> ConfigCommerciale[Configurazione commerciale] ConfigCommerciale --> Fattibilita[Fattibilita tecnico commerciale] Fattibilita --> Revisione{Esito revisione} Revisione -->|Da rivedere| Preventivo Revisione -->|Approvato| InvioCliente[Invio al cliente] InvioCliente --> EsitoCliente{Esito cliente} EsitoCliente -->|Accettato| Produzione[Avvio produzione] EsitoCliente -->|Rifiutato o parziale| RevisioneCommerciale[Revisione commerciale] Produzione --> Rilievi[Rilievo misure] Rilievi --> BOM[Distinta e calcoli] BOM --> Lavorazioni[Lavorazioni reparto] Lavorazioni --> Chiusura[Chiusura commessa]

7.2 Passaggio tra macro-moduli

flowchart TB subgraph areaCommerciale [Modulo Commerciale] Clienti[Clienti] Commesse[Commesse] Preventivi[Preventivi] Wizard[Wizard configurazione] FattibilitaCheck[Fattibilita e prezzi] end subgraph areaProduzione [Modulo Produzione] Conferma[Conferma preventivo] Rilievo[Rilievo misure] ConfigTecnica[Configurazione tecnica] Distinta[BOM per tenda] Reparti[Lavorazioni e reparti] end Cataloghi[Cataloghi e regole] --> Wizard Cataloghi --> ConfigTecnica Wizard --> FattibilitaCheck FattibilitaCheck --> Conferma Conferma --> Rilievo Rilievo --> ConfigTecnica ConfigTecnica --> Distinta Distinta --> Reparti

7.3 Esempio confine commerciale / produzione

Aspetto	Commerciale	Produzione
Modello tenda, variante	Sceglie	Usa
Dimensioni	Inserisce (stima)	Conferma (rilievo reale)
Colore	Sceglie	Conferma
Kit motorizzazione	Sceglie	Risolve componenti derivati
Accessori principali	Sceglie	Completa con componenti tecnici
Staffe, viti, consumabili	Non vede	Risolve automaticamente o manualmente
Compensazioni, detrazioni	Non gestisce	Calcola
BOM	Genera prima impegnativa	Genera per tenda
Lavorazioni	Non gestisce	Pianifica ed esegue

8. Piano strategico di sviluppo

Ogni fase prevede momenti di confronto con cliente e responsabili di reparto: raccolta esempi reali, validazione flussi, affinamento prima dello sviluppo definitivo.

Fase	Contenuto	Output
0 — Analisi	Inventario regole, formule, flussi reparto; mappatura dati Odoo; priorità; casi campione per tipologia tenda	Documento funzionale validato, backlog prioritizzato
1 — Fondazioni	Piattaforma, utenti/ruoli/permessi, anagrafiche clienti, integrazione Odoo controllata (clienti, componenti)	Ambiente funzionante, sync Odoo base
2 — Regole e configuratore	Cataloghi, configuratore tende, regole compatibilità, vincoli, costi, simulatore formule	Processo decisionale operativo con primi modelli tenda
3 — Commerciale	Preventivi, wizard configurazione, workflow revisione/fattibilità, versionamento, PDF, invio/accettazione	Flusso commerciale end-to-end
4 — Rilievi	App offline per rilievo misure e note, fasi rilievo, storico, variazioni	Rilievo misure operativo su campo
5 — Produzione	BOM per tenda, calcoli (sartoria, taglio, saldatura, assemblaggio), lavorazioni, operatori, prelievo, CSV macchina	Flusso produzione end-to-end
6 — Consolidamento	Dashboard, reporting, ottimizzazioni, test sul campo, pianificazione migrazione dati	Go-live e affinamento

9. Test automatici e validazione formule

Le formule di produzione sono la parte più delicata del progetto. Non verranno solo configurate: verranno validate sistematicamente.

9.1 Casi campione

Per ogni tipologia di tenda o formula critica si definiscono almeno 2 casi campione:

Campo	Contenuto
Input	Modello tenda, variante, dimensioni, colore, kit/accessori, rilievi
Risultato atteso	Componenti, quantità, detrazioni, lavorazioni, costi o misure — validato dal responsabile di reparto
Risultato calcolato	Output calcolato dal sistema di regole e formule
Esito	Corretto / non corretto, con note di revisione

9.2 Simulatore formule

Schermata dedicata per testare in tempo reale se una regola produce il risultato previsto. Utilizzabile da responsabile tecnico o di reparto senza dover creare un preventivo completo.

9.3 Test automatici ripetibili

I casi campione diventano test automatici eseguibili a ogni modifica alle formule. Se una regola già validata si rompe, il sistema lo segnala prima del deploy.

9.4 Affidabilità delle regole

Questo approccio riduce il rischio su una delle parti più critiche del progetto e garantisce che le regole operative siano replicate correttamente nel software.

10. Rischi, assunzioni e decisioni aperte

Rischio / decisione	Mitigazione
Regole e formule incomplete o ambigue	Fase 0 con esempi reali; casi campione per tipologia; validazione reparto per reparto
Qualità dati Odoo (codici, colori, prezzi)	Policy sync definita con cliente; accettazione manuale import; check notturno
Migrazione dati storici	Fattibile. Insieme definiremo perimetro e modalità (anagrafiche, cataloghi, storico commesse/preventivi). È possibile predisporre un archivio consultabile dell’evolutiva precedente. Non è prevista perdita di dati.
Confine automazione vs scelta manuale in produzione	Definire per ogni tipo componente se risoluzione automatica o intervento operatore
Usabilità configuratore	Potente per amministratore, semplice per commerciale e operatore
Varianti rare o eccezioni storiche	Non nel MVP; backlog post go-live
Versionamento preventivi	Confermare con cliente: nuova versione vs split tende approvate/non approvate
Gestione cambio modello/accessori durante rilievo	Valutare se ammesso e con quale workflow di validazione

Migrazione dati

La migrazione dei dati dall’installazione attuale è fattibile. In fase di consolidamento valuteremo insieme perimetro e modalità (anagrafiche, cataloghi, storico commesse e preventivi). Se utile, si potrà predisporre un archivio consultabile dell’evolutiva precedente. In ogni caso non è prevista perdita di dati.

11. Materiale per preventivo commerciale

11.1 Macroaree stimabili

Macroarea	Deliverable
Fase 0 — Analisi funzionale	Documento requisiti, casi campione, backlog prioritizzato
Fase 1 — Fondazioni	Piattaforma, auth, anagrafiche, sync Odoo base
Fase 2 — Regole e configuratore	Cataloghi, regole, vincoli, formule, simulatore
Fase 3 — Commerciale	Preventivi, wizard, revisione, PDF, workflow cliente
Fase 4 — Rilievi	App offline, rilievo misure e note, storico
Fase 5 — Produzione	BOM, calcoli, lavorazioni, operatori, prelievo, CSV
Fase 6 — Consolidamento	Dashboard, migrazione, ottimizzazioni

11.2 Criteri di accettazione (alto livello)

Commerciale crea preventivo guidato senza errori di compatibilità
Revisore approva/respinge tenda per tenda con motivazioni
Preventivo confermato passa a produzione con dati coerenti
Rilievo misure funziona offline e sblocca lavorazioni
BOM generata per singola tenda con componenti e quantità corrette
Almeno 2 casi campione validati per ogni tipologia tenda nel MVP
Integrazione Odoo operativa per clienti e componenti

11.3 Nota sulla stima

Data la complessità del dominio, si consiglia una fase iniziale di analisi/prototipo (Fase 0) prima della stima economica definitiva delle fasi successive. Questo permette di quantificare con maggiore precisione il perimetro delle regole e delle formule.

12. Chiarimento MVP — prima versione operativa

12.1 Cosa deve fare l’MVP

Gestire clienti, commesse e preventivi in un flusso ordinato
Permettere al commerciale di configurare una tenda con scelte guidate: modello, variante, dimensioni, colore, kit motorizzazione, accessori principali, filoguidatura, magneti e caratteristiche generali
Applicare regole base di compatibilità e segnalare dati mancanti, incoerenze o scelte da verificare
Gestire la fattibilità tecnico-commerciale tenda per tenda, con esito approvato, respinto o da rivedere
Gestire stati principali del preventivo: bozza, creato, in revisione, controllato, inviato al cliente, accettato/rifiutato
Passare un preventivo confermato al modulo Produzione
Consentire alla produzione di completare i dettagli tecnici: componenti specifici, staffe, consumabili, varianti colore articolo e regole produttive
Gestire rilievi misure essenziali, anche con predisposizione offline: larghezza, altezza, colore, teatrino e note testuali
Generare distinta materiali e lavorazioni base per singola tenda
Integrazione Odoo essenziale per clienti e componenti/articoli, con sync controllato e tracciabile
Test automatici sulle formule principali, con almeno 2 casi campione validati per tipologia/regola critica
Produrre PDF preventivo e viste operative essenziali per commerciale, revisore e produzione

12.2 Cosa può essere semplificato nell’MVP

Dashboard e analytics avanzate
Automazioni complete su tutte le casistiche di produzione
Gestione completa di ogni variante rara o eccezione storica
Ottimizzazioni avanzate macchina/file produzione oltre ai flussi prioritari
Definizione del perimetro di migrazione dati (modalità da concordare in Fase 6; vedi sezione 10)

12.3 Cosa rimane obiettivo della fase successiva (panoramica di esempio)

Raffinamento di tutte le regole specialistiche dopo test con casi reali
Estensione dei workflow reparto per reparto
Reporting avanzato e KPI direzionali
Automazioni più spinte verso Odoo, magazzino e macchine
Ampliamento libreria test formule e validazioni automatiche
Allegati su modelli tenda, kit, componenti (e.g. manuali)
Gestione cambio modello/accessori durante rilievo misure
Note avanzate nelle schede di produzione

Riferimenti

Documento	Contenuto
note-evolutiva.md	Requisiti evolutivi principali
note-tecniche.md	Intenzione architetturale
appunti-cliente.md	Richieste operative e bug attuali
calcoli-produzione.numbers	Formule produzione (sartoria, taglio, saldatura, assemblaggio)
Analisi codebase CRS	Analisi tecnica del sistema attuale