# CNC Lab — roadmap tecnica e di prodotto Aggiornata al 5 novembre 2026. ## Obiettivo Aggiornamento applicativo 0.31.0: la piattaforma dispone ora di compensazione raggio G41/G42 continua su linee e archi G02/G03, registri D selezionabili e origini G54-G59 indipendenti. Tabelle e trasformazioni sono condivise da parser, interfaccia, storage e formato progetto `.cnclab`; la suite browser-native ne verifica geometria, persistenza e integrazione con renderer e worker. Filetti e godronature dispongono oggi di geometria e trama rappresentativa, ma non costituiscono ancora una geometria micrometrica certificabile. Questa precisione resta parte della milestone di tornitura avanzata. CNC Lab deve evolvere da prototipo web a piattaforma modulare per formazione, simulazione preliminare e onboarding industriale. Lo stesso motore deve alimentare prodotti separabili: Fresatura, Tornitura, Laser, Plotter, Additive, Education e Business. Il prodotto rimane un simulatore formativo finché accuratezza geometrica, collisioni e dialetti non saranno validati su macchine reali. Nessuna release deve presentarsi come verificatore certificato senza evidenze, tolleranze dichiarate e procedure di convalida. ## Stato attuale — versione 0.31.0 ### Piattaforma - Applicazione interamente browser, installabile come PWA e distribuibile come sito statico. - Landing page e caricamento selettivo dei moduli per fresa, tornio, laser e plotter. - Loader organizzato in cinque stadi di dipendenza, con download parallelo e telemetria locale del bootstrap. - Registry separati per macchine, pacchetti e bundle commerciali. - Fresatura CNC e Tornitura CNC classificate Pre-alpha; Laser e Plotter classificati In sviluppo. - CAD 2D/3D e Circuit Lab classificati In sviluppo; Idrogetto, Stampa 3D FDM e ambiente CAD/CAM autonomo classificati In arrivo. - Accesso consentito soltanto agli applicativi Pre-alpha e In sviluppo; i prodotti In arrivo restano visibili ma non avviabili. - CAD parametrico 2D/3D disponibile come applicativo separato: schizzi modificabili, disegno interattivo ed estrusioni WebGL costituiscono il primo nucleo operativo; vincoli e operazioni solide avanzate restano evoluzioni successive. - UI responsive con menu applicativi e pannelli ridimensionabili, rimovibili e ripristinabili senza stati intermedi compressi. ### Programmazione e controllo - Editor G-code con evidenziazione, suggerimenti, autocompletamento, import/export NC e collegamento fra traiettoria e riga sorgente. - Profilo ISO/Fanuc didattico con interpolazioni G00–G03, archi I/J/K o R, piani G17/G18/G19, unità, coordinate assolute/incrementali, riferimenti macchina, origini pezzo G54-G59 e compensazione raggio continua G41/G42 su linee e archi nei piani ammessi. - Cicli G73/G81/G82/G83/G84/G85/G86/G89, ritorni G98/G99, avanzamenti G93/G94/G95 e CSS tornio G96/G97 con limite G50. - Funzioni macchina principali per mandrino, refrigerante, arresti, orientamento e cambio utensile M06. - Pannello MEM/MDI/JOG/EDIT, step jog da 100 a 0,001 mm, override, timeline e diagnostica. - Manuale G/M/T/S/F con stato di supporto, esempi validati e anteprime animate 2D/3D. ### Geometria e visualizzazione - Renderer WebGL 2 con depth buffer, camera orbitale, pan, zoom e viste ortografiche. - Illuminazione PBR-lite, griglia adattiva, percorso futuro/in corso/completato e selezione visuale dei blocchi. - Bordi geometrici, trasparenza del componente e percorsi ribbon a spessore regolabile sempre visibili attraverso il pezzo. - Kernel CAD/CAM 2.5D incrementale a height-map per fresatura. - Mesh residua indicizzata, interpolazione delle transizioni e profili di qualità. - Tornio orizzontale con asse mandrino Z, autocentrante sul lato negativo, utensile X/Z e ricostruzione di rivoluzione. - Kernel tornio condiviso da vista ed export con raggio punta, larghezza gola, profondità massima per passata e controllo spallamenti. - Inserti C/D/V/gola orientabili per M03, M04 o entrambi; torretta configurabile sopra/sotto asse e allineamento fra punta renderizzata e profilo asportato. - Modello didattico di carico, temperatura e usura utensile con allarmi, colore termico e stop protettivo. - Utensili visibili e differenziati, rotazione fresa disattivabile; catalogo tornio con utensili esterni/interni, filettatura, gole e punte assiali, magazzino, utensili personalizzati e cambio utensile animato. - Esportazione del componente lavorato come solido chiuso in STL binario, OBJ e PLY, a fine programma o allo stato corrente, con tolleranza manufacturing indipendente dalla risoluzione grafica. ### Limiti noti - Il kernel fresa è 2.5D: non gestisce sottosquadri, teste inclinate o lavorazioni simultanee oltre tre assi. - Le compensazioni G41/G42 e G43 non equivalgono ancora alle regole complete di uno specifico controllo. - Mancano macro, variabili, sottoprogrammi e cicli tornio proprietari. - Collisioni con macchina, mandrino, portautensile e staffaggi non sono ancora validate. - Tempi ciclo non includono accelerazioni, jerk, look-ahead e logiche PLC reali. - L’export 3D è una mesh triangolata entro una tolleranza, non un modello CAD B-Rep parametrico. - Carico, calore, usura e rottura sono stime formative, non un modello FEM o un sistema di monitoraggio macchina certificato. ## Versione 0.29 — consolidamento e prestazioni Obiettivo raggiunto: ridurre accoppiamento e lavoro ripetuto senza imporre una toolchain di build alla distribuzione statica. - Renderer WebGL separato in geometria comune, utensili, mesh tornio e gestione GPU. - Validazione grezzo e stato moto estratti dal bootstrap applicativo. - Cache della mesh tornio e riuso dei buffer GPU per frame equivalenti. - Lookup utensili indicizzato nei kernel e scansione della foratura circoscritta alla zona attiva. - Bundle macchina alleggeriti e caricamento delle dipendenze per stadi paralleli. - Test core portati a 52 casi e smoke test per cache e confini dei bundle. Attività che proseguono nel ciclo di affidabilità: - Formalizzare `cnclab-iso-fanuc-edu-v1` con gruppi modali, precedenze e comportamento atteso di ogni blocco. - Separare parser, interprete modale e generatore di eventi cinematici. - Implementare sottoprogrammi M98/M99, numeri di sequenza, variabili locali di base e limiti di ricorsione. - Aggiungere tabelle persistenti per G54–G59, correttori H/D e secondo riferimento G30. - Portare parsing e calcolo CAD/CAM in Web Worker per mantenere fluida la UI. - Introdurre test Playwright automatici, golden program, visual regression e benchmark. - Validare almeno 30 programmi anonimizzati contro due controlli o simulatori industriali. Criteri di uscita: - nessuna regressione nei programmi golden; - sessioni senza crash ≥ 99,5%; - parsing di 100.000 blocchi senza bloccare il thread UI; - matrice supporto pubblica e versionata. ## Versione 0.30 — motore CAD/CAM avanzato Obiettivo: superare visivamente e geometricamente i limiti della height-map uniforme. - Griglia adattiva o sparse voxel octree nelle sole zone lavorate. - Mesh dual contouring/marching cubes con normali continue e controllo della tolleranza. - Modello utensile composto da tagliente, gambo e portautensile. - Asportazione con frese cilindriche, sferiche, toriche, coniche, punte e utensili personalizzati. - Ricostruzione più accurata di pareti verticali, raccordi, fori e cuspidi residue. - WebGPU opzionale con fallback WebGL 2; calcolo in Worker/WASM. - Cache geometrica per blocchi e aggiornamento incrementale durante editing e timeline. - Export STL/OBJ/PLY ottimizzato, GLB con materiali e 3MF con unità e metadati. - Riparazione mesh: normali, bordi aperti, triangoli degeneri e verifica manifold. Criteri di uscita: - errore geometrico dichiarato e configurabile; - 30 FPS durante la simulazione su notebook didattico di fascia media; - export manifold verificato automaticamente; - stress test complesso entro budget di memoria definito. ## Versione 0.35 — macchina, staffaggio e collisioni Obiettivo: passare dalla sola lavorazione del pezzo alla simulazione della cella. - Libreria portautensili, pinze, mandrini, morse, griffe e staffaggi. - Import di geometrie STEP/STL/GLB per pezzo e attrezzaggio. - Albero cinematico parametrico per assi, corse, limiti e punti di cambio utensile. - Collisioni utensile–pezzo, gambo–pezzo, portautensile–pezzo e macchina–staffaggio. - Distanza minima, arresto sulla collisione e collegamento al blocco sorgente. - Accelerazioni, rapidi, cambio utensile e tempi ausiliari configurabili. ## Versione 0.40 — tornitura avanzata Obiettivo: portare il tornio allo stesso livello della fresatura. - Cicli di sgrossatura, finitura, gole, filettatura e foratura assiale tramite profili dialetto. - Torretta reale, correttori utensile, orientamento inserti e raggio punta. - Mandrino, contropunta e autocentrante parametrico. - Collisioni e controllo delle prese sulle griffe. - Profilo residuo adattivo con gole e raccordi più accurati. - Supporto opzionale asse C e utensili motorizzati in una milestone successiva. ## Versione 0.50 — CNC Lab Additive Obiettivo: introdurre la stampa 3D senza mescolare impropriamente processi sottrattivi e additivi. Prima release FDM: - interprete G-code RepRap/Marlin per X/Y/Z/E; - modalità estrusore assoluta e relativa, retrazioni e travel move; - temperature hotend e piatto, ventola, homing e livellamento rappresentativo; - profili stampante, volume utile, diametro ugello e filamento; - visualizzazione progressiva per layer della deposizione estrusa; - colori distinti per perimetri, riempimento, supporti, bridge e travel; - statistiche su tempo, materiale, massa e costo stimato; - warning per movimenti fuori volume, estrusione a freddo e collisioni semplificate; - import G-code prodotto da slicer esterni. Seconda release Additive: - confronto layer, analisi flusso e velocità volumetrica; - simulazione semplificata di raffreddamento, overhang e bridging; - profili multi-materiale e cambio filamento; - esportazione del deposito simulato in mesh. Uno slicer completo da STL/3MF non è incluso nella prima release: verrà valutato come modulo separato dopo la validazione del simulatore G-code additivo. ## Versione 0.60 — prodotto Education Obiettivo: trasformare il simulatore in uno strumento didattico acquistabile. - Account, organizzazioni, classi e ruoli docente/studente. - Esercizi versionati, obiettivi, tentativi, rubriche e correzione automatica. - Modalità guidata, step-by-step, breakpoint e spiegazione contestuale degli errori. - Dashboard docente, progressi, esportazione report e certificati. - Italiano e inglese; accessibilità WCAG 2.2 AA. - Integrazioni LTI 1.3 e SCORM. - Salvataggio cloud e sincronizzazione PWA offline. Criteri di uscita: - almeno tre scuole pilota paganti; - completamento esercizi ≥ 70%; - misurazione pre/post delle competenze; - strumenti privacy e gestione dati conformi al GDPR. ## Versione 0.70 — prodotto Business Obiettivo: supportare onboarding e procedure aziendali. - Multi-tenant, ruoli granulari, audit log e versionamento programmi. - Academy privata, procedure operative, programmi approvati e assessment. - SSO OIDC/SAML, SCIM e policy di conservazione dati. - API e webhook; integrazioni MES, PLM, LMS e object storage. - Macchine e pannelli white-label versionati. - Telemetria tecnica: errori, tempi, collisioni, avanzamento e competenze. - SLA, backup, disaster recovery e data residency UE. ## Versione 1.0 — piattaforma avanzata La versione 1.0 è raggiunta quando: - i profili dialetto pubblicati superano suite golden e validazione documentata; - renderer e kernel rispettano tolleranze e budget prestazionali dichiarati; - collisioni, offset e cinematiche hanno copertura automatica; - Education e Business condividono lo stesso motore con entitlement separati; - sicurezza, accessibilità, privacy, backup e osservabilità sono operative; - documentazione, changelog e compatibilità file sono versionati; - almeno 15 clienti mantengono una retention trimestrale ≥ 90%. La certificazione per verifica produttiva resta un percorso distinto, con partner industriali, responsabilità contrattuali, tracciabilità dei dati macchina e test di conformità dedicati. ## Priorità operative immediate 1. Automatizzare suite browser e benchmark in CI. 2. Completare specifica e golden test del profilo ISO/Fanuc didattico. 3. Spostare kernel e parsing fuori dal thread principale. 4. Validare e riparare automaticamente le mesh esportate. 5. Prototipare il parser additivo X/Y/Z/E e il renderer per layer. 6. Avviare due design partnership: una scuola e un’azienda. 7. Misurare accuratezza, frame time, memoria, crash e completamento dei task. ## Strategia commerciale indicativa | Pacchetto | Destinatari | Contenuto | |---|---|---| | Free | Studenti e maker | Sandbox, esempi e manuale | | Milling / Turning / Laser / Additive | Singoli e laboratori | Modulo macchina separato | | Education | Scuole, ITS e CFP | Macchine, corsi, classi e report | | Business | Aziende | Academy, programmi privati, analytics e SSO | | Enterprise / OEM | Costruttori e rivenditori | Macchine personalizzate, API, SLA e white-label | Prezzi e packaging devono essere validati con piloti paganti, non soltanto tramite questionari.