Vai al contenuto

Naming Standard

Scopo

Questa pagina definisce le convenzioni di naming consigliate per mantenere coerenti:

  • tenant;
  • reti;
  • anagrafiche;
  • tipologie;
  • servizi;
  • ruoli operativi.

1. Tenant

Regola

Usare sempre il formato:

  • tenant_<nome>

Esempi:

  • tenant_besant
  • tenant_ids

Da evitare

  • mix tra:
  • besant
  • tenant_besant

Motivo:

  • crea filtri incoerenti;
  • rompe select e perimetri;
  • costringe a introdurre fallback non desiderati.

Eccezione attuale da mantenere

Nel sistema corrente esiste un tenant gia registrato con eccezione storica:

  • host safecondo.nxt-sense.eu
  • chiave tecnica tenant_extra

Questa chiave va mantenuta cosi per evitare una migrazione non necessaria sul tenant gia attivo.

Quindi:

  • Safecondo resta mappato a tenant_extra
  • non va forzato a tenant_safecondo se non con una migrazione dedicata e pianificata

2. Reti di Gestione

Nome

Formato consigliato:

  • Rete Gestione <nome>

Esempi:

  • Rete Gestione Besant
  • Rete Gestione Nord

Codice

Formato consigliato:

  • maiuscolo corto, senza spazi

Esempi:

  • RG_BESANT
  • RG_NORD

3. Reti Commerciali

Nome

Formato consigliato:

  • Rete Commerciale <nome partner>

Esempi:

  • Rete Commerciale Netopen
  • Rete Commerciale Demo

Codice

Formato consigliato:

  • maiuscolo, breve, stabile

Esempi:

  • RC_NETOPEN
  • RC_DEMO

4. Aziende Commerciali

Regola

Se l'azienda commerciale deriva da una anagrafica cliente:

  • mantenere lo stesso nome dell'anagrafica;
  • evitare varianti non necessarie.

Esempio:

  • Netopen Di Emiliani Roberto

Non usare un secondo nome “tecnico” diverso se non serve.

5. Tipologie Cliente

Standard consigliato

Usare nomi stabili e consistenti:

  • Commerciale
  • Condominio
  • Amministratore
  • Studio Amministrativo
  • Prospect
  • Cliente Attivo

Regola

Le tipologie devono rappresentare il significato business dell'anagrafica, non il ruolo applicativo FAB.

6. Servizi

Codice servizio

Usare codici stabili e leggibili.

Esempi:

  • RAS_CONDOMINIO
  • DVR_BASE
  • INTERVENTO_TECNICO
  • DUVRI_STANDARD

Nome servizio

Usare un nome leggibile lato utente.

Esempi:

  • RAS Condominio
  • DVR Base
  • Intervento Tecnico

7. Utenti demo / test

Per utenti demo o di validazione usare nomi espliciti:

  • commerciale
  • gestione
  • tecnico

Se servono piu varianti:

  • commerciale_besant
  • gestione_besant
  • tecnico_besant

8. Regola pratica finale

Una convenzione non serve solo per ordine. Serve per evitare:

  • filtri vuoti;
  • record non selezionabili;
  • mismatch tra dati e perimetro;
  • debug piu difficile.

Per questo motivo:

  • tenant,
  • tipologie,
  • reti,
  • servizi

vanno nominati in modo stabile e documentato.