Paramètres d'instance

Route : /admin/settings

Cet écran présente la configuration globale de l'instance MaxiPBX : branding, identité technique, mises à jour, licence, outils techniques et réglages système (IA, annuaire externe). La plupart des informations sont en lecture seule : elles proviennent du déploiement (fichier de branding, ControlPlane) et ne se modifient pas depuis l'interface.

• Titre : « Paramètres de l'instance ».
• Sous-titre : « Configuration globale du PBX (lecture seule pour la plupart). »
• État d'erreur : « Impossible de charger les informations de l'instance : {erreur}. »

Page réservée aux administrateurs système. Les réglages modifiables (IA, annuaire) s'appliquent à toute l'instance.

Branding

Carte « Branding » — description : « Régi par /etc/maxipbx/branding.json (déployé par Ansible role maxipbx-branding) ».

Champs affichés (lecture seule) :

Champ	Détails
Nom produit	Nom commercial du produit.
Couleur primaire	Pastille de couleur + valeur hexadécimale.
Logo	URL du logo, ou tiret si absent.
Favicon	URL du favicon, ou tiret si absent.
API base URL	URL de l'API (police à chasse fixe).

Le branding se modifie côté déploiement (fichier branding.json), pas depuis l'interface.

Instance

Carte « Instance » — description : « Identité technique du PBX ». Champs en lecture seule :

Champ	Détails
ID instance	Identifiant unique de l'instance.
Domaine	Domaine principal de l'instance.
Partenaire	Revendeur / partenaire associé.
Version	Version installée.
Canal de mise à jour	Canal de release suivi.
Politique de mise à jour	Politique appliquée aux mises à jour.

Mises à jour

Carte « Mises à jour » — description : « Vérification auprès du ControlPlane et suivi du dernier job local. »

Champs d'état (lecture seule) : Statut local, Étape, Job (identifiant), Version cible.

Après une vérification, la carte affiche la release disponible (« Version {version} »), le sous-titre « Canal {canal} · version actuelle {version} », un badge de canal, le changelog, ainsi que d'éventuels avertissements :

• Snapshot requis — avertissement (triangle ambre).
• Backup requis — avertissement (triangle ambre).

La liste des artefacts (composant, empreinte SHA-256 tronquée) est affichée si présente. Sinon : « Aucune mise à jour disponible » avec le motif, ou « Le PBX est déjà aligné avec le canal configuré. »

Boutons :

Bouton	Effet
Vérifier	Interroge le ControlPlane pour une nouvelle release. Désactivé pendant la vérification.
Mettre à jour maintenant	Lance la mise à jour. Désactivé si aucune mise à jour applicable ou pendant l'enregistrement.

Une snapshot ou un backup peut être exigé avant une mise à jour : respectez ces avertissements pour pouvoir revenir en arrière.

Licence

Carte « Licence » — description : « Quota global de l'instance + features actives ». Champs en lecture seule :

Champ	Détails
Instance ID	Identifiant de l'instance.
Max extensions	Quota global d'extensions (nombre).
Expire le	Date d'expiration de la licence.
Features	Fonctionnalités actives, affichées sous forme de badges.

Outils techniques

Carte « Outils techniques » (sur deux colonnes) — description : « Pour les administrateurs avancés — accès direct aux outils du PBX ».

Outil	Détails
API Docs (OpenAPI)	« Swagger UI de l'orchestration MaxiPBX ». Lien vers /maxipbx-api/docs.
Health	« Orchestration: OK · DB: OK · PBX: OK ». État de santé des services.

IA / API

Carte de réglages système (groupe « ai »). Chaque réglage affiche un badge « configuré » ou « non configuré », un bouton pour modifier, puis un champ de saisie (masqué pour les secrets) avec boutons Enregistrer, Effacer et Annuler.

Réglage	Type	Détails
Clé API OpenAI	Secret	Format sk-.... Active la transcription et la traduction.
Modèle Whisper	Texte	Défaut : whisper-1. Modèle de transcription audio.
Modèle de traduction live	Texte	Défaut : gpt-4o-mini. Modèle de traduction en direct.

Annuaire externe (CLI lookup)

Carte « Annuaire externe (CLI lookup) » — description : « Reverse lookup automatique sur les appels entrants — affiche le nom de l'appelant depuis tel.search.ch quand son nom n'est pas transmis. Clé API à récupérer sur https://tel.search.ch/api/getkey ».

Réglage	Type	Détails
Clé API search.ch	Secret	Clé d'accès à l'annuaire tel.search.ch.
Annuaire téléphones physiques	Interrupteur	Active l'annuaire pour les téléphones de bureau.
Annuaire téléphones — port HTTP	Texte	Port HTTP exposé par l'annuaire.
Annuaire téléphones — port HTTPS	Texte	Port HTTPS exposé par l'annuaire.
Annuaire téléphones — préférer HTTPS	Interrupteur	« Oui » / « Non » — privilégie HTTPS.

Le reverse lookup affiche automatiquement le nom de l'appelant sur les appels entrants lorsque le réseau ne le transmet pas.