Contrôle d'accès connecté

Table des matières

1. Architecture du système d'accès
2. Types d'actions disponibles
3. Configurer les commandes MQTT
4. Historique des accès
5. Logs et traçabilité
6. Gestion des codes d'accès clients
7. Cas d'usage
8. FAQ

Architecture du système d'accès

Boxanet s'appuie sur une architecture IoT moderne pour piloter les accès physiques de votre centre de self-stockage :

Application web Boxanet
        │
        ▼ (commande MQTT via WebSocket sécurisé)
  Broker MQTT (cloud)
        │
        ▼ (topic spécifique au site)
 Dispositifs Shelly (Shelly Pro 1, Shelly Plus 1, etc.)
        │
        ▼
 Portails / Portes / Barrières

• Application web Boxanet : l'interface d'administration et l'application client envoient des commandes d'action (entrée, sortie, ouverture de bâtiment).
• Broker MQTT : messagerie temps réel hébergée dans l'infrastructure Boxanet. Chaque site dispose de topics MQTT dédiés et isolés.
• Dispositifs Shelly : relais intelligents connectés en WiFi. Ils reçoivent les commandes MQTT et actionnent les relais physiques (portails, serrures, barrières).
• Codes PIN : chaque client dispose d'un code PIN unique généré automatiquement à la création du contrat. Ce code peut être utilisé sur un clavier externe ou via l'application mobile.

Types d'actions disponibles

Boxanet supporte quatre types d'actions d'accès physique, configurables indépendamment pour chaque site :

1. Entrée site (entry)

2. Ouverture bâtiment (building_open)

3. Fermeture bâtiment (building_close)

4. Sortie site (exit)

Configurer les commandes MQTT

Accéder à la configuration

1. Allez dans Paramètres → Site → Contrôle d'accès.
2. Sélectionnez l'onglet "Commandes MQTT".

Structure JSON des commandes

Chaque action est définie par un objet JSON envoyé sur un topic MQTT spécifique. Voici la structure complète :

{
  "actions": {
    "entry": {
      "topic": "shellies/site-paris-01/portail-entree/relay/0/command",
      "payload": "on",
      "duration_ms": 800,
      "confirm_topic": "shellies/site-paris-01/portail-entree/relay/0"
    },
    "building_open": {
      "topic": "shellies/site-paris-01/porte-bat-a/relay/0/command",
      "payload": "on",
      "duration_ms": 500,
      "confirm_topic": "shellies/site-paris-01/porte-bat-a/relay/0"
    },
    "building_close": {
      "topic": "shellies/site-paris-01/porte-bat-a/relay/0/command",
      "payload": "off",
      "duration_ms": 0,
      "confirm_topic": null
    },
    "exit": {
      "topic": "shellies/site-paris-01/portail-sortie/relay/0/command",
      "payload": "on",
      "duration_ms": 800,
      "confirm_topic": "shellies/site-paris-01/portail-sortie/relay/0"
    }
  },
  "broker": {
    "host": "mqtt.boxanet.fr",
    "port": 8883,
    "tls": true
  }
}

Tester une commande MQTT

Après avoir enregistré la configuration :

1. Cliquez sur "Tester" à côté de chaque action.
2. Un appui envoie la commande en temps réel.
3. Le résultat (succès / timeout / erreur) s'affiche dans les 3 secondes.

Historique des accès

Consulter l'historique

1. Allez dans Accès → Historique.
2. La liste affiche par défaut les 100 derniers événements du site courant.

Filtres disponibles

• Client : recherche par nom, prénom ou numéro de contrat
• Action : entrée, sortie, ouverture bâtiment, fermeture bâtiment
• Date : sélecteur de plage de dates
• Statut : succès, échec, timeout
• Box : filtrer les accès liés à une box spécifique

Exporter l'historique

Cliquez sur "Exporter → CSV" pour télécharger l'historique filtré. Le fichier inclut : date/heure, client, action, statut, IP, durée d'exécution.

Logs et traçabilité

Chaque événement d'accès génère un log complet incluant :

Consulter les logs techniques

Les logs techniques détaillés sont accessibles dans Accès → Logs techniques (rôle manager uniquement). Ils permettent de diagnostiquer les problèmes de connectivité MQTT ou de timeout réseau.

Gestion des codes d'accès clients

Génération automatique

Un code PIN à 6 chiffres est généré automatiquement lors de la création d'un contrat. Il est envoyé au client par SMS et email, et consultable dans l'espace client.

Consulter le code PIN d'un client

1. Ouvrez le contrat du client.
2. Dans la section "Accès", cliquez sur l'icône œil pour afficher le code PIN.

Régénérer un code PIN

1. Ouvrez le contrat.
2. Dans la section "Accès", cliquez sur "Régénérer le code".
3. Confirmez l'action — l'ancien code est immédiatement invalidé.
4. Le nouveau code est envoyé au client par SMS automatiquement.

Suspension temporaire d'accès

Pour suspendre l'accès d'un client sans résilier le contrat (ex. : loyers impayés) :

1. Ouvrez le contrat.
2. Section "Accès" → "Suspendre l'accès".
3. Le client reçoit une notification et son code PIN est désactivé jusqu'à la levée de suspension.

Cas d'usage

Accès client depuis smartphone

1. Marie se connecte à son espace client sur client.boxanet.fr ou via l'application mobile.
2. Sur l'écran d'accueil, elle voit les boutons d'accès : "Entrer sur le site", "Ouvrir le bâtiment", "Sortir du site".
3. En appuyant sur "Entrer sur le site", l'application envoie la commande MQTT via le serveur Boxanet.
4. Le Shelly Pro 1 connecté au portail reçoit la commande et ouvre le portail pendant 800 ms.
5. L'accès est loggé avec l'heure, l'IP et (si autorisé) les coordonnées GPS de Marie.

• Le contrat de Marie est actif (non résilié, non suspendu)
• L'heure d'accès est dans les plages horaires autorisées (configurables par site)
• Le dispositif Shelly est connecté et répond sur le broker MQTT

Débogage d'une porte bloquée

1. Allez dans Accès → Historique et filtrez sur le client et les 30 dernières minutes.
2. Cherchez un événement d'accès avec statut "Échec" ou "Timeout".
3. Cliquez sur l'événement pour voir le log détaillé.
4. Si "Timeout MQTT" : le dispositif Shelly n'a pas répondu. Vérifiez la connexion WiFi du Shelly (LED orange = déconnecté).
5. Si "Accès refusé" : le contrat est peut-être suspendu. Vérifiez dans Contrats → [Client].
6. Si "Hors horaires" : l'accès a été tenté hors des plages autorisées.
7. Pour tester manuellement : Paramètres → Contrôle d'accès → Tester → Ouverture portail.

FAQ