TAMIOT HR — Manuale d'uso
Piattaforma di gestione risorse umane per aziende agricole: timbrature GPS, ferie, DPI, attestati, visite mediche, adempimenti.
1. Accesso
Apri https://tamiothr.fattorecreativo.it/ nel browser (desktop o mobile). Fai clic su "Aggiungi a Home" per installare come app.
Credenziali demo
| Ruolo | Email | Password |
| Super admin | mario.grillo@agrisolution.it | Mg11081974!@ |
| Dipendente | anna.verdi@demo.it | demo123 |
| Dipendente | luca.bianchi@demo.it | demo123 |
| Dipendente | paolo.neri@demo.it | demo123 |
2. Ruoli e permessi
| Ruolo | Cosa può fare |
| SUPER_ADMIN | Tutto, più log audit e override |
| TITOLARE / RESPONSABILE | Tutti i dati azienda, approva ferie, compliance override |
| CAPO_SQUADRA | Approva timbrature team, legge attestati e DPI |
| DIPENDENTE | Timbra, richiede ferie, vede i suoi dati |
3. Funzionalità principali
3.1 Timbrature (Dipendente)
- Apri "Timbratura"
- Consenti l'accesso alla posizione GPS
- Tocca ENTRATA / PAUSA / USCITA
- Il sistema verifica il geofence aziendale (se configurato)
Se il geofence segna non valido, la timbratura viene comunque registrata ma marcata per revisione dal capo squadra.
3.2 Ferie e Permessi (Dipendente)
- "Ferie" → "Nuova richiesta"
- Scegli tipo (FERIE/PERMESSO/ROL/EX_FESTIVITA), date, motivazione
- Invia; il titolare riceve notifica e approva/rifiuta
3.3 Attestati (Dipendente / Titolare)
- Dipendente: carica foto dell'attestato; OCR GPT-4o estrae dati automaticamente
- Titolare: conferma i dati estratti e salva
- Sistema genera alert a 90/60/30 giorni prima della scadenza
3.4 DPI (Dispositivi Protezione Individuale)
- Titolare: registra consegna DPI al dipendente
- Dipendente: firma digitale sul telefono (foto firma)
- Sistema registra timestamp e canale firma
3.5 Visite mediche
Titolare programma visite periodiche; dipendente riceve convocazione; il medico competente registra esito (IDONEO / LIMITAZIONI / NON_IDONEO).
3.6 Buste paga
Dipendente: "Buste paga" → scegli mese → scarica PDF. Il PDF generato è un demo: in produzione arriverà dal consulente del lavoro.
3.7 Dashboard
- Dipendente: ore lavorate oggi, timbrature, scadenze imminenti
- Capo squadra: timbrature del team, alert
- Titolare: % conformità, adempimenti (RSPP/MC/DVR/POS/PSC)
4. Super Admin
Log audit
GET /api/v1/admin/audit?limit=100
Restituisce gli ultimi eventi: login, timbrature, approvazioni, modifiche.
Configurazioni sede geofence
Da DB diretto (prossima UI): tabella hr_sede_geofence con lat/lng/raggio_mt per azienda.
5. Integrazioni
- WhatsApp (2Chat): webhook su
/api/v1/whatsapp/webhook
- OpenAI GPT-4o vision: per OCR attestati (
POST /api/v1/attestati/ocr)
- SMTP Gmail: invio notifiche automatiche
- PostGIS: verifica geofence spaziale sulle timbrature
6. API Reference
Documentazione interattiva: Swagger UI
Schema OpenAPI: /api/api-docs
7. Supporto
Mario Grillo — mario.grillo@agrisolution.it — WhatsApp +39 368 762 9105
TAMIOT HR v1.0 — Piattaforma multi-tenant agrisolution — Live