🔧 Cicli di lavorazione — vista dedicata alle parti: in alto la scelta della parte con i filtri per famiglia, sottofamiglia e testo; sotto la distinta parte (materie prime e commerciali necessari) e il ciclo di lavorazione (fasi 10, 20, 30… riordinabili con ↑ ↓). In testa una riga dice da dove viene il costo di quella parte, secondo il suo approvvigionamento. Ogni modifica si salva subito.

⚙ Carico dei centri di lavoro (Pianificazione → Carico centri) — le ore che i piani chiedono a ciascun centro, settimana per settimana, contro una capacità dichiarata sul centro in ore/settimana. Tavola centro × settimana con la saturazione in percentuale, il sovraccarico in rosso e il riepilogo delle settimane sfondate con i centri nominati; da ogni cella si apre il dettaglio di chi ha portato quelle ore — parte, fase, piano. Somma tutti i piani aperti, perché il centro è condiviso e un piano solo non dice se regge; si può restringere a un piano solo, e la stessa tavola sta in fondo alla scheda di ogni piano. Sopra la tavola un grafico a barre per centro — una barra per settimana, la capacità come linea, gli stessi colori della tavola — che serve a dire dove guardare: ogni barra porta comunque il suo numero, e la tavola resta la lettura esatta. Sotto, i codici da produrre: codice, pezzi, settimana e le fasi interne con ore/pezzo e ore totali, ordinati per settimana e per ore decrescenti — la domanda è «cosa lancio per primo». Cliccando il nome di un centro le due letture si restringono a quello. Export Excel e PDF in forma lunga, con due sezioni: il carico per centro/settimana e i codici per codice/fase/settimana, pronte da pivotare. I pezzi di un codice non si sommano fra le sue fasi — ogni fase lavora gli stessi pezzi — mentre le ore sì. Due cose vanno dette perché il prospetto non prometta più di quel che dà. La capacità è infinita: il sovraccarico si vede, non si sposta. Dalla 0.88.0 le ore stanno nella settimana in cui la fase comincia, programmata a ritroso dalla consegna sul calendario di fabbrica (prima stavano in quella in cui il pezzo serve pronto): le date dicono quando ogni fase deve partire perché la consegna regga, non spostano niente per far posto. Le fasi in conto lavoro non caricano nessun centro interno: quelle si comprano, e stanno nel fabbisogno. Un centro senza capacità dichiarata mostra le ore e non il sovraccarico: zero significa «non dichiarata», non «nessuna capacità».

🌳 Distinta base → Visualizza DB — costificazione: incidenza delle voci di costo e distinta esplosa; export PDF ed Excel.

📨 Documenti → Fabbisogno materiali — piani di produzione salvati (3 × macchina A, 2 × macchina B): le distinte si esplodono e si sommano in una lista d'acquisto consolidata, raggruppabile per fornitore, più l'elenco delle parti da fabbricare e quello delle lavorazioni da far fare fuori. Da qui si generano richieste di offerta e ordini, un documento per fornitore, scegliendo quali righe includere. Il fabbisogno netto toglie quello che è già a magazzino, quello già ordinato e quello impegnato dagli altri piani aperti, così due piani non si dichiarano coperti con la stessa merce; un piano che non serve più si chiude (🔓) e la sua quota torna libera. Export Excel e PDF.

🔧 Conto lavoro → 🛠 Ordini di lavoro (ODL) — una fase del ciclo con un fornitore è una lavorazione affidata a un terzista, ed è denaro che esce come qualunque acquisto: entra nel fabbisogno accanto al materiale, in una sezione sua, e da lì si genera un ordine di lavoro — un documento a parte, con numerazione ODL-anno-NNN, elenco proprio e stampa propria. Gli ordini d'acquisto (ODA) restano quello che erano: comprano merce, e non contengono lavorazioni. Uno per terzista e per passata: le fasi affidate a Beta in un ODL solo, anche di parti diverse, ma un pezzo che torna da Beta una seconda volta — fasi 20 e 40 con la 30 in mezzo altrove — finisce in un secondo ODL, perché fra le due il pezzo torna da noi e chiedergliele insieme sarebbe un ordine che non si può eseguire di seguito. La richiesta d'offerta invece le tiene insieme: chiedere non è commissionare. Una riga è una tratta: le fasi consecutive dello stesso terzista stanno insieme — «fasi 20-30» — perché sono una lavorazione da commissionare e non due, col prezzo e i giorni sommati e il dettaglio di ciascuna nella nota. La riga porta il codice della parte (è il pezzo che il terzista riceve e rispedisce), i pezzi come quantità e la tariffa del ciclo come prezzo; a costo orario la nota dice ore/pezzo × tariffa. Un ODL si può anche scrivere a mano, senza passare da un piano: + Lavorazione da ciclo fa scegliere la parte fra quelle che un ciclo ce l'hanno, poi la tratta e i pezzi. Si vedono tutte le fasi — anche quelle di un altro terzista e quelle interne, marcate — perché mandare fuori una lavorazione che di solito si fa in casa è un caso vero. La riga che ne esce è identica a quella generata dal fabbisogno; l'ordine però non è legato a nessun piano, e lì la fase continuerà a risultare da ordinare. Le fasi senza fornitore sono interne e restano fuori: non si comprano, si vedono nel Carico centri. Una richiesta di offerta invece può contenere insieme materiale e lavorazioni dello stesso fornitore — chiedere quanto costa il pezzo e quanto costa lavorarlo è una domanda sola. Convertendola, la richiesta si divide nei due ordini. Il fabbisogno netto non si applica alle lavorazioni, ed è dichiarato in pagina: una fase non sta a scaffale. Dalla 0.74 i pezzi già lavorati l'app li sa — glieli dicono gli ordini di produzione — ma nettare una fase richiede di decidere cosa fare di quelle coperte da ordini di altri piani, che è la stessa discussione dell'impegnato sul materiale: finché non è fatta, la quantità resta lorda. Nell'ODL il rientrato significa pezzi tornati: porta l'ordine a evaso, non carica il magazzino — quello lo fanno i movimenti di conto lavoro. Il magazzino si muove in due punti soli, e sono i due estremi del ciclo, non quelli del documento: alla prima tratta esterna esce il materiale del ciclo e scarica, all'ultima entra il pezzo finito e carica. Ogni altro estremo è un passaggio: il pezzo cambia posto e la giacenza non si muove. Senza questa distinzione una parte lavorata due volte dallo stesso terzista farebbe uscire il materiale due volte e caricare il pezzo due volte. La scheda propone il residuo — quanto resta da spedire o da far rientrare — e a residuo zero lo dice, invece di riproporre il modulo come se niente fosse. Il materiale esce una volta sola, alla prima fase di ogni parte, ed è quello scritto nel suo ciclo di lavorazione (le stesse righe che il fabbisogno ha già fatto comprare), con le quantità proposte in automatico: q.tà del ciclo × pezzi dell'ordine. I pezzi rientrano una volta, all'ultima fase. Le fasi in mezzo non muovono il magazzino e lo dicono, invece di offrire un comando che farebbe uscire la stessa merce due volte: due fasi dallo stesso terzista sono due lavorazioni sullo stesso pezzo, non due pezzi.

🏭 Documenti → Ordini di produzione (ODP) — il documento che segue una parte lungo il suo ciclo: uno per parte da fabbricare, numerazione ODP-anno-NNN, generato dal fabbisogno (dalla sezione Da fabbricare) oppure scritto a mano. Dentro, le fasi del ciclo congelate in successione: una fase non si avvia finché la precedente non è chiusa, e il rifiuto nomina la fase che blocca con i suoi numeri — «la fase 10 non è chiusa: 6 di 10». Forza avvio resta possibile e pretende un motivo, che finisce nello storico: una forzatura non è un permesso speso e dimenticato. Su ogni fase si dichiarano pezzi buoni e scarti, e solo i buoni proseguono: uno scarto alla prima fase restringe tutte quelle che seguono, e a magazzino entra la resa vera, non la quantità lanciata. Il magazzino si muove in due punti soli, e sono i due estremi del ciclo — vale identico per un ciclo tutto interno, tutto esterno o misto: all'avvio della prima fase escono i codici del ciclo (Consumo di produzione se la fase è interna, Uscita a conto lavoro se è esterna), sull'ultima entra il codice della parte per i pezzi buoni (Versamento di produzione se interna, Rientro da conto lavoro se esterna). Fra le fasi non si scrive niente, ed è la regola che tiene in piedi il resto: un movimento nomina una quantità di un codice, e in mezzo i pezzi non sono più il materiale e non sono ancora la parte — la parte lo diventano al rientro dell'ultima fase. Dove stanno lo dice la fase corrente dell'ordine, che è il posto in cui quella domanda ha davvero una risposta; il prospetto presso terzi legge anche da lì, e lo dichiara. Dalla fase esterna si genera l'ordine di lavoro al terzista, con la tariffa del ciclo e i pezzi che ci sono davvero. Su quella riga i comandi di conto lavoro diventano un rimando all'ordine di produzione: il magazzino ha un padrone solo, e due strade per lo stesso gesto sono due registrazioni. I pezzi rientrati dell'ODL li scrive la dichiarazione sull'ordine di produzione. Il piano continua a generare ordini di lavoro diretti per le fasi non coperte da un ordine di produzione; dove un ODP esiste, la fase risulta «coperta da ODP-…» e l'ordine si genera da lì. Un ordine di lavoro senza ODP si comporta esattamente come prima.

📋 Commesse e copertura materiale — la commessa è il cliente e la data a monte del lavoro, e ci si agganciano piani di fabbisogno, richieste e ordini. La sua scheda dice se il materiale c’è: cosa è ancora da ordinare, cosa sta in un documento non ancora inviato, cosa arriva dopo la data in cui serve. Mettendola In produzione l’app chiede conferma nominando i codici mancanti e la data di consegna — avvisa, non blocca. I piani della stessa commessa si sommano prima di guardare il magazzino: due piani non si contendono la stessa merce. Se non ci sono piani aperti lo dice, invece di dichiarare tutto coperto.

📇 Clienti (Gestione → Clienti) — l'anagrafica a monte delle commesse: nome, referente, email, telefono, P.IVA, indirizzo e note. I nomi si propongono nel campo Cliente della commessa, così due commesse dello stesso cliente non si chiamano più «Rossi Srl» e «Rossi S.r.l.». Il nome è unico, rinominarlo allinea le commesse che lo citavano, e un cliente citato da una commessa non si elimina.

💶 Listino fornitori — l'unico posto dove nasce un prezzo d'acquisto. Più quotazioni per articolo (fornitore, codice e descrizione presso il fornitore, prezzo, q.tà minima, giorni di consegna, data), alimentate anche dai prezzi tornati con le richieste di offerta. Vale per commerciali, materie prime e parti. Il prezzo che entra nella costificazione si sceglie esplicitamente dal listino.

🔗 Dove è usato — da ogni articolo si risale a chi lo contiene e alle macchine impattate, con simulazione del costo: si prova un prezzo diverso e si vede subito l'effetto sul costo delle macchine, senza salvare nulla.

📨 Richieste di offerta (RFQ) — una richiesta per fornitore, righe da catalogo o manuali, documento bilingue IT/EN in PDF ed Excel, compilazione dei prezzi al ritorno dell'offerta e confronto offerte tra più richieste.

🧾 Ordini a fornitore (ODA) — generabili da una richiesta, da un piano di fabbisogno o da zero, con prezzi, importi, consegne e registrazione dei ricevimenti (ricevuto/residuo per riga).

Righe di documento a due piani — nelle righe di richieste e ordini le colonne sono coppie, una sopra l’altra: codice/descrizione, quantità/U.M., prezzo unitario/importo, data richiesta/data confermata, ricevuto/residuo, modifica/elimina. Dodici colonne stavano su uno schermo solo a costo di scorrere in orizzontale, e il codice usciva di vista; così le due metà si leggono insieme. Una riga di documento resta un solo rigo di tabella.

Gli elenchi di richieste e ordini si filtrano per stato, fornitore e testo (numero, oggetto, fornitore, note e righe del documento).

Filtro per periodo in tutti e quattro gli elenchi — richieste, ordini, commesse e piani: un intervallo dal … al … sulla data del documento (per le commesse, la data di apertura), aperto anche da un lato solo. Entra nel conteggio e finisce scritto negli export dell'elenco.

🔎 Scheda articolo di sola lettura — un click su un codice, in qualunque tabella, apre la scheda completa: anagrafica, listino, costo, magazzino (esistente, impegnato, libero), composizione, dove è usato, documenti e piani in cui compare, revisioni. Non modifica niente, e per questo si può aprire in mezzo a qualunque lavoro; dentro la scheda i codici sono a loro volta cliccabili, con il tasto ← Indietro.

🏭 Avanzamento di produzione — nella tabella Da fabbricare di un piano ogni parte porta due colonne, fatti e restano, e un pulsante che apre la scheda dell'avanzamento: si dichiara quanti pezzi sono stati fatti, con una nota, e resta lo storico di chi ha dichiarato cosa e quando. Non è un campo che si sovrascrive ma una dichiarazione per volta, sommata quando serve — la stessa scelta che l'app fa per la giacenza, che non è un campo ma la somma dei movimenti: un totale che si ricostruisce si può spiegare, e si corregge con una dichiarazione negativa senza riscrivere il passato. La conseguenza che conta è sulle lavorazioni da mandare fuori: una parte dichiarata finita ha già attraversato tutte le sue fasi, quindi sparisce da lì invece di finire in un ordine di lavoro che pagherebbe una seconda volta lo stesso lavoro. Una parte ferma a metà ciclo conta ancora per intero — si dichiara la parte finita, non la fase superata — quindi il conto è prudente per scelta. Dalla 0.105.5 dichiarare pezzi fatti mette la parte a magazzino, con un versamento legato alla dichiarazione (eliminarla lo toglie), e non annulla gli acquisti del piano: il materiale per una parte si compra prima di farla.

📎 Allegati: i PDF stanno in una cartella, non nel database — disegni, schede tecniche e cataloghi appesi a un articolo, dal pulsante 📁 sulla riga di catalogo o dal pannello laterale (Ctrl+I), che ne mostra il numero; accanto, un pulsante apri documento che lo apre in una scheda nuova (con più documenti apre l'elenco, invece di indovinare). L'archivio fisico resta fuori dall'app: una cartella locale, oppure quella di un servizio sincronizzato — OneDrive, Dropbox — già presente su tutti i PC. Bomtrack ne memorizza il percorso relativo, che è un dato come gli altri: entra nel backup JSON e ripristinato altrove continua a valere, purché quel PC abbia la sua copia dell'archivio. Chi aggiorna un disegno lo aggiorna nella cartella, col programma vero, e l'app punta già alla versione nuova. Quale cartella lo decide ogni PC, e non sta nel database: scriverlo lì dentro imporrebbe a tutti la lettera di unità del primo che l'ha configurata. Si sceglie una volta con la finestra di sistema — un browser non apre un percorso scritto a mano, e non lo farà mai — dalla scheda Allegati o da Gestione → Backup. Funziona su Chrome ed Edge e solo se l'app è aperta dal suo indirizzo: con un doppio click su index.html non c'è nessuna origine sotto cui ricordare un permesso, e lì la scheda lo dice in chiaro invece di mostrare un pulsante inerte. Un documento vale per più codici — il catalogo di un commerciale sta appeso a tutti gli articoli di quella serie — quindi è censito una volta sola e i codici ci si collegano: rinominarlo o spostarlo si corregge in un punto («Ricollega»), e i codici che lo citavano seguono. La descrizione appartiene al documento (i nomi dei file dei fornitori non dicono niente, e riscriverla la corregge per tutti), la pagina al singolo collegamento. Scollegare da un codice non è eliminare il documento, e un documento citato non si elimina. Gli esiti dell'apertura sono tre, perché sono tre rimedi diversi: NESSUN DOCUMENTO SALVATO, archivio non impostato su questo PC (col pulsante che lo imposta lì per lì) e DOCUMENTO NON TROVATO, col nome cercato e la cartella dove l'ha cercato. In Gestione → Backup una verifica scorre la cartella e nomina i documenti spariti, una volta per documento e non una per collegamento: il difetto di questo disegno è il collegamento che si rompe in silenzio, e questo è il rimedio. Gli allegati caricati dentro l'app prima della 0.78.0 restano e funzionano, in una sezione loro: di quelli il backup JSON porta l'elenco e non i byte, e vanno riscaricati prima di trasferirsi.

📲 Installabile, e offline per davvero — Bomtrack si può installare come applicazione, con un'icona sua, e una volta aperta funziona senza rete, manuale compreso. Il service worker mette in cache il programma, mai i dati. Aperta con un doppio click su file:// non cambia nulla: lì i service worker non esistono, l'app se ne accorge e tace — ed è la ragione per cui le librerie di export stanno in vendor/ e non nella cache.

📗📄 Export degli elenchi — Magazzino, le due anagrafiche, Cicli, Commesse, Richieste, Ordini e piani di Fabbisogno hanno i pulsanti Esporta Excel ed Esporta PDF. Si esporta quello che si vede: filtri attivi applicati, stesse colonne, e la paginazione a schermo non taglia niente. I filtri finiscono scritti nel file — un foglio Estrazione nell'Excel, una riga sotto il titolo nel PDF — così a distanza di tempo si sa ancora cosa contiene. Il PDF porta la testata azienda e il numero di pagina su ogni pagina; l'Excel l'autofiltro sull'intestazione, i numeri come numeri e le date come date — quindi si ordinano e si filtrano per periodo dentro Excel, non come testo.

Colonne dell’elenco a scelta — in Acquisti, Progetto e Magazzino un pulsante Colonne apre l’elenco delle colonne disponibili: quelle che non servono si tolgono, e restano tolte anche domani. Codice e nome non si nascondono, che sono l’identità della riga. Ogni elenco tiene la sua scelta — le due anagrafiche condividono le colonne di base ma si guardano per motivi diversi, e solo Progetto ospita anche concetto e approvvigionamento, che riguardano solo le parti — e ciò che sparisce dalla tabella resta nel pannello laterale. Oltre alle colonne mostrate di serie, lo stesso pannello ne offre altre — sottofamiglia, fornitore, doppia unità d’acquisto, scorta minima, lotto, note, autore delle modifiche, e per Progetto anche concetto e approvvigionamento — nascoste finché non le si accende: chi non apre mai il pannello continua a vedere l’elenco di sempre. Lo stesso pannello porta anche l’interruttore Dividi l’elenco per famiglia: acceso di serie come oggi (le righe restano sezionate per macrofamiglia, o per tipo negli assiemi), spegnendolo l’elenco torna a una tabella sola. L’export Excel e PDF resta completo: esporta l’elenco, non la vista.

Barra Filtri a scomparsa, con ambito condiviso — in Acquisti, Progetto, Magazzino, Cicli di lavorazione e Gestione DB la barra filtri sta dove è sempre stata ma parte chiusa: mostra solo il pulsante Filtri, le pasticche di ciò che sta restringendo l’elenco in quel momento e, quando c’è qualcosa da togliere, Rimuovi filtri. Aprirla o chiuderla è un’unica scelta per tutta l’app: chi la apre in una vista se la ritrova aperta anche nelle altre. Famiglia, sottofamiglia, macchina e gruppo — dove la vista li ha — sono anche condivisi: sceglierli in Progetto li propone già impostati passando a Magazzino o a Gestione DB, così si può lavorare su un solo set di codici (una macchina, una famiglia) muovendosi fra le viste senza riselezionarlo ogni volta. Una famiglia che in un’altra vista non esiste (materie prime/commerciali contro parti sono ambiti diversi, come nei filtri di sempre) semplicemente non si applica lì. Rimuovi filtri azzera sia i campi di quella vista sia l’ambito condiviso: la restrizione sparisce per davvero, non ricompare cambiando pagina. Fuori da questo meccanismo restano il Carico centri (filtra per piano e centro di lavoro, un altro genere di domanda) e i filtri delle viste documento (Commesse, Fabbisogno, Richieste, Ordini), che restano quelli di sempre nella colonna a destra.

Pannello laterale (Ctrl+I) — una colonna a destra, ridimensionabile trascinandone il bordo, che mostra i comandi eseguibili sulla riga scelta nell’elenco e le schede da consultare (scheda articolo, listino, dove è usato), più un riepilogo con costo, giacenza e impieghi. Vale per Acquisti, Progetto e Magazzino. Con il pannello aperto la colonna dei pulsanti sparisce dall’elenco — i suoi comandi sono nel pannello, scritti per esteso invece che a icone — e chiudendolo torna dov’era. Le frecce ↑ ↓ scorrono le righe, Invio apre la scheda completa, Esc deseleziona. Ctrl+click aggiunge una riga alla scelta e Maiusc+click (o Maiusc+freccia) prende tutto quello che sta in mezzo: con più righe scelte il pannello passa alle azioni di massa — segna obsoleti, preferiti, esporta la selezione in Excel o PDF, elimina — e mostra l’elenco di ciò su cui sta per agire. Larghezza e apertura restano fra una sessione e l’altra.

Elenco a destra, documento al centro — Commesse, Fabbisogno, Richieste di offerta e Ordini hanno la stessa forma: l’elenco sta in una colonna a destra e resta visibile mentre si lavora un documento, che occupa il centro. Si passa da un documento all’altro con un click, senza tornare indietro e ritrovare la riga; la riga aperta resta marcata, i documenti chiusi o annullati si vedono spenti. I filtri stanno con l’elenco, impilati nella sua colonna. I comandi che agiscono sul documento (crea ordine, duplica, elimina, chiudi/riapri) sono nella sua testata, scritti per esteso. Le modifiche in sospeso si salvano da sole quando si apre un altro documento, com’è sempre stato uscendo verso l’elenco. In stampa esce il documento, non l’elenco.

🏠 Riepilogo — «Richiede attenzione» — all’avvio, cosa c’è da fare adesso: commesse oltre la consegna, righe di fabbisogno da ordinare, ordini confermati in ritardo, richieste senza risposta, articoli sotto scorta o senza prezzo, codici duplicati. Ogni avviso nomina i codici e i numeri che lo riguardano (fino a otto, poi «+N altri»), con il perché nel suggerimento, e ogni voce porta dove si risolve: la commessa alla sua commessa, la riga di fabbisogno al piano che la genera, l’articolo alla sua scheda.

🌗 Tema chiaro o scuro — il pulsante nell'intestazione gira su tre stati: come il sistema (quello di partenza), chiaro, scuro. La scelta resta su questo browser e non viene condivisa con i colleghi: è una preferenza personale, non un dato aziendale. In stampa la carta resta bianca in tutti e tre i casi.

🔎 Ricerca globale (Ctrl+K) — un campo solo per articoli, richieste, ordini e piani: si scrive un codice o un numero e si salta dove serve, senza passare dalla vista giusta e dai suoi filtri.

🖨 Stampa della vista aperta (Ctrl+P) — distinta, costificazione, fabbisogno, richiesta o ordine escono su carta ripuliti di navigazione, filtri e pulsanti, con intestazione, data e autore.

Autore delle modifiche — in fondo a schede articolo, richieste, ordini e piani si legge chi ha creato il record e chi l'ha aggiornato per ultimo, con data e ora.

Schede mobili — le finestre di dialogo non bloccano più la pagina: si spostano trascinandole per il titolo, si ridimensionano dall'angolo e si chiudono con ✕ o Esc. Dietro si continua a navigare, e listino, Dove è usato e un form possono restare aperti insieme.

Le anagrafiche mostrano 200 articoli per volta (Mostra altri / Mostra tutti in fondo all'elenco): i cataloghi grandi restano scorrevoli.

🔒 Note interne su richieste e ordini: restano nell'app, non compaiono mai su PDF ed Excel. Passano dalla richiesta all'ordine generato e sono modificabili in qualunque stato del documento.

⚙ Gestione — dati azienda, fornitori, clienti, condizioni di offerta (trasporto/pagamento), famiglie articolo, concetti (nomenclatura delle parti), centri di lavoro (tariffe €/h), unità di misura, impostazioni globali (spese generali %, margine %, valuta, approvvigionamento parte), import massivo da Excel e backup JSON (esporta/importa/ripristina/azzera tutto).

Sospendere invece di eliminare — fornitori, clienti e centri di lavoro si possono sospendere (⏸): restano negli archivi e nei documenti che li citano, ma spariscono dai menu a tendina e dai suggerimenti. È la risposta a chi non si può cancellare — un fornitore citato da ordini di tre anni fa — ma non deve nemmeno continuare a comparire ovunque. Il riquadro accanto al nome dice sempre se una voce è attiva o sospesa, e lo stato viaggia nell'export e nell'import Excel.