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é, compilation, dashboards…) dépendent du plan du comptepropriétaire (Découverte ou Intégrateur).
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
| Type | Pour qui | Facturation | Plan requis |
|---|---|---|---|
| Personnel | Votre propre installation (maison, atelier…) | Auto-payée par vous | Découverte / Client / Intégrateur |
| Client (intégrateur) | Une installation que vous gérez pour un tiers | Gratuit en mode dégradé tant que le client n’a pas revendiqué | Intégrateur (19 €) |
Le mode client (intégrateur) est conçu pour les installateurs domotique : vous pouvez préparer une installation complète avant que votre client final ne crée son compte. Une fois prête, vous lui transmettez un claim-tokenqu’il revendique depuis son propre compte — le workspace bascule alors automatiquement en mode auto-payé.
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 le workspace dans votre liste) + adresse de l’installation. Le workspace est créé en mode dégradé : limité à 3 appareils, 7 jours d’historique — comme un Free.
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, workspaces clients illimités) depuis Compte › Abonnement.4. Claim-token : transférer un workspace à votre client
Sur la page de détail d’un workspace client (/dashboard/workspaces/<id>), cliquez sur Générer un token. Vous choisissez sa durée de validité (1 à 30 jours) et obtenez un code à usage unique de la forme els-XXXXXX-XXXXXX-XXXXXX.
- Le token n’est affiché qu’une seule fois — copiez-le immédiatement (un bouton « Copier » est prévu). Le serveur n’en garde qu’une empreinte Argon2, pas le code lui-même.
- Transmettez-le à votre client par le canal de votre choix (email, SMS, papier…). Il devra le saisir depuis Dashboard › Workspaces › Revendiquer dans son propre compte Elark.
- À la première revendication réussie, le token est révoqué automatiquement et le workspace passe en mode auto-payé. Si la limite Découverte est dépassée, le client est invité à choisir le plan Intégrateur.
- Vous pouvez révoquer un token avant revendication (bouton dédié à côté du formulaire).
La revendication est facultative. Le client final n’est jamais obligé de créer un compte ni de revendiquer son workspace : l’intégrateur peut continuer à gérer l’installation aussi longtemps que son abonnement Intégrateur est actif. Revendiquer présente toutefois un intérêt pour le client : il devient propriétaire et peut gérer lui-même son installation (les tableaux de bord nécessitent le plan Intégrateur).
5. Rôles et matrice d’invitation
| Rôle | Permissions | Peut inviter |
|---|---|---|
| Propriétaire | Tout, y compris supprimer le workspace | Admin, Intégrateur, Technicien, Visiteur |
| Administrateur | Modifie tout sauf supprimer le workspace | Intégrateur, Technicien, Visiteur |
| Intégrateur | Modifie les devices et les automations | Technicien, Visiteur |
| Technicien | Pilote les devices, accès lecture seule à la config | Aucun |
| Visiteur | Lecture seule | Aucun |
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
| Plan | Workspaces personnels max | Workspaces clients max |
|---|---|---|
| Découverte | 1 | 0 (pas autorisé) |
| Client | 1 | 0 (pas autorisé) |
| Intégrateur | Illimité | Illimité |
Le plan Découverte est limité à 3 appareils, 7 jours d’historique et un seul espace. Le plan Client (3 €/mois) lève les limites d’appareils et d’historique dans le workspace personnel, mais ne permet ni de créer des workspaces clients ni la compilation en ligne. Pour gérer plusieurs installations (et workspaces clients illimités), le plan Intégrateur débloque tout.
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.