# Firmato for Perfex — 1.0.0

Pacchetto preliminare MOCK. Nessuna firma provider o consumo reale abilitato.

## Installazione
Caricare `firmato_connect-1.0.0.zip` nel gestore Moduli Perfex. Attivare come amministratore; il modulo crea solo la propria tabella prefissata. Servono PHP 8.2, cURL/OpenSSL, chiave di cifratura CodeIgniter configurata e CSRF Perfex attivo. Assegnare view/create agli staff autorizzati.

## Funzioni
Pannello MOCK, credenziale cifrata, scelta servizio/1–10 firmatari/sequenza, request key persistita prima dell’invio, polling e download PDF di prova. Ogni staff vede solo le proprie richieste. L’admin può associare un ID cliente locale esistente; nessun dato cliente viene inviato.

In caso di timeout non creare una nuova prova: riutilizzare la richiesta salvata e la sua chiave. I PDF scaricati sono marcati TEST/NON VALIDO PER USO LEGALE. Configurare soltanto token Firmato, mai token Openapi.

## Limiti e collaudo
Installazione Perfex 3.x non eseguita. Hook contratti/preventivi, allegati cliente automatici, UI firmatari, upload PDF e callback ricevente non completati. I file lingua presenti non costituiscono una traduzione completa. Limite 200 riferimenti per staff; archiviazione amministrativa da definire prima di uso esteso.
Verificare in una piattaforma staging di proprietà: attivazione, login/permessi, nonce/CSRF, richiesta duplicata, revoca, saldo esaurito, polling/download e disattivazione. Nessun risultato nativo è dichiarato PASS in questa patch.

## Disattivazione e dati
Disattivazione rimuove gli hook runtime e lascia dati/configurazione. Prima di rimuovere il modulo, revocare la credenziale Firmato. Non cancellare tabella o documenti cliente automaticamente.

## Distribuzione
Checksum in marketplace e `connect/distribution/manifest.json`. Nessuna telemetria o registrazione installazione automatica. Aggiornamento manuale: non viene scaricato/eseguito codice remoto. Pubblicazione sui marketplace non effettuata. Il pacchetto non effettua pagamenti; il futuro consumo LIVE richiederà un listino distinto e un adattatore validato.
