# Guide d'Utilisation du Radar Technologique Laplank ## Introduction Le Radar Technologique Laplank est un tech radar classique pour suivre l'évolution des technologies de l'écosystème Laplank/Duniter/Ğ1. Il permet de suivre l'adoption des technologies au fil du temps avec un historique par release. ## Accès Le Radar Technologique Laplank est accessible sur le **port 3006** et est protégé par un **mot de passe** : `laplank-radar` L'authentification est gérée côté client via `localStorage` (session valide jusqu'à fermeture du navigateur). ## Structure du Radar ### Quadrants Le radar est organisé en 4 quadrants business : 1. **Technologies Différenciantes** : Créent un avantage concurrentiel 2. **Technologies de Commodité** : Nécessaires mais non différenciantes 3. **Technologies à Risque** : Obsolètes, coûteuses, à migrer 4. **Technologies Émergentes** : Opportunités futures ### Anneaux (Rings) Chaque technologie est classée dans un des 4 anneaux classiques : 1. **Adopt** : Technologies recommandées et utilisées avec succès en production. Stables, éprouvées, peuvent être adoptées en toute confiance pour de nouveaux projets. 2. **Trial** : Technologies à essayer. Prometteuses et testées avec succès dans certains contextes. À considérer pour de nouveaux projets. 3. **Assess** : Technologies à évaluer. Prometteuses mais nécessitent une évaluation approfondie avant adoption. À surveiller et tester. 4. **Hold** : Technologies à éviter ou à remplacer. Présentent des risques, sont obsolètes ou ne sont plus recommandées. À éviter pour de nouveaux projets. **Important** : Tous les blips doivent utiliser ces rings standards (adopt, trial, assess, hold). Les anciens rings (core, strategic, support, legacy) ne sont plus utilisés. ## Historique des Technologies Le Radar Technologique Laplank suit l'évolution des technologies au fil du temps avec un système d'historique par release. ### Structure par Release Les technologies sont organisées par date de release dans des dossiers : - `radar-business/2025-01-15/` : Release de janvier 2025 - `radar-business/2025-04-15/` : Release d'avril 2025 (exemple) - etc. ### Suivi de l'Évolution Chaque technologie peut évoluer entre les releases : - **Nouveau** : Technologie ajoutée dans cette release - **Modifié** : Technologie déplacée (ring ou quadrant) ou description mise à jour - **Inchangé** : Technologie stable, pas de changement ### Créer une Nouvelle Release Pour créer une nouvelle release : 1. Créer un nouveau dossier avec la date au format `YYYY-MM-DD` : ```bash mkdir radar-business/2025-04-15 ``` 2. Copier les blips pertinents depuis la release précédente 3. Mettre à jour les blips existants si nécessaire (changement de ring, quadrant, description) 4. **Migrer les rings si nécessaire** : S'assurer que tous les blips utilisent les rings standards (adopt, trial, assess, hold) 5. Ajouter les nouveaux blips pour les technologies nouvellement évaluées ## Métadonnées Business Chaque technologie (blip) contient des métadonnées business : ### Métadonnées Standard - **title** : Nom de la technologie - **ring** : Anneau (adopt, trial, assess, hold) - **IMPORTANT** : Utiliser uniquement ces rings standards - **quadrant** : Quadrant business - **tags** : Tags pour le filtrage ### Métadonnées Business - **businessImpact** : Impact sur le business (high, medium, low) - **costToReplace** : Coût estimé de remplacement en euros - **revenueImpact** : Impact sur les revenus (direct, indirect, none) - **riskLevel** : Niveau de risque (high, medium, low) - **maintenanceCost** : Coût annuel de maintenance en euros - **differentiation** : Capacité de différenciation (high, medium, low) ### Métadonnées Compétences - **competencyLevel** : Niveau moyen de compétence (expert, intermediate, beginner) - **teamCoverage** : Nombre de personnes maîtrisant la technologie - **skillGap** : Risque de compétence manquante (high, medium, low) ## Pages de Stratégie Le Radar Technologique Laplank inclut trois pages de stratégie accessibles depuis le header : 1. **Stratégie Technique** : Vision et roadmap technique pour l'évolution du stack 2. **Business** : Analyse stratégique business autour de la dataviz et des flux économiques 3. **DataViz Expert** : Opportunités supplémentaires en dataviz (Smart Cities, Green Tech, KM, Cybersecurity) Ces pages sont générées dynamiquement via `public/strategie-script.js` qui convertit le contenu Markdown en HTML. **Note** : Les fonctions d'ajout de liens dans le header ont été désactivées pour éviter les doublons. Tous les liens sont maintenant gérés par `Navigation.tsx`. ### Contenu des Pages Le contenu des pages de stratégie est intégré directement dans `public/strategie-script.js` : - `docs/data/strategie-evolution-technique.md` : Stratégie d'évolution technique - `docs/data/strategie-business.md` : Analyse business et opportunités - `docs/data/opportunites-dataviz.md` et `docs/data/opportunites-dataviz-details.md` : Opportunités DataViz Pour modifier le contenu, éditer directement `public/strategie-script.js` (sections `markdownContent`) ou les fichiers sources dans `docs/data/`. ## Navigation Le header de navigation contient les liens suivants : - **Comment utiliser le Radar Technologique ?** : Page d'aide - **Vue d'ensemble des technologies** : Vue d'ensemble - **👥 Équipe** : Page de visualisation équipe/technologies **Important** : Tous les liens sont gérés par `Navigation.tsx`. Les scripts JavaScript qui ajoutaient des liens ont été désactivés pour éviter les doublons. ## Utilisation ### Ajouter une Nouvelle Technologie 1. Créer un fichier Markdown dans `radar-business/2025-01-15/` 2. Utiliser le format défini dans `radar-business/FORMAT-BLIP.md` 3. **Utiliser les rings standards** : adopt, trial, assess, hold 4. Remplir toutes les métadonnées 5. Ajouter la description et les sections recommandées ### Modifier une Technologie Existante 1. Ouvrir le fichier Markdown correspondant 2. Modifier les métadonnées ou le contenu 3. **Vérifier que le ring est standard** : adopt, trial, assess, hold 4. Mettre à jour la date si changement significatif ### Analyser le Radar 1. Exécuter le script d'analyse : ```bash node scripts/analyze-business-metrics.js ``` 2. Consulter le rapport généré dans `docs/data/analyse-strategique.md` ### Générer les Blips Pour régénérer les blips depuis `docs/data/technologies-duniter.md` : ```bash node scripts/extract-technologies.js ``` ## Migration des Rings Si vous avez des blips avec les anciens rings, utilisez ce mapping : - **core** → **adopt** : Technologies fondamentales en production - **strategic** → **assess** : Technologies prometteuses à évaluer - **support** → **adopt** : Technologies utilisées en production - **trial** → **trial** : Déjà correct - **legacy** → **hold** : Technologies obsolètes à remplacer Le script `scripts/migrate-rings.sh` peut être utilisé pour automatiser cette migration. ## Interprétation des Résultats ### Technologies Critiques Les technologies en ring "adopt" avec businessImpact "high" sont critiques. Elles nécessitent : - Maintenance proactive - Formation continue - Documentation exhaustive - Plans de continuité ### Technologies à Risque Les technologies avec riskLevel "high" ou skillGap "high" présentent des risques. Actions recommandées : - Formation ou recrutement - Documentation - Plan de migration si nécessaire ### Opportunités d'Innovation Les technologies émergentes avec differentiation "high" sont des opportunités. Actions : - POC (Proof of Concept) - Évaluation de l'impact - Adoption progressive ### Optimisation des Coûts Les technologies de commodité avec maintenanceCost élevé peuvent être optimisées : - Standardisation - Automatisation - Réduction des coûts ## Méthodologie d'Analyse ### 1. Collecte des Données - Inventorier toutes les technologies - Collecter les métadonnées business - Analyser les compétences de l'équipe ### 2. Classification - Classer par quadrant business - Classer par ring (adopt, trial, assess, hold) - **utiliser uniquement ces rings** - Évaluer les métadonnées ### 3. Analyse - Identifier les patterns - Calculer les métriques - Identifier les risques et opportunités ### 4. Recommandations - Prioriser les actions - Définir la roadmap - Planifier les investissements ## Templates ### Template de Blip Voir `radar-business/FORMAT-BLIP.md` pour le template complet avec toutes les métadonnées. ### Template d'Analyse Le script `analyze-business-metrics.js` génère automatiquement un rapport d'analyse. ## Maintenance ### Mise à Jour Régulière - Mettre à jour les métadonnées trimestriellement - Réviser les classifications annuellement - Mettre à jour les coûts et risques - **Vérifier que tous les blips utilisent les rings standards** ### Révision Stratégique - Révision annuelle de la stratégie - Ajustement des priorités - Mise à jour de la roadmap ## Déploiement Le Radar Technologique Laplank est déployé via Docker et Portainer : - **Dockerfile** : `Dockerfile.business` - **Docker Compose** : `docker-compose.business.yml` - **Port** : 3006 (mappé depuis le port 3000 du conteneur) - **Base path** : `/` (racine, pas de sous-chemin) Voir [deploiement.md](./deploiement.md) pour les détails complets. ## Ressources - **Format des blips** : `radar-business/FORMAT-BLIP.md` - **Configuration** : `radar-business/config-business.json` - **Script de stratégie** : `public/strategie-script.js` - **Analyse stratégique** : `docs/data/analyse-strategique.md` - **Stratégie d'évolution** : `docs/data/strategie-evolution-technique.md` - **Stratégie business** : `docs/data/strategie-business.md` - **Opportunités DataViz** : `docs/data/opportunites-dataviz.md` et `docs/data/opportunites-dataviz-details.md` - **Technologies Duniter** : `docs/data/technologies-duniter.md` - **Profils Team** : `docs/data/team/*.md` (fichiers individuels) ## Support Pour toute question ou contribution, consulter la documentation ou contacter l'équipe technique.