Elenco Servizi¶
elenco_servizi è il catalogo dei servizi/prodotti acquistabili in BcOK. Non riguarda solo i Carnet: contiene anche modelli e listini usati per altri tipi di Acquisto.
Nel caso dei Carnet, però, elenco_servizi ha assunto un ruolo più importante: i post di questo CPT possono fungere da modelli di Carnet, governando sia l'attivazione sia la visibilità/utilizzabilità dei Carnet derivati.
Ruolo generale del CPT¶
- descrive i servizi a listino
- fornisce valori di default per nuovi acquisti
- per i Carnet, può fungere da modello di partenza
- per i Carnet multisede/Ufficiarredati, è il riferimento obbligatorio
Tassonomie rilevanti¶
| Nome | slug | note |
|---|---|---|
| Categoria servizio | cat_servizi |
Tipo servizio: Carnet, a provvigione, feature, ecc. |
| Tipo Carnet | tipo_carnet |
Classifica la modalità di consumo del Carnet |
| Tipo utilizzi | tipo_utilizzi |
Tipo di unità da scalare/registrare |
| Sedi valide | sedi_valide |
Definisce in quali sedi il modello è visibile, attivabile e utilizzabile dai Carnet derivati |
| Clienti centro | clienti_centro |
Indica la sede che ha creato/emesso il modello |
Multi-tenancy e ownership (2026+)¶
La multi-tenancy di elenco_servizi è governata dalla tassonomia clienti_centro, non più da un meta field center_id. Ogni modello è automaticamente assegnato alla sede che lo ha creato tramite il termine di tassonomia clienti_centro. Questo vale per tutti i CPT multi-sede in BcOK: aziende, acquisti, prenotazioni, risorse, notifiche e appunto elenco_servizi.
Campi e concetti chiave per i modelli Carnet¶
clienti_centro(tassonomia): sede proprietaria/originaria del modello - determina dove il modello è creato e di chi è la responsabilitàsedi_valide(tassonomia): perimetro di utilizzo e visibilità del modello - determina dove il modello può essere attivato e dove i Carnet derivati sono utilizzabilicat_servizi = carnet: identifica i modelli usati per i Carnet
La combinazione tra clienti_centro (ownership) e sedi_valide (visibility/usage) è oggi il cuore del comportamento dei modelli.
Tipi di modello Carnet¶
1. Modello specifico della sede¶
- creato da una sede
- in
sedi_valideha in genere solo la sede emittente - viene usato per attivare Carnet utilizzabili solo in quella sede
- può convivere con Carnet locali senza modello: il modello, in questo caso, è facoltativo
2. Modello multisede¶
- ha più sedi reali in
sedi_valide - ogni sede elencata può vedere il modello e attivare Carnet da quel modello
- i Carnet derivati erediteranno una logica multisede coerente con
sedi_valide - attualmente la creazione di questi modelli è riservata agli amministratori
3. Modello Ufficiarredati¶
- in
sedi_validecontiene la sede virtuale Ufficiarredati - rappresenta modelli nazionali/network-wide
- i Carnet derivati sono visibili e utilizzabili in tutte le sedi del network
- al momento l'attivazione di questi Carnet è riservata agli amministratori
Visibilità dei modelli nelle query¶
La visibilità dei modelli non dipende più solo da clienti_centro.
Per i modelli Carnet si combinano:
- la sede proprietaria (
clienti_centro) - le sedi di utilizzo/visibilità (
sedi_valide)
Parametri principali usati nelle query del CPT:
include_multisede=true|falseinclude_ufficiarredati=true|false
In pratica si possono ottenere:
- solo modelli locali della sede corrente
- modelli locali + multisede
- modelli locali + multisede + Ufficiarredati
Le implementazioni più recenti ricostruiscono il tax_query in modo esplicito per fare un OR tra clienti_centro e sedi_valide, preservando gli altri filtri in AND.
Relazione con il CPT Acquisti¶
Per i Carnet il collegamento è acquisti.id_servizio -> elenco_servizi.ID.
Regole pratiche:
- Carnet locale:
id_serviziofacoltativo - Carnet multisede:
id_servizioobbligatorio, deve puntare a un modello multisede coerente - Carnet Ufficiarredati:
id_servizioobbligatorio, deve puntare a un modello Ufficiarredati
Implicazioni UI¶
Nel tema:
- l'archivio
elenco_servizimostra filtri per modelli multisede e Ufficiarredati - il selettore del modello in attivazione Carnet raggruppa i modelli in tre sezioni:
- sede corrente
- Carnet Multisede
- Carnet Ufficiarredati
- il selettore può restare vuoto per i Carnet locali
Nota importante¶
elenco_servizi non va quindi letto come "solo catalogo statico". Per i Carnet è anche un CPT infrastrutturale, perché definisce la topologia di visibilità e utilizzo tra sedi.