TechradarDev/docs/app

Documentation AJR Technology Radar

Bienvenue dans la documentation du projet AJR Technology Radar (CoeurBox).

Vue d'ensemble

Le Technology Radar AJR est une application web interactive qui présente les technologies, outils, méthodes et plateformes utilisées et évaluées par AJR. Il est basé sur le framework aoe_technology_radar, dont le code source est vendu dans le répertoire radar-app/.

Le radar est organisé en quatre quadrants et quatre anneaux (rings) pour classifier chaque technologie selon son niveau d'adoption et sa catégorie.

Structure de la documentation

Cette documentation est organisée en plusieurs sections :

Documentation technique

• Architecture - Structure du projet, organisation des fichiers et composants
• Configuration - Configuration du radar, quadrants, anneaux et personnalisation
• Développement - Guide pour développer et tester localement
• Déploiement - Instructions pour déployer le radar en production
• Contribution - Guide pour ajouter de nouvelles technologies au radar
• Guide Radar Business - Guide d'utilisation du radar technologique Laplank
• Page Équipe & Technologies - Documentation de la page de visualisation équipe/technologies
• Dépannage - 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/ :

• Technologies Duniter - Liste des technologies de l'écosystème Duniter/Ğ1
• Profils Team - Profils individuels des membres de l'équipe (fichiers Markdown)
• Stratégie d'Évolution Technique - Vision et roadmap technique
• Stratégie Business - Analyse stratégique business
• Analyse Stratégique - Rapport d'analyse généré automatiquement

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 (code vendu dans radar-app/)

Démarrage rapide

Radar Principal

Pour démarrer rapidement le radar principal en local :

npm install
npm run serve

Puis ouvrir http://localhost:3000/techradar dans votre navigateur.

Radar Technologique Laplank

Pour démarrer le radar technologique Laplank en local :

npm install
npm run serve-business

Le serveur démarre sur http://localhost:3006

Note : Le radar technologique Laplank est protégé par un mot de passe (laplank-radar).

Pour plus de détails, consultez le guide de développement et le guide du radar technologique Laplank.

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-block-script.js  # Script principal pour la page equipe
│   └── team-visualization-data.json  # Donnees equipe
├── scripts/                # Scripts utilitaires
└── Dockerfile.business     # Dockerfile pour le déploiement

Commandes principales

# 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 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
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
• Ouvrir une issue sur le dépôt Git
• Contacter l'équipe technique