Specie animali

Descrizione generale

Le specie animali permettono di classificare e gestire i diversi tipi di animali domestici che possono essere ospitati nelle camere. Ogni specie può avere multiple razze e taglie associate, ognuna con caratteristiche specifiche come il numero di slot richiesti.

Le specie animali sono utilizzate per:

• Definire quali animali sono ammessi in una camera (configurazione nelle occupancy)
• Calcolare gli slot pet necessari per ogni animale
• Organizzare le razze e le taglie per specie

Come arrivarci

1. Apri l'area amministrativa https://stage.bauking.dnalab.online/admin.
2. Nel menu laterale, espandi la sezione Servizi.
3. Clicca su Specie Animali.

Panoramica della schermata

La schermata delle specie animali mostra un elenco di tutte le specie configurate nel sistema. La tabella mostra:

• Icona: icona grafica associata alla specie
• Nome: nome della specie animale
• Descrizione: descrizione testuale della specie (supporta formattazione HTML)
• Azione: pulsante per modificare la specie

Nella parte superiore della pagina trovi:

• Pulsante Nuovo per creare una nuova specie
• Selettore Locale per cambiare la lingua dei contenuti (italiano, inglese, tedesco)
• Campo di ricerca per filtrare le specie

Come creare una specie animale

Procedura passo per passo

1. Nella pagina delle specie animali, clicca sul pulsante Nuovo in alto a destra.

2. Si apre il form di creazione con i seguenti campi:

• Nome*: inserisci il nome della specie animale (es. "Cane", "Gatto", "Coniglio"). Questo campo è obbligatorio e traducibile.
• Descrizione: inserisci una descrizione dettagliata della specie. Supporta formattazione HTML (grassetto, corsivo, sottolineato, link, intestazioni). Questo campo è opzionale e traducibile.
• Icona: seleziona un'icona grafica dalla libreria disponibile oppure carica una nuova icona cliccando sul pulsante Carica. L'icona viene visualizzata nella lista e nelle interfacce utente.

3. Clicca Salva per registrare la nuova specie e tornare alla lista, oppure Salva & nuovo per salvare e aprire subito un nuovo form vuoto.

Dopo la creazione

Dopo aver creato una specie animale, puoi:

• Aggiungere razze associate alla specie (es. per "Cane": Yorkshire, Pastore Tedesco, ecc.)
• Aggiungere taglie associate alla specie (es. per "Cane": Piccola, Media, Grande) con il relativo numero di slot richiesti

Queste operazioni vengono eseguite nella pagina di modifica della specie (vedi sezione "Come modificare una specie animale").

Come modificare una specie animale

Procedura passo per passo

1. Nella lista delle specie animali, clicca sul pulsante Modifica accanto alla specie che vuoi modificare.

2. Si apre la pagina di modifica con tre sezioni principali:

   • Form principale: contiene i campi Nome, Descrizione e Icona (stessi campi del form di creazione)
   • Tab "Razze": gestisce le razze associate alla specie
   • Tab "Taglie": gestisce le taglie associate alla specie con i relativi slot richiesti

3. Modifica i campi desiderati nel form principale.

4. Per gestire le razze:

   • Clicca sulla tab Razze
   • Clicca su Nuovo per aggiungere una nuova razza
   • Compila il form con Nome, Descrizione (opzionale) e Icona (opzionale)
   • Clicca Salva per registrare la razza
   • Usa i pulsanti Modifica o Elimina per gestire le razze esistenti

5. Per gestire le taglie:

   • Clicca sulla tab Taglie
   • Clicca su Nuovo per aggiungere una nuova taglia
   • Compila il form con:
     • Nome*: nome della taglia (es. "Piccola", "Media", "Grande")
     • Descrizione: descrizione opzionale della taglia
     • Icona: icona opzionale
     • Slot richiesti*: numero di slot che questa taglia occupa (es. 2 per piccola, 4 per grande)
     • Peso minimo e Peso massimo: range di peso in chilogrammi (opzionali)
   • Clicca Salva per registrare la taglia
   • Usa i pulsanti Modifica o Elimina per gestire le taglie esistenti

6. Clicca Salva nel form principale per applicare le modifiche alla specie.

Eliminare una specie animale

1. Nella pagina di modifica della specie, clicca sul pulsante Elimina in alto a destra.
2. Conferma l'eliminazione nella finestra di dialogo.
3. Attenzione: l'eliminazione di una specie elimina anche tutte le razze e taglie associate.

Campi disponibili

Form principale

Campo	Tipo e formato	Dettagli e requisiti
Nome*	Testo	Nome della specie animale; obbligatorio; traducibile; lunghezza massima 255 caratteri
Descrizione	Rich Text (HTML)	Descrizione dettagliata della specie; opzionale; traducibile; supporta formattazione (grassetto, corsivo, sottolineato, link, intestazioni H2/H3)
Icona	Selezione/Upload	Icona grafica associata alla specie; opzionale; può essere selezionata da libreria esistente o caricata tramite pulsante "Carica"

Tab Razze

Campo	Tipo e formato	Dettagli e requisiti
Nome*	Testo	Nome della razza; obbligatorio; traducibile
Descrizione	Rich Text (HTML)	Descrizione opzionale della razza; traducibile
Icona	Selezione/Upload	Icona opzionale per la razza

Tab Taglie

Campo	Tipo e formato	Dettagli e requisiti
Nome*	Testo	Nome della taglia (es. "Piccola", "Media", "Grande"); obbligatorio; traducibile
Descrizione	Rich Text (HTML)	Descrizione opzionale della taglia; traducibile
Icona	Selezione/Upload	Icona opzionale per la taglia
Slot richiesti*	Numero intero	Numero di slot che questa taglia occupa; obbligatorio; valore minimo 1; utilizzato per calcolare la capacità pet delle camere
Peso minimo	Numero decimale	Peso minimo in chilogrammi; opzionale
Peso massimo	Numero decimale	Peso massimo in chilogrammi; opzionale

Relazione con le Occupancy

Le specie animali sono utilizzate nelle configurazioni delle occupancy per:

1. Definire gli animali ammessi: nella tab Pet di un'occupancy, puoi selezionare le specie consentite.
2. Definire le taglie ammesse: sempre nella tab Pet, puoi selezionare le taglie specifiche consentite per le specie selezionate.
3. Calcolare gli slot: il sistema utilizza il campo "Slot richiesti" delle taglie per verificare che la somma degli slot degli animali prenotati non superi il numero di "Slot pet" configurato nell'occupancy.

Esempio:

• Specie "Cane" con taglia "Piccola" (2 slot) e taglia "Grande" (4 slot)
• Occupancy con 8 slot pet disponibili
• Il cliente può prenotare: 2 cani grandi (4+4=8) oppure 1 cane grande + 2 cani piccoli (4+2+2=8)

Messaggi

• Dopo aver creato una specie, viene visualizzata una notifica di conferma.
• Dopo aver modificato una specie, viene visualizzata una notifica di successo.
• Dopo aver eliminato una specie, viene mostrata una notifica di conferma.
• Eventuali errori di validazione vengono mostrati come messaggi di errore nei campi interessati.
• Quando si elimina una specie, viene mostrato un avviso che informa che verranno eliminate anche tutte le razze e taglie associate.

Esempio pratico

Creare una specie "Cane" con razze e taglie

1. Vai in Servizi > Specie Animali e clicca Nuovo.
2. Compila il form:
   • Nome: "Cane"
   • Descrizione: "Animale domestico appartenente alla famiglia dei canidi"
   • Icona: seleziona o carica un'icona rappresentativa
3. Clicca Salva.
4. Nella pagina di modifica, clicca sulla tab Razze:
   • Clicca Nuovo e aggiungi razze come "Yorkshire", "Pastore Tedesco", "Labrador"
5. Clicca sulla tab Taglie:
   • Clicca Nuovo e aggiungi:
     • Taglia "Piccola" con 2 slot richiesti
     • Taglia "Media" con 3 slot richiesti
     • Taglia "Grande" con 4 slot richiesti
6. La specie "Cane" è ora configurata e può essere utilizzata nelle occupancy per definire gli animali ammessi.

Gli screenshot allegati mostrano ciascun passaggio con evidenziazioni chiare.