Gestion de l’installation

Comment les clients choisissent un forfait, déploient une installation, gèrent des équipes et exploitent chaque site depuis la console d’installation.

Interface utilisateur principale :

• Tarification — plans marketing publics
• Tableau de bord → Installations — liste
• Détail de l’installation — gestion par onglets (/dashboard/installations/{id}?tab=…)

Sélection du plan et paiement

1. Parcourir les tarifs (packs publiés + fonctionnalités marketing).
2. Commencer le paiement pour un pack (et des options supplémentaires / un code promo si proposé).
3. Payer via la passerelle de plateforme active (Stripe Checkout, Paddle, Mollie, …) ou activer l’essai si le pack inclut trial_days.
4. En cas de réussite, l’installation passe de « paiement en attente » → « provisionnement » → « en cours d’exécution » (workers Horizon + agent hôte).

Espace réservé de capture d’écran : Page de tarification Espace réservé de capture d’écran : Revue de commande (forfait + options) Espace réservé de capture d’écran : Page de paiement du fournisseur Espace réservé de capture d’écran : Succès de facturation / progression de l’approvisionnement

Si le navigateur renvoie une réponse avant le webhook, la page de succès peut confirmer la session auprès de l’API du fournisseur afin que le paiement aboutisse quand même.

Déployer une nouvelle installation

Les échecs apparaissent dans les onglets **Aperçu** et **Activité** lors de l’installation ; les administrateurs de la plateforme voient également les opérations/journaux.

Le paramètre « max_installations » bloque les déploiements supplémentaires lorsque la limite est atteinte.

Gestion des installations

Ouvrez une installation pour obtenir des onglets horizontaux. La capacité de facturation dépend du rôle du membre (peut.facturer).

Espace réservé de capture d’écran : en-tête d’installation avec badge d’état et barre d’onglets

Aperçu

• Statut de l’installation, domaine principal, résumé du bundle.
• Opérations de déploiement actives avec progression par étapes (provisionnement, mise à jour, réinstallation).
• Modules intitulés par le bundle : installation/mise à jour lorsque des versions sont disponibles.
• Mises à jour du cœur / des modules en un clic lorsque la plateforme signale des mises à jour disponibles (met en file une tâche de mise à jour ; surveille la progression dans cet onglet).
• Réinstaller : effacement complet (wipe) ou restauration à partir d’une sauvegarde sélectionnée (même identité d’installation).

Paramètres (mot de passe administrateur du locataire)

• Les paramètres de localisation / fuseau horaire de type installation ont été exposés.
• Réinitialiser les identifiants administrateur de NexoPOS (e-mail/mot de passe) via l’agent de la plateforme.

Important : la réinitialisation du mot de passe/identifiants administrateur ne fonctionne que lorsque l’application est installée et en cours d’exécution. Elle n’aboutira pas dans les états en attente/de provisionnement/échec. Le nouveau mot de passe s’affiche généralement une seule fois dans l’interface utilisateur (flash) — il n’est pas envoyé par e-mail en remplacement de SMTP.

Facturation (inclut le renouvellement et l’annulation)

Il n’y a pas d’onglet distinct « Renouvellement ». Le cycle de vie de l’abonnement se trouve sous Facturation :

• Statut actuel de l’abonnement, période, fin de la période d’essai.
• Liste des factures.
• Renouveler / reprendre le paiement lorsque celui-ci est en retard ou qu’une action est requise.
• Annuler le renouvellement (accès jusqu’à la fin de la période selon les règles du produit).
• Historique des demandes de remboursement / soumettre (voir 

Domaine

• Affiche le sous-domaine de la plateforme gratuite ({slug}.{base_domain}).
• Domaine personnalisé quand :
  • Le mode Domaine est gratuit, ou bien
  • Le mode de domaine est « addon » et l’installation dispose d’une autorisation « domaine personnalisé » active, ou bien
  • Le client peut acheter l’option « domaine personnalisé » publiée à partir de cet onglet.

Flux : saisissez le nom d’hôte → créez des enregistrements DNS (A/AAAA vers l’IP publique de la plateforme, plus l’hôte de défi de vérification comme indiqué) → vérifiez (nginx + SSL). Des limites quotidiennes de modifications vérifiées peuvent s’appliquer.

Sauvegarde

Visible/utilisable lorsque l’installation dispose de l’add-on Backups (ou CTA d’achat lorsqu’un add-on Backups publié existe).

• Sauvegarde complète manuelle ou uniquement via la base de données.
• Historique : restaurer, télécharger, supprimer (dans le cadre de la politique).
• Les sauvegardes automatiques de la plateforme s’exécutent selon le calendrier d’administration lorsqu’elles sont activées ; les clients ne configurent pas de cron.
• Rétention : les N dernières sauvegardes réussies (Admin → Sauvegardes → conserver les dernières).

Nécessite une configuration Admin S3 fonctionnelle.

Journaux

Récupère les journaux des candidatures des locataires pour le dépannage (autorisations, erreurs d’application) sans SSH.

Activité

Journal de type audit des opérations effectuées sur cette installation par les membres de l’organisation (et des actions du système lorsqu’elles sont consignées) : déploiements, modifications de domaine, sauvegardes, réinitialisations d’identifiants, actions de facturation, etc.

Parcours clients courants

Le paiement a échoué

Notification par e-mail (si SMTP) → bannière de renouvellement / onglet Facturation → mettre à jour le mode de paiement → reprendre. Après la période de grâce, l’installation peut être suspendue (page hors ligne selon les paramètres de suspension de l’administrateur).

Annuler ou rembourser

• Annuler le renouvellement : continuer à l’utiliser jusqu’à la fin de la période.
• Demande de remboursement : l’approbation de l’administrateur permet une installation plus rapide et planifie une suppression définitive plus rapide.

Conseils pour l’opérateur

• Horizon doit être en cours d’exécution, sinon les installations restent « en cours de provisionnement ».
• HOST_AGENT_LOCAL_REAL_CLONE=false utilise un stub rapide dans Docker ; définissez true (ou utilisez script sur un VPS) pour de vrais arbres NexoPOS.
• Onglets de sauvegarde/domaine vides ? Vérifiez les clés de la fonctionnalité de catalogue et les paramètres Admin Domaine/S3.
• La réinitialisation du mot de passe échoue ? Vérifiez que l’état est en cours d’exécution.