Documenti di progetto

🔗 Apri nel BackOffice

• Documenti progetto
• Documenti azienda
• Documenti staff
• Documenti spesa
• Tipi documento

🎯 Cosa fa

Gestisce la documentazione richiesta da FondItalia lungo il ciclo di vita del progetto: documenti aziendali (visura, DURC, delega, dichiarazioni aiuti), documenti di progetto (programma formativo, declaratorie ruoli docenti, ecc.) e documenti di staff (CV, contratti). L'anagrafica tipi di documento (documentTypes) classifica cosa è richiesto a chi.

🧩 Concetti chiave

Oggetto	Cosa rappresenta
Tipo documento	Categoria nell'anagrafica: codice, nome, soggetto (azienda / progetto / docente / modulo / sessione / corsista / spesa).
Documento azienda	Richiesta di documento per una specifica azienda di progetto (visura, DURC, ecc.). Ha uno stato ciclico.
Documento progetto	Documento legato al progetto complessivo (programma, delibere, allegati).
Documento staff	Documento di staff coinvolto (CV, contratto, abilitazioni).
Stato documento	da_richiedere → richiesto → ricevuto → approvato → scaduto.

🕒 Quando usarlo

• Censire un nuovo tipo di documento richiesto.
• Tracciare quali documenti sono richiesti a ciascuna azienda partecipante.
• Avanzare lo stato di un documento nel tempo (richiesto, ricevuto, approvato).
• Allegare il file concreto del documento al record.

👣 Passi principali

Censire un tipo documento

1. Menu Formazione finanziata → Tipi documento.
2. Compila:
   • Codice (es. VISURA_CAMERALE)
   • Nome (es. "Visura camerale")
   • Soggetto (azienda, progetto, docente, modulo, sessione, corsista, spesa)
   • Descrizione (opzionale)
3. Salva.

Richiedere un documento a un'azienda

1. Menu Formazione finanziata → Documenti aziende.
2. Crea nuova richiesta.
3. Compila:
   • Azienda di progetto (FK alla combinazione progetto-azienda)
   • Tipo documento
   • Stato iniziale: da_richiedere
4. Aggiorna lo stato man mano: richiesto, ricevuto, approvato.
5. Collega l'allegato tramite Documento (FK a archivio file).

Documenti progetto e staff

Stessa logica con menu separati Documenti progetto e Documenti staff.

🗂️ Campi chiave

Tipo documento

Campo	Obbligatorio	Note
Codice	Sì	Stringa stabile.
Nome	Sì	Descrizione.
Soggetto	Sì	A chi si riferisce.
Descrizione	No	Libera.
Attivo	No	Default: sì.

Documento (azienda / progetto / staff)

Campo	Obbligatorio	Note
FK soggetto	Sì	projectCompanyId / projectId / staffId.
Tipo documento	Sì	FK anagrafica.
Documento allegato	No	FK a archivio file (documentId).
Stato	Sì	Ciclo: da_richiedere → richiesto → ricevuto → approvato → scaduto.
Note	No	Libere.

⚡ Casi particolari

• Documento condizionato dal regime aiuto. Alcune dichiarazioni (de minimis vs aiuti formazione) sono richieste solo per il regime corrispondente. Il sistema non le suggerisce automaticamente — gestione manuale.
• Documento scaduto. Lo stato scaduto si usa per documenti con validità temporale (DURC ha 4 mesi, visura ha 6 mesi). Quando scadono, vanno rifatti.
• Allegato opzionale. Un documento può essere in stato ricevuto senza allegato digitale (es. documento consegnato cartaceo). L'allegato è best-effort.

⚠️ Domande aperte

• Auto-popolazione documenti richiesti. Sulla base di fase e regime aiuto, il sistema dovrebbe creare in automatico le richieste di documento?
• Scadenza automatica. Un documento "ricevuto" passa in "scaduto" dopo N giorni? Configurabile per tipo?
• Checklist unica vs separati. Oggi documenti aziende, progetto e staff sono in tabelle separate: vista aggregata "cosa manca nel progetto X" esiste?

🔗 Vedi anche

• Panoramica
• Progetti e fasi
• Aziende e iscrizioni
• Glossario
• Notifiche automatiche — promemoria su finestra integrazioni FondItalia (60-90 giorni dalla richiesta) e, una volta definita la regola con il cliente, su documenti richiesti in attesa.