Elark KB

Démarrage

Workspaces : organiser vos installations

Un workspace regroupe vos appareils et leurs membres. Personnel pour votre maison, ou client si vous êtes intégrateur — chaque workspace a son plan et sa facturation.

Lecture 6 min

1. Qu’est-ce qu’un workspace ?

Un workspace Elark est un conteneur isolé qui regroupe une installation complète : ses appareils, ses pièces, ses automations, ses utilisateurs et son historique. À chaque workspace correspond un mode de facturation (auto-payé, géré par un intégrateur, ou en essai gratuit). Les capacités (illimité, dashboards…) dépendent du plan du compte propriétaire (Découverte, Intégrateur ou Intégrateur Pro).

Cette séparation garantit l’isolation des données entre vos installations : un appareil créé dans le workspace « Maison Dupont » n’apparaît jamais dans le workspace « Mon foyer », même si vous êtes membre des deux. C’est aussi la base de la sécurité multi-tenant des topics MQTT (t/<workspace>/d/<device>/...).

2. Workspaces personnels vs clients

TypePour quiFacturationPlan requis
PersonnelVotre propre installation (maison, atelier…)Auto-payée par vousDécouverte / Intégrateur / Intégrateur Pro
Client (intégrateur)Une installation que vous gérez pour un clientComptée dans le quota d’installations de votre abonnement intégrateurIntégrateur (19 €) ou Intégrateur Pro (49 €)

Le mode client (intégrateur) est conçu pour les installateurs domotique : vous créez et gérez l’installation de bout en bout pour le compte de votre client. Le client final ne se connecte jamais à la plateforme — c’est vous qui pilotez son installation en continu, aussi longtemps que votre abonnement Intégrateur est actif (voir la section suivante sur le modèle Client).

3. Créer un nouveau workspace

Direction Dashboard › Workspaces › Nouveau workspace. Choisissez le type :

  • Personnel : saisissez juste un nom. Le workspace est créé avec vous comme propriétaire et bascule immédiatement en facturation auto-payée.
  • Client (intégrateur) : nom + email du client (optionnel mais utile pour identifier l’installation dans votre liste) + adresse de l’installation. Le workspace est immédiatement géré par votre abonnement — ses limites d’appareils et d’historique sont celles de votre propre plan (Intégrateur ou Intégrateur Pro), pas un mode dégradé séparé.
Si l’option « Client » est grisée dans votre formulaire, c’est que votre plan ne permet pas le mode intégrateur. Passez au plan Intégrateur (19 €/mois, jusqu’à 10 installations clientes) depuis Compte › Abonnement.

4. Le modèle Client : regrouper plusieurs installations

Un Client est une fiche d’identité — nom, email, téléphone — qui regroupe une ou plusieurs installations (workspaces). Par exemple, « M. Dupont » peut avoir deux installations rattachées à sa fiche Client : sa maison principale et sa dépendance, chacune avec ses propres appareils, pièces et historique.

Le Client n’est pas un compte : il n’a ni mot de passe ni connexion à la plateforme. C’est un simple regroupement de supervision, géré exclusivement par vous (l’intégrateur qui le gère). Vous le créez et le modifiez depuis Dashboard › Clients, puis rattachez une ou plusieurs installations depuis la fiche du client.

Le client final ne se connecte jamais à l’application Elark. Toute la supervision — appareils, alertes, interventions — reste entre vos mains tant que vous gérez son installation.

5. Rôles et matrice d’invitation

RôlePermissionsPeut inviter
PropriétaireTout, y compris supprimer le workspaceAdmin, Intégrateur, Technicien, Visiteur
AdministrateurModifie tout sauf supprimer le workspaceIntégrateur, Technicien, Visiteur
IntégrateurModifie les devices et les automationsTechnicien, Visiteur
TechnicienPilote les devices, accès lecture seule à la configAucun
VisiteurLecture seuleAucun

La matrice d’invitation empêche un rôle inférieur d’inviter un rôle supérieur — c’est validé côté backend (cf. workspaces/permissions.py::INVITE_MATRIX). Le dernier Propriétaire d’un workspace personnel ne peut jamais être retiré : vous devez d’abord en désigner un autre.

6. Workspace courant et bandeau de contexte

En haut de votre dashboard, le sélecteur de workspace (à droite du titre) permet de basculer entre vos installations. Le choix est stocké dans un cookie et propagé automatiquement à toutes les requêtes via le header X-Workspace-Id.

Quand vous travaillez sur un workspace client (ou que vous y êtes invité comme intégrateur / technicien), un bandeau orange apparaît en haut de chaque page pour vous le rappeler. Un workspace gelé (facturation suspendue) affiche un bandeau rouge avec icône cadenas — toutes les actions sont en lecture seule.

7. Quotas par plan utilisateur

PlanWorkspaces personnels maxWorkspaces clients max
Découverte11
IntégrateurIllimité10
Intégrateur ProIllimitéIllimité

Le plan Découverte est limité à 3 appareils, 7 jours d’historique et une seule installation cliente. Le plan Intégrateur (19 €/mois) lève les limites d’appareils et d’historique et débloque jusqu’à 10 installations clientes. Pour un parc illimité, le plan Intégrateur Pro (49 €/mois) lève cette dernière limite.

Les workspaces clients gelés ne comptent pas dans le quota. Un intégrateur dont un client a cessé de payer peut donc continuer à créer de nouveaux workspaces — la limite porte uniquement sur les workspaces actifs.

8. Détection hors ligne par workspace

Chaque workspace définit un délai au-delà duquel un appareil silencieux est considéré hors ligne dans l’interface. Réglage depuis la fiche du workspace (Détection hors ligne) — entre 60 et 3600 secondes, 120 secondes par défaut.

  • Un réseau stable (Ethernet, WiFi domestique fiable) supporte des valeurs basses (60–120 s) : l’état affiché bascule très rapidement après une coupure.
  • Un réseau plus capricieux (4G/LTE, WiFi étendu) gagne à monter à 300–600 s pour éviter les bascules transitoires lors de micro-coupures qui se résorbent toutes seules.

Le réglage est réservé aux Propriétaires et Administrateurs du workspace. La détection intervient au maximum une minute après le dépassement du seuil.