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:
@@ -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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user