TechradarDev/docs/app/guide-radar-business.md

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 :

   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 :

   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 :

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 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.