Files
TechradarDev/docs/guide-radar-business.md
syoul ee62981ebe docs: actualiser toute la documentation avec les infos du radar business
- Mise à jour du Readme.md avec les infos sur le radar business, port 3004 et protection par mot de passe
- Actualisation de docs/README.md avec les instructions pour le radar business
- Mise à jour de docs/architecture.md avec la structure complète du projet
- Actualisation de docs/configuration.md avec la config business et basePath vide
- Mise à jour de docs/developpement.md avec les commandes pour le radar business
- Actualisation complète de docs/deploiement.md avec Portainer et Dockerfile.business
- Mise à jour de docs/guide-radar-business.md avec les pages de stratégie et protection
2025-12-03 10:15:35 +01:00

215 lines
6.6 KiB
Markdown

# Guide d'Utilisation du Radar Business
## Introduction
Le Radar Business est un outil stratégique pour analyser les technologies de l'écosystème Laplank/Duniter/Ğ1 sous l'angle business. Il permet d'identifier les patterns, les risques, les opportunités et de définir une stratégie d'évolution technique.
## Accès
Le Radar Business est accessible sur le **port 3004** 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 :
1. **Core** : Technologies critiques pour le business model
2. **Strategic** : Technologies stratégiques pour la croissance
3. **Support** : Technologies de support nécessaires
4. **Legacy** : Technologies à remplacer
## Métadonnées Business
Chaque technologie (blip) contient des métadonnées business :
### Métadonnées Standard
- **title** : Nom de la technologie
- **ring** : Anneau (core, strategic, support, legacy)
- **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 Business 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` :
- `strategie-evolution-technique.md` : Stratégie d'évolution technique
- `strategie-business.md` : Analyse business et opportunités
- `opportunites-dataviz.md` et `opportunites-dataviz-details.md` : Opportunités DataViz
Pour modifier le contenu, éditer directement `public/strategie-script.js` (sections `markdownContent`).
## 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/analyse-strategique.md`
### Générer les Blips
Pour régénérer les blips depuis `technologies-duniter.md` :
```bash
node scripts/extract-technologies.js
```
## Interprétation des Résultats
### Technologies Critiques
Les technologies en ring "core" 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 (core, strategic, support, legacy)
- É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 Business est déployé via Docker et Portainer :
- **Dockerfile** : `Dockerfile.business`
- **Docker Compose** : `docker-compose.business.yml`
- **Port** : 3004 (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/analyse-strategique.md`
- **Stratégie d'évolution** : `docs/strategie-evolution-technique.md`
- **Stratégie business** : `docs/strategie-business.md`
- **Opportunités DataViz** : `docs/opportunites-dataviz.md` et `docs/opportunites-dataviz-details.md`
## Support
Pour toute question ou contribution, consulter la documentation ou contacter l'équipe technique.