Files
TechradarDev/radar-business/FORMAT-BLIP.md
syoul 005ed9ee7f 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
2025-12-09 11:01:29 +01:00

159 lines
5.5 KiB
Markdown

# Format de Blip Enrichi - Métadonnées Business
Ce document définit le format standard pour les blips du radar business avec toutes les métadonnées business.
## Structure de base
```markdown
---
title: "Nom de la technologie"
ring: adopt|trial|assess|hold
quadrant: technologies-differentiantes|technologies-commodite|technologies-risque|technologies-emergentes
tags: [tag1, tag2]
businessImpact: high|medium|low
costToReplace: 50000
revenueImpact: direct|indirect|none
riskLevel: high|medium|low
competencyLevel: expert|intermediate|beginner
maintenanceCost: 10000
differentiation: high|medium|low
teamCoverage: 3
skillGap: low|medium|high
---
Description de la technologie en Markdown.
## Impact Business
Description de l'impact sur le business.
## Coûts
- Coût de remplacement : X€
- Coût de maintenance annuel : Y€
## 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
## Recommandations
Recommandations stratégiques pour cette technologie.
```
## Description des métadonnées
### Métadonnées standard
- **title** (obligatoire) : Nom de la technologie
- **ring** (obligatoire) :
- `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
- `technologies-risque` : Obsolètes, coûteuses, à migrer
- `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) :
- `high` : Impact majeur sur le business
- `medium` : Impact modéré
- `low` : Impact faible
- **costToReplace** (obligatoire) : Coût estimé de remplacement en euros (0 si non applicable)
- **revenueImpact** (obligatoire) :
- `direct` : Impact direct sur les revenus
- `indirect` : Impact indirect (support, efficacité)
- `none` : Pas d'impact sur les revenus
- **riskLevel** (obligatoire) :
- `high` : Risque élevé (obsolescence, sécurité, dépendance)
- `medium` : Risque modéré
- `low` : Risque faible
- **maintenanceCost** (obligatoire) : Coût annuel de maintenance en euros
- **differentiation** (obligatoire) :
- `high` : Forte capacité de différenciation
- `medium` : Différenciation modérée
- `low` : Faible différenciation (commodité)
### Métadonnées compétences
- **competencyLevel** (obligatoire) : Niveau moyen de compétence de l'équipe
- `expert` : Plusieurs experts dans l'équipe
- `intermediate` : Compétences intermédiaires
- `beginner` : Compétences limitées
- **teamCoverage** (obligatoire) : Nombre de personnes maîtrisant la technologie
- **skillGap** (obligatoire) : Risque de compétence manquante
- `high` : Risque élevé (peu de personnes, départ possible)
- `medium` : Risque modéré
- `low` : Risque faible (plusieurs personnes compétentes)
## Exemple complet
```markdown
---
title: "Rust"
ring: adopt
quadrant: technologies-differentiantes
tags: [blockchain, rust, substrate]
businessImpact: high
costToReplace: 200000
revenueImpact: indirect
riskLevel: medium
competencyLevel: beginner
maintenanceCost: 50000
differentiation: high
teamCoverage: 1
skillGap: high
---
- **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
Technologie critique pour le fonctionnement de la blockchain Ğ1. Sans cette technologie, le projet ne peut pas fonctionner.
## Coûts
- Coût de remplacement : 200 000€ (refonte complète)
- Coût de maintenance annuel : 50 000€ (développement, mise à jour)
## Compétences
- 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
- Investir dans la formation de l'équipe sur Rust/Substrate
- Recruter ou former des développeurs Rust supplémentaires
- Documenter les connaissances critiques
- 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.