BClock
Un gestionale per le ore di lavoro: clienti, progetti e attività, registrazione delle ore a mano o con un timer, calendario del carico giornaliero, Gantt con dipendenze, assenze e festività, dashboard con esportazione CSV e notifiche in tempo reale. Quattro ruoli (Boss, Capo area, HR e Dipendente), interfaccia in italiano e in inglese e un server MCP che permette alle app AI di leggere i progetti e registrare ore a nome di chi le ha autorizzate. Laravel 13 con Inertia, React e TypeScript. Nato a scopo didattico.

Perché è nato
BClock è un progetto a scopo didattico. Volevo provare
FigCraft e il suo MCP, e per farlo
mi serviva un’app abbastanza grande da avere molte schermate: un gestionale
per registrare e pianificare le ore di lavoro di un’azienda ne ha parecchie.
Il risultato del test sta nel repository, nel file
BClock-wireframe.figcraft, che è il riferimento per l’interfaccia: una
schermata nuova si disegna prima lì e poi si costruisce nel codice.
Va detto che non ho competenze di UI/UX: di solito le grafiche le fanno altre persone. Qui ho voluto vedere fin dove si arriva partendo da zero con uno strumento di design, quindi il risultato è un esperimento più che un progetto di grafica.
Il codice è open source (licenza MIT) su GitHub.
Cosa fa
- Clienti e progetti: anagrafica dei clienti con i referenti, progetti con attività, ore previste, date e dipendenze tra le attività. I progetti si possono creare da un template.
- Ore e timer: le ore si registrano a mano o con un timer da avviare e fermare, si modificano dopo, e un avviso segnala quando si superano le ore previste.
- Calendario: vista settimanale e mensile del carico di ogni persona, dove si può spostare una parte di ore da un giorno all’altro.
- Gantt: attività con dipendenze, barre trascinabili e spostamento a catena delle attività collegate.
- Assenze e festività: richieste di ferie e permessi (anche a ore), conferma da parte dell’HR e un calendario aziendale con i giorni non lavorativi.
- Dashboard ed esportazione: ore per persona, progetto e cliente, con esportazione in CSV.
- Notifiche: campanella in tempo reale, pagina con l’elenco completo e preferenze per tipo, sia nell’app sia via email.
- Utenti e ruoli: Boss, Capo area, HR e Dipendente, ognuno con permessi diversi. I nuovi utenti ricevono un invito via email.
- Preferenze personali: lingua, formato dell’ora, carico di lavoro e tema colore, anche con una palette personalizzata.
Le app AI collegate
BClock espone un server MCP a /mcp/bclock. In un’app AI come Claude si
aggiunge l’indirizzo come server MCP remoto: alla prima connessione compare
una schermata di consenso dove si accede e si autorizza l’app, che da quel
momento agisce con i permessi della persona. Può elencare progetti, attività,
ore, assenze e notifiche, registrare ore, avviare e fermare il timer e
richiedere un’assenza; non può cancellare dati, approvare assenze né cambiare
le impostazioni. Le app autorizzate sono elencate, e revocabili, in
Impostazioni › App collegate.
Screenshot
La dashboard: ore registrate per progetto rispetto a quelle previste, in rosso quando si superano.
Le mie ore: le registrazioni raggruppate per giorno, con timer e avviso sulle ore previste.
Il calendario: il carico di ogni persona giorno per giorno rispetto alla capacità.
Il Gantt: attività con dipendenze, filtri per progetto, area e persona e la linea di oggi.
Un progetto: assegnatari, date e ore usate rispetto a quelle previste per ogni attività.
Le assenze: l’HR conferma o rifiuta le richieste.
Le app collegate: l’indirizzo del server MCP e l’elenco delle app autorizzate.
Tecnologie usate
Il backend è Laravel 13 (PHP 8.4) con database MySQL; il frontend è Inertia 2 con React 19 e TypeScript, stilato con Tailwind CSS 4. Le notifiche in tempo reale passano da Laravel Reverb, e se non è attivo l’app funziona comunque: la campanella si aggiorna alla navigazione successiva. Il server MCP usa Laravel MCP con Laravel Passport per l’autorizzazione, i test sono scritti con Pest, e il design dell’interfaccia è in FigCraft.