> For the complete documentation index, see [llms.txt](https://manuale.opencontent.it/manuali/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuale.opencontent.it/manuali/manuale-operativo-interno/tenant-manager/onboarding-di-un-nuovo-cliente.md).

# Onboarding di un nuovo cliente

Questa sezione descrive la procedura completa che il team delivery segue per portare un nuovo applicativo di un cliente da zero alla produzione.

> **Ricorda:** esegui sempre la procedura prima sull'ambiente di **QA**, poi replica sull'ambiente di **Produzione**.

***

#### Prima di iniziare

Assicurati di avere a disposizione:

* L'ordine del cliente su Odoo (per ricavare il piano: S/M/L/XL/XXL)
* Il nome del cliente così come è registrato nel Tenant Manager
* Il tipo di applicativo da attivare
* Le credenziali o gli endpoint specifici richiesti dalla configurazione dell'applicativo (es. URL del gestionale, credenziali API del fornitore)
* Accesso al Tenant Manager (QA e/o Produzione)

***

#### Passo 1 — Creare il tenant

1. Accedi al Tenant Manager nell'ambiente corretto (inizia da QA)
2. Clicca su **"Nuovo tenant"**
3. Compila i campi obbligatori:
   * **Cliente** — seleziona dall'anagrafica esistente
   * **Applicativo** — seleziona il tipo di prodotto/integrazione
   * **Piano** — inserisci il valore dall'ordine Odoo (S / M / L / XL / XXL)
   * **Ambiente** — QA o Produzione, coerente con l'istanza TM in cui stai operando
4. Salva — il tenant viene creato in stato **In attesa di attivazione**

<figure><img src="/files/aE2AOyKrvmKwvplAwVce" alt=""><figcaption></figcaption></figure>

> **Nota sull'UID:** l'identificativo univoco viene generato automaticamente. Se l'applicativo richiede che l'UID sia assegnato manualmente (caso raro, dipende dall'applicativo), è possibile specificarlo in questa fase.

***

#### Passo 2 — Attivare il tenant

1. Dalla scheda del tenant appena creato, clicca su **"Attiva"**
2. Conferma l'operazione nella finestra di dialogo
3. Il tenant entra in stato transitorio **Provisioning** — attendi il completamento
4. Al termine del workflow Windmill (se presente), lo stato avanza automaticamente ad **Attivato**

<figure><img src="/files/809DmsMtorvg6FO05mHr" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/pRSi4lDoco9d9tkuTHJc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/k9cG9kF5FHZdTkmrMYVI" alt=""><figcaption></figcaption></figure>

> Se dopo alcuni minuti il tenant rimane in stato *Provisioning*, il workflow potrebbe essere andato in errore.

***

#### Passo 3 — Configurare il tenant

Una volta in stato *Attivato*, è possibile compilare la configurazione specifica dell'applicativo tramite il form generato automaticamente da Form.io.

1. Apri la scheda del tenant
2. Vai alla sezione **Configurazione**
3. Compila i campi richiesti dall'applicativo (endpoint, credenziali, parametri operativi)
4. Salva la configurazione

> `[SCREENSHOT: Sezione "Configurazione" di un tenant — form Form.io con campi specifici per tipo applicativo]`

I campi disponibili variano a seconda dell'applicativo. Per il dettaglio dei campi di ciascun tipo, consulta la sezione [Applicativi supportati](/manuali/manuale-operativo-interno/tenant-manager/applicativi-supportati.md).

> **Attenzione alle credenziali:** non utilizzare mai le credenziali di superuser del Tenant Manager nei campi di configurazione degli applicativi. Usa esclusivamente le credenziali applicative dedicate. Vedi la sezione [Configurare un tenant](/manuali/manuale-operativo-interno/tenant-manager/configurare-un-tenant.md).

***

#### Passo 4 — Verificare il funzionamento

Prima di andare in produzione, verifica che l'applicativo funzioni correttamente nell'ambiente di staging:

* L'applicativo è raggiungibile sull'URL temporaneo
* Le credenziali configurate sono corrette (nessun errore di autenticazione)
* Le funzionalità principali rispondono come atteso (es. almeno un test di pagamento andato a buon fine, almeno una protocollazione, ecc.)

***

#### Passo 5 — Mettere in produzione

Quando la verifica è superata:

1. Dalla scheda del tenant, clicca su **"Metti in produzione"**
2. Conferma l'operazione
3. Il tenant entra in stato transitorio **Deploying**
4. Al termine, lo stato avanza automaticamente a **In produzione**

> `TODO: [SCREENSHOT: Pulsante "Metti in produzione" e stato "In produzione" raggiunto]`

> **Attenzione:** da questo momento il servizio è live. I cittadini possono accedervi, le notifiche sono attive e — per gli applicativi di pagamento — vengono processate transazioni reali.

***

#### Riepilogo visivo del flusso

```
Odoo (ordine + piano)
        │
        ▼
  Crea tenant  →  [In attesa di attivazione]
        │
        ▼
     Attiva    →  [Provisioning]  →  [Attivato]
        │
        ▼
   Configura   →  (Form.io)
        │
        ▼
    Verifica   →  (test funzionali)
        │
        ▼
  Vai in prod  →  [Deploying]  →  [In produzione] ✓
```