Techradar Laplank

Techradar Laplank est un Technology Radar interactif pour suivre l'évolution des technologies de l'écosystème Laplank/Duniter/Ğ1. Le projet est basé sur le framework aoe_technology_radar, dont le code source est vendu dans le répertoire radar-app/.

🎯 Vue d'ensemble

Techradar Laplank est un projet stand-alone qui présente :

• 38 technologies organisées par quadrants business et anneaux d'adoption
• 12 membres d'équipe avec leurs compétences et projets
• Visualisations interactives : graphe réseau, matrice de congestion, équipe de genèse
• Pages de stratégie : Technique, Business, DataViz Expert

Technologies utilisées

• Next.js : 16.1.6 (avec Turbopack)
• React : 19
• TypeScript : 5
• Cytoscape.js : Visualisation du graphe réseau
• ECharts : Matrice de congestion
• Node.js : 20+

🚀 Démarrage rapide

Prérequis

• Node.js 20 ou supérieur
• npm ou yarn
• Docker (pour le déploiement)

Installation

git clone gitea@git.open.us.org:AJR/TechradarDev.git
cd TechradarDev
npm install

Développement local

Mode développement Next.js (avec hot-reload) :

npm run serve-dev

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

Mode production local (serveur statique) :

npm run serve-business

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

Build de production :

npm run build

Les fichiers statiques sont générés dans le répertoire build/

🐳 Déploiement Docker

Le radar est déployé via Docker Compose :

Commande de déploiement :

docker compose -f docker-compose.business.yml up -d --build

Cette commande :

• Build l'image Docker sans cache (--build)
• Démarre le conteneur en mode détaché (-d)
• Le radar sera accessible sur http://localhost:3006

Arrêter le déploiement :

docker compose -f docker-compose.business.yml down

Configuration Docker :

• Dockerfile : Dockerfile.business
• Docker Compose : docker-compose.business.yml
• Port : 3006 (mappé depuis le port 3000 du conteneur)
• Conteneur : laplank-radar-technolologique

📊 Fonctionnalités

Radar Technologique

• Quadrants business :

  • Technologies Différenciantes
  • Technologies Commodité
  • Technologies Risque
  • Technologies Émergentes

• Anneaux d'adoption :

  • Adopt : Technologies adoptées et utilisées en production
  • Trial : Technologies en phase d'essai
  • Assess : Technologies à évaluer
  • Hold : Technologies à éviter ou remplacer

• 38 technologies suivies dans la release 2025-01-15

Page Équipe (/team)

Visualisations interactives de l'équipe :

1. Graphe réseau : Relations entre membres et technologies (Cytoscape.js)
2. Matrice de congestion : Technologies core vs disponibilité de l'équipe (ECharts)
3. Équipe de genèse : Membres fondateurs et leurs compétences
4. Profils cliquables : Cartes de profil détaillées pour chaque membre

12 membres de l'équipe avec leurs compétences, projets et disponibilités.

Pages de stratégie

Accès à trois pages de stratégie depuis le header :

• Stratégie Technique : Vision technique et roadmap
• Business : Impact business et métriques
• DataViz Expert : Stratégie de visualisation de données

Protection par mot de passe : laplank-radar

📁 Structure du projet

TechradarDev/
├── radar-app/              # Framework Next.js vendu (stand-alone)
│   ├── src/                # Code source Next.js
│   ├── data/               # Données du radar
│   └── package.json        # Next.js 16.1.6, React 19
├── radar-business/         # Contenu du radar business
│   ├── 2025-01-15/         # Release actuelle (38 technologies)
│   └── config-business.json # Configuration du radar
├── docs/
│   ├── data/
│   │   └── team/           # Profils des 12 membres
│   └── app/                # Documentation technique
├── scripts/
│   ├── build-radar.js      # Script de build stand-alone
│   ├── serve-radar.js      # Script de serve
│   ├── generate-team-visualization-data.js # Génération données équipe
│   └── ...
├── public/                 # Fichiers statiques
│   ├── team-block-script.js # Script page équipe
│   └── team-visualization-data.json # Données visualisations
├── Dockerfile.business     # Dockerfile pour déploiement
└── docker-compose.business.yml # Configuration Docker Compose

🛠️ Scripts disponibles

Script	Description
npm run build	Build de production (génère build/)
npm run serve	Serve les fichiers statiques depuis build/
npm run serve-dev	Mode développement Next.js (hot-reload)
npm run serve-business	Serve le radar business en local (port 3006)
npm run extract-tech	Extraction des technologies depuis la doc
npm run analyze-business	Analyse des métriques business

📝 Content Guidelines

Tags disponibles

Les blips doivent être tagués avec les tags suivants :

• architecture
• security
• devops
• frontend
• agile
• coding
• quality assurance
• ci/cd
• ux/ui
• documentation

Exemple :

tags: [devops, security]

Format des blips

Voir radar-business/FORMAT-BLIP.md pour le format complet des métadonnées business.

🔐 Sécurité

• Protection par mot de passe : Les pages de stratégie sont protégées par le mot de passe laplank-radar
• Authentification client-side : Système d'authentification JavaScript côté client

📚 Documentation

La documentation complète est disponible dans le dossier docs/ :

• Architecture - Architecture technique du projet
• Configuration - Configuration du radar
• Développement - Guide de développement
• Déploiement - Guide de déploiement
• Contribution - Guide de contribution
• Guide Radar Business - Guide spécifique au radar business
• Guide Page Équipe - Documentation de la page équipe
• Migration Next.js 16 - Notes de migration

🔄 État du projet

• Branche actuelle : stand-alone
• Version : 4.3.0
• Statut : Projet stand-alone, indépendant du package externe aoe_technology_radar
• Framework : Code vendu dans radar-app/ (basé sur aoe_technology_radar)

📞 Support

• Dépôt Git : https://git.open.us.org/AJR/TechradarDev
• Radar en ligne : http://localhost:3006 (après déploiement)

📄 Licence

MIT