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

@@ -1,8 +1,8 @@
# Configuration
## Fichier config.json
## Fichier config-business.json
Le fichier `config.json` contient toute la configuration du radar. Il définit l'apparence, le comportement et la structure du radar.
Le fichier `radar-business/config-business.json` contient toute la configuration du Radar Technologique Laplank. Il définit l'apparence, le comportement et la structure du radar.
## Structure de configuration
@@ -12,9 +12,9 @@ Le fichier `config.json` contient toute la configuration du radar. Il définit l
{
"basePath": "",
"baseUrl": "",
"editUrl": "https://git.open.us.org/syoul/TechradarDev/_edit/main/radar/{release}/{id}.md",
"editUrl": "https://git.open.us.org/syoul/TechradarDev/_edit/main/radar-business/{release}/{id}.md",
"logoFile": "logo.svg",
"jsFile": "strategie-script.js"
"jsFile": "/strategie-script.js"
}
```
@@ -22,7 +22,7 @@ Le fichier `config.json` contient toute la configuration du radar. Il définit l
- **baseUrl** : URL de base du site
- **editUrl** : Template d'URL pour éditer les fichiers (utilise {release} et {id})
- **logoFile** : Nom du fichier logo dans `public/`
- **jsFile** : Fichier JavaScript personnalisé à charger (optionnel, utilisé pour le radar business)
- **jsFile** : Fichier JavaScript personnalisé à charger (`/strategie-script.js` pour le radar business)
### Options d'affichage (toggles)
@@ -58,57 +58,59 @@ Définit l'ordre des sections dans l'interface.
{
"colors": {
"foreground": "#fff",
"background": "#173d7a",
"highlight": "#029df7",
"background": "#1a4d3a",
"highlight": "#2ecc71",
"content": "#fff",
"text": "#575757",
"link": "#029df7",
"link": "#2ecc71",
"border": "rgba(255, 255, 255, 0.1)",
"tag": "rgba(255, 255, 255, 0.1)"
}
}
```
Personnalisation des couleurs de l'interface.
Personnalisation des couleurs de l'interface avec un thème vert.
### Quadrants
### Quadrants Business
Les quadrants définissent les quatre catégories principales :
Les quadrants définissent les quatre catégories principales selon l'impact business :
1. **Languages & Frameworks** : Langages et frameworks de développement
2. **Methods & Patterns** : Méthodes et patterns de développement
3. **Platforms & Operations** : Plateformes et opérations
4. **Tools** : Outils de développement
1. **Technologies Différenciantes** : Créent un avantage concurrentiel et de la valeur différenciante
2. **Technologies de Commodité** : Nécessaires mais non différenciantes, à optimiser pour réduire les coûts
3. **Technologies à Risque** : Obsolètes, coûteuses ou présentant des risques, à migrer ou remplacer
4. **Technologies Émergentes** : Opportunités futures, à évaluer et potentiellement adopter
Chaque quadrant a :
- **id** : Identifiant unique
- **id** : Identifiant unique (technologies-differentiantes, technologies-commodite, technologies-risque, technologies-emergentes)
- **title** : Titre affiché
- **description** : Description du quadrant
- **color** : Couleur associée
### Anneaux (Rings)
Les anneaux classifient les technologies selon leur niveau d'adoption :
Les anneaux classifient les technologies selon leur niveau d'adoption. Le Radar Technologique Laplank utilise les anneaux classiques :
1. **Adopt** : Recommandé, utilisé avec succès
2. **Trial** : À essayer, prometteur
3. **Assess** : À évaluer, à surveiller
4. **Hold** : À éviter, à remplacer
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.
Chaque anneau a :
- **id** : Identifiant unique
- **id** : Identifiant unique (adopt, trial, assess, hold)
- **title** : Titre affiché
- **description** : Description de l'anneau
- **color** : Couleur associée
- **radius** : Rayon dans le graphique (0-1)
- **strokeWidth** : Épaisseur du trait
**Important** : Tous les blips doivent utiliser ces rings (adopt|trial|assess|hold). Les anciens rings (core, strategic, support) ne sont plus utilisés.
### Flags (Drapeaux)
Les flags marquent les changements entre versions :
- **new** : Nouveau dans cette version
- **changed** : Modifié récemment
- **new** : Nouveau dans cette version (couleur : #f1235a)
- **changed** : Modifié récemment (couleur : #40a7d1)
- **default** : Inchangé
### Graphique
@@ -128,7 +130,7 @@ Les flags marquent les changements entre versions :
### Labels (Textes)
Les labels permettent de personnaliser tous les textes de l'interface, notamment :
- Titre du site
- Titre du site : "Radar Technologique Laplank"
- Textes des pages
- Messages d'erreur
- Placeholders
@@ -138,7 +140,7 @@ Les labels permettent de personnaliser tous les textes de l'interface, notamment
### Modifier les couleurs
Éditez la section `colors` dans `config.json` avec les codes hexadécimaux souhaités.
Éditez la section `colors` dans `radar-business/config-business.json` avec les codes hexadécimaux souhaités.
### Ajouter un quadrant
@@ -146,7 +148,7 @@ Ajoutez un nouvel objet dans le tableau `quadrants` avec les propriétés requis
### Modifier les descriptions
Les descriptions des quadrants et anneaux peuvent être modifiées directement dans `config.json`.
Les descriptions des quadrants et anneaux peuvent être modifiées directement dans `config-business.json`.
### Styles personnalisés
@@ -159,7 +161,7 @@ Le Radar Technologique Laplank utilise une configuration spécifique dans `radar
### Différences principales
- **basePath** : `""` (vide) pour servir à la racine
- **jsFile** : `"strategie-script.js"` pour charger le script de stratégie
- **jsFile** : `"/strategie-script.js"` pour charger le script de stratégie
- **Quadrants business** : Technologies Différenciantes, Commodité, Risque, Émergentes
- **Anneaux classiques** : Hold, Assess, Trial, Adopt
- **Couleurs** : Thème vert (`#1a4d3a` pour le background, `#2ecc71` pour les accents)
@@ -169,7 +171,8 @@ Le Radar Technologique Laplank utilise une configuration spécifique dans `radar
Le fichier `public/strategie-script.js` est chargé automatiquement et fournit :
- Protection par mot de passe (authentification client-side)
- Pages de stratégie dynamiques (Markdown converti en HTML)
- Navigation dans le header
**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`.
## Variables d'environnement
@@ -191,6 +194,20 @@ Les tags suivants sont établis pour classifier les technologies :
- ci/cd
- ux/ui
- documentation
- blockchain
- infrastructure
- dataviz
- mobile
Les tags sont utilisés dans les fichiers Markdown des blips et permettent le filtrage dans l'interface.
## Migration des rings
Si vous avez des blips avec les anciens rings (core, strategic, support), ils doivent être migrés vers les rings standards :
- **core** → **adopt** (technologies fondamentales en production)
- **strategic** → **assess** (technologies prometteuses à évaluer)
- **support** → **adopt** (technologies utilisées en production)
- **trial** → **trial** (déjà correct)
Le script `scripts/migrate-rings.sh` peut être utilisé pour automatiser cette migration.