Files
TechradarDev/Readme.md
syoul 055e4a9281 refactor: réorganiser la documentation en séparant app et data
- Création de docs/app/ pour la documentation de l'application
- Création de docs/data/ pour les données utilisées par l'application
- Déplacement de la documentation technique vers docs/app/
- Déplacement des données métier vers docs/data/
- Mise à jour de tous les liens et références dans les fichiers
- Mise à jour des scripts (extract-technologies.js, analyze-business-metrics.js)
- Mise à jour des fichiers JavaScript (custom.js, strategie-link.js)
- Création de README.md dans docs/, docs/app/ et docs/data/
- Mise à jour du Readme.md principal avec les nouveaux chemins
2025-12-03 14:35:36 +01:00

93 lines
2.5 KiB
Markdown

# AJR Technology Radar - Content
Ce dépôt contient le contenu du Technology Radar AJR, publié sous : https://www.coeurbox.syoul.fr
Le projet est basé sur le framework [aoe_technology_radar](https://github.com/AOEpeople/aoe_technology_radar).
## Vue d'ensemble
Le projet contient deux radars distincts :
1. **Radar Technique Principal** : Radar standard des technologies utilisées par AJR
2. **Radar Technologique Laplank** : Tech radar classique pour suivre l'évolution des technologies de l'écosystème Laplank/Duniter/Ğ1 avec historique par release
## Radar Technologique Laplank
Le Radar Technologique Laplank est un tech radar classique accessible via le port **3006** avec une **protection par mot de passe** (`laplank-radar`).
### Fonctionnalités
- **Historique par release** : Suivi de l'évolution des technologies au fil du temps avec organisation par date
- **Pages de stratégie dynamiques** : Accès à trois pages de stratégie depuis le header :
- Stratégie Technique
- Business
- DataViz Expert
- **Protection par mot de passe** : Accès restreint via un système d'authentification client-side
- **Quadrants business** : Classification selon l'impact business (Différenciantes, Commodité, Risque, Émergentes)
- **Anneaux classiques** : Hold, Assess, Trial, Adopt
### Développement local
```bash
npm install
npm run serve-business
```
Le serveur démarre sur http://localhost:3006
### Déploiement
Le Radar Technologique Laplank est déployé via Docker et Portainer :
- **Dockerfile** : `Dockerfile.business`
- **Docker Compose** : `docker-compose.business.yml`
- **Port** : 3006 (mappé depuis le port 3000 du conteneur)
- **Base path** : `/` (racine)
## Content Guidelines
Les nouveaux blips doivent être tagués. Les tags suivants sont établis :
* architecture
* security
* devops
* frontend
* agile
* coding
* quality assurance
* ci/cd
* ux/ui
* documentation
Exemple d'utilisation :
```md
tags: [devops, security]
```
## Development
### Build le radar principal
```
npm install
npm run serve
```
Puis ouvrir : http://localhost:3000/techradar
### Build avec fichiers statiques
```
npm install
npm run build
```
## Documentation
La documentation complète est disponible dans le dossier `docs/` :
- [Architecture](./docs/app/architecture.md)
- [Configuration](./docs/app/configuration.md)
- [Développement](./docs/app/developpement.md)
- [Déploiement](./docs/app/deploiement.md)
- [Contribution](./docs/app/contribution.md)
- [Guide Radar Technologique Laplank](./docs/app/guide-radar-business.md)