TechradarDev/docs/app/README.md

# 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](https://github.com/AOEpeople/aoe_technology_radar).

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](./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
- **[Déploiement](./deploiement.md)** - Instructions pour déployer le radar en production
- **[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
- **[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

## 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

## Démarrage rapide

### Radar Principal

Pour démarrer rapidement le radar principal en local :

```bash
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 :

```bash
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](./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