Home

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 utilizzabili
  • cat_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_valide ha 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_valide contiene 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|false
  • include_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_servizio facoltativo
  • Carnet multisede: id_servizio obbligatorio, deve puntare a un modello multisede coerente
  • Carnet Ufficiarredati: id_servizio obbligatorio, deve puntare a un modello Ufficiarredati

Implicazioni UI

Nel tema:

  • l'archivio elenco_servizi mostra 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.