Stéphan Peccini
f812fac89e
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>
Module d'Analyse
Ce module permet d'analyser les relations entre les différentes parties de la chaîne de fabrication du numérique. Il offre des outils pour visualiser les flux et identifier les vulnérabilités potentielles dans la chaîne d'approvisionnement.
Structure du module
Le module d'analyse comprend deux composants principaux :
- interface.py : Gère l'interface utilisateur pour paramétrer les analyses
- sankey.py : Génère les diagrammes de flux (Sankey) pour visualiser les relations entre les éléments
Fonctionnalités
Interface d'analyse
L'interface permet de :
- Sélectionner les niveaux de départ et d'arrivée pour l'analyse (produits, composants, minerais, opérations, etc.)
- Filtrer les données par minerais spécifiques
- Effectuer une sélection fine des nœuds de départ et d'arrivée
- Appliquer des filtres pour identifier les vulnérabilités :
- Filtres ICS (criticité pour un composant)
- Filtres IVC (criticité par rapport à la concurrence sectorielle)
- Filtres IHH (concentration géographique ou industrielle)
- Filtres ISG (instabilité des pays)
- Choisir la logique de filtrage (OU, ET)
Visualisation Sankey
Le module génère des diagrammes Sankey qui :
- Affichent les flux entre les différents éléments de la chaîne
- Mettent en évidence les relations de dépendance
- Permettent d'identifier visuellement les goulots d'étranglement potentiels
- Sont interactifs et permettent d'explorer la chaîne de valeur
Utilisation
- Sélectionnez un niveau de départ (ex : Produit final, Composant)
- Choisissez un niveau d'arrivée (ex : Pays géographique, Acteur d'opération)
- Si nécessaire, filtrez par minerais spécifiques
- Affinez votre sélection avec des nœuds de départ et d'arrivée spécifiques
- Appliquez les filtres de vulnérabilité souhaités
- Lancez l'analyse pour générer le diagramme Sankey
Le diagramme résultant permet d'identifier visuellement les relations et points de vulnérabilité dans la chaîne d'approvisionnement du numérique.