Step 1 – Archivio tipi utente

L'archivio elenca i 15 tipi di operatore della filiera ittica che l'applicazione dovrà riconoscere. Ogni tipo determina quali documenti l'utente produce, riceve e conserva, secondo gli obblighi descritti nel perimetro normativo. Un'azienda reale può avere più tipi (es. un armatore che vende direttamente, un grossista che importa).

Tipi di operatore

Archivio unico: utenti WordPress

Ogni operatore della filiera è un utente WordPress. Il tipo di anagrafica e tutti i dati sono salvati come metadati dell'utente (wp_usermeta), con chiavi che iniziano per fi_. Non esistono altri archivi anagrafici.

• Ruoli WordPress: fi_operatore per gli operatori; fi_gestore per chi configura i tipi di anagrafica dal front end; fi_controllore in sola lettura per autorità o consulenti; gli amministratori restano administrator.
• Tipo di anagrafica: metadato fi_tipo_utente, a spunte multiple. Il profilo mostra solo i campi dei tipi spuntati.
• Schede ripetibili (imbarcazioni, impianti, punti vendita, automezzi, magazzini): elenco di schede dentro il metadato corrispondente, ognuna con un proprio codice per collegarla ai documenti.
• Stato dell'anagrafica: tendina fi_stato_verifica (Da verificare, Verificata, Sospesa). Un operatore non verificato non può emettere documenti.

Tipi di anagrafica configurabili dal front end

I 15 tipi descritti sotto sono la configurazione iniziale, non uno schema fisso. Un utente con ruolo fi_gestore li modifica da una pagina del sito, senza toccare codice.

• Cosa si può fare: creare un nuovo tipo, rinominarlo, disattivarlo; aggiungere, modificare, riordinare o nascondere campi; cambiare le voci di una tendina o di un gruppo di spunte; segnare un campo come obbligatorio.
• Dove sono salvati: ogni tipo è un contenuto WordPress fi_tipo_anagrafica con codice, nome, fase della filiera, stato (attivo/disattivo) e l'elenco dei suoi campi.
• Definizione di un campo: etichetta, chiave, formato (tendina, spunta, spunte multiple, testo, numero, data, email, file, schede ripetibili), voci disponibili per tendine e spunte, obbligatorio sì/no, condizione di visibilità (es. "solo se Serve pesce crudo = sì"), ordine.
• Regola di sicurezza: un campo già compilato da qualche operatore non si cancella ma si disattiva, così i dati esistenti non vanno persi.

Formati usati, in ordine di preferenza: tendina (una scelta), spunte (più scelte), spunta (sì/no); poi numero, data, email, file; testo libero solo per codici e nomi propri.

Anagrafica comune a tutti i tipi

Campi specifici per tipo

UT01 – Armatore / comandante peschereccio (≥ 12 m)

Schede ripetibili imbarcazione (fi_imbarcazioni).

UT02 – Pescatore della piccola pesca costiera (< 12 m)

Stessa scheda imbarcazione di UT01, con IMO, IRCS e VMS non obbligatori sotto i 9 metri fino al 31/12/2029. In più:

UT03 – Acquacoltore (pesci e crostacei)

Schede ripetibili impianto (fi_impianti).

UT04 – Molluschicoltore / raccoglitore di bivalvi

Schede ripetibili area di produzione (fi_aree_produzione).

UT05 – Mercato ittico all'ingrosso / asta

UT06 – Primo acquirente registrato

UT07 – Centro di depurazione o spedizione molluschi (CDM/CSM)

UT08 – Stabilimento di lavorazione e trasformazione

UT09 – Grossista / deposito frigorifero

UT10 – Trasportatore refrigerato

UT11 – Importatore

UT12 – Esportatore

UT13 – Dettagliante (pescheria, GDO)

Schede ripetibili punto vendita (fi_punti_vendita).

UT14 – Ristoratore / ristorazione collettiva

Schede ripetibili locale (fi_locali).

UT15 – Pescatore ricreativo

Valgono solo i campi comuni da persona fisica.

Da decidere

• Utenti in sola lettura (autorità, consulenti, laboratori, consumatore tramite QR): confermare il ruolo fi_controllore e cosa può vedere.
• Elenchi di valori da caricare all'avvio (compartimenti marittimi, porti, posti di controllo frontalieri, specie con codici FAO): da quali fonti ufficiali prenderli.
• Strumento per i campi configurabili: plugin di campi personalizzati già esistente o plugin sviluppato su misura.
• Verifica delle anagrafiche: chi la esegue e quali documenti chiede all'operatore.