Introduction à Wekan

Wekan est une alternative open source à Trello, offrant une solution autonome pour la gestion de kanban. Ce guide technique détaille la mise en place d'un environnement de développement fonctionnel en cinq étapes, permettant une personnalisation complète et une intégration avec des systèmes existants.

Étapes de Configuration de l'Environnement

Étape 1 : Récupération du Code Source

Cloner le dépôt officiel depuis GitHub :

git clone https://github.com/wekan/wekan
cd wekan

Étape 2 : Installation Automatisée des Dépendances

Exécuter le script d'installation pour configurer automatiquement les composants nécessaires :

./install-wekan.sh

Dans le menu interactif, sélectionner l'option pour installer les dépendances. Cela inclut :

• Configuration de Node.js version 14.21.4
• Installation du framework Meteor 2.14
• Téléchargement et configuration des paquets requis

Étape 3 : Compilation du Projet

Relancer le script et choisir l'option de construction pour optimiser les ressources et générer un package prêt pour la production.

Étape 4 : Lancement du Serveur de Développement

Après la compilation, démarrer le serveur local :

meteor run --port 4000

Accéder à l'interface via http://localhost:4000 pour vérifier l'installation.

Étape 5 : Validation et Tests Initiaux

Créer un tableau test et ajouter des cartes pour vérifier le bon fonctionnement des fonctionnalités de base.

Fonctionnalités Clés et Utilisation

Gestion par Sélection Multiple

Cette fonctionnalité permet des opérations groupées, telles que :

• Déplacer plusieurs tâches vers une liste d'archive
• Filtrer les cartes assignées à un membre spécifique
• Sélectionner des tâches par type pour une réorganisation rapide

Raccourcis Clavier Essentiels

Optimiser le workflow avec ces combinaisons :

• W : Afficher ou masquer la barre latérale du tableau
• Q : Filtrer pour n'afficher que vos propres cartes
• F : Ouvrir le panneau de filtrage avancé
• @ : Auto-compléter les noms des membres
• ? : Consulter la liste complète des raccourcis

Résolution des Problèmes Courants

Erreurs de Mémoire Insuffisante

Pour augmenter la limite de mémoire de Node.js :

export NODE_OPTIONS="--max-old-space-size=4096"

Alternative : libérer de la mémoire système en fermant des applications inutiles ou en augmentant l'espace swap.

Configuraton des Paramètres Linguistiques

S'assurer que le système supporte UTF-8 pour éviter des erreurs d'ecnodage :

sudo dpkg-reconfigure locales

Sélectionner en_US.UTF-8 comme locale par défaut.

Optimisation pour le Développement

Connexion à une Base de Données Externe

Pour utiliser une instance MongoDB personnalisée :

MONGO_URL=mongodb://localhost:27017/wekan ./install-wekan.sh

Rechargement à Chaud

Le mode développement détecte automatiquement les modifictaions de fichiers, recompile le code et actualise le navigateur pour une expérience itérative rapide.

Perspectives d'Amélioration

Pour approfondir l'utilisation de Wekan :

• Étudier les modèles de données dans le répertoire models/
• Implémenter des logiques métier personnalisées dans server/
• Adapter l'interface utilisateur via les composants dans client/