Limiti di prenotazione

I limiti di prenotazione ti permettono di controllare il numero massimo di appuntamenti che possono essere prenotati in base a criteri specifici. Puoi limitare le prenotazioni per:

Convenzioni: Assicurazioni, SSN, pagamenti privati, ecc.
Servizi: Servizi medici specifici o procedure
Agende: Medici, specialisti, stanze o attrezzature

Concetti chiave

Scope: Definisce QUALI appuntamenti il limite si applica
Numero massimo: Il numero massimo di appuntamenti consentiti nel periodo temporale
Date di validità: Date opzionali di inizio/fine quando il limite è attivo

🎯 Comprendere i Tipi di scope

1. Tutte/Tutti

Si applica a TUTTI gli appuntamenti, indipendentemente dal valore. Include appuntamenti con E senza la dimensione specificata. Filtro più ampio.

Esempio: Scope convenzioni = Tutte

✅ Appuntamenti con convenzione A → Contati
✅ Appuntamenti con convenzione B → Contati
✅ Appuntamenti senza convenzione → Contati

2. Nessuna/Nessuno

Si applica SOLO agli appuntamenti SENZA la dimensione specificata. Gli appuntamenti CON un valore sono esclusi dal limite.

Esempio: Scope convenzioni = Nessuna

❌ Appuntamenti con convenzione A → NON contati
❌ Appuntamenti con convenzione B → NON contati
✅ Appuntamenti senza convenzione → Contati

3. Specifiche/Specifici

Si applica SOLO agli appuntamenti che utilizzano elementi selezionati. Devi scegliere quali elementi specifici da una lista. Filtro più mirato.

Esempio: Scope Convenzioni = Specifiche → Seleziona “convenzione ASL”

✅ Appuntamenti con convenzione ASL → Contati
❌ Appuntamenti con convenzione Poste → NON contati
❌ Appuntamenti senza convenzione → NON contati

4. Qualsiasi (non vuota/vuoto)

Si applica SOLO agli appuntamenti CON QUALSIASI valore non nullo. Non importa quale valore specifico, purché esista. Esclude gli appuntamenti senza la dimensione specificata.

Esempio: Scope Convenzioni = Qualsiasi (non vuota)

✅ Appuntamenti con convenzione A → Contati
✅ Appuntamenti con convenzione B → Contati
✅ Appuntamenti con convenzione C → Contati
❌ Appuntamenti senza convenzione → NON contati

💼 Casi d’uso comuni ed esempi

Caso d’uso 1: Limitare solo gli appuntamenti con convenzione

Scenario: Vuoi limitare le prenotazioni con convenzione a 10 al giorno, ma consentire appuntamenti privati illimitati.

Configurazione:

Nome: "Limite convenzioni giornaliero"
Tipo Limite: Per Giorno
Numero Massimo: 10

Scope Convenzioni: Qualsiasi (non vuota)
Scope Servizi: Tutti
Scope Agende: Tutte

Risultato:

10 appuntamenti con convenzione massimo al giorno (qualsiasi convenzione)
Appuntamenti privati illimitati (senza convenzione)

Esempio di agenda giornaliera:

8:00  - convenzione ASL     ✅ Conteggio: 1/10
8:30  - Privato             ✅ Non contato
9:00  - convenzione Poste   ✅ Conteggio: 2/10
9:30  - Privato             ✅ Non contato
...
15:00 - convenzione ASL     ✅ Conteggio: 10/10
15:30 - convenzione Poste   ❌ BLOCCATO (limite raggiunto)
16:00 - Privato             ✅ CONSENTITO

Caso d’Uso 2: Limitare un servizio specifico

Scenario: Hai un servizio specializzato “Risonanza Magnetica” che può essere eseguito solo 5 volte al giorno a causa delle limitazioni dell’attrezzatura.

Configurazione:

Nome: "Limite RM giornaliero"
Tipo Limite: Per Giorno
Numero Massimo: 5

Scope Convenzioni: Tutte
Scope Servizi: Specifici → Seleziona "Risonanza Magnetica"
Scope Agende: Tutte

Risultato:

Massimo 5 risonanze magnetiche al giorno (qualsiasi paziente, qualsiasi convenzione)
Altri servizi non sono influenzati

Caso d’uso 3: Limitare un medico specifico con convenzione specifica

Scenario: Il Dr. Rossi ha un contratto con la convenzione ASL per un massimo di 15 appuntamenti al giorno.

Configurazione:

Nome: "Dr. Rossi - ASL"
Tipo Limite: Per giorno
Numero Massimo: 15

Scope Convenzioni: Specifiche → Seleziona "convenzione ASL"
Scope Servizi: Tutti
Scope Agende: Specifiche → Seleziona "Dr. Rossi"

Risultato:

Max 15 appuntamenti al giorno per Dr. Rossi + convenzione ASL
Gli appuntamenti privati del Dr. Rossi non sono influenzati
Altri appuntamenti con convenzione del Dr. Rossi non sono influenzati
Appuntamenti ASL di altri medici non sono influenzati

Caso d’uso 4: Bloccare solo appuntamenti privati

Scenario: Durante gli orari di punta (gestiti tramite date di validità), vuoi solo appuntamenti con convenzione.

Configurazione:

Nome: "Solo convenzioni - Orari di punta"
Tipo Limite: Per Giorno
Numero Massimo: 0

Scope Convenzioni: Nessuna
Scope Servizi: Tutti
Scope Agende: Tutte

Data Inizio: 2026-01-15
Data Fine: 2026-02-28

Risultato:

Gli appuntamenti privati (senza convenzione) sono bloccati dal 15 Gen al 28 Feb
Gli appuntamenti con convenzione sono consentiti

Caso d’uso 5: Limitare QUALSIASI appuntamento con convenzione per servizi specifici

Scenario: Vuoi limitare gli appuntamenti con convenzione per servizi costosi (es. “Visita Specialistica”, “Intervento Chirurgico”) a 20 al giorno, indipendentemente da quale convenzione.

Configurazione:

Nome: "Convenzioni - Servizi costosi"
Tipo Limite: Per giorno
Numero Massimo: 20

Scope Convenzioni: Qualsiasi (non vuota)
Scope Servizi: Specifici → Seleziona ["Visita Specialistica", "Intervento Chirurgico"]
Scope Agende: Tutte

Risultato:

Max 20 appuntamenti al giorno per servizi costosi quando prenotati con QUALSIASI convenzione
Le prenotazioni private per servizi costosi non sono contate
Le prenotazioni con convenzione per altri servizi non sono influenzate

Esempio:

Lunedì:
- 9:00  - convenzione A + Intervento            ✅ Conteggio: 1/20
- 10:00 - Privato + Intervento                  ✅ Non contato
- 11:00 - convenzione B + Visita Specialistica  ✅ Conteggio: 2/20

Martedì:
- 9:00  - convenzione A + Visita Generale       ✅ Non contato (servizio diverso)
- 10:00 - convenzione C + Intervento            ✅ Conteggio: 3/20
...

Venerdì:
- 15:00 - convenzione A + Intervento            ✅ Conteggio: 20/20
- 16:00 - convenzione B + Intervento            ❌ BLOCCATO (limite raggiunto)
- 17:00 - Privato + Intervento                  ✅ CONSENTITO (non è prenotazione con convenzione)
- 18:00 - convenzione A + Visita Generale       ✅ CONSENTITO (servizio diverso)

Caso d’uso 6: Limiti multipli sovrapposti

Scenario: Hai regole complesse:

Max 50 appuntamenti totali al giorno (tutti)
Max 30 appuntamenti con convenzione al giorno
Max 5 risonanze magnetiche al giorno

Configurazione:

Limite 1: tetto giornaliero totale

Nome: "Limite totale giornaliero"
Numero Massimo: 50
Scope Convenzioni: Tutte
Scope Servizi: Tutti
Scope Agende: Tutte

Limite 2: tetto giornaliero convenzioni

Nome: "Limite convenzioni giornaliero"
Numero Massimo: 30
Scope Convenzioni: Qualsiasi (non vuota)
Scope Servizi: Tutti
Scope Agende: Tutte

Limite 3: tetto giornaliero RM

Nome: "Limite RM giornaliero"
Numero Massimo: 5
Scope Convenzioni: Tutte
Scope Servizi: Specifici → "Risonanza Magnetica"
Scope Agende: Tutte

Risultato:

Tutti i limiti sono controllati indipendentemente
Un appuntamento è bloccato se viola QUALSIASI limite
Il limite più restrittivo vince

Esempio di giornata:

Conteggi attuali:
- Totale: 48/50
- Convenzioni: 28/30
- RM: 5/5

Tentativo di nuova prenotazione: convenzione ASL + RM
✅ Limite totale: 48 < 50 (OK)
✅ Limite convenzioni: 28 < 30 (OK)
❌ Limite RM: 5 >= 5 (BLOCCATO!)

Risultato: Prenotazione BLOCCATA a causa del limite RM

Caso d’uso 7: Restrizioni stagionali

Scenario: Durante l’estate (Luglio-Agosto), vuoi ridurre gli appuntamenti con convenzione a 15 al giorno.

Configurazione:

Nome: "Limite estivo convenzioni"
Tipo Limite: Per Giorno
Numero Massimo: 15

Scope Convenzioni: Qualsiasi (non vuota)
Scope Servizi: Tutti
Scope Agende: Tutte

Data Inizio: 2026-07-01
Data Fine: 2026-08-31

Risultato:

Dal 1° Luglio al 31 Agosto: Max 15 appuntamenti con convenzione al giorno
Fuori da questo periodo: Il limite non si applica

Caso d’uso 8: Bloccare appuntamenti senza convenzione per servizio specifico

Scenario: Il servizio “Vaccino COVID” deve sempre essere prenotato con una convenzione (nessun privato consentito).

Configurazione:

Nome: "Vaccino COVID - Solo convenzioni"
Tipo Limite: Per Giorno
Numero Massimo: 0

Scope Convenzioni: Nessuna
Scope Servizi: Specifici → "Vaccino COVID"
Scope Agende: Tutte

Risultato:

Gli appuntamenti privati per Vaccino COVID sono bloccati (conteggio = 0)
Vaccino COVID con qualsiasi convenzione è consentito

📝 Come creare un limite

Creare un nuovo limite

Navigare a Limiti di prenotazione
- Vai su Clinica → Impostazioni avanzate → Limiti di prenotazione
- Clicca “Crea Nuovo Limite”
Informazioni di base
- Nome: Scegli un nome descrittivo (es. “Limite RM giornaliero”)
- Tipo limite: Seleziona Per Giorno, Per giorno o Per Mese
- Numero massimo: Inserisci il numero massimo di appuntamenti
Configura scope convenzioni
- Tutte: Il limite si applica a tutti gli appuntamenti (con o senza convenzione)
- Nessuna: Il limite si applica solo agli appuntamenti SENZA convenzione
- Specifiche: Seleziona convenzioni specifiche dalla lista
- Qualsiasi (non vuota): Il limite si applica agli appuntamenti CON qualsiasi convenzione
Configura scope servizi
- Tutti: Il limite si applica a tutti i servizi
- Nessuno: Il limite si applica solo agli appuntamenti SENZA servizi
- Specifici: Seleziona servizi specifici dalla lista
- Qualsiasi (non vuoto): Il limite si applica agli appuntamenti CON qualsiasi servizio
Configura scope agende
- Tutte: Il limite si applica a tutte le agende (medici, stanze, ecc.)
- Nessuna: Il limite si applica solo agli appuntamenti SENZA agenda
- Specifiche: Seleziona agende specifiche dalla lista
- Qualsiasi (non vuota): Il limite si applica agli appuntamenti CON qualsiasi agenda
Imposta date di validità (opzionale)
- Data inizio: Il limite inizia ad applicarsi da questa data
- Data fine: Il limite smette di applicarsi dopo questa data
- Lascia vuoto per sempre attivo
Salva
- Clicca “Crea” per salvare il limite
- Il limite è immediatamente attivo

🔧 Scenari Avanzati

Combinare Qualsiasi (NotNone) con specifici

Puoi creare regole sofisticate mescolando i tipi di scope:

Scenario: Limitare gli appuntamenti che hanno QUALSIASI convenzione E utilizzano servizi costosi specifici.

Scope Convenzioni: Qualsiasi (non vuota) (qualsiasi convenzione esiste)
Scope Servizi: Specifici → ["RM", "TAC", "Intervento Chirurgico"]
Scope Agende: Tutte

Logica:

✅ Conta se: Ha convenzione (qualsiasi) + Il servizio è uno di [RM, TAC, Intervento]
❌ Non conta: Nessuna convenzione (anche se RM)
❌ Non conta: Ha convenzione ma servizio diverso

Limiti multipli con scope diversi

Puoi creare restrizioni a più livelli:

Limite 1: Max 100 appuntamenti totali al giorno (Tutte, Tutti, Tutte)
Limite 2: Max 30 convenzione ASL al giorno (Specifiche ASL, Tutti, Tutte)
Limite 3: Max 20 per Dr. Rossi al giorno (Tutte, Tutti, Specifiche Dr. Rossi)

Tutti i limiti sono valutati. Un appuntamento è bloccato se viola QUALSIASI limite applicabile.

🔍 Risoluzione Problemi

Problema: il limite non funziona

Controlla:

Il limite è attivo (non eliminato)?
Le date di validità sono impostate correttamente?
L’appuntamento corrisponde a TUTTI i criteri di scope?
Il numero massimo è > 0?

Problema: limiti in conflitto

Comprensione:

Più limiti possono applicarsi allo stesso appuntamento
Un appuntamento è bloccato se viola QUALSIASI limite
Rivedi tutti i limiti attivi per sovrapposizioni

📋 Tabella di Riferimento Rapido

Tipo di Scope	Corrisponde	Caso d’Uso Comune
Tutte/Tutti	Tutto (incluso nullo)	Tetti giornalieri totali, nessuna restrizione
Nessuna/Nessuno	Solo valori nulli/vuoti	Bloccare appuntamenti privati, richiedere convenzioni
Specifiche/Specifici	Solo elementi selezionati dalla lista	medico specifico, servizio specifico, convenzione specifica
Qualsiasi (non vuota/vuoto)	Qualsiasi valore non nullo	Limitare tutte le convenzioni (ma consentire privati), limitare tutti i servizi (ma consentire vuoti)

📚 Riassunto

Come limitare solo appuntamenti con convenzione?

Scope Convenzioni: Qualsiasi (non vuota)
Scope Servizi: Tutti
Scope Agende: Tutte

➜ Limita appuntamenti che hanno una convenzione (qualsiasi) ➜ Gli appuntamenti privati sono illimitati

Come limitare solo appuntamenti privati?

Scope Convenzioni: Nessuna
Scope Servizi: Tutti
Scope Agende: Tutte

➜ Limita appuntamenti senza convenzione ➜ Gli appuntamenti con convenzione sono illimitati

Come limitare una convenzione specifica?

Scope Convenzioni: Specifiche → Seleziona "ASL"
Scope Servizi: Tutti
Scope Agende: Tutte

➜ Limita solo appuntamenti con convenzione ASL ➜ Altre convenzioni e privati sono illimitati

Come limitare tutti gli appuntamenti (totale giornaliero)?

Scope Convenzioni: Tutte
Scope Servizi: Tutti
Scope Agende: Tutte

➜ Limita tutti gli appuntamenti indipendentemente da convenzione/servizio/agenda