Clients (tenants)

Route : /admin/tenants

Cet écran gère les clients (tenants) de l'instance MaxiPBX. Chaque client est une organisation isolée : ses utilisateurs, trunks, téléphones et appels lui sont propres. Chaque client possède un numéro unique (de 100 à 999) et un nom commercial libre.

• Titre : « Clients ».
• Sous-titre : « {n} clients · numéros 100 à 999 » (le nombre est dynamique).
• État vide : « Aucun client pour l'instant », avec un bouton « Créer le premier client ».
• État d'erreur : « Impossible de charger les clients : {erreur} » (carte rouge).
• Chargement : 4 lignes squelette pendant le chargement initial.

La gestion des clients est réservée aux administrateurs système. La suppression d'un client est en cascade : tout son contenu est détruit.

La liste des clients

Les clients sont affichés sous forme de liste de cartes (et non un tableau classique). Chaque ligne montre :

Colonne	Détails
Numéro client	Badge à gauche, en police à chasse fixe (100–999).
Nom commercial	Texte principal de la ligne.
Email admin	Affiché seulement s'il est renseigné (masqué sur petit écran).
Longueur des extensions	Badge « {n} chiffres » (masqué sur petit écran).
Quota d'extensions	Badge « max {n} ext », ou « illimité » si aucun quota (masqué sur petit écran).
Date de création	Format « j mois aaaa » (masqué sur écran moyen et inférieur).

Au survol d'une ligne apparaissent deux boutons : Modifier (crayon) et Supprimer (corbeille, rouge).

Ajouter un client

Le bouton « Ajouter un client » (icône +) ouvre une fenêtre.

• Titre : « Ajouter un client ».
• Description : « Chaque client a un numéro unique (100-999) + un nom commercial libre. »

Le formulaire est réparti en deux onglets : Paramètres essentiels et Paramètres avancés.

Paramètres essentiels

Champ	Type	Obligatoire	Détails
N° client	Nombre	Oui	De 100 à 999. Doit faire exactement 3 chiffres. Pré-rempli automatiquement avec le prochain numéro libre à l'ouverture. Erreurs : « Doit être 3 chiffres (100-999) » et « Doit être entre 100 et 999 ».
Nom commercial	Texte	Oui	Exemple : ACME SA. De 2 à 128 caractères.
Longueur des extensions	Liste	Oui	Nombre de chiffres des extensions internes. Valeur par défaut : 4. Fixée à la création, non modifiable ensuite.

Options de Longueur des extensions :

Valeur	Libellé
3	3 chiffres (extensions 100 → 999)
4	4 chiffres (extensions 1000 → 9999) — recommandé
5	5 chiffres (extensions 10000 → 99999)
6	6 chiffres (extensions 100000 → 999999)

Aide affichée : « Cette valeur est fixée à la création — toutes les extensions du client devront avoir ce nombre de chiffres exact. »

Paramètres avancés

Champ	Type	Obligatoire	Détails
Email contact admin	E-mail	Non	Exemple : admin@acme.ch. Format e-mail valide exigé. Vide = aucun.
Téléphone admin	Texte	Non	Exemple : +41 79 .... Texte libre.
Méthode de connexion par défaut	Liste	Non	Défaut : « Mot de passe local ». Voir options ci-dessous.
Max extensions	Nombre	Non	« (vide = illimité) ». De 1 à 10000. Limite le nombre total d'extensions du client. Vide = illimité.
Domaines du client	Texte	Non	Exemple : acme.ch acme.local. Séparés par espace, virgule ou point-virgule. Mis en minuscules et dédoublonnés.

Options de Méthode de connexion par défaut :

Valeur	Libellé
native	Mot de passe local (défaut)
saml	SSO SAML
ldap	LDAP

Aide « Domaines » : « Sépare les domaines par espace, virgule ou point-virgule. Utilisé par l'authentification et les intégrations. »

Boutons de la fenêtre : « Annuler » et « Créer » (désactivé pendant l'enregistrement).

Modifier un client

Le bouton crayon d'une ligne ouvre la fenêtre d'édition.

• Titre : « {numéro} — Modifier le client ».
• Description : « Le numéro client et le slug ({slug}) ne sont pas modifiables. »

L'édition reprend les mêmes champs que la création, sauf le N° client et la Longueur des extensions (tous deux fixés à la création). Le slug est généré automatiquement à partir du nom et ne se modifie pas.

Un champ supplémentaire apparaît uniquement en édition, dans l'onglet avancé :

Champ	Type	Obligatoire	Détails
Numéros d'urgence interdits comme extensions	Texte	Non	Exemple : 112 117 118 143 144 145 147. Séparés par espace, virgule ou point-virgule. Chaque numéro doit avoir 2 à 15 chiffres (avec + optionnel). Les numéros valides s'affichent en aperçu sous le champ.

Aide : « Sépare les numéros par espace, virgule ou point-virgule. Bloque la création d'extensions, files, groupes, IVR et conférences avec ces numéros. Liste vide = aucun blocage. »

Boutons : « Annuler » et « Enregistrer ».

Supprimer un client

Le bouton corbeille ouvre une confirmation.

• Titre : « Supprimer {nom} (#{numéro}) ? »
• Description : « Tous les utilisateurs, trunks, devices et incalls de ce client seront aussi supprimés (cascade). Action irréversible. »
• Bouton de confirmation : « Supprimer ».

La suppression est irréversible et détruit l'intégralité du contenu du client. Assurez-vous d'une sauvegarde avant toute suppression.