Synchronisation en cloud

Comment fonctionne la synchronisation en cloud

Kanban Pro est une application « local-first ». Chaque projet est un dossier sur votre système de fichiers contenant des fichiers de tâches Markdown et un répertoire de configuration .kanban/. Il n'y a pas de comptes, pas de services cloud propriétaires et pas d'inscriptions.

Pour collaborer avec d'autres, placez simplement votre dossier de projet dans un répertoire synchronisé par le cloud — iCloud Drive, Dropbox, Google Drive, OneDrive ou tout lecteur réseau. Chaque participant ouvre le même dossier dans Kanban Pro, et les modifications se propagent automatiquement via la synchronisation de fichiers du fournisseur cloud.

Configuration d'un projet partagé

1. Choisissez un dossier sur le cloud. Ouvrez Finder et accédez au répertoire de synchronisation de votre fournisseur cloud (par exemple ~/Library/Mobile Documents/com~apple~CloudDocs/ pour iCloud Drive, ~/Dropbox/ pour Dropbox, ou le montage Google Drive / OneDrive dans votre barre latérale Finder).
2. Créez un dossier de projet. Créez un nouveau dossier pour votre projet, par exemple Team Board.
3. Ouvrez-le dans Kanban Pro. Lancez Kanban Pro, cliquez sur Ouvrir le dossier, et sélectionnez le dossier que vous venez de créer. Kanban Pro initialiseront le répertoire .kanban/ et vous pouvez commencer à ajouter des colonnes et des tâches.
4. Partagez le dossier. Utilisez les fonctionnalités de partage de votre fournisseur cloud pour inviter des collaborateurs. Sur iCloud Drive, cliquez avec le bouton droit sur le dossier et choisissez Partager. Sur Dropbox ou Google Drive, utilisez le dialogue de partage. Sur OneDrive, cliquez avec le bouton droit et sélectionnez Partager → Partager avec OneDrive. Chaque collaborateur devrait ensuite ouvrir le même dossier synchronisé dans sa propre copie de Kanban Pro.

Structure de dossier recommandée

Lorsque Kanban Pro initialise un projet, il crée la structure suivante dans le dossier que vous avez choisi :

Chaque tâche est un fichier Markdown simple avec un frontmatter YAML pour les métadonnées (statut, priorité, assigné, étiquettes, champs personnalisés). Vous pouvez lire, modifier ou sauvegarder ces fichiers avec n'importe quel outil — y compris les agents de codage IA qui travaillent directement avec le système de fichiers.

Synchronisation en temps réel et édition sans conflit

Kanban Pro surveille le dossier du projet pour les modifications du système de fichiers à l'aide d'un observateur de fichiers en temps réel. Lorsqu'un collaborateur enregistre une tâche ou met à jour la configuration du tableau, le changement est détecté en quelques secondes et l'interface s'actualise automatiquement.

Comment les conflits sont évités

• Verrouillage des tâches : Lorsque vous ouvrez une tâche pour l'édition, Kanban Pro crée un petit fichier de verrouillage dans .kanban/locks/. Les autres utilisateurs voient la tâche comme verrouillée et ne peuvent pas écraser vos modifications. Les fichiers de verrouillage se synchronisent via votre fournisseur cloud, de sorte que tous les collaborateurs voient le même état de verrouillage.
• Écritures atomiques : Chaque tâche est un fichier Markdown unique. Kanban Pro écrit d'abord dans un fichier temporaire, puis le renomme sur place — empêchant les mises à jour partielles même si le fournisseur cloud se synchronise en cours d'écriture.
• Détection de la fin d'écriture : Kanban Pro attend que les fichiers se stabilisent (2 secondes pour les tâches, 1 seconde pour la configuration du tableau) avant de les lire. Cela garantit que la synchronisation en cloud a terminé l'écriture avant que l'application ne traite le changement.
• Dernière écriture gagnante pour la configuration du tableau : L'ordre des colonnes, les paramètres et les définitions des champs personnalisés sont stockés dans board.json. Si deux utilisateurs modifient les paramètres du tableau simultanément, la dernière écriture gagne — mais c'est rare en pratique puisque la configuration du tableau change peu fréquemment.

Comprendre les fichiers de verrouillage

Le répertoire .kanban/locks/ contient des fichiers de verrouillage temporaires qui indiquent quelles tâches sont actuellement en cours de modification et par qui. Chaque fichier de verrouillage est un petit document JSON :

{
  "ticket": "KAN-42",
  "user": "Alice",
  "device": "Alice-MacBook",
  "timestamp": "2026-03-09T10:30:00Z"
}

Les fichiers de verrouillage sont créés lorsqu'une tâche est ouverte pour l'édition et supprimés à la fermeture de l'éditeur. Ils permettent à Kanban Pro d'afficher un indicateur visuel sur les tâches verrouillées pour que les collaborateurs sachent que quelqu'un travaille dessus.

Résolution des verrous obsolètes

Si Kanban Pro plante ou qu'un appareil se met hors ligne, un fichier de verrouillage peut rester sans être nettoyé. C'est ce qu'on appelle un verrou obsolète.

Kanban Pro détecte également les verrous plus anciens que 24 heures et les signale comme potentiellement obsolètes dans l'interface, vous donnant la possibilité de forcer le déverrouillage directement à partir de l'application.

Notes sur les fournisseurs cloud

Bonnes pratiques

• Gardez les dossiers du projet disponibles hors ligne. Marquez votre dossier de projet comme « Disponible hors ligne », « Fichiers miroir », « Toujours garder sur cet appareil » ou « Garder téléchargé » selon votre fournisseur cloud. Cela évite les délais causés par les téléchargements de fichiers à la demande.
• Gardez la structure de dossier peu profonde. Évitez les répertoires profondément imbriqués — une disposition plate améliore la fiabilité de la synchronisation sur tous les fournisseurs.
• Vérifiez l'état de la synchronisation avant de fermer votre Mac. Recherchez les icônes de synchronisation en cours dans Finder ou la barre de menu. L'arrêt en cours de synchronisation peut laisser des fichiers partiels qui confondent les collaborateurs.
• Maintenez l'espace de stockage libre. Gardez au moins 10–15 % d'espace libre sur votre Mac et au moins 20 % d'espace cloud libre. Un stockage faible peut arrêter la synchronisation ou déclencher l'éviction de fichiers.
• Utilisez le même fournisseur cloud dans toute l'équipe. Mélanger les fournisseurs (par exemple une personne sur iCloud, une autre sur Dropbox) nécessite que chaque personne ait sa propre copie — ils ne se synchroniseront pas les uns avec les autres.

Dépannage

• Les modifications n'apparaissent pas : Vérifiez que votre fournisseur cloud est activement synchronisé. Recherchez les icônes d'état de synchronisation dans Finder ou l'icône de barre de menu du fournisseur cloud. Kanban Pro s'actualise en quelques secondes après avoir détecté un changement de fichier — si le fichier n'a pas encore été synchronisé, l'application ne peut pas le voir.
• Tâche bloquée comme verrouillée : Consultez la section sur les verrous obsolètes ci-dessus. Vous pouvez forcer le déverrouillage à partir de l'application (pour les verrous plus anciens que 24 heures) ou supprimer manuellement le fichier de verrouillage dans .kanban/locks/.
• Tâches manquantes après la synchronisation : Certains fournisseurs cloud retardent la synchronisation des nouveaux fichiers. Attendez un moment et vérifiez l'état de la synchronisation de votre fournisseur. Si le problème persiste, vérifiez que le dossier est défini pour se synchroniser hors ligne. Sur iCloud Drive, vérifiez que les fichiers n'ont pas été remplacés par des fichiers d'espace réservé .icloud.
• Chargement initial lent : Si votre fournisseur cloud diffuse les fichiers à la demande, le premier chargement peut être plus long car les fichiers sont téléchargés. Passez au mode hors ligne ou miroir pour les meilleures performances.
• Synchronisation mise en pause de manière inattendue : Certains fournisseurs cloud mettent en pause la synchronisation lorsque votre Mac fonctionne sur batterie ou a peu d'espace disque. Vérifiez l'icône de la barre de menu de votre fournisseur pour les indicateurs de pause et reprendre la synchronisation si nécessaire.
• Fichiers de copie en conflit apparaissant : Si vous voyez des fichiers nommés avec « copie en conflit » dans Finder, deux personnes ont probablement édité le même fichier hors ligne. Ouvrez les deux fichiers pour comparer, conservez la version correcte et supprimez la copie en conflit.