Manuale Utente FormService
Guida completa all'utilizzo della piattaforma LMS per la formazione sulla sicurezza sul lavoro
Panoramica FormService
Cos'è FormService?
FormService è una piattaforma LMS (Learning Management System) dedicata alla formazione obbligatoria sulla sicurezza sul lavoro, conforme al D.Lgs 81/08 e all'Accordo Stato-Regioni.
Conformità Normativa
Corsi certificati conformi al D.Lgs 81/08 con attestati validi ai fini di legge.
Multi-Tenant
Supporto per aziende, enti di formazione e associazioni con isolamento dati.
Certificati Digitali
Generazione automatica di attestati PDF con QR code per verifica autenticità.
Funzionalità Principali
- Gestione Corsi: Catalogo completo di corsi sulla sicurezza (Generale, Specifica, Preposti, Dirigenti, RLS, RSPP, Antincendio, Primo Soccorso)
- Iscrizione e Tracciamento: Sistema automatico di iscrizione ai corsi con tracciamento progressi in tempo reale
- Contenuti Multimediali: Video lezioni, documenti PDF, quiz interattivi e casi studio pratici
- Valutazione: Sistema di quiz con domande random, timer e soglia di superamento configurabile
- Smart Compliance: Scansione automatica DVR e generazione piani formativi personalizzati via AI
- Pagamenti: Integrazione PayPal per acquisto corsi singoli o piani aziendali
Architettura Tecnica
| Backend | Spring Boot 3.2.1 (Java 21) |
| Database | PostgreSQL 17 |
| Frontend Web | Thymeleaf + Bootstrap 5 + Alpine.js |
| Autenticazione | JWT + Spring Security |
| Deploy | Tomcat 10 + Nginx (HTTPS) |
| AI Integration | OpenAI GPT-4o per Smart Compliance |
| Notifiche | WhatsApp (2Chat API) + Email SMTP |
Login & Gestione Ruoli
Modalità di Accesso
Password Classica
- Vai su
/login - Inserisci email e password
- Click su "Accedi"
- Ricevi JWT token (valido 24h)
OTP WhatsApp/Email
- Vai su
/login - Click "Accedi con OTP"
- Inserisci email o telefono
- Ricevi codice a 6 cifre
- Inserisci OTP (valido 5 minuti)
Ruoli e Permessi
SUPERADMIN
Accesso completo alla piattaforma con privilegi di amministrazione globale.
- ✅ Gestione tutti gli utenti (CRUD)
- ✅ Gestione aziende e associazioni
- ✅ Gestione catalogo corsi globale
- ✅ Visualizzazione log di sistema
- ✅ Configurazione integrazioni (2Chat, OpenAI, PayPal)
- ✅ Accesso statistiche globali
ADMIN (Ente Formazione)
Amministratore di ente di formazione accreditato.
- ✅ Creazione e pubblicazione corsi
- ✅ Gestione studenti iscritti ai propri corsi
- ✅ Emissione certificati
- ✅ Statistiche corsi propri
- ❌ No accesso ad altri enti
COMPANY_ADMIN (Azienda)
Responsabile formazione aziendale.
- ✅ Iscrizione dipendenti ai corsi
- ✅ Monitoraggio progressi dipendenti
- ✅ Scadenzario attestati
- ✅ Upload DVR per Smart Compliance
- ✅ Gestione pagamenti aziendali
- ❌ No creazione corsi
ASSOCIATION_ADMIN (Associazione)
Responsabile associazione di categoria.
- ✅ Gestione aziende associate
- ✅ Catalogo corsi per associati
- ✅ Sconti e convenzioni
- ✅ Report aggregati associazione
PRIVATE / BUSINESS (Studente)
Utente finale che fruisce dei corsi.
- ✅ Iscrizione ai corsi
- ✅ Fruizione contenuti (video, PDF, quiz)
- ✅ Svolgimento quiz finali
- ✅ Download attestati
- ✅ Tracciamento progressi personali
Flussi Operativi Step-by-Step
1 Registrazione Nuovo Utente
https://formservice.fattorecreativo.it/registrati
2 Iscrizione a un Corso
3 Fruizione Contenuti e Completamento
4 Smart Compliance (Analisi DVR con AI)
5 Creazione Corso (per ADMIN)
Troubleshooting
Non riesco ad accedere - Password errata
Sintomo: "Credenziali non valide" al login
Soluzioni:
- Verifica Caps Lock sia disattivato
- Usa "Password dimenticata" → ricevi link reset via email
- Prova login con OTP WhatsApp/Email come alternativa
- Contatta supporto se problema persiste
Video non si carica
Sintomo: Schermata nera o spinner infinito
Soluzioni:
- Verifica connessione internet (min 2 Mbps per streaming)
- Disabilita adblocker o estensioni browser
- Prova con browser diverso (Chrome/Firefox consigliati)
- Svuota cache browser: CTRL+SHIFT+DEL
- Segnala il problema includendo: corso, modulo, browser usato
Certificato non generato dopo quiz superato
Sintomo: Quiz completato ma nessun PDF in "I Miei Certificati"
Soluzioni:
- Verifica di aver completato TUTTI i moduli (100%)
- Verifica punteggio quiz ≥ 70% (soglia superamento)
- Aggiorna la pagina (F5) - generazione può richiedere ~10 secondi
- Logout e login nuovamente
- Se persiste: contatta amministratore corso con screenshot
Pagamento completato ma corso non sbloccato
Sintomo: PayPal ha addebitato ma corso ancora bloccato
Soluzioni:
- Attendi 2-3 minuti per sincronizzazione webhook PayPal
- Aggiorna Dashboard (F5)
- Controlla email ricevuta da PayPal (transazione ID)
- Contatta supporto con: email account, ID transazione PayPal, nome corso
- Supporto sbloccherà manualmente in max 24h
Smart Compliance non analizza il DVR
Sintomo: Upload DVR OK ma nessun piano formativo generato
Soluzioni:
- Verifica file sia PDF testuale (no scansioni immagini)
- Dimensione max 10 MB
- Documento deve contenere sezioni "Rischi" o "Valutazione" leggibili
- Prova a ri-uploadare dopo 1 minuto
- Contatta supporto con DVR anonimizzato per debug
OTP WhatsApp non arriva
Sintomo: Click "Invia OTP" ma nessun messaggio ricevuto
Soluzioni:
- Verifica numero telefono inserito con prefisso +39
- Controlla WhatsApp sia attivo e connesso
- Attendi fino a 2 minuti (delay gateway)
- Prova login con OTP Email come alternativa
- Verifica numero non sia in blacklist spam
Supporto Tecnico
Se il problema persiste dopo aver seguito i passaggi sopra:
- Email: support@formservice.it
- WhatsApp: +39 368 762 9105
- Orari: Lun-Ven 9:00-18:00
- Tempo risposta: Max 24h lavorative
Domande Frequenti (FAQ)
Sì, tutti i corsi erogati da enti accreditati su FormService sono conformi al D.Lgs 81/08 e all'Accordo Stato-Regioni. Gli attestati hanno valore legale e sono riconosciuti dagli organi ispettivi (ASL, Ispettorato del Lavoro). Ogni certificato include QR code per verifica autenticità.
Dipende dal tipo di corso. I corsi hanno una validità di 6 mesi dalla data di iscrizione. Puoi studiare al tuo ritmo, mettere in pausa e riprendere quando vuoi. I progressi vengono salvati automaticamente. Per corsi aziendali, il COMPANY_ADMIN può impostare scadenze custom.
Sì, puoi ripetere il quiz finale fino a 3 volte. Le domande vengono randomizzate ad ogni tentativo. Se dopo 3 tentativi non raggiungi la soglia di superamento (70%), dovrai contattare il docente del corso per un tutoraggio personalizzato o rivedere i moduli prima di un nuovo tentativo.
Smart Compliance usa AI (GPT-4o di OpenAI) per analizzare il tuo Documento di Valutazione Rischi (DVR). Il sistema: 1) Estrae i rischi presenti, 2) Mappa ogni rischio ai corsi obbligatori per legge, 3) Genera piano formativo personalizzato con tempistiche e priorità, 4) Ti permette di iscrivere dipendenti con un click. Questo automatizza completamente la compliance formativa aziendale.
No, i video sono protetti da DRM e devono essere fruiti online per tracciare correttamente i progressi e rispettare i requisiti normativi di tracciamento ore formazione. Tuttavia, i documenti PDF possono essere scaricati per consultazione offline.
Gli attestati hanno validità variabile per legge (es. Generale 5 anni, Antincendio 3 anni, Primo Soccorso 3 anni). FormService ti invia notifiche automatiche via email/WhatsApp a 90, 60 e 30 giorni prima della scadenza. Per rinnovare, dovrai frequentare il corso di aggiornamento specifico (spesso più breve del corso base). Gli aggiornamenti sono disponibili nel catalogo con tag "AGGIORNAMENTO".
Sì! FormService è responsive e funziona su tutti i dispositivi (desktop, tablet, smartphone). È inoltre disponibile un'app mobile nativa per Android e iOS (in beta) con funzionalità offline per continuare i corsi senza connessione. Scaricala da Google Play Store o Apple App Store cercando "FormService LMS".
Le aziende possono acquistare piani enterprise con sconti a volume: 10-49 utenti = -15%, 50-99 utenti = -25%, 100+ utenti = -35%. Inoltre, le associazioni di categoria (es. Confartigianato, CNA) possono creare convenzioni per i propri associati con sconti fissi. Contatta sales@formservice.it per un preventivo personalizzato.
Changelog
Cronologia degli aggiornamenti e delle nuove funzionalità della piattaforma.
v2.0.0 - Rilascio Maggiore
2026-02-06Riscrittura completa con Spring Boot 3.2.1 e nuova architettura multi-tenant.
🎉 Nuove Funzionalità
- ✅ Smart Compliance con AI (analisi DVR automatica)
- ✅ Login OTP via WhatsApp e Email
- ✅ Certificati PDF con QR code verifica
- ✅ Dashboard multi-ruolo (SuperAdmin, Admin, Company, Student)
- ✅ Integrazione PayPal per pagamenti
- ✅ Notifiche scadenza attestati
- ✅ Sistema quiz con randomizzazione domande
🔧 Miglioramenti
- 🚀 Performance migliorate del 300% su query database
- 🎨 UI completamente rinnovata con Tailwind CSS
- 🔒 Sicurezza rafforzata con JWT e Spring Security 6
- 📱 Responsive design per mobile/tablet
🐛 Bug Fix
- 🔨 Fix #19: Thymeleaf syntax error in templates
- 🔨 Fix #20: JWT Principal mismatch (39 endpoints)
- 🔨 Fix #21: LazyInitializationException in Enrollment
- 🔨 Fix #22: Homepage missing Bootstrap CSS
v1.5.2 - Patch
2025-12-20🐛 Bug Fix
- 🔨 Fix email SMTP timeout con Gmail
- 🔨 Fix video player flickering su Safari
- 🔨 Fix calcolo progressi corso errato
v2.1.0 - Sprint Completamento
2026-02-07Nuove Funzionalità
- - QR Check-in presenze con generazione QR code per sessioni
- - Assistente AI integrato per supporto formazione e compliance
- - Media Library per gestione video e documenti
- - Import dipendenti da file Excel (Company Admin)
- - Report e analytics con grafici interattivi (Chart.js)
- - Export report iscrizioni e certificati (Excel/PDF)
- - Template email personalizzabili da database
Sicurezza
- - Rate limiting su endpoint autenticazione (10 req/min/IP)
- - Header HSTS, XSS Protection, Content-Type-Options
- - Favicon e meta tag SEO/Open Graph
Miglioramenti
- - Sidebar admin con nuove sezioni: Presenze, Media, Report
- - Pagina check-in QR accessibile da mobile
- - Manuale utente aggiornato con nuove funzionalità
v1.5.0 - Minor Release
2025-11-15🎉 Nuove Funzionalità
- ✅ Export report Excel per Company Admin
- ✅ Filtri avanzati catalogo corsi
- ✅ Dark mode (beta)
🔧 Miglioramenti
- 🚀 Caricamento homepage -40% tempo
- 📊 Grafici dashboard interattivi
Roadmap 2026 Q1-Q2
- Q1 App mobile nativa iOS/Android (rilascio beta)
- Q1 Integrazione fatturazione elettronica (FatturaPA)
- Q2 Webinar live integrati nella piattaforma
- Q2 Gamification: badge, leaderboard, punti esperienza
- Q2 Marketplace corsi terze parti
Link Utili
Supporto
- support@formservice.it
- WhatsApp: +39 368 762 9105
- Orari: Lun-Ven 9:00-18:00