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:
@@ -12,6 +12,8 @@ Le radar est organisé en quatre quadrants et quatre anneaux (rings) pour classi
|
||||
|
||||
Cette documentation est organisée en plusieurs sections :
|
||||
|
||||
### Documentation technique
|
||||
|
||||
- **[Architecture](./architecture.md)** - Structure du projet, organisation des fichiers et composants
|
||||
- **[Configuration](./configuration.md)** - Configuration du radar, quadrants, anneaux et personnalisation
|
||||
- **[Développement](./developpement.md)** - Guide pour développer et tester localement
|
||||
@@ -19,13 +21,14 @@ Cette documentation est organisée en plusieurs sections :
|
||||
- **[Contribution](./contribution.md)** - Guide pour ajouter de nouvelles technologies au radar
|
||||
- **[Guide Radar Business](./guide-radar-business.md)** - Guide d'utilisation du radar technologique Laplank
|
||||
- **[Page Équipe & Technologies](./guide-page-equipe.md)** - Documentation de la page de visualisation équipe/technologies
|
||||
- **[Dépannage](./troubleshooting.md)** - Guide de résolution des problèmes courants
|
||||
|
||||
### Données du Radar Technologique Laplank
|
||||
|
||||
Les données utilisées par l'application sont dans le dossier [`../data/`](../data/) :
|
||||
|
||||
- **[Technologies Duniter](../data/technologies-duniter.md)** - Liste des technologies de l'écosystème Duniter/Ğ1
|
||||
- **[Profil Team](../data/profil-team.md)** - Profils et compétences des membres de l'équipe
|
||||
- **[Profils Team](../data/team/)** - Profils individuels des membres de l'équipe (fichiers Markdown)
|
||||
- **[Stratégie d'Évolution Technique](../data/strategie-evolution-technique.md)** - Vision et roadmap technique
|
||||
- **[Stratégie Business](../data/strategie-business.md)** - Analyse stratégique business
|
||||
- **[Analyse Stratégique](../data/analyse-strategique.md)** - Rapport d'analyse généré automatiquement
|
||||
@@ -33,6 +36,7 @@ Les données utilisées par l'application sont dans le dossier [`../data/`](../d
|
||||
## Liens utiles
|
||||
|
||||
- **Radar en ligne** : https://www.coeurbox.syoul.fr
|
||||
- **Radar Technologique Laplank** : http://laplank.techradar.syoul.fr:3006
|
||||
- **Dépôt Git** : https://git.open.us.org/AJR/TechradarDev
|
||||
- **Framework source** : https://github.com/AOEpeople/aoe_technology_radar
|
||||
|
||||
@@ -64,3 +68,89 @@ Le serveur démarre sur http://localhost:3006
|
||||
|
||||
Pour plus de détails, consultez le [guide de développement](./developpement.md) et le [guide du radar technologique Laplank](./guide-radar-business.md).
|
||||
|
||||
## Fonctionnalités principales
|
||||
|
||||
### Radar Technologique
|
||||
|
||||
- **Visualisation interactive** : Graphique radar avec zoom et filtres
|
||||
- **Historique par release** : Suivi de l'évolution des technologies au fil du temps
|
||||
- **Quadrants business** : Classification selon l'impact business
|
||||
- **Anneaux classiques** : Hold, Assess, Trial, Adopt
|
||||
- **Filtrage par tags** : Recherche et filtrage des technologies
|
||||
- **Pages de stratégie** : Accès à la stratégie technique, business et opportunités
|
||||
|
||||
### Page Équipe & Technologies
|
||||
|
||||
- **Graphe réseau** : Visualisation des connexions technologies/membres
|
||||
- **Matrice de congestion** : Identification des technologies avec faible couverture
|
||||
- **Équipe de genèse MVP** : Composition automatique d'une équipe minimale
|
||||
|
||||
## Technologies utilisées
|
||||
|
||||
- **Next.js** : Framework React pour la génération statique
|
||||
- **React** : Bibliothèque JavaScript pour l'interface utilisateur
|
||||
- **TypeScript** : Typage statique
|
||||
- **Cytoscape.js** : Visualisation de graphes
|
||||
- **ECharts** : Visualisation de données (heatmaps, scatter plots)
|
||||
- **Markdown** : Format des blips et profils
|
||||
- **YAML** : Métadonnées dans les fichiers Markdown
|
||||
|
||||
## Structure du projet
|
||||
|
||||
```
|
||||
TechradarDev/
|
||||
├── radar-business/ # Contenu du radar business (actif)
|
||||
│ ├── 2025-01-15/ # Blips organisés par release
|
||||
│ └── config-business.json # Configuration
|
||||
├── docs/
|
||||
│ ├── app/ # Documentation technique
|
||||
│ └── data/ # Données métier
|
||||
│ └── team/ # Profils équipe individuels
|
||||
├── public/ # Fichiers statiques
|
||||
│ ├── team.html # Page équipe
|
||||
│ └── team-visualization-data.json # Données équipe
|
||||
├── scripts/ # Scripts utilitaires
|
||||
└── Dockerfile.business # Dockerfile pour le déploiement
|
||||
```
|
||||
|
||||
## Commandes principales
|
||||
|
||||
```bash
|
||||
# Développement
|
||||
npm run serve-business # Démarrer le serveur de développement (port 3006)
|
||||
|
||||
# Génération de données
|
||||
node scripts/generate-team-visualization-data.js # Générer les données équipe
|
||||
node scripts/extract-technologies.js # Extraire les technologies
|
||||
node scripts/analyze-business-metrics.js # Analyser les métriques
|
||||
|
||||
# Build
|
||||
npm run build # Build de production
|
||||
```
|
||||
|
||||
## Problèmes courants
|
||||
|
||||
Consultez le [guide de dépannage](./troubleshooting.md) pour les problèmes courants :
|
||||
|
||||
- Doublons de liens dans la navigation
|
||||
- Seulement quelques blips affichés
|
||||
- Page équipe inaccessible
|
||||
- Données de visualisation manquantes
|
||||
|
||||
## Contribution
|
||||
|
||||
Pour contribuer au projet :
|
||||
|
||||
1. Lire le [guide de contribution](./contribution.md)
|
||||
2. Créer une branche pour vos modifications
|
||||
3. Ajouter/modifier les blips dans `radar-business/2025-01-15/`
|
||||
4. Tester localement avec `npm run serve-business`
|
||||
5. Créer une pull request
|
||||
|
||||
## Support
|
||||
|
||||
Pour toute question :
|
||||
- Consulter la documentation dans `docs/app/`
|
||||
- Vérifier le [guide de dépannage](./troubleshooting.md)
|
||||
- Ouvrir une issue sur le dépôt Git
|
||||
- Contacter l'équipe technique
|
||||
|
||||
Reference in New Issue
Block a user