docs: Mise a jour finale docs/app
- README.md: Structure fichiers mise a jour - configuration.md: Ajout section script page equipe - troubleshooting.md: Mise a jour diagnostic page equipe
This commit is contained in:
syoul
@@ -107,8 +107,8 @@ TechradarDev/
|
||||
│ └── data/ # Données métier
|
||||
│ └── team/ # Profils équipe individuels
|
||||
├── public/ # Fichiers statiques
|
||||
│ ├── team.html # Page équipe
|
||||
│ └── team-visualization-data.json # Données équipe
|
||||
│ ├── 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
|
||||
```
|
||||
|
||||
@@ -166,13 +166,23 @@ Le Radar Technologique Laplank utilise une configuration spécifique dans `radar
|
||||
- **Anneaux classiques** : Hold, Assess, Trial, Adopt
|
||||
- **Couleurs** : Thème vert (`#1a4d3a` pour le background, `#2ecc71` pour les accents)
|
||||
|
||||
### Script de stratégie
|
||||
### Script de strategie
|
||||
|
||||
Le fichier `public/strategie-script.js` est chargé automatiquement et fournit :
|
||||
Le fichier `public/strategie-script.js` est charge automatiquement et fournit :
|
||||
- Protection par mot de passe (authentification client-side)
|
||||
- Pages de stratégie dynamiques (Markdown converti en HTML)
|
||||
- Pages de strategie dynamiques (Markdown converti en HTML)
|
||||
|
||||
**Note** : Les fonctions d'ajout de liens dans le header ont été désactivées pour éviter les doublons. Tous les liens sont maintenant gérés par `Navigation.tsx`.
|
||||
**Note** : Les fonctions d'ajout de liens dans le header ont ete desactivees pour eviter les doublons. Tous les liens sont maintenant geres par `Navigation.tsx`.
|
||||
|
||||
### Script de la page equipe
|
||||
|
||||
Le fichier `public/team-block-script.js` est charge via `_document.tsx` et fournit :
|
||||
- Detection de la route `/team`
|
||||
- Remplacement du DOM avec le contenu de la page equipe
|
||||
- Chargement dynamique de Cytoscape.js et ECharts depuis CDN
|
||||
- Initialisation des trois visualisations (graphe reseau, matrice congestion, equipe genese)
|
||||
|
||||
Ce script utilise le layout `cose` integre a Cytoscape (pas de plugin externe necessaire).
|
||||
|
||||
## Variables d'environnement
|
||||
|
||||
|
||||
@@ -88,44 +88,70 @@ find . -name "*.md" -exec sed -i 's/^ring: support$/ring: adopt/' {} \;
|
||||
|
||||
**Solution** : Vérifier que tous les rings utilisés dans les blips sont bien définis dans `config-business.json`.
|
||||
|
||||
### Page Équipe
|
||||
### Page Equipe
|
||||
|
||||
#### Page `/team` affiche le radar au lieu des visualisations
|
||||
|
||||
**Symptome** : La page `/team` affiche le contenu du radar au lieu des visualisations equipe.
|
||||
|
||||
**Causes possibles** :
|
||||
- Le script `team-block-script.js` n'est pas charge
|
||||
- Le script `patch_document.py` n'a pas modifie `_document.tsx`
|
||||
- Le script n'a pas pu remplacer le DOM
|
||||
|
||||
**Solutions** :
|
||||
1. Verifier la console du navigateur (F12) pour les erreurs JavaScript
|
||||
2. Verifier que le script `team-block-script.js` est inclus dans le HTML :
|
||||
```bash
|
||||
curl -s http://localhost:3006/team/ | grep team-block-script
|
||||
```
|
||||
3. Rebuild avec `--no-cache` pour forcer l'execution des scripts Python
|
||||
|
||||
**Verification** :
|
||||
```bash
|
||||
# Dans le conteneur
|
||||
ls -l .techradar/public/team-block-script.js
|
||||
grep "team-block-script" .techradar/src/pages/_document.tsx
|
||||
```
|
||||
|
||||
#### Page `/team` retourne 404
|
||||
|
||||
**Symptôme** : La page `/team` n'est pas accessible ou retourne une erreur 404.
|
||||
**Symptome** : La page `/team` n'est pas accessible ou retourne une erreur 404.
|
||||
|
||||
**Causes possibles** :
|
||||
- Le fichier `team.html` n'est pas dans `out/`
|
||||
- La page Next.js `team.tsx` n'a pas été créée
|
||||
- Le fichier n'a pas été copié dans `.techradar/public/`
|
||||
- La page Next.js `team.tsx` n'a pas ete creee
|
||||
- Le serveur utilise `--single` qui redirige vers index.html
|
||||
|
||||
**Solutions** :
|
||||
1. Vérifier que `public/team.html` existe
|
||||
2. Vérifier que le Dockerfile a bien créé `.techradar/src/pages/team.tsx`
|
||||
3. Vérifier que `team.html` a été copié dans `.techradar/public/` puis dans `out/`
|
||||
4. Vérifier les logs du script `start-business.sh` qui doit copier les fichiers manquants
|
||||
1. Verifier que le Dockerfile a bien cree `.techradar/src/pages/team.tsx`
|
||||
2. Verifier que `scripts/start-business.sh` ne contient pas l'option `--single`
|
||||
3. Verifier les logs du build Docker
|
||||
|
||||
**Vérification** :
|
||||
**Verification** :
|
||||
```bash
|
||||
# Dans le conteneur
|
||||
ls -l .techradar/public/team.html
|
||||
ls -l out/team.html
|
||||
ls -l .techradar/src/pages/team.tsx
|
||||
ls -l out/team/index.html
|
||||
```
|
||||
|
||||
#### Données de visualisation manquantes
|
||||
#### Donnees de visualisation manquantes ou erreur de chargement
|
||||
|
||||
**Symptôme** : Les visualisations de la page équipe sont vides.
|
||||
**Symptome** : Les visualisations de la page equipe sont vides ou affichent une erreur.
|
||||
|
||||
**Cause** : Le fichier `team-visualization-data.json` n'a pas été généré ou n'est pas accessible.
|
||||
**Causes possibles** :
|
||||
- Le fichier `team-visualization-data.json` n'a pas ete genere
|
||||
- Le fichier n'est pas accessible depuis le navigateur
|
||||
- Erreur dans le chargement des bibliotheques (Cytoscape, ECharts)
|
||||
|
||||
**Solution** :
|
||||
1. Générer les données :
|
||||
**Solutions** :
|
||||
1. Generer les donnees :
|
||||
```bash
|
||||
node scripts/generate-team-visualization-data.js
|
||||
```
|
||||
2. Vérifier que le fichier existe dans `public/team-visualization-data.json`
|
||||
3. Vérifier que le fichier a été copié dans `out/` lors du build
|
||||
2. Verifier que le fichier existe dans `public/team-visualization-data.json`
|
||||
3. Verifier l'acces direct : `http://localhost:3006/team-visualization-data.json`
|
||||
4. Verifier la console du navigateur pour les erreurs JavaScript
|
||||
5. Verifier la connexion internet (les bibliotheques sont chargees depuis CDN)
|
||||
|
||||
### Build Docker
|
||||
|
||||
@@ -211,22 +237,26 @@ Dans Portainer, cocher l'option "No cache" lors du rebuild de la stack.
|
||||
|
||||
## Commandes utiles pour le débogage
|
||||
|
||||
### Vérifier les fichiers dans le conteneur
|
||||
### Verifier les fichiers dans le conteneur
|
||||
|
||||
```bash
|
||||
# Se connecter au conteneur
|
||||
docker exec -it <container-name> /bin/sh
|
||||
|
||||
# Vérifier les fichiers
|
||||
# Verifier les fichiers de la page equipe
|
||||
ls -la .techradar/src/pages/team.tsx
|
||||
ls -la .techradar/public/team-block-script.js
|
||||
ls -la out/team-block-script.js
|
||||
ls -la out/team-visualization-data.json
|
||||
|
||||
# Verifier les modifications
|
||||
grep "team-block-script" .techradar/src/pages/_document.tsx
|
||||
ls -la .techradar/src/components/Navigation/Navigation.tsx
|
||||
ls -la .techradar/public/team.html
|
||||
ls -la out/team.html
|
||||
|
||||
# Compter les blips
|
||||
find .techradar/data/radar -name "*.md" | wc -l
|
||||
|
||||
# Vérifier la config
|
||||
# Verifier la config
|
||||
head -60 .techradar/data/config.json
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user