Documentazione

Impara a usare HeadOps

Dalla configurazione iniziale del workspace alle impostazioni avanzate del motore di pianificazione — tutto il necessario per trasformare il tuo flusso produttivo.

🏢

Configurazione Workspace

Crea il workspace della tua azienda e invita il team

Al primo accesso a HeadOps con il tuo account Google, viene creato automaticamente un Workspace. Il workspace è il confine sicuro dei dati della tua azienda — tutti i progetti, team, tipi di fase e calendari festività sono delimitati al suo interno.

Invitare i membri del team

Vai su Impostazioni → Workspace per gestire il team. Invita i colleghi inserendo il loro indirizzo email e selezionando un ruolo:

  • AdminAccesso completo incluse impostazioni workspace, gestione membri e operazioni nella zona pericolosa.
  • EditorPuò creare e modificare progetti, componenti, fasi e allocazioni.
  • VisualizzatoreAccesso in sola lettura alla timeline e alle viste per team.
Sicurezza: HeadOps applica Row Level Security (RLS) a livello di database. Gli utenti possono vedere e modificare solo i dati del proprio workspace, anche a livello di API.
📐

Gerarchia Dati

Il modello dati alla base di ogni programma

HeadOps organizza i dati di produzione in una gerarchia rigorosa a 4 livelli.

Workspace (confine della tua azienda)
└── Progetto (numero ordine, cliente, data di consegna)
└── Componente (pezzo fisico: "353 - STC D")
└── Fase (passo produttivo: "Pre-saldatura", "Verniciatura")
└── Allocazione (team + date inizio/fine)

Progetti

Un Progetto rappresenta un singolo ordine cliente o installazione. Ogni progetto ha un numero ordine, un nome cliente e una data di consegna ufficiale che funge da scadenza.

Componenti

Un Componente è un pezzo fisico all'interno di un progetto. I componenti appaiono come righe individuali sulla timeline.

Fasi

Una Fase è un passo produttivo necessario per un componente — come "Pre-saldatura", "Installazione Elettrica" o "Collaudo". Ogni fase ha una durata definita in giorni lavorativi.

Allocazioni

Un'Allocazione è l'assegnazione programmata di un team per completare una fase. Le allocazioni appaiono come blocchi colorati sul canvas Gantt e possono essere trascinate per attivare la ripianificazione automatica.

⚙️

Tipi di Fase & Team

Configura il flusso di lavoro unico del tuo stabilimento e le capacità dei team

Definire i tipi di fase

In Impostazioni → Tipi di Fase, definisci le fasi produttive del tuo stabilimento. Ogni tipo ha un nome, una durata predefinita (in giorni lavorativi) e un colore per la timeline.

Associare i team ai tipi di fase

I team possono essere associati a uno o più tipi di fase, definendo quali lavori sono in grado di eseguire. Questa relazione many-to-many alimenta il wizard di auto-allocazione.

Esempio: Se il team "Saldatura Alpha" è associato sia a "Pre-saldatura" che a "Saldatura", il wizard lo considererà per entrambi i tipi di fase.
📅

Calendario & Giorni Lavorativi

Controlla come HeadOps calcola le date di pianificazione

Configurazione settimana lavorativa

Per default, tutti i team operano con settimana lavorativa standard lunedì-venerdì (5 giorni). Le singole fasi possono essere impostate a 6 giorni (lunedì-sabato).

Festività

Vai su Impostazioni → Festività per gestire il calendario del workspace. Quando una fase ha "osserva festività" attivo (default), il motore salta le date festive nel calcolo delle date di fine.

🖱️

Timeline di Pianificazione

Trascina, rilascia e ripianifica con sicurezza

Navigare sul canvas

La timeline è un canvas Gantt completo. A sinistra la gerarchia di progetti e componenti. A destra la timeline con colonne giornaliere, ombreggiatura weekend, indicatori festività e l'indicatore blu "oggi".

Aggiungere progetti e componenti

Clicca su "+ Nuovo Progetto" nell'angolo in alto a sinistra del canvas. Nella riga di un progetto, clicca "+" per aggiungere componenti.

Pianificare le fasi

Le fasi in backlog appaiono nel pannello espanso del componente. Trascina una fase dal backlog sulla timeline per creare un'allocazione.

Ripianificazione

Trascina qualsiasi blocco di allocazione a una nuova data. HeadOps calcolerà automaticamente l'effetto a cascata con il motore EDF. Se la modifica creerebbe nuove violazioni di scadenza, vedrai un avviso.

Come funzionano gli algoritmi di pianificazione

Non serve essere ingegneri software per capire come ragiona HeadOps. Qui sotto trovi una spiegazione semplice di ogni algoritmo che alimenta il motore.

🗓️

Calcolo Giorni Lavorativi

Come HeadOps conta i giorni su un calendario reale di fabbrica

HeadOps usa un contatore giorno per giorno. Partendo da una data, avanza nel calendario un giorno alla volta contando solo i "giorni lavorativi". Salta:

  • WeekendSabato e domenica in modalità 5 giorni, o solo domenica in modalità 6 giorni.
  • Festivitàqualsiasi data aggiunta al calendario festività del workspace.
Perché è importante: Se aggiungi una festività nazionale, ogni fase che la attraversa si estende automaticamente di un giorno — senza toccare un singolo blocco.
🔗

Ripianificazione a Cascata

Come un singolo spostamento muove automaticamente tutte le fasi a valle

Immagina tre fasi in sequenza: Pre-saldatura → Saldatura → Verniciatura. Se sposti Pre-saldatura avanti di 3 giorni, ti aspetti che anche Saldatura e Verniciatura si spostino. È esattamente ciò che fa HeadOps — ma in modo più intelligente.

Come funziona

Quando sposti un blocco, HeadOps misura l'intervallo in giorni lavorativi tra la fase spostata e ogni fase successiva nel progetto. Non conta i giorni di calendario — conta i giorni lavorativi effettivi.

Anche per le modifiche di durata: Lo stesso algoritmo si attiva quando cambi la durata di una fase. Se Pre-saldatura cresce da 3 a 5 giorni, tutte le fasi a valle si spostano automaticamente per mantenere la spaziatura originale.

Ripianificazione Dinamica (EDF)

L'algoritmo in 5 fasi che risolve i conflitti tra team in millisecondi

Questo è il "cervello" di HeadOps. Quando sposti un componente, il motore non si limita a cascadare le fasi nel progetto — verifica se lo spostamento ha accidentalmente sovrapposto un team e redistribuisce intelligentemente il lavoro nell'intero stabilimento.

Fase 1: Blocca la tua modifica

Il motore rispetta la tua decisione. Pianifica tutte le fasi del componente spostato, partendo dalla nuova data scelta, e segna quei team come "occupati".

Fase 2: Trova il lavoro interessato

Il motore scansiona ogni altro componente e chiede: "Qualcuna delle fasi usa lo stesso team, su date sovrapposte?" Solo i componenti con risposta positiva entrano nella ripianificazione.

Fase 3: Ordina per urgenza (EDF)

I componenti interessati vengono ordinati per priorità. Il componente con la scadenza di consegna più vicina va per primo.

Perché le scadenze prima? È una strategia classica nella teoria della pianificazione chiamata "Earliest Deadline First" (EDF). L'intuizione è semplice: il lavoro da completare prima deve avere la priorità sugli slot disponibili dei team.

Fase 4: Riempi i vuoti

Per ogni componente in coda, il motore pianifica le sue fasi una per una. Per ogni fase chiede: "Quando è disponibile il team assegnato?" Usa una tecnica di salto efficiente — salta interi blocchi di tempo occupato.

Fase 5: Verifica le violazioni di scadenza

Infine, il motore controlla l'ultima fase di ogni componente per verificare se termina dopo la scadenza. Se sì, calcola esattamente quanti giorni di ritardo avrà il progetto.

🎯

Wizard di Auto-Allocazione

Come HeadOps trova la migliore combinazione di team tra migliaia

Quando aggiungi un componente con più fasi, ti trovi davanti a un puzzle combinatorio: ogni fase può essere assegnata a diversi team. Il wizard li prova tutti.

Step 1: Trova i team idonei

Per ogni fase, HeadOps identifica il tipo di fase e trova tutti i team associati a quel tipo.

Step 2: Genera tutte le combinazioni

Il motore crea ogni possibile combinazione di assegnazioni team-fase. Un limite di sicurezza limita a 100.000 combinazioni per mantenere la velocità.

Step 3: Simula ogni pianificazione

Per ogni combinazione, il motore simula la pianificazione come se avessi posizionato manualmente ogni fase. Verifica il calendario esistente di ogni team per trovare il primo slot senza conflitti.

Step 4: Scegli il vincitore

La combinazione con la data di completamento più anticipata vince.

Esempio concreto: Un componente ha 4 fasi (Pre-saldatura, Saldatura, Elettrico, Collaudo) con 3 team idonei ciascuna. Il wizard valuta tutte le 81 combinazioni in meno di 50 millisecondi.
🛡️

Rilevamento Conflitti

Come HeadOps individua istantaneamente i team sovrapposti

Un "conflitto" in HeadOps significa che un singolo team è stato assegnato a due fasi con intervalli di date sovrapposti.

Come funziona il rilevamento

Il motore raggruppa tutte le allocazioni per team. Per ogni team, ordina le assegnazioni per data di inizio e scansiona la lista cercando sovrapposizioni. Quando ne trova una, entrambi i blocchi vengono marcati come "in conflitto" con un overlay rosso sul canvas.

Risolvere i conflitti

Hai due opzioni. Puoi trascinare manualmente uno dei blocchi in conflitto a una nuova data — attivando gli algoritmi di cascata e ripianificazione. Oppure puoi cliccare "Ripianifica Tutto" per ricostruire l'intero programma da zero.

Pronto per iniziare?

Registrati e configura il tuo workspace in meno di 5 minuti.