Gestione dell’installazione

Come i clienti scelgono un piano, distribuiscono un’installazione, gestiscono i team e gestiscono ogni sito dalla console di installazione.

Interfaccia utente principale:

• Prezzi — piani di marketing pubblici
• Dashboard → Installazioni — elenco
• Dettagli di installazione — gestione a schede (/dashboard/installations/{id}?tab=…)

Selezione del piano e checkout

1. Sfoglia i prezzi (bundle pubblicati + funzionalità di marketing).
2. Avvia il checkout per un bundle (e componenti aggiuntivi opzionali / coupon se offerti).
3. Paga tramite il gateway della piattaforma attiva (Stripe Checkout, Paddle, Mollie, …) oppure attiva la prova quando il pacchetto include trial_days.
4. In caso di esito positivo, l’installazione passa da in attesa di pagamento → provisioning → in esecuzione (worker Horizon + agente host).

Segnaposto screenshot: Pagina dei prezzi Segnaposto screenshot: Riepilogo dell’ordine (bundle + componenti aggiuntivi) Segnaposto screenshot: Pagina di pagamento del provider Segnaposto screenshot: Successo della fatturazione / avanzamento del provisioning

Se il browser restituisce la risposta prima della webhook, la pagina di successo potrebbe confermare la sessione con l’API del provider, così il pagamento viene comunque completato.

Distribuisci una nuova installazione

I guasti emergono nelle schede Panoramica e Attività dell’installazione; gli amministratori della piattaforma vedono anche ops/log.

Org max_installations blocca ulteriori deploy quando è completo.

Gestione dell’installazione

Apri un’installazione per ottenere le schede orizzontali. La funzionalità di fatturazione dipende dal ruolo del membro (può.fatturare).

Segnaposto per screenshot: Intestazione di installazione con badge di stato e barra delle schede

Panoramica

• Stato dell’installazione, dominio principale, riepilogo del bundle.
• Operazioni di distribuzione attive con avanzamento per fasi (provisioning, aggiornamento, reinstallazione).
• Moduli intitolati dal bundle: installa/aggiorna quando sono disponibili versioni.
• Aggiornamenti principali/moduli con un clic quando la piattaforma segnala aggiornamenti disponibili (accoda un processo di aggiornamento; monitora l’avanzamento in questa scheda).
• Reinstalla: ripristino pulito oppure ripristino da un backup selezionato (stessa identità di installazione).

Impostazioni (password dell’amministratore del tenant)

• Impostazioni dello stile di localizzazione / fuso orario per l’installazione sono state esposte.
• Reimposta le credenziali di amministratore di NexoPOS (email/password) tramite l’agente della piattaforma.

Importante : il ripristino della password/credenziali di amministrazione funziona solo quando l’applicazione è installata e in esecuzione. Non riuscirà negli stati in sospeso/provisioning/non riuscito. La nuova password viene in genere mostrata una sola volta nell’interfaccia utente (flash) — non viene inviata via email come sostituto di SMTP.

Fatturazione (include rinnovo e annullamento)

Non esiste una scheda separata “Rinnovo”. Il ciclo di vita dell’abbonamento si trova in Fatturazione:

• Stato attuale dell’abbonamento, periodo, fine del periodo di prova.
• Elenco delle fatture.
• Rinnova / riprendi il pagamento quando è scaduto o quando è richiesta un’azione.
• Annulla rinnovo (accesso fino alla fine del periodo in base alle regole del prodotto).
• Cronologia della richiesta di rimborso / invia (vedi 

Dominio

• Mostra il sottodominio della piattaforma gratuita ({slug}.{base_domain}).
• Dominio personalizzato quando:
  • La modalità dominio è gratuita, oppure
  • La modalità dominio è «addon» e l’installazione dispone di un diritto attivo per il dominio personalizzato, oppure
  • Il cliente può acquistare l’add-on Dominio personalizzato pubblicato da questa scheda.

Flusso: inserisci il nome host → crea record DNS (A/AAAA verso l’IP pubblico della piattaforma, più l’host della challenge di verifica come indicato) → verifica (nginx + SSL). Potrebbero essere applicati limiti giornalieri alle modifiche verificate.

Backup

Visibile/utilizzabile quando l’installazione include il componente aggiuntivo **Backups** (oppure CTA di acquisto quando esiste un componente aggiuntivo **Backups** pubblicato).

• Backup completo manuale o solo database.
• Cronologia: ripristina, scarica, elimina (entro la policy).
• I backup automatici della piattaforma vengono eseguiti secondo la pianificazione dell’amministratore quando sono abilitati; i clienti non impostano il cron.
• Conservazione: ultime N copie di backup riuscite (Admin → Backup → conserva le ultime).

Richiede una configurazione Admin S3 funzionante.

Registri

Recupera i file di log dell’applicazione del tenant per la risoluzione dei problemi (permessi, errori dell’app) senza SSH.

Attività

Registro in stile audit delle operazioni eseguite su questa installazione dai membri dell’organizzazione (e delle azioni di sistema, quando registrate): distribuzioni, modifiche di dominio, backup, reimpostazioni delle credenziali, azioni di fatturazione, ecc.

Percorsi tipici del cliente

Pagamento non riuscito

Notifica e-mail (se SMTP) → banner di rinnovo / scheda Fatturazione → aggiorna metodo di pagamento → riprendi. Dopo il periodo di tolleranza, l’installazione può essere sospesa (pagina offline in base alle impostazioni di sospensione dell’Amministratore).

Annulla vs rimborso

• Annulla il rinnovo: continua a utilizzarlo fino alla fine del periodo.
• Richiesta di rimborso: l’approvazione dell’amministratore termina l’installazione rapidamente e pianifica un’eliminazione definitiva più veloce.

Suggerimenti per l’operatore

• Horizon deve essere in esecuzione o le installazioni restano in “provisioning”.
• HOST_AGENT_LOCAL_REAL_CLONE=false usa uno stub veloce in Docker; imposta true (oppure usa lo script su VPS) per alberi NexoPOS reali.
• Schede di dominio/backup vuote? Controlla le chiavi della funzione catalogo e le impostazioni Admin Domain/S3.
• Reimpostazione della password non riuscita? Verifica che lo stato sia in esecuzione.