Domain Knowledge Base - Turismo
Come funziona il dominio, prima di scrivere una riga di codice? Scegli un documento dall'albero a sinistra: ogni pagina spiega una parte del modello.
Regole di Business - Dominio Turismo
Questo documento elenca le regole di business fondamentali del dominio Turismo, identificate con codice univoco BR-NNN. Le regole sono technology-independent e descrivono vincoli invarianti sul comportamento del sistema.
---
BR-001 - La Prenotazione deve avere date valide
Codice: BR-001
Nome: La data di check-out deve essere successiva alla data di check-in
Descrizione: Una Prenotazione è valida solo se la data di check-out è almeno il giorno successivo alla data di check-in. Il soggiorno di almeno una notte distingue un Turista da un escursionista (definizione UNWTO).
Motivazione: Coerenza con la definizione UNWTO di turista (pernottamento obbligatorio); prevenzione di prenotazioni semanticamente non valide.
Priorità: CRITICA
Attori: Sistema di prenotazione
Violazione: Rifiuto della prenotazione con messaggio "La data di check-out deve essere successiva al check-in".
Tracciabilità: UNWTO IRTS 2008 §2.9; entities.md entità Prenotazione.
---
BR-002 - La capacità di carico non può essere superata
Codice: BR-002
Nome: Il numero di visitatori non può superare la capacità di carico di un sito
Descrizione: Nessuna prenotazione o accesso può essere confermato se porterebbe il numero di visitatori presenti simultaneamente oltre la soglia di capacità di carico definita per la Destinazione o l'Attrazione. La capacità di carico è un invariante del dominio.
Motivazione: Protezione del patrimonio naturale e culturale; coerenza con le normative UNESCO e GSTC sulla gestione sostenibile dei siti.
Priorità: ALTA
Attori: Ente Turistico/DMO, Sistema di prenotazione del sito
Violazione: La prenotazione viene rifiutata con proposta di slot alternativi disponibili.
Tracciabilità: entities.md entità Attrazione; concept-map.md; KH-KIT-SPEC best-practices BP-002.
---
BR-003 - Una Prenotazione garantita non può essere cancellata senza penale oltre il termine
Codice: BR-003
Nome: La cancellazione oltre il termine libero comporta penale contrattuale
Descrizione: Se una Prenotazione viene cancellata dopo la scadenza del periodo di cancellazione gratuita previsto dalla tariffa scelta, viene applicata la penale contrattuale definita (es. una notte di soggiorno, percentuale del valore totale). La penale è determinata dalla tipologia di tariffa selezionata al momento della prenotazione.
Motivazione: Protezione del rischio di ricavo per la Struttura Ricettiva o l'Operatore Turistico; conformità alla Direttiva EU 2015/2302.
Priorità: ALTA
Attori: Turista, Struttura Ricettiva, Operatore Turistico
Eccezioni: Circostanze inevitabili e straordinarie (calamità, pandemia, impossibilità sopravvenuta documentata) possono giustificare deroghe in base alla Direttiva EU 2015/2302.
Tracciabilità: Direttiva EU 2015/2302 art. 11; state-machines/prenotazione-lifecycle.md.
---
BR-004 - La classificazione di una Struttura Ricettiva determina i servizi obbligatori
Codice: BR-004
Nome: Ogni categoria di stelle implica requisiti minimi obbligatori
Descrizione: Una Struttura Ricettiva classificata con un certo numero di stelle deve rispettare i requisiti minimi previsti dalla normativa per quella categoria (spazio minimo delle camere, dotazioni igieniche, servizi). L'assenza di un requisito obbligatorio comporta declassamento o sospensione dell'autorizzazione.
Motivazione: Tutela del consumatore; omogeneità del sistema di classificazione; conformità al DPCM 21 ottobre 2008.
Priorità: ALTA
Attori: Struttura Ricettiva, Ente di classificazione regionale
Tracciabilità: DPCM 21 ottobre 2008; entities.md entità StrutturaRicettiva.
---
BR-005 - Un Itinerario pubblicato deve avere almeno una Struttura Ricettiva per ogni notte
Codice: BR-005
Nome: Ogni giorno dell'Itinerario deve prevedere ospitalità garantita
Descrizione: Un Itinerario in stato PUBBLICATO (commercializzabile) deve includere una Struttura Ricettiva confermata per ogni notte del soggiorno. Un Itinerario con notti non coperte non può essere venduto a clienti finali.
Motivazione: Garanzia di completezza del prodotto turistico; tutela del Turista; conformità agli obblighi informativi della Direttiva EU 2015/2302.
Priorità: ALTA
Attori: Operatore Turistico, Sistema di gestione itinerari
Violazione: L'Itinerario rimane in stato BOZZA e non può essere aggiunto al catalogo.
Tracciabilità: entities.md entità Itinerario; workflows/pianificazione-viaggio.md.
---
BR-006 - La Guida Turistica deve essere abilitata per la regione in cui opera
Codice: BR-006
Nome: Solo guide con abilitazione regionale valida possono accompagnare visitatori in visita guidata
Descrizione: Una Guida Turistica può esercitare l'attività professionale esclusivamente nell'ambito territoriale per cui è abilitata (abilitazione regionale), oppure in virtù di abilitazione nazionale o di diritti EU (CGUE C-539/11 per guide di altri stati UE che accompagnano gruppi provenienti dal proprio paese).
Motivazione: Qualità dell'offerta turistica; tutela del titolo professionale; conformità alla Legge n. 135/2001 e normative regionali.
Priorità: ALTA
Attori: Guida Turistica, Operatore Turistico
Tracciabilità: Legge n. 135/2001; sentenza CGUE C-539/11; roles/actors.md.
---
BR-007 - Un Pacchetto Turistico deve includere obbligo di garanzia contro l'insolvenza
Codice: BR-007 Nome: L'Operatore Turistico che vende pacchetti deve avere copertura obbligatoria contro l'insolvenza Descrizione: Qualsiasi Operatore Turistico che venda Pacchetti Turistici è obbligato dalla Direttiva EU 2015/2302 a garantire protezione dei pagamenti dei clienti in caso di insolvenza, tramite polizza assicurativa o equivalente strumento finanziario. Motivazione: Tutela del consumatore; conformità alla Direttiva EU 2015/2302 art. 17. Priorità: CRITICA Attori: Operatore Turistico Violazione: L'attività di vendita di pacchetti senza copertura anti-insolvenza è illecita. Tracciabilità: Direttiva EU 2015/2302 art. 17; KH-KIT-SPEC faq.md Q3.
---
BR-008 - L'Attività Agrituristica deve mantenere la prevalenza agricola
Codice: BR-008
Nome: In un agriturismo italiano l'attività agricola deve restare prevalente
Descrizione: Un'impresa che opera come agriturismo ai sensi della Legge n. 96/2006 deve mantenere l'attività di coltivazione, allevamento o silvicoltura come attività prevalente rispetto all'attività di accoglienza turistica. Il venir meno della prevalenza agricola comporta la perdita della qualificazione agrituristica.
Motivazione: Conformità alla Legge n. 96/2006; tutela dell'identità del prodotto agriturismo; accesso ai regimi fiscali e contributivi riservati agli imprenditori agricoli.
Priorità: ALTA
Attori: Imprenditore agricolo/agriturismo, Ente di controllo regionale
Tracciabilità: Legge n. 96/2006 art. 2; entities.md.