refactor: réorganiser la documentation en séparant app et data

- Création de docs/app/ pour la documentation de l'application - Création de docs/data/ pour les données utilisées par l'application - Déplacement de la documentation technique vers docs/app/ - Déplacement des données métier vers docs/data/ - Mise à jour de tous les liens et références dans les fichiers - Mise à jour des scripts (extract-technologies.js, analyze-business-metrics.js) - Mise à jour des fichiers JavaScript (custom.js, strategie-link.js) - Création de README.md dans docs/, docs/app/ et docs/data/ - Mise à jour du Readme.md principal avec les nouveaux chemins
2025-12-03 14:35:36 +01:00
parent 6add0ece80
commit 055e4a9281
21 changed files with 219 additions and 92 deletions
--- a/docs/app/guide-radar-business.md
+++ b/docs/app/guide-radar-business.md
@@ -0,0 +1,249 @@
+# 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. Stables et é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.
+
+## 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. 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)
+- **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.
+
+### 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/`.
+
+## 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. Remplir toutes les métadonnées
+4. 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. 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
+```
+
+## 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)
+- É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.
+
+### 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
+
+### 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`
+- **Profil Team** : `docs/data/profil-team.md`
+
+## Support
+
+Pour toute question ou contribution, consulter la documentation ou contacter l'équipe technique.
+