Cette mise a jour complete ameliore significativement la qualite et la maintenabilite du projet. 1. Extension de la couverture de tests Couverture globale passee de 8% a 16% (+100%) - Ajout de 25 nouveaux tests (total: 67 tests, 100% passent) - Nouveaux fichiers de tests: * tests/unit/test_gitea.py (17 tests) * tests/unit/test_fiches_tickets.py (8 tests) Etat de la couverture par module: - utils/gitea.py: 100% - utils/widgets.py: 100% - utils/logger.py: 94% - app/fiches/utils/tickets/core.py: 77% - utils/graph_utils.py: 59% 2. Documentation d'architecture complete Creation de 3 nouveaux documents (30 Ko total): - docs/ARCHITECTURE.md (15 Ko) * Architecture complete du projet * Flux de donnees detailles * Indices de vulnerabilite (IHH, ISG, ICS, IVC) * Structure du graphe NetworkX - docs/MODULES.md (15 Ko) * Guide des 11 modules principaux * Exemples de code (15+ snippets) * Bonnes pratiques * Guide de depannage - docs/README.md (4 Ko) * Index de toute la documentation Contenu documente: - 5 modules applicatifs - 6 modules utilitaires - 4 indices de vulnerabilite avec formules et seuils - Conventions de code 3. Reorganisation de la documentation Structure finale optimisee: - Racine: README.md (mis a jour) + Instructions.md - docs/: 11 documents organises par categorie Fichiers deplaces vers docs/: - README_connexion.md -> docs/CONNEXION.md - GUIDE_LOGS.md -> docs/ - GUIDE_RUFF.md -> docs/ - RAPPORT_RUFF.md -> docs/ - RAPPORT_CORRECTIONS_AUTO.md -> docs/ - REFACTORING_REPORT.md -> docs/ - VERIFICATION_LOGS.md -> docs/ - TODO_IA_BATCH.md -> docs/ 4. Ajout de docstrings 52 fonctions documentees en style Google (100%) Documentation en francais avec Args, Returns, Raises 5. Corrections automatiques Ruff Application de 347 corrections automatiques: - Formatage du code (line-length: 120) - Organisation des imports - Simplifications syntaxiques - Suppressions de code mort - Ameliorations de performance 6. Configuration qualite du code Nouveaux fichiers: - pyproject.toml: configuration Ruff complete - .vscode/settings.json: integration Ruff avec formatOnSave - GUIDE_RUFF.md: documentation du linter - GUIDE_LOGS.md: documentation du logging - .gitignore: ajout htmlcov/ pour rapports de couverture Etat final du projet: - Linter: Ruff configure (15 regles actives) - Tests: 67 tests (100% passent) - Couverture de code: 16% - Docstrings: 52/52 (100%) - Documentation: 11 fichiers organises Impact: - Tests plus robustes et maintenables - Documentation technique complete - Meilleure organisation des fichiers - Workflow optimise avec Ruff - Code pret pour integration continue References: - Architecture: docs/ARCHITECTURE.md - Guide modules: docs/MODULES.md - Tests: tests/unit/ - Configuration: pyproject.toml Co-Authored-By: Claude <noreply@anthropic.com>
76 lines
1.5 KiB
Markdown
76 lines
1.5 KiB
Markdown
# Guide de vérification des logs - FabNum
|
|
|
|
## Emplacement
|
|
Les logs sont dans le dossier `logs/`
|
|
|
|
## Commandes rapides
|
|
|
|
### 1. Voir le résumé
|
|
```bash
|
|
./logs/view_logs.sh
|
|
```
|
|
|
|
### 2. Suivre les logs en temps réel
|
|
```bash
|
|
tail -f logs/*.log
|
|
```
|
|
|
|
### 3. Voir les logs d'un module spécifique
|
|
```bash
|
|
# Logs des fonctions de graphe
|
|
cat logs/utils_graph_utils.log
|
|
|
|
# Logs de la génération IA
|
|
cat logs/batch_ia_utils_sections.log
|
|
|
|
# Logs des widgets HTML
|
|
cat logs/utils_widgets.log
|
|
```
|
|
|
|
### 4. Rechercher des erreurs
|
|
```bash
|
|
# Toutes les erreurs
|
|
grep -r "ERROR" logs/
|
|
|
|
# Tous les warnings
|
|
grep -r "WARNING" logs/
|
|
|
|
# Recherche spécifique
|
|
grep -r "hafnium" logs/
|
|
```
|
|
|
|
### 5. Nettoyer les logs de tests
|
|
```bash
|
|
./logs/clean_test_logs.sh
|
|
```
|
|
|
|
## Logs actuels (état sain)
|
|
|
|
- **4 warnings** : Comportement normal (nœuds manquants dans les tests, cas edge hafnium)
|
|
- **0 errors** : Application stable
|
|
- **0 critical** : Tout fonctionne
|
|
|
|
## Interprétation
|
|
|
|
### WARNING normal :
|
|
```
|
|
Nœuds manquants pour MineraiInexistant : ... — Ignoré.
|
|
```
|
|
→ Test qui cherche un minerai inexistant (attendu)
|
|
|
|
### WARNING cas edge :
|
|
```
|
|
Impossible de traiter le produit 'Procédé EUV' (cas edge hafnium/EUV)
|
|
```
|
|
→ Cas spécifique géré gracieusement (attendu)
|
|
|
|
## Fichiers créés
|
|
|
|
- `logs/view_logs.sh` : Affiche un résumé
|
|
- `logs/clean_test_logs.sh` : Nettoie les logs de tests
|
|
- `GUIDE_LOGS.md` : Documentation complète
|
|
|
|
## Documentation complète
|
|
|
|
Voir [GUIDE_LOGS.md](GUIDE_LOGS.md) pour la documentation détaillée.
|