Network
Le module Diagrammes réseau de SmartDoc vous offre un éditeur visuel interactif pour créer et maintenir des schémas d'infrastructure de vos clients. Chaque noeud du diagramme peut être lié à un actif SmartDoc réel, et les diagrammes sont exportables en PNG, SVG ou PDF pour les rapports et documentations remis aux clients.
Table des matières
- Vue d'ensemble
- Types de diagrammes
- Interface de la liste des diagrammes
- Éditeur de diagramme
- Palette de noeuds
- Types de noeuds personnalisés
- Connexions (arêtes)
- Liaison avec les actifs SmartDoc
- Export et partage
- Module réseau structuré
- Bonnes pratiques
Vue d'ensemble
Le module Diagrammes réseau répond à un besoin fondamental de la documentation MSP : avoir une représentation visuelle claire et à jour de l'architecture réseau d'un client. Que ce soit pour un onboarding, une révision annuelle, un audit ou une intervention d'urgence, un diagramme bien maintenu réduit considérablement le temps de compréhension de l'infrastructure.
L'éditeur est basé sur la librairie React Flow (anciennement @xyflow/react), qui offre une expérience fluide de glisser-déposer et de connexion de noeuds directement dans le navigateur.
Points clés :
- Trois types de diagrammes : réseau, carte mentale, organigramme
- Noeuds personnalisables : icônes Lucide ou SVG vectoriel importé (Adobe Illustrator, Visio, etc.)
- Liaison aux actifs : chaque noeud peut afficher l'IP, le nom d'hôte ou l'adresse MAC de l'actif lié
- Export multi-format : PNG, SVG, PDF
- Duplication : clonez un diagramme existant comme point de départ
- Accès par niveau : chaque diagramme peut être marqué interne ou partageable avec le client
Types de diagrammes
| Type | Icône | Usage typique |
|---|---|---|
| Diagramme réseau | Réseau | Infrastructure IT, serveurs, équipements réseau, topologie |
| Carte mentale | Cerveau | Brainstorming, cartographie d'idées, analyse de processus |
| Organigramme | Personnes | Structure d'entreprise, hiérarchie, équipes |
Le type de diagramme est défini à la création et détermine la bibliothèque de noeuds disponible dans la palette.
Interface de la liste des diagrammes
Navigation
Accès via la barre latérale SmartDoc : SmartDoc > Diagrammes réseau
Modes d'affichage
Quatre modes sont disponibles, ajustables depuis les boutons en haut à droite :
| Mode | Description |
|---|---|
| Petites cartes | Grille très dense (8 colonnes max), nom et type uniquement |
| Cartes moyennes | Grille équilibrée, 6 colonnes |
| Grandes cartes | 4 colonnes, avec client, date et statut |
| Tableau | Une ligne par diagramme, toutes les colonnes, tri par colonne |
Filtres disponibles
- Recherche textuelle : sur le nom du diagramme
- Filtre par statut : Actif, Inactif, Archivé
- Filtre par niveau d'accès : Interne, Client
- Filtre par type : Réseau, Carte mentale, Organigramme
Taille de page
En mode tableau, il est possible de choisir le nombre d'éléments par page : 25, 50, 75 ou 100.
Actions depuis la liste
| Action | Description |
|---|---|
| Clic sur une carte | Ouvre l'éditeur dans un nouvel onglet |
| Menu contextuel (trois points) | Modifier, Dupliquer, Supprimer |
| Dupliquer | Ouvre un dialogue pour nommer la copie |
| Nouveau diagramme | Ouvre le dialogue de création de diagramme |
Dialogue de création
Le dialogue de création propose :
- Type de diagramme : choisir parmi Réseau, Carte mentale, Organigramme
- Nom : titre du diagramme
- Client : compagnie associée (optionnel)
- Modèle : partir d'un template existant ou d'un diagramme vierge
Après validation, l'éditeur s'ouvre automatiquement dans un nouvel onglet.
Éditeur de diagramme
L'éditeur s'ouvre dans un onglet dédié à plein écran. Il est composé de :
- Un canevas central : zone de travail infinie où les noeuds et connexions sont disposés
- Un panneau gauche : palette de noeuds et bibliothèque de types
- Un panneau droit : propriétés de l'élément sélectionné (noeud ou connexion)
- Une barre d'outils en haut
Barre d'outils
| Bouton | Fonction |
|---|---|
| Sauvegarder | Enregistre le diagramme (noeuds, arêtes, viewport) |
| Ajuster la vue | Recadre le canevas pour afficher tous les éléments |
| Export | Ouvre le menu d'export (PNG, SVG, PDF) |
| Basculer le panneau gauche | Masque ou affiche la palette |
| Basculer le panneau droit | Masque ou affiche les propriétés |
| Bascule thème | Passe du mode sombre au mode clair |
| Bascule langue | Alterne entre français et anglais |
Contrôles du canevas
L'éditeur React Flow inclut les contrôles standards :
- Zoom avant/arrière : molette de souris ou boutons + / -
- Panoramique : maintenir Espace + glisser, ou clic milieu
- Sélection multiple : maintenir Maj + cliquer sur plusieurs noeuds
- Supprimer : touche Delete ou Backspace sur un noeud/arête sélectionné
- Minimap : vue en miniature en bas à droite pour se repérer sur les grands diagrammes
- Grille d'alignement : fond en grille ou en points pour aligner les éléments
Palette de noeuds
La palette gauche présente les types de noeuds disponibles, organisés en catégories accordéon.
Utilisation de la palette
Deux méthodes pour ajouter un noeud :
- Glisser-déposer : saisissez un type de noeud depuis la palette et déposez-le sur le canevas à l'endroit voulu
- Clic : un clic simple sur un type de noeud l'ajoute au centre du canevas
Icônes disponibles par défaut
La palette inclut des icônes pour tous les équipements réseau courants :
| Icône | Représente |
|---|---|
| Serveur | Serveurs physiques ou virtuels |
| Routeur | Équipements de routage |
| Réseau | Switch, hub, topologie générique |
| Pare-feu | Firewall, UTM |
| Nuage | Cloud (AWS, Azure, GCP) |
| Écran | Postes de travail, moniteurs |
| WiFi | Points d'accès sans fil |
| Disque dur | Stockage, NAS, SAN |
| Imprimante | Imprimantes réseau |
| Smartphone | Appareils mobiles |
| Base de données | Serveurs de base de données |
| Globe | Internet, WAN |
| Cadenas | Sécurité, VPN, chiffrement |
| Processeur | Équipements de traitement |
| Radio | Liaisons sans fil, antennes |
| Ordinateur portable | Laptops |
| Câble | Liaisons filaires |
| Cerveau | IA, automatisation (utilisé pour les cartes mentales) |
| Et de nombreux autres... | Organisations, équipes, lieux, etc. |
Recherche dans la palette
Un champ de recherche en haut de la palette permet de filtrer les types de noeuds par nom.
Types de noeuds personnalisés
Les types de noeuds sont entièrement personnalisables par le MSP depuis la page Paramètres > Types de noeuds réseau.
Propriétés d'un type de noeud
| Propriété | Description |
|---|---|
| Nom (EN/FR) | Label affiché dans la palette et sur le canevas |
| Icône | Sélection parmi les icônes Lucide disponibles |
| SVG personnalisé | Import d'une icône SVG vectorielle (max 200 KB) |
| Couleur | Couleur de fond du noeud (violet, bleu, cyan, vert, orange, rouge, rose, etc.) |
| Étiquettes (tags) | Mots-clés pour le filtrage |
| Catégorie | Groupe dans la palette |
| Portée | Global (tous les types de diagrammes) ou spécifique à un type |
Import d'icônes SVG personnalisées
SmartDoc accepte les icônes SVG provenant de logiciels professionnels comme Adobe Illustrator ou Visio. Le système :
- Valide et sanitize le SVG (suppression des scripts malveillants via DOMPurify)
- Rend les identifiants SVG uniques pour éviter les conflits lorsque plusieurs icônes identiques sont présentes sur le canevas
- Gère les classes CSS d'Illustrator (
st0,st1, etc.) pour éviter les conflits de style - Supporte les icônes transparentes (sans fond coloré) pour les SVG détaillés
Catégories de noeuds
Les types de noeuds peuvent être organisés en catégories personnalisables. Chaque catégorie apparait comme une section accordéon dans la palette, ce qui facilite la navigation lorsque le nombre de types est important.
Connexions (arêtes)
Création d'une connexion
Pour connecter deux noeuds :
- Survoler le bord d'un noeud jusqu'à faire apparaitre les points de connexion (handles)
- Cliquer et glisser depuis un point de connexion vers le noeud cible
- Relâcher sur le noeud cible pour créer la connexion
Les connexions sont bidirectionnelles par défaut : chaque face d'un noeud (haut, bas, gauche, droite) dispose de points de connexion source et cible.
Style des connexions
Le panneau de propriétés permet de personnaliser chaque connexion :
| Propriété | Options |
|---|---|
| Couleur | Gris, Bleu, Vert, Rouge, Orange, Violet, Cyan, Rose |
| Épaisseur | Fine (1px), Moyenne (2px), Épaisse (4px) |
| Style de trait | Plein, Tirets |
| Flèches | Aucune, Fin, Début, Les deux extrémités |
| Type de tracé | Direct, Courbe (smooth), Angle droit (step), Bézier |
| Label | Texte affiché sur la connexion |
| Couleur du label | Personnalisable |
| Fond du label | Transparent, Blanc, ou couleur |
| Position du label | Déplaçable par glisser-déposer |
Déconnexion
Sélectionner une arête puis appuyer sur Delete ou Backspace pour la supprimer.
Liaison avec les actifs SmartDoc
Fonctionnement
Chaque noeud peut être lié à un actif SmartDoc (serveur, switch, pare-feu, poste de travail, etc.). Une fois la liaison établie, les informations de l'actif sont affichées directement sur le noeud dans le diagramme.
Informations affichées sur le noeud
Les champs suivants peuvent être activés ou désactivés individuellement dans le panneau de propriétés du noeud :
| Information | Description |
|---|---|
| Nom de l'actif | Nom tel que saisi dans la fiche d'actif |
| Nom d'hôte | Hostname réseau de l'équipement |
| Adresse IP | Adresse IP principale |
| Adresse MAC | Adresse MAC principale |
Liaison d'un actif à un noeud
- Sélectionner un noeud sur le canevas
- Dans le panneau de propriétés (droite), cliquer sur "Lier un actif"
- Rechercher l'actif par nom, hostname ou IP dans la liste de recherche
- Sélectionner l'actif - les informations se mettent à jour immédiatement sur le noeud
La recherche d'actifs tient compte du client sélectionné dans le contexte SmartDoc.
Position du label
La position des informations textuelles autour du noeud est configurable :
- Bas, Haut, Gauche, Droite
- Bas-gauche, Bas-droite, Haut-gauche, Haut-droite
- Masqué
Redimensionnement des noeuds SVG
Les noeuds utilisant une icône SVG personnalisée sont redimensionnables par glisser-déposer sur les poignées de redimensionnement qui apparaissent lors de la sélection.
Export et partage
Formats d'export
| Format | Description |
|---|---|
| PNG | Image haute résolution, idéale pour les rapports Word ou PowerPoint |
| SVG | Vecteur modifiable dans Illustrator, Inkscape ou intégrable dans le web |
| Document prêt à imprimer ou à envoyer par email |
L'export capture l'intégralité du diagramme visible sur le canevas, y compris les noeuds, connexions et labels.
Niveaux d'accès
Chaque diagramme est associé à un niveau d'accès :
- Interne : visible uniquement par l'équipe MSP dans SmartDoc
- Client : partageable avec les contacts du client via le portail client SmartDoc
Duplication
La duplication crée une copie complète d'un diagramme (noeuds, arêtes, viewport, paramètres) sous un nouveau nom. C'est le moyen recommandé pour créer des diagrammes similaires pour plusieurs clients ou pour créer une version archivée avant une mise à jour majeure.
Module réseau structuré
En parallèle de l'éditeur visuel, SmartDoc dispose d'un module réseau structuré accessible depuis l'onglet Réseau de la barre de navigation SmartDoc. Ce module gère les données réseau de manière tabulaire et hiérarchique.
Vue d'ensemble réseau
La page de vue d'ensemble affiche une arborescence hiérarchique :
Compagnie cliente
|__ Site (ex. : Siège social Montréal)
|__ VLANs du site
|__ Sous-réseaux du site
|__ Actifs liés au sous-réseau
Les données se chargent de manière paresseuse (lazy loading) : les sites ne se chargent que lorsque la compagnie est développée, et les sous-réseaux uniquement lorsque le site est développé.
Gestion des sites
Un site représente un emplacement physique d'un client. Les informations d'un site comprennent :
| Champ | Description |
|---|---|
| Nom | Nom descriptif du site |
| Adresse | Adresse physique complète (rue, ville, province, pays) |
| Téléphone | Numéro de téléphone du site |
| Contact | Nom du contact sur place |
| Fournisseur d'accès (ISP) | Nom du fournisseur Internet |
| Identifiant de circuit | Numéro de circuit chez l'ISP |
| Bande passante | Débit de la liaison (ex. : 1 Gbps) |
| IP WAN | Adresse IP publique de la connexion WAN |
Gestion des VLANs
Les VLANs sont associés à un site et à une compagnie. Chaque VLAN est défini par :
| Champ | Description |
|---|---|
| ID VLAN | Numéro du VLAN (1 à 4094) |
| Nom | Nom descriptif du VLAN |
| Description | Informations complémentaires |
| Usage | Data, Voix, Management, Invités, IoT, DMZ, Sécurité, Autre |
Gestion des sous-réseaux (subnets)
Les sous-réseaux documentent les plages d'adresses IP utilisées par client. Chaque sous-réseau comprend :
| Champ | Description |
|---|---|
| CIDR | Notation CIDR de la plage IP (ex. : 192.168.10.0/24) |
| Type | LAN, WAN, DMZ, VPN, Invités, Management, VoIP, IoT, Autre |
| Description | Informations sur l'usage du sous-réseau |
| DHCP activé | Indique si le DHCP est actif sur ce réseau |
| Plage DHCP | Adresses de début et de fin de la plage DHCP |
| DNS primaire | Adresse IP du serveur DNS principal |
| DNS secondaire | Adresse IP du serveur DNS secondaire |
| Site associé | Site hébergeant ce sous-réseau |
| VLAN associé | VLAN sur lequel ce sous-réseau est configuré |
Connexions inter-sites
Le module permet de documenter les connexions entre deux sites d'un même client (VPN, MPLS, SD-WAN, liaison point-à-point, etc.) :
| Type de connexion | Description |
|---|---|
| VPN | Tunnel VPN entre deux sites |
| MPLS | Liaison MPLS opérateur |
| SD-WAN | Réseau WAN défini par logiciel |
| Point à point | Liaison dédiée |
| Internet | Connexion via l'Internet public |
| IPSec | Tunnel chiffré IPSec |
| Autre | Type personnalisé |
Liaison actifs-réseau
Le module permet de lier un actif SmartDoc à un sous-réseau avec :
- Adresse IP de l'actif sur ce réseau
- Adresse MAC de l'interface
- Nom de l'interface réseau (ex. : eth0, ens3)
- Indicateur "Interface principale"
Page de détail d'un site
La page de détail d'un site affiche toutes les informations du site ainsi que les VLANs, sous-réseaux et actifs associés dans des onglets dédiés.
Bonnes pratiques
- Nommez vos diagrammes de manière descriptive et incluez la date ou la version (ex. : "Réseau principal - XYZ Corp - 2026", "Topologie WAN v3")
- Créez un diagramme par "couche" de l'infrastructure pour éviter les schémas surchargés : un diagramme physique (équipements), un diagramme logique (IP, VLANs), un diagramme de sécurité (flux, zones)
- Liez systématiquement les noeuds aux actifs SmartDoc pour que le diagramme se maintienne à jour lorsque les informations des actifs changent
- Utilisez la duplication pour créer une version "avant intervention" d'un diagramme avant de faire des modifications importantes
- Archivez les anciens diagrammes plutôt que de les supprimer pour conserver l'historique de l'évolution de l'infrastructure
- Exportez en PDF et joignez le diagramme aux rapports remis au client lors des revues mensuelles ou trimestrielles
- Pour les icônes SVG importées depuis Illustrator, vérifiez que le fichier ne dépasse pas 200 KB et ne contient pas de liens externes
- Utilisez les catégories de noeuds personnalisées pour organiser votre bibliothèque si vous gérez de nombreux types d'équipements spécifiques à vos clients
- Renseignez le module réseau structuré (sites, VLANs, sous-réseaux) en parallèle des diagrammes visuels : ces données alimentent d'autres modules de SmartDoc et permettent des recherches et des liens croisés
Dernière mise à jour : 2026-03-05