Vai al contenuto
← Tutti i progetti

Bubble Clock

Nata dalle due cose che ci servivano davvero — un Registro Ore semplice e un Gantt — e cresciuta in una web app multi-utente con calendario unificato (Google e Infomaniak), anagrafica condivisa, documenti interni, report e quattro ruoli con permessi per area.

PHP 8Slim 4MySQLSQLiteVanilla JSMaterial Design 3FullCalendarEditor.jsPHPUnit
Screenshot di Bubble Clock

Perché è nato

Bubble Clock è nato dopo aver riscontrato alcune difficoltà nell’uso di ClickUp che, per il nostro modo di lavorare, risultava sovraccarico di funzionalità e troppo complesso. Ho deciso quindi di ripartire dalle due cose che ci servivano davvero — un semplice Registro Ore e un Gantt — e da lì è cresciuto quello che oggi è Bubble Clock: un’applicazione che permette di gestire le ore e i carichi settimanali di tutte le persone che lavorano in azienda. Attorno a questi due moduli si sono poi aggiunti il Calendario (Google e Infomaniak in un’unica vista), l’Anagrafica condivisa di clienti, brand e progetti e una knowledge base di Documenti interni.

A completare il tutto ci sono un’area di reportistica e l’import dei dati da Dipendenti in Cloud, per verificare la corrispondenza tra le ore registrate nel Registro Ore e le timbrature segnate su Dipendenti in Cloud.

Screenshot

Schermata di accesso di Bubble Clock Accesso, con recupero password via email.

Registro ore con la vista della giornata Registro ore: la giornata, con attività dal Gantt.

Gantt con pianificazione settimanale Gantt: pianificazione delle ore sui giorni, ferie e permessi.

Calendario unificato Google e Infomaniak Calendario: Google e Infomaniak kSuite in un’unica vista.

Anagrafica clienti con brand e progetti Anagrafica: dati cliente, brand e progetti collegati.

Documenti con editor a blocchi Documenti: knowledge base con editor a blocchi.

Report con ore per categoria e persona Report: ore per categoria e per persona, con export CSV.

Console di gestione utenti e aree Gestione: utenti, aree e import (Dipendenti in Cloud).

Pagina profilo con tema e colore accent Profilo: immagine, tema e colore accent.

Registro ore con tema scuro attivo Il tema scuro per-utente (Registro ore).

Tecnologie usate

La scelta di fondo è stata PHP: ci permette di ospitare il programma su SiteGround, il servizio che già utilizziamo per i siti WordPress, senza aggiungere infrastruttura nuova. (Il primo prototipo era in Node.js: è stato portato a PHP proprio per poter stare sull’hosting condiviso di SiteGround.) Non servendo nulla di complicato, questa strada ci ha permesso di tenere tutto il più semplice possibile: niente step di build, niente framework frontend, poche dipendenze.

Nel dettaglio:

  • Backend — PHP 8 con il micro-framework Slim 4 (routing e middleware), sessioni PHP per il login e password protette con hash bcrypt.
  • Database — MySQL in produzione (su SiteGround) e SQLite in sviluppo locale, con lo stesso codice grazie a PDO.
  • Frontend — HTML, CSS e JavaScript “vanilla”, senza framework e senza build: la navigazione è single-page con un guscio condiviso, l’interfaccia segue Material Design 3 con tema chiaro/scuro e colore accent personalizzabili per ogni utente.
  • Librerie — FullCalendar per il Calendario ed Editor.js per l’editor a blocchi dei Documenti (entrambe salvate localmente nel progetto); lato PHP Google API Client (OAuth per Google Calendar), sabre/vobject (CalDAV/iCal per Infomaniak kSuite) e PHPMailer (email di recupero password).
  • Integrazioni e dati — import delle timbrature da Dipendenti in Cloud (file Excel .xlsx), export CSV dei report ed export .ics del calendario.
  • Qualità e deploy — codice su GitHub con suite di test PHPUnit e CI (lint + test a ogni push); deploy sull’hosting condiviso SiteGround.

I ruoli

Bubble Clock è multi-utente, con quattro ruoli in ordine gerarchico: Admin, Capo, Capo area e Dipendente. Le persone sono organizzate in aree (es. Sviluppo, Grafica, Amministrazione): un utente può far parte di più aree e un capo area può gestirne più di una.

  • Dipendente — il ruolo base: registra le proprie ore, pianifica il proprio Gantt, collega i propri calendari e usa Anagrafica e Documenti (condivisi da tutta l’azienda). Vede solo i propri dati.
  • Capo area — tutto quello che fa un dipendente e, in più, Report e Console di gestione limitati alle aree che gestisce: ore e Gantt dei membri in sola lettura, gestione dei loro account (nuovi utenti, reset password, attiva/disattiva) e import dei dati storici. Non può creare o modificare le aree né cambiare i ruoli.
  • Capo — ha gli stessi poteri dell’Admin su tutte le aree e tutti gli utenti, ma con una navigazione ridotta pensata per chi non registra ore: vede solo Calendario, Anagrafica, Report e Gestione (niente Registro ore e Gantt personali).
  • Admin — accesso completo: tutti i moduli, tutti gli utenti e tutte le aree (creazione, rinomina, colore, eliminazione), cambio dei ruoli e import.

I permessi valgono sia lato server sia nell’interfaccia: un dipendente che prova ad aprire Report o Gestione viene semplicemente rimandato alla home.