PIM - Product Information Management

Il pannello di amministrazione (PIM) è il sistema di gestione backend che consente agli amministratori di gestire tutti i contenuti e le configurazioni della piattaforma.

Moduli Principali del PIM

Gestione Alloggi

• Creazione e Modifica: Creazione nuove strutture, modifica dati esistenti
• Configurazione Camere: Gestione tipologie camera, occupazioni, servizi
• Gestione Media: Upload e organizzazione immagini strutture
• Servizi e Punti di Interesse: Collegamento servizi e punti di interesse alle strutture
• Categorie: Assegnazione categorie agli alloggi
• Attivazione/Disattivazione: Controllo visibilità strutture sul frontend

Gestione Prenotazioni

• Lista Prenotazioni: Visualizzazione tutte le prenotazioni con filtri
• Dettaglio Prenotazione: Visualizzazione completa dati prenotazione
• Azioni: Modifica stato, cancellazione, export
• Gestione Clienti: Collegamento prenotazioni a clienti

Gestione Contenuti

• Servizi: Creazione e gestione servizi (pet e bipedi)
• Destinazioni: Gestione destinazioni geografiche
• Entity Locator: Gestione punti di interesse, trasporti, documenti
• FAQ: Gestione domande frequenti e categorie

Gestione Utenti

• Utenti: Gestione utenti amministratori
• Clienti: Visualizzazione clienti registrati

Caratteristiche Tecniche

• Interfaccia basata su Filament (framework Laravel)
• Gestione multi-lingua dei contenuti (IT, EN, DE)
• Sistema di cache integrato (pulizia cache per aggiornare frontend)
• Export dati e reportistica
• Validazione e controllo dati in input

Relazione PIM ↔ Frontend

Relazione Bidirezionale:

• PIM → Frontend:

  • Il PIM gestisce tutti i dati che vengono visualizzati sul frontend
  • Modifiche nel PIM (alloggi, servizi, destinazioni) devono essere pubblicate
  • Pulizia cache obbligatoria dopo ogni modifica per vedere cambiamenti sul frontend
  • Il frontend legge principalmente dati cached per performance

• Frontend → PIM:

  • Le prenotazioni create dal frontend vengono salvate e visibili nel PIM
  • Le registrazioni utenti dal frontend creano record nel PIM
  • Le recensioni scritte dagli utenti appaiono nel PIM

Meccanismo Cache:

• Cache layer tra PIM e Frontend
• Modifiche PIM → invalidazione cache → frontend legge dati aggiornati
• Menu "Pulisci Cache" nella rotellina per invalidazione manuale

Use Case Diagram - PIM

Questa sezione illustra il diagramma degli use case del PIM (Product Information Management), mostrando le principali funzionalità e interazioni tra gli attori e il sistema di amministrazione.

Diagramma Use Case PIM

Il diagramma seguente mostra tutti gli use case principali del PIM:

Panoramica

Il diagramma degli use case del PIM mostra le interazioni tra gli attori (utenti del sistema) e le funzionalità (use case) del pannello di amministrazione. Questo diagramma aiuta a comprendere:

• Chi utilizza il sistema (attori)
• Cosa può fare (use case)
• Come interagiscono con il sistema

Attori Principali

1. Amministratore (Admin)

L'amministratore ha accesso completo a tutte le funzionalità del PIM e può:

• Gestire tutti i contenuti della piattaforma
• Configurare impostazioni di sistema
• Gestire utenti
• Visualizzare report e statistiche

2. Content Manager

Il content manager si occupa della gestione dei contenuti:

• Gestione alloggi e strutture
• Gestione contenuti editoriali
• Gestione servizi e destinazioni
• Gestione media e immagini

3. Booking Manager

Il booking manager gestisce le prenotazioni:

• Visualizzazione prenotazioni
• Gestione stato prenotazioni
• Gestione clienti
• Export dati prenotazioni

4. Super Admin

Il super admin ha privilegi massimi:

• Gestione completa sistema
• Configurazione avanzata
• Accesso a tutte le funzionalità

Use Case Principali

Gestione Alloggi

Use Case: Gestire Alloggi

• Attori: Admin, Content Manager
• Descrizione: Creazione, modifica, eliminazione e visualizzazione di strutture ricettive
• Precondizioni: Utente autenticato con permessi appropriati
• Flusso principale:
  1. Accesso alla sezione Alloggi
  2. Visualizzazione lista alloggi
  3. Creazione nuovo alloggio o modifica esistente
  4. Inserimento dati struttura (nome, indirizzo, descrizione)
  5. Configurazione camere e tipologie
  6. Upload immagini e media
  7. Collegamento servizi e punti di interesse
  8. Attivazione/disattivazione struttura
  9. Salvataggio modifiche
  10. Pulizia cache per aggiornare frontend

Use Case: Gestire Camere

• Attori: Admin, Content Manager
• Descrizione: Gestione tipologie camera, occupazioni e configurazioni
• Flusso principale:
  1. Accesso alla struttura
  2. Visualizzazione lista camere
  3. Creazione nuova tipologia camera
  4. Configurazione occupazioni (adulti, bambini, pets)
  5. Impostazione servizi camera
  6. Configurazione tariffe e disponibilità
  7. Clonazione camere esistenti
  8. Salvataggio modifiche

Use Case: Gestire Media Alloggi

• Attori: Admin, Content Manager
• Descrizione: Upload, organizzazione e gestione immagini strutture
• Flusso principale:
  1. Accesso alla sezione media di un alloggio
  2. Upload nuove immagini
  3. Organizzazione immagini in galleria
  4. Impostazione immagine principale
  5. Modifica ordine immagini
  6. Eliminazione immagini
  7. Salvataggio modifiche

Gestione Prenotazioni

Use Case: Visualizzare Prenotazioni

• Attori: Admin, Booking Manager
• Descrizione: Visualizzazione lista prenotazioni con filtri e ricerca
• Flusso principale:
  1. Accesso alla sezione Prenotazioni
  2. Applicazione filtri (data, stato, cliente)
  3. Visualizzazione lista prenotazioni
  4. Accesso dettaglio prenotazione
  5. Visualizzazione informazioni complete

Use Case: Gestire Stato Prenotazione

• Attori: Admin, Booking Manager
• Descrizione: Modifica stato prenotazione (pending, paid, cancelled, etc.)
• Flusso principale:
  1. Accesso a dettaglio prenotazione
  2. Selezione nuovo stato
  3. Conferma modifica
  4. Aggiornamento stato nel sistema
  5. Notifica cliente se necessario

Use Case: Gestire Fatturazione

• Attori: Admin, Booking Manager
• Descrizione: Upload, download e gestione fatture per prenotazioni
• Flusso principale:
  1. Accesso a dettaglio prenotazione
  2. Visualizzazione sezione fatturazione
  3. Upload fattura generata esternamente
  4. Download fattura esistente
  5. Eliminazione fattura se necessario

Use Case: Export Prenotazioni

• Attori: Admin, Booking Manager
• Descrizione: Export dati prenotazioni in formati standard (CSV, Excel)
• Flusso principale:
  1. Accesso alla sezione Prenotazioni
  2. Applicazione filtri per selezione
  3. Selezione formato export
  4. Generazione file export
  5. Download file

Gestione Contenuti

Use Case: Gestire Servizi

• Attori: Admin, Content Manager
• Descrizione: Creazione e gestione servizi disponibili (pet e bipedi)
• Flusso principale:
  1. Accesso alla sezione Servizi
  2. Creazione nuovo servizio o modifica esistente
  3. Configurazione categoria servizio
  4. Impostazione disponibilità per tipo (pet/bipedi)
  5. Collegamento servizio ad alloggi
  6. Salvataggio modifiche

Use Case: Gestire Destinazioni

• Attori: Admin, Content Manager
• Descrizione: Gestione destinazioni geografiche e località
• Flusso principale:
  1. Accesso alla sezione Destinazioni
  2. Creazione nuova destinazione
  3. Configurazione dati geografici
  4. Collegamento alloggi a destinazioni
  5. Salvataggio modifiche

Use Case: Gestire Punti di Interesse

• Attori: Admin, Content Manager
• Descrizione: Gestione punti di interesse, trasporti e documenti (Entity Locator)
• Flusso principale:
  1. Accesso alla sezione Entity Locator
  2. Creazione nuovo punto di interesse
  3. Configurazione tipo (POI, trasporto, documento)
  4. Collegamento ad alloggi
  5. Salvataggio modifiche

Use Case: Gestire FAQ

• Attori: Admin, Content Manager
• Descrizione: Gestione domande frequenti e categorie FAQ
• Flusso principale:
  1. Accesso alla sezione FAQ
  2. Creazione nuova FAQ o modifica esistente
  3. Assegnazione categoria
  4. Inserimento domanda e risposta
  5. Configurazione visibilità
  6. Salvataggio modifiche

Gestione Utenti

Use Case: Gestire Utenti Admin

• Attori: Admin, Super Admin
• Descrizione: Creazione, modifica e gestione utenti amministratori
• Flusso principale:
  1. Accesso alla sezione Utenti
  2. Creazione nuovo utente o modifica esistente
  3. Configurazione dati utente
  4. Configurazione autenticazione
  5. Salvataggio modifiche

Use Case: Visualizzare Clienti

• Attori: Admin, Booking Manager
• Descrizione: Visualizzazione clienti registrati e loro dati
• Flusso principale:
  1. Accesso alla sezione Clienti
  2. Ricerca cliente per nome, email
  3. Visualizzazione dettagli cliente
  4. Visualizzazione prenotazioni cliente
  5. Visualizzazione dati profilo

Gestione Sistema

Use Case: Gestire Cache

• Attori: Admin, Content Manager
• Descrizione: Pulizia cache per aggiornare contenuti sul frontend
• Flusso principale:
  1. Accesso a dettaglio alloggio o contenuto
  2. Click su menu rotellina (impostazioni)
  3. Selezione "Pulisci Cache"
  4. Conferma operazione
  5. Cache invalidata e contenuti aggiornati

Use Case: Visualizzare Dashboard

• Attori: Admin, Booking Manager, Content Manager
• Descrizione: Visualizzazione dashboard con statistiche e overview
• Flusso principale:
  1. Accesso al PIM
  2. Visualizzazione dashboard principale
  3. Analisi statistiche prenotazioni
  4. Visualizzazione ordini recenti
  5. Accesso a sezioni specifiche

Use Case: Gestire Configurazioni

• Attori: Super Admin
• Descrizione: Configurazione impostazioni sistema e piattaforma
• Flusso principale:
  1. Accesso alla sezione Configurazioni
  2. Modifica impostazioni sistema
  3. Configurazione integrazioni
  4. Impostazione parametri globali
  5. Salvataggio configurazioni

Relazioni tra Use Case

Include

Alcuni use case includono altri use case come parte del loro flusso:

• Gestire Alloggi include Gestire Cache (dopo salvataggio modifiche)
• Gestire Camere include Gestire Cache (dopo modifiche)
• Gestire Media include Gestire Cache (dopo upload/modifica immagini)

Extend

Alcuni use case estendono altri use case in condizioni specifiche:

• Export Prenotazioni può estendere Visualizzare Prenotazioni (quando si vuole esportare)
• Gestire Fatturazione estende Visualizzare Prenotazioni (per gestire fatture)

Flussi di Lavoro Tipici

Workflow: Creazione Nuovo Alloggio

1. Content Manager accede al PIM
2. Crea nuovo alloggio
3. Inserisce dati base (nome, indirizzo, descrizione)
4. Configura camere e tipologie
5. Upload immagini struttura
6. Collega servizi disponibili
7. Collega punti di interesse
8. Attiva struttura
9. Pulisce cache
10. Verifica su frontend

Workflow: Gestione Prenotazione

1. Booking Manager accede alla sezione Prenotazioni
2. Visualizza lista prenotazioni
3. Filtra per stato o data
4. Accede a dettaglio prenotazione
5. Verifica dati cliente e prenotazione
6. Modifica stato se necessario
7. Upload fattura se generata
8. Export dati se necessario

Workflow: Gestione Contenuti

1. Content Manager accede alla sezione Contenuti
2. Crea o modifica servizio/destinazione/FAQ
3. Configura dati e relazioni
4. Salva modifiche
5. Pulisce cache se necessario
6. Verifica su frontend

Note Tecniche Use Case

Tecnologie Utilizzate

• Framework: Filament (Laravel)
• Autenticazione: Laravel Fortify
• Autorizzazione: Filament Shield (Spatie Permission)
• Cache: Redis
• Storage: S3 per media

Best Practices

• Pulizia Cache: Sempre pulire cache dopo modifiche contenuti
• Validazione: Validare sempre dati prima di salvare
• Backup: Backup regolari prima di modifiche importanti
• Testing: Testare modifiche su staging prima di produzione
• Documentazione: Documentare modifiche significative