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

@@ -7,7 +7,7 @@ Ce document définit le format standard pour les blips du radar business avec to
```markdown
---
title: "Nom de la technologie"
ring: core|strategic|support|legacy
ring: adopt|trial|assess|hold
quadrant: technologies-differentiantes|technologies-commodite|technologies-risque|technologies-emergentes
tags: [tag1, tag2]
businessImpact: high|medium|low
@@ -35,6 +35,7 @@ Description de l'impact sur le business.
## Compétences
- Nombre de personnes maîtrisant : N
- Membres de l'équipe : pseudo1, pseudo2
- Niveau moyen : expert|intermediate|beginner
- Risque de compétence manquante : low|medium|high
@@ -49,10 +50,10 @@ Recommandations stratégiques pour cette technologie.
- **title** (obligatoire) : Nom de la technologie
- **ring** (obligatoire) :
- `core` : Critique pour le business model
- `strategic` : Stratégique pour la croissance
- `support` : De support nécessaire
- `legacy` : À remplacer
- `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.
- `trial` : Technologies à essayer. Prometteuses et testées avec succès dans certains contextes. À considérer pour de nouveaux projets.
- `assess` : Technologies à évaluer. Prometteuses mais nécessitent une évaluation approfondie avant adoption. À surveiller et tester.
- `hold` : Technologies à éviter ou à remplacer. Présentent des risques, sont obsolètes ou ne sont plus recommandées. À éviter pour de nouveaux projets.
- **quadrant** (obligatoire) :
- `technologies-differentiantes` : Créent un avantage concurrentiel
- `technologies-commodite` : Nécessaires mais non différenciantes
@@ -60,6 +61,8 @@ Recommandations stratégiques pour cette technologie.
- `technologies-emergentes` : Opportunités futures
- **tags** (optionnel) : Tags pour le filtrage
**Important** : Les anciens rings (core, strategic, support, legacy) ne sont plus utilisés. Tous les blips doivent utiliser les rings standards (adopt, trial, assess, hold).
### Métadonnées business
- **businessImpact** (obligatoire) :
@@ -97,22 +100,26 @@ Recommandations stratégiques pour cette technologie.
```markdown
---
title: "Rust / Substrate"
ring: core
title: "Rust"
ring: adopt
quadrant: technologies-differentiantes
tags: [blockchain, rust, substrate]
businessImpact: high
costToReplace: 200000
revenueImpact: direct
revenueImpact: indirect
riskLevel: medium
competencyLevel: intermediate
competencyLevel: beginner
maintenanceCost: 50000
differentiation: high
teamCoverage: 2
teamCoverage: 1
skillGap: high
---
Rust et le framework Substrate sont au cœur du développement de Duniter v2S, le nœud blockchain principal.
- **Utilisation** : Développement du nœud Duniter v2S (basé sur Substrate)
- **Projets** :
- `Duniter v2S` : Nœud blockchain principal
- `Ğcli-v2s` : Interface en ligne de commande Rust
- **Compétences requises** : Rust avancé, développement blockchain, Substrate framework
## Impact Business
@@ -125,8 +132,9 @@ Technologie critique pour le fonctionnement de la blockchain Ğ1. Sans cette tec
## Compétences
- Nombre de personnes maîtrisant : 2 (Eloïs, autres contributeurs)
- Niveau moyen : intermediate
- Nombre de personnes maîtrisant : 1
- Membres de l'équipe : elois
- Niveau moyen : beginner
- Risque de compétence manquante : high (peu de personnes, compétences critiques)
## Recommandations
@@ -137,3 +145,14 @@ Technologie critique pour le fonctionnement de la blockchain Ğ1. Sans cette tec
- Créer un plan de continuité en cas de départ de contributeurs clés
```
## 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.