smartbooking/features/visualizzazione-prenotazioni.md

Ecco una bozza di specifiche tecniche strutturate in Markdown, ottimizzate per essere interpretate da un agente di coding (come un plugin IDE o un modello LLM focalizzato sullo sviluppo).

---

Specifiche Tecniche: Gestione e Visualizzazione Prenotazioni

1. Obiettivo

Implementare un sistema di visualizzazione e gestione delle prenotazioni basato sui ruoli utente (ROLE_USER, ROLE_INCARICATO), con logica di business legata all'esistenza di un oggetto Conferma correlato.

2. Modello Dati e Relazioni

• Prenotazione (P): Entità principale.
• Conferma (C): Entità correlata a Prenotazione.
  • Relazione: One-to-One.
  • Chiave Primaria: C.id deve coincidere con P.id.
  • Campi Conferma:
    • tipoConferma (Enum: TipoConferma)
    • motivoConferma (String/Text)
    • codice (String, Alfanumerico Base62, generato dal sistema).

3. Logica di Accesso e Visualizzazione

3.1 Vista: ROLE_USER

L'utente visualizza esclusivamente le proprie prenotazioni.

• Query: SELECT * FROM Prenotazione WHERE utente_id = :current_user_id ORDER BY data_inserimento DESC.
• Interfaccia (Tabella):
  • Caso A: Prenotazione SENZA Conferma
    • Azioni permesse: Visualizza, Modifica, Cancella.
  • Caso B: Prenotazione CON Conferma
    • Azioni permesse: Visualizza (Read-only), Visualizza Conferma.
    • Inibizione: I tasti Modifica e Cancella devono essere disabilitati o nascosti.

3.2 Vista: ROLE_INCARICATO

L'utente visualizza tutte le prenotazioni del sistema create negli ultimi 12 mesi.

• Filtro Temporale: data_prenotazione >= CURRENT_DATE - 12 mesi.
• Layout: Due tabelle distinte.

Tabella 1: Prenotazioni Pendenti (Senza Conferma)

• Contenuto: Prenotazioni che non hanno un record corrispondente nella tabella Conferma.
• Azioni:
  1. Visualizza: Apre il dettaglio della prenotazione.
  2. Prendi in carico: Apre una finestra modale (Pop-up).

Tabella 2: Prenotazioni Completate (Con Conferma)

• Contenuto: Prenotazioni che hanno un record corrispondente nella tabella Conferma.
• Azioni: Visualizzazione del dettaglio e della relativa conferma.

---

4. Workflow "Prendi in carico" (Modale)

Al clic sul pulsante nella Tabella 1 del ROLE_INCARICATO:

1. Apertura Modale: Form di creazione per l'oggetto Conferma.
2. Input Utente:

• tipoConferma: Select box basata sull'Enum.
• motivoConferma: TextArea (Testo libero).

3. Logica di Sistema (Generazione Codice):

• Il campo codice deve essere generato lato server (o pre-calcolato) convertendo il timestamp corrente (data/ora) in una stringa Base62 (caratteri 0-9, a-z, A-Z).

4. Salvataggio:

• Creazione record Conferma con id identico a quello della Prenotazione selezionata.

5. Post-Azione:

• Chiusura modale.
• Refresh Reattivo: Le tabelle devono aggiornarsi senza ricaricare l'intera pagina (la prenotazione deve spostarsi dalla Tabella 1 alla Tabella 2).

---

5. Requisiti Tecnici Suggeriti

• Sicurezza: Verificare l'authority lato server (Spring Security o equivalente) per ogni richiesta API. Non basarsi solo sull'occultamento dei tasti lato UI.
• Generazione Base62: Implementare una funzione di encoding che trasformi long timestamp in String Base62.

---

6. Definizione del Successo (Criteri di Accettazione)

• Un ROLE_USER non può cancellare una prenotazione se esiste una conferma.
• Un ROLE_INCARICATO vede solo i dati degli ultimi 12 mesi.
• Il salvataggio di una conferma sposta istantaneamente la riga tra le due tabelle dell'incaricato.
• Il codice della conferma è univoco e generato in Base62.