> 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/il-ciclo-di-vita-di-un-tenant.md).

# Il ciclo di vita di un tenant

> **Nota importante:** gli stati del ciclo di vita sono un vocabolario condiviso, non un insieme di regole tecniche imposte dalla piattaforma. Il significato operativo di ogni stato è definito dai workflow Windmill associati e/o dal comportamento interno di ciascun applicativo. Le descrizioni di questa sezione riflettono le convenzioni adottate negli applicativi attualmente in uso. Per un nuovo applicativo è possibile ridefinirle in base alle proprie esigenze.

Ogni tenant attraversa una serie di stati che ne descrivono la maturità operativa. Le transizioni tra stati avvengono tramite azioni manuali del team delivery, e possono avviare automaticamente un workflow Windmill in background.

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

***

#### Gli stati

```
[In attesa di attivazione]
          │
          │  "Attiva"
          ▼
    [Attivato]  ◄──────────────────┐
          │                        │ (riattivazione)
          │  "Metti in produzione"  │
          ▼                        │
  [In produzione]                  │
          │                        │
          │  "Archivia"            │
          ▼                        │
    [Archiviato] ──────────────────┘
          │
          │  "Elimina"
          ▼
    [Eliminato]
```

***

#### Descrizione di ogni stato

**In attesa di attivazione**

Il tenant è stato creato nel sistema ma nessuna risorsa infrastrutturale è ancora stata predisposta. È uno stato puramente amministrativo: l'applicativo non esiste ancora nell'ambiente di destinazione.

**Chi può agire:** team delivery&#x20;

**Azione successiva:** "Attiva" → avvia il workflow di provisioning Windmill (se presente e se necessario)

***

**Attivato**

L'infrastruttura dell'applicativo è stata creata (database, bucket S3, stack Docker, ecc.). L'amministratore del cliente può accedere al backoffice e configurare i contenuti. L'applicativo è raggiungibile tipicamente su un URL temporaneo, **non ancora sul dominio definitivo**.

I cittadini **non** hanno accesso. Le notifiche **non** sono attive. I pagamenti reali **non** vengono processati.

È lo stato in cui il team delivery lavora insieme al cliente per completare la configurazione prima del go-live.

**Chi può agire:** team delivery&#x20;

**Azione successiva:** "Metti in produzione" → avvia il workflow di deploy Windmill (se presente e se necessario.

***

**In produzione**

L'applicativo è operativo a tutti gli effetti. I cittadini possono accedervi, le notifiche sono attive, i pagamenti reali vengono processati, le integrazioni scrivono e leggono dati reali.

Questo è lo stato "normale" di un tenant a regime.

**Chi può agire:** team delivery&#x20;

**Azioni successive:** "Archivia" (sospensione servizio)

> **Attenzione:** la transizione a *In produzione* ha effetti immediati e reali sui servizi. Assicurarsi che la configurazione sia completa e verificata prima di procedere.

***

**Archiviato**

Il servizio è sospeso, tipicamente perché il cliente ha interrotto il contratto o il pagamento. Le configurazioni sono conservate in sola lettura. Le risorse infrastrutturali possono essere mantenute o deallocate a seconda dell'applicativo.

Gli applicativi che controllano il proprio stato (es. il poller dei pagamenti) saltano automaticamente i tenant archiviati: nessuna operazione reale viene eseguita.

Il tenant può essere **riattivato** tornando ad *Attivato* senza dover ripartire da zero.

**Chi può agire:** team delivery&#x20;

**Azioni successive:** "Riattiva" → torna ad *Attivato*, oppure "Elimina"

***

**Eliminato**

Stato terminale. Tutte le risorse associate al tenant sono state rimosse. L'operazione è irreversibile.

***

#### Gli stati transitori

Quando viene avviato un workflow Windmill (es. al click su "Attiva"), il tenant entra temporaneamente in uno **stato transitorio** che blocca qualsiasi altra azione fino al completamento dell'automazione:

| Azione              | Stato transitorio |
| ------------------- | ----------------- |
| Attiva              | *Provisioning*    |
| Metti in produzione | *Deploying*       |
| Archivia            | *Archiving*       |
| Elimina             | *Deleting*        |

Questi stati impediscono doppi click accidentali o operazioni concorrenti. Scompaiono automaticamente quando il workflow Windmill invia la sua callback al Tenant Manager.

> **Se un tenant rimane bloccato in uno stato transitorio** (es. il workflow Windmill è andato in errore senza notificare il tenant manager), è possibile sbloccarlo manualmente tramite l'apposito pulsante nella scheda del tenant. Vedi la sezione [Troubleshooting](/manuali/manuale-operativo-interno/tenant-manager/troubleshooting.md).

***

#### Impatto operativo per stato — convenzioni attuali

| Stato                    | Convenzione d'uso attuale                                               | Chi la definisce                        |
| ------------------------ | ----------------------------------------------------------------------- | --------------------------------------- |
| In attesa di attivazione | Nessuna risorsa infrastrutturale creata                                 | Workflow Windmill di provisioning       |
| Attivato                 | Infrastruttura creata, accesso solo agli amministratori, URL temporaneo | Workflow Windmill + applicativo         |
| In produzione            | Servizio live, accesso cittadini, pagamenti reali, notifiche attive     | Applicativo (controllo a runtime)       |
| Archiviato               | Servizio sospeso, configurazione in sola lettura                        | Applicativo (salta i tenant archiviati) |
| Eliminato                | Risorse rimosse, stato terminale irreversibile                          | Workflow Windmill di eliminazione       |

<br>