Wiva Employee – Rilevazione Presenze

Descrizione

Gestionale Laravel + Filament per la rilevazione presenze dei dipendenti tramite dispositivi (timbrature), con generazione dei fogli ore.

Wiva Employee è una soluzione enterprise per il Workforce Management concepita per eliminare le inefficienze dei vecchi sistemi di marcatempo cartacei o stand-alone. L'applicazione implementa un'architettura ibrida in cui dispositivi hardware e terminali di timbratura dialogano direttamente con un'infrastruttura cloud centralizzata. Il sistema acquisisce in tempo reale ogni singolo evento di accesso, valida l'identità del dipendente, riconosce lo stato del terminale mittente e applica algoritmi lato server per calcolare la quadratura delle ore lavorate, evidenziando anomalie, straordinari o ritardi all'interno di una dashboard amministrativa moderna e performante.

Finalità

Sistema di gestione del personale focalizzato sulla rilevazione presenze: i dispositivi (Device) inviano eventi di timbratura (TimeEvent) tramite API, l’applicazione li associa ai dipendenti (Employee) e ne deriva i fogli ore (Timesheet). Pensato per aziende che devono tracciare entrate/uscite e ore lavorate del personale, con un pannello amministrativo per la consultazione e la gestione dei dati.

Tecnologie

• Laravel 12 / PHP 8.2
• Filament 5 per il pannello di amministrazione (Resources per Device, Employee, TimeEvent, Timesheet)
• API REST versionata (`/api/v1`) con autenticazione dei dispositivi (middleware `AuthenticateDevice`)
• Vite per il tooling; PHPUnit per i test

Funzionalità principali

• Endpoint API per dispositivi: `/api/v1/ping` e `/api/v1/events` (registrazione timbrature) protetti da autenticazione device
• Modelli di dominio: Device, Employee, TimeEvent, Timesheet
• Backoffice Filament con risorse CRUD per dispositivi, dipendenti, eventi e fogli ore
• Generazione/gestione dei timesheet a partire dagli eventi di timbratura
• Script per ambiente Windows (cartella `scripts/windows`), probabilmente client/agent di timbratura

Note

Progetto distinto dagli altri “wiva” (qui niente multi-tenancy ne Vue): backend Laravel + Filament. README di default Laravel. Stato attivo (aggiornamenti maggio 2026). Le cartelle con nomi propri nella root potrebbero essere dati/test locali piuttosto che parte del codice applicativo.

Particolarità

Architettura device-to-cloud: dispositivi fisici autenticati che inviano eventi via API, con un backoffice Filament moderno (v5) per la gestione. La presenza di script Windows e di cartelle con nomi di persone (camrne, sofia, stefania, valentina) suggerisce installazioni/test su postazioni dipendenti reali.