12 - Sondaggi e Questionari in Tempo Reale

@Entity
@Table(name = "sondaggi")
public class Sondaggio {
    private Long id;
    private Evento evento;
    private TipoEntitaSondaggio tipoEntita;  // LUOGO, DATA, MENU...
    private Long entitaId;
    private String titolo;
    private String descrizione;
    private TipoRispostaSondaggio tipoRisposta; // SINGOLA o MULTIPLA
    private StatoSondaggio stato;               // BOZZA, ATTIVO, CHIUSO, ANNULLATO
    private TipoSondaggio tipo;                 // EVENTO o TEMPLATE
    private Long templateOrigineId;
    private LocalDateTime dataScadenza;
    private Boolean anonimo;
    private Boolean permettiModificaVoto;
    private Boolean mostraRisultatiPrimaVoto;
    private Integer maxOpzioniSelezionabili;
    private Boolean pubblico;
    private String codiceCondivisione;          // UUID per sharing
    private Set<OpzioneSondaggio> opzioni;
    private OpzioneSondaggio opzioneVincitrice;
    private Set<StoricoVincitoreSondaggio> storicoVincitori;
}

public enum StatoSondaggio {
    BOZZA("Bozza"),         // Creazione e configurazione
    ATTIVO("Attivo"),       // Aperto alle votazioni
    CHIUSO("Chiuso"),       // Votazioni terminate
    ANNULLATO("Annullato"); // Sondaggio invalidato
}

public void pubblica() {
    if (this.stato != StatoSondaggio.BOZZA) {
        throw new IllegalStateException(
            "Solo sondaggi in bozza possono essere pubblicati");
    }
    if (this.opzioni.size() < 2) {
        throw new IllegalStateException(
            "Il sondaggio deve avere almeno 2 opzioni");
    }
    this.stato = StatoSondaggio.ATTIVO;
}

public void riapri() {
    if (this.stato != StatoSondaggio.CHIUSO) {
        throw new IllegalStateException(
            "Solo sondaggi chiusi possono essere riaperti");
    }
    this.stato = StatoSondaggio.ATTIVO;
}

public enum TipoRispostaSondaggio {
    SINGOLA("Singola"),    // Radio button - una sola scelta
    MULTIPLA("Multipla");  // Checkbox - più' opzioni selezionabili
}

public static Sondaggio crea(Evento evento, User creatoDa,
        TipoEntitaSondaggio tipoEntita, String titolo,
        TipoRispostaSondaggio tipoRisposta) {
    Sondaggio s = new Sondaggio();
    // ... inizializzazione campi ...
    s.maxOpzioniSelezionabili =
        tipoRisposta == TipoRispostaSondaggio.SINGOLA ? 1 : 3;
    s.permettiModificaVoto = true;
    s.mostraRisultatiPrimaVoto = false;
    return s;
}

// Voto di un utente registrato
RispostaSondaggio.creaPerUtente(sondaggio, opzione, utente);

// Voto di un esterno via email (con token di modifica)
RispostaSondaggio.creaPerEmail(sondaggio, opzione, email);

// Voto anonimo su sondaggio pubblico
RispostaSondaggio.creaAnonima(sondaggio, opzione);

public String rendiPubblico() {
    if (this.stato == StatoSondaggio.BOZZA) {
        throw new IllegalStateException(
            "Pubblica il sondaggio prima di renderlo pubblico");
    }
    if (this.pubblico && this.codiceCondivisione != null) {
        return this.codiceCondivisione; // Gia' pubblico
    }
    this.pubblico = true;
    this.codiceCondivisione = UUID.randomUUID().toString();
    return this.codiceCondivisione;
}

public String rigeneraCodiceCondivisione() {
    // Invalida i link precedenti
    this.codiceCondivisione = UUID.randomUUID().toString();
    return this.codiceCondivisione;
}

@Entity
@Table(name = "voti_pubblici",
    uniqueConstraints = @UniqueConstraint(
        columnNames = {"sondaggio_id", "fingerprint"}))
public class VotoPubblico {
    private Long id;
    private Sondaggio sondaggio;
    private String fingerprint;   // Hash del browser
    private Instant votatoIl;
}

// Crea un template riutilizzabile
Sondaggio template = Sondaggio.creaTemplate(
    utente, "Preferenza Location",
    TipoEntitaSondaggio.LUOGO, "Dove facciamo la festa?",
    TipoRispostaSondaggio.SINGOLA);

// Istanzia il template per un evento specifico
Sondaggio istanza = Sondaggio.creaDaTemplate(
    template, evento, organizzatore);
istanza.copiaOpzioniDa(template);

// L'istanza eredita: titolo, descrizione, tipoRisposta,
// configurazione (anonimo, maxSelezionabili, ecc.)
// ma parte sempre in stato BOZZA

@Entity
@Table(name = "storico_vincitori_sondaggio")
public class StoricoVincitoreSondaggio {
    private Long id;
    private Sondaggio sondaggio;
    private OpzioneSondaggio opzionePrecedente; // null se prima selezione
    private OpzioneSondaggio opzioneNuova;
    private String motivazione;                 // obbligatoria per cambi
    private User modificatoDa;
    private Instant modificatoIl;
}

public StoricoVincitoreSondaggio selezionaVincitore(
        Long opzioneId, User selezionatoDa, String motivazione) {
    verificaChiuso();      // Deve essere CHIUSO
    verificaTipoLuogo();   // Solo per sondaggi LUOGO

    OpzioneSondaggio opzione = trovaNelleOpzioni(opzioneId);

    StoricoVincitoreSondaggio storico;
    if (this.opzioneVincitrice != null) {
        // Cambio vincitore: motivazione OBBLIGATORIA
        if (motivazione == null || motivazione.isBlank()) {
            throw new IllegalArgumentException(
                "La motivazione e' obbligatoria per cambiare il vincitore");
        }
        storico = StoricoVincitoreSondaggio.creaCambio(
            this, this.opzioneVincitrice, opzione,
            motivazione, selezionatoDa);
    } else {
        // Prima selezione
        storico = StoricoVincitoreSondaggio.creaPrimaSelezione(
            this, opzione, selezionatoDa);
    }

    this.opzioneVincitrice = opzione;
    this.storicoVincitori.add(storico);
    return storico;
}

public enum TipoEntitaSondaggio {
    LUOGO("Luogo"),           // Votare la venue dell'evento
    DATA("Data"),             // Scegliere la data
    MENU("Menu"),             // Preferenze catering
    ATTIVITA("Attività"),      // Attività da organizzare
    CUSTOM("Personalizzato"); // Sondaggio generico
}

@Entity
public class OpzioneSondaggio {
    private Long id;
    private Sondaggio sondaggio;
    private String testo;
    private Long entitaRiferimentoId;  // ID del luogo collegato
    private String descrizione;         // Info aggiuntive
    private String immagineUrl;         // Foto della venue
    private Integer ordine;
    private Set<RispostaSondaggio> risposte;
}

public void configura(Boolean anonimo, Boolean permettiModificaVoto,
        Boolean mostraRisultatiPrimaVoto,
        Integer maxOpzioniSelezionabili,
        LocalDateTime dataScadenza) {
    verificaModificabile(); // Solo in stato BOZZA
    if (maxOpzioniSelezionabili != null) {
        if (maxOpzioniSelezionabili < 1) {
            throw new IllegalArgumentException(
                "Deve essere selezionabile almeno un'opzione");
        }
        this.maxOpzioniSelezionabili = maxOpzioniSelezionabili;
    }
    this.dataScadenza = dataScadenza;
    // ... altri campi ...
}

@Entity
@Table(name = "questionari")
public class Questionario {
    private Long id;
    private Evento evento;
    private TipoQuestionario tipo;       // TEMPLATE o EVENTO
    private Long templateOrigineId;
    private String titolo;
    private String descrizione;
    private String etichetta;
    private String coloreEtichetta;
    private StatoQuestionario stato;     // BOZZA, PUBBLICATO, CHIUSO, ARCHIVIATO
    private LocalDateTime dataScadenza;
    private Boolean anonimo;
    private Boolean richiediEmail;
    private Boolean richiediNome;
    private Boolean pubblico;
    private String codiceCondivisione;
    private List<DomandaQuestionario> domande;
}

public enum StatoQuestionario {
    BOZZA("Bozza"),           // In fase di creazione
    PUBBLICATO("Pubblicato"), // Aperto alle compilazioni
    CHIUSO("Chiuso"),         // Compilazioni terminate
    ARCHIVIATO("Archiviato"); // Conservato in archivio
}

public enum TipoDomanda {
    APERTA("Risposta aperta"),           // Testo libero
    SCELTA_SINGOLA("Scelta singola"),    // Radio button
    SCELTA_MULTIPLA("Scelta multipla");  // Checkbox
}

@Entity
public class DomandaQuestionario {
    private Long id;
    private Questionario questionario;
    private String testo;
    private TipoDomanda tipoDomanda;
    private Boolean obbligatoria;        // Default: true
    private Integer ordine;
    private String descrizioneAiuto;     // Testo di aiuto opzionale
    private List<OpzioneDomanda> opzioni;
}

// Validazione nel metodo aggiungiOpzione
public OpzioneDomanda aggiungiOpzione(String testo) {
    if (!this.tipoDomanda.richiedeOpzioni()) {
        throw new IllegalStateException(
            "Le domande di tipo " + this.tipoDomanda
            + " non supportano opzioni");
    }
    // ...
}

@Entity
public class CompilazioneQuestionario {
    private Long id;
    private Questionario questionario;
    private User utente;                // null se compilazione pubblica
    private String nomeCompilatore;
    private String emailCompilatore;
    private String fingerprint;         // Per tracciamento anonimo
    private List<RispostaQuestionario> risposte;
    private Instant compilatoIl;
}

// Due modalità' di compilazione
CompilazioneQuestionario.creaPerUtente(questionario, utente);
CompilazioneQuestionario.creaPubblica(
    questionario, nome, email, fingerprint);

@Entity
public class EtichettaQuestionario {
    private Long id;
    private String nome;          // Max 50 caratteri
    private String colore;        // Codice esadecimale (#3B82F6)
    private Long userId;          // null per etichette di sistema
    private boolean predefinita;  // true = di sistema
}

// Creazione etichetta personalizzata
EtichettaQuestionario.creaPersonalizzata(
    userId, "Feedback Post-Evento", "#10B981");

public boolean sonoRisultatiVisibili(boolean haVotato) {
    if (this.stato == StatoSondaggio.CHIUSO) return true;
    if (Boolean.TRUE.equals(this.mostraRisultatiPrimaVoto)) return true;
    return haVotato;
}

public boolean isVotabile() {
    return this.stato == StatoSondaggio.ATTIVO &&
        (this.dataScadenza == null ||
         LocalDateTime.now().isBefore(this.dataScadenza));
}