docs: mise à jour complète de la documentation dans docs/app/

- architecture.md : structure Next.js, modifications Navigation.tsx, page équipe
- configuration.md : rings standards adopt|trial|assess|hold, migration
- deploiement.md : script Python, Navigation.tsx, processus de build détaillé
- developpement.md : nouvelles commandes, scripts, gestion profils équipe
- contribution.md : format business, rings standards, métadonnées complètes
- guide-page-equipe.md : architecture hybride, script Python, troubleshooting
- guide-radar-business.md : rings standards, migration, navigation
- troubleshooting.md : nouveau document avec problèmes courants et solutions
- README.md : liens mis à jour, nouvelles fonctionnalités
- FORMAT-BLIP.md : rings standards adopt|trial|assess|hold
This commit is contained in:
syoul
2025-12-09 11:01:29 +01:00
parent 9a055add6f
commit 005ed9ee7f
10 changed files with 1284 additions and 436 deletions

View File

@@ -25,11 +25,13 @@ Le radar est organisé en 4 quadrants business :
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.
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.
@@ -61,7 +63,9 @@ Pour créer une nouvelle release :
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
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
@@ -70,7 +74,7 @@ Chaque technologie (blip) contient des métadonnées business :
### Métadonnées Standard
- **title** : Nom de la technologie
- **ring** : Anneau (adopt, trial, assess, hold)
- **ring** : Anneau (adopt, trial, assess, hold) - **IMPORTANT** : Utiliser uniquement ces rings standards
- **quadrant** : Quadrant business
- **tags** : Tags pour le filtrage
@@ -99,6 +103,8 @@ Le Radar Technologique Laplank inclut trois pages de stratégie accessibles depu
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` :
@@ -108,20 +114,31 @@ Le contenu des pages de stratégie est intégré directement dans `public/strate
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. Remplir toutes les métadonnées
4. Ajouter la description et les sections recommandées
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. Mettre à jour la date si changement significatif
3. **Vérifier que le ring est standard** : adopt, trial, assess, hold
4. Mettre à jour la date si changement significatif
### Analyser le Radar
@@ -139,6 +156,18 @@ 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
@@ -181,7 +210,7 @@ Les technologies de commodité avec maintenanceCost élevé peuvent être optimi
### 2. Classification
- Classer par quadrant business
- Classer par ring (adopt, trial, assess, hold)
- Classer par ring (adopt, trial, assess, hold) - **utiliser uniquement ces rings**
- Évaluer les métadonnées
### 3. Analyse
@@ -200,7 +229,7 @@ Les technologies de commodité avec maintenanceCost élevé peuvent être optimi
### Template de Blip
Voir `radar-business/FORMAT-BLIP.md` pour le template complet.
Voir `radar-business/FORMAT-BLIP.md` pour le template complet avec toutes les métadonnées.
### Template d'Analyse
@@ -213,6 +242,7 @@ Le script `analyze-business-metrics.js` génère automatiquement un rapport d'an
- 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
@@ -241,9 +271,8 @@ Voir [deploiement.md](./deploiement.md) pour les détails complets.
- **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`
- **Profils Team** : `docs/data/team/*.md` (fichiers individuels)
## Support
Pour toute question ou contribution, consulter la documentation ou contacter l'équipe technique.