Vai al contenuto
← Tutti i progetti

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.

LaravelPHPInertia.jsReactTypeScriptTailwind CSSMySQLLaravel ReverbLaravel MCPPestFigCraft
Screenshot di BClock

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 con le ore per progetto La dashboard: ore registrate per progetto rispetto a quelle previste, in rosso quando si superano.

La pagina delle ore Le mie ore: le registrazioni raggruppate per giorno, con timer e avviso sulle ore previste.

Il calendario del carico Il calendario: il carico di ogni persona giorno per giorno rispetto alla capacità.

Il Gantt Il Gantt: attività con dipendenze, filtri per progetto, area e persona e la linea di oggi.

Le attività di un progetto Un progetto: assegnatari, date e ore usate rispetto a quelle previste per ogni attività.

Le assenze Le assenze: l’HR conferma o rifiuta le richieste.

Le app AI collegate 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.