Gestione Abbonamento

La pagina Abbonamento ti permette di monitorare l'utilizzo del tuo piano e verificare lo stato dei servizi attivi.

Accesso

Clicca su Abbonamento nel menu laterale sotto la sezione "Management".

Permessi

Solo gli utenti con ruolo COMPANY_ADMIN o SYSTEM_ADMIN possono accedere a questa sezione.

Dashboard Abbonamento

Stato Abbonamento

La card principale mostra:

• Badge Stato: Il colore indica lo stato attuale

  • 🟢 Attivo: Piano regolarmente attivo
  • 🔵 Prova: Periodo di trial
  • 🟡 Avviso: Vicino al limite di utilizzo
  • 🔴 Sospeso: Superato il limite, servizio limitato
  • ⚫ Scaduto: Piano scaduto

• Nome Piano: Il tipo di abbonamento attivo

• Scadenza: Data di scadenza (se applicabile)

• Giorni Rimasti: Countdown alla scadenza

Utilizzo Token

Visualizza il consumo di token del mese corrente:

• Progress Bar: Percentuale di utilizzo rispetto al limite
• Token Utilizzati: Numero attuale vs limite mensile
• Data Reset: Quando i contatori si azzerano

Token Illimitati

Se il tuo piano ha token illimitati, vedrai "Illimitato" invece del limite.

Utilizzo per Servizio

Un grafico a torta mostra come sono distribuiti i token tra i servizi:

• Chat: Token usati nelle conversazioni AI
• Ricerca: Token usati nelle ricerche documenti
• Widget: Token usati dai widget embeddati

Trend Utilizzo

Il grafico ad area mostra l'andamento dell'utilizzo negli ultimi 6 mesi, utile per:

• Identificare picchi di utilizzo
• Pianificare upgrade del piano
• Monitorare la crescita

Servizi Abilitati

Lista dei servizi inclusi nel tuo piano:

• ✅ Chat AI: Conversazioni con l'assistente
• ✅ Ricerca Documenti: Ricerca semantica nei documenti
• ✅ Ricerca Web: Ricerca su fonti web
• ✅ Widget: Widget embeddabili per siti esterni

Info Account

Dettagli tecnici del piano:

• Max Utenti: Numero massimo di utenti consentiti
• Utenti Attuali: Utenti attualmente attivi
• Modello LLM: Il modello AI utilizzato (es. Qwen 2.5 32B)

Custom LLM Provider (API Key Personalizzata)

A partire dalla v2.2.0, le aziende possono configurare il proprio provider AI con API key personalizzata invece di usare il modello di sistema.

Provider Supportati

Provider	Modelli Consigliati	Note
OpenAI	gpt-4o, gpt-4o-mini, o1, o1-mini	gpt-4o consigliato
Anthropic	claude-sonnet-4, claude-3-5-sonnet	claude-sonnet-4 consigliato
Google	gemini-2.0-flash, gemini-1.5-pro	gemini-2.0-flash consigliato

Come Configurare

1. Vai su Abbonamento nel menu laterale
2. Scorri fino alla sezione Provider AI Personalizzato
3. Seleziona il provider desiderato (OpenAI, Anthropic, Google)
4. Seleziona il modello
5. Inserisci la tua API key
6. Clicca Valida per verificare che la key funzioni
7. Clicca Salva per applicare la configurazione

Sicurezza API Key

Le API key sono criptate con AES-256-GCM prima di essere salvate. Solo tu puoi vedere una versione mascherata della key (es. sk-a...xyz1).

Comportamento

• Con API key configurata: Tutte le chat e ricerche della tua azienda useranno il provider custom
• Senza API key: Il sistema usa il modello di default (Ollama Qwen 2.5 32B)

Rimuovere la Configurazione

Per tornare al modello di sistema:

1. Vai su Abbonamento > Provider AI Personalizzato
2. Clicca Rimuovi Configurazione
3. Conferma la rimozione

Test nel Playground

Puoi testare il tuo provider custom nel Playground prima di applicarlo a tutta l'azienda.

Stati Abbonamento

Stato	Descrizione	Azione Richiesta
Attivo	Tutto funziona regolarmente	Nessuna
Prova	Periodo di valutazione	Valuta upgrade
Avviso	Superato 80% del limite	Monitora utilizzo
Sospeso	Limite superato	Contatta supporto
Scaduto	Piano terminato	Rinnova abbonamento

Vista Amministratore

Solo SYSTEM_ADMIN

Questa sezione è visibile solo agli amministratori di sistema.

Gli amministratori di sistema vedono una dashboard aggregata con:

Overview Globale

• Totale Abbonamenti: Numero totale di aziende
• Per Stato: Conteggi divisi per stato (attivi, warning, sospesi, etc.)
• Token Totali Mese: Consumo aggregato di tutte le aziende
• Richieste Totali: Numero totale di chiamate API

Top Consumatori

Grafico a barre con le 10 aziende che consumano più token, utile per:

• Identificare clienti ad alto utilizzo
• Proporre upgrade personalizzati
• Monitorare anomalie

Distribuzione Status

Grafico a torta che mostra la distribuzione degli abbonamenti per stato.

Aziende in Warning

Tabella con le aziende che hanno superato l'80% del limite, con:

• Nome azienda
• Percentuale utilizzo
• Stato attuale
• Giorni alla scadenza

Filtro per Azienda

Usa il dropdown "Filtra per azienda" per vedere i dettagli di una specifica azienda come se fossi il suo admin.

FAQ

Come posso aumentare il limite token?

Contatta il supporto per discutere un upgrade del piano.

Cosa succede se supero il limite?

Il sistema passa in stato "Warning" all'80% e "Sospeso" al 100%. In stato sospeso, alcune funzionalità potrebbero essere limitate.

Quando si resettano i contatori?

I token si resettano il primo giorno di ogni mese (per piani MONTHLY) o mai (per piani LIFETIME).

Posso vedere lo storico utilizzo?

Sì, il grafico "Trend 6 Mesi" mostra lo storico. Per dati più dettagliati, contatta il supporto.