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