Passa al contenuto principale

Staff e sessioni

πŸ”— Apri nel BackOffice​

🎯 Cosa fa​

Gestisce il personale coinvolto in un progetto finanziato (docenti, tutor, coordinatori, personale amministrativo) con contratti e costi orari, e le sessioni di erogazione delle edizioni con registri presenze, requisiti di fase e storico stato progetto.

🧩 Concetti chiave​

OggettoCosa rappresenta
StaffPersona coinvolta nel progetto: anagrafica, contratto, costo orario, ore settimanali/mensili. Distinto da edu.teachers (formatore ordinario).
Staff di progettoAssegnazione di una persona a un progetto con ruolo e monte ore mensile.
Sessione (fin)Evento erogativo concreto di un'edizione, con data di vidimazione registro. Distinto da edu.appointments (appuntamento formativo ordinario).
Registro presenzeDocumento ufficiale vidimato per tracciare le presenze in una sessione.
Requisito faseVoce della checklist di requisiti per completare una fase (documento, campo dati, azione).
Storico progettoLog cronologico dei cambi di stato del progetto (chi ha cambiato cosa, quando).

πŸ•’ Quando usarlo​

  • Registrare il personale dell'ente attuatore che lavora sui progetti.
  • Assegnare staff a un progetto con ruolo definito.
  • Vidimare i registri delle sessioni.
  • Definire requisiti specifici per ciascuna fase.
  • Consultare lo storico dei cambi di stato di un progetto.

πŸ‘£ Passi principali​

Registrare una persona di staff​

  1. Menu Formazione finanziata β†’ Staff.
  2. Compila:
    • Nome, Cognome
    • Codice fiscale
    • Tipo contratto (libero o enumerato)
    • Costo orario, Ore settimanali, Ore mensili
    • Utente collegato (opzionale): se la persona ha un account applicativo, collegalo per riusare email e permessi senza duplicare il dato. È il modo con cui i promemoria automatici (es. scadenza rendicontazione) raggiungono il referente di progetto.
  3. Salva.

Assegnare staff a progetto​

  1. Menu Formazione finanziata β†’ Staff di progetto.
  2. Compila:
    • Progetto
    • Staff
    • Ruolo (es. Coordinatore, Tutor, Amministrativo)
    • Ore allocate mensili
  3. Salva.

Vidimazione registro presenze​

  1. Menu Formazione finanziata β†’ Sessioni.
  2. Per ogni edizione, crea una sessione.
  3. Compila:
    • Edizione
    • Data vidimazione registro
  4. Menu Formazione finanziata β†’ Registri presenze.
  5. Crea il registro:
    • Sessione
    • Data
    • Orari inizio / fine
    • Documento (allegato)

Definire requisiti di fase​

  1. Menu Formazione finanziata β†’ Requisiti fase.
  2. Compila:
    • Fase (FK anagrafica)
    • Tipo requisito: document, data_field, action
    • Tipo documento (se tipo = document)
    • Nome del requisito
    • Obbligatorio (flag)
    • Hard block (flag: bloccante se non completato)
    • Ordine

Consultare storico progetto​

Dal menu Formazione finanziata β†’ Storico progetti: elenco cronologico di tutti i passaggi di stato con data, utente e note.

πŸ—‚οΈ Campi chiave​

Staff​

CampoObbligatorio
Nome, CognomeSì
Codice fiscaleNo
Tipo contrattoNo
Costo orarioNo
Ore settimanali / mensiliNo
Utente collegatoNo

Staff di progetto​

CampoObbligatorio
ProgettoSì
StaffSì
RuoloSì
Ore allocate mensiliNo

Sessione​

CampoObbligatorio
EdizioneSì
Data vidimazioneNo

Registro presenze​

CampoObbligatorio
SessioneSì
DataSì
OrariNo
Documento allegatoNo

Requisito fase​

CampoObbligatorio
FaseSì
Tipo requisitoSì
NomeSì
ObbligatorioNo (default sì)
Hard blockNo (default no)

⚑ Casi particolari​

  • Staff vs docenti edu. fin.staff Γ¨ personale dell'ente attuatore (coordinatori, tutor, docenti progetto finanziato). edu.teachers sono docenti di formazione ordinaria. Tabelle separate per ora β€” se una persona Γ¨ in entrambi, sono due record distinti.
  • Sessioni vs appuntamenti edu. fin.sessions Γ¨ l'evento di erogazione di un'edizione finanziata. edu.appointments Γ¨ l'appuntamento formativo ordinario. EntitΓ  separate.
  • Vidimazione registro come hard block. La vidimazione Γ¨ obbligatoria prima di iniziare l'erogazione. Configurare il relativo requisito fase con hardBlock = true.
  • Presenze lavoratori. Il registro presenze Γ¨ il contenitore; le presenze effettive per singolo lavoratore vanno altrove (enrollments.attendanceHours aggrega; dettaglio per sessione / giorno non Γ¨ coperto da tabella dedicata in scope).
  • Storico progetto automatico. Ogni cambio di stato del progetto dovrebbe generare un record in projectHistory. Verificare trigger (automatico vs manuale).

⚠️ Domande aperte​

  • Unificazione fin.staff e edu.teachers. Doppia anagrafica per persone che fanno sia formazione ordinaria sia progetti finanziati. Pattern condiviso "persona" da valutare.
  • Sessione senza registro. Se si crea una sessione ma non si allega il registro vidimato, il sistema segnala?
  • Requisiti fase pre-popolati. Esiste seed dataset dei requisiti tipici di FondItalia (per ogni fase) o vanno creati a mano per ogni installazione?
  • Attribuzione storico. projectHistory.changedBy Γ¨ l'utente applicativo o un servizio di sistema? Formato stringa libero.

πŸ”— Vedi anche​