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:
@@ -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