llm_ticket3/docs/finalisation_migration.md
2025-04-09 13:36:42 +02:00

2.5 KiB

Finalisation de la Migration

Ce document décrit les étapes finales pour terminer la migration de la structure du projet.

Étapes déjà réalisées

  1. Création de la nouvelle structure de répertoires (odoo/, formatters/, loaders/, core/)
  2. Migration des fichiers vers leurs nouveaux emplacements
  3. Mise à jour de la fonction is_important_image dans core/utils.py
  4. Mise à jour des imports avec le script docs/migration_imports.py
  5. Création de la documentation de la structure dans docs/structure.md

Étapes finales à réaliser

  1. Renommer le dossier utils/:

    mv utils utils_old
    

    Cette étape permet de conserver temporairement les anciens fichiers en cas de besoin, tout en permettant de tester la nouvelle structure.

  2. Tester l'application: Exécuter différents scripts pour vérifier que tout fonctionne correctement avec la nouvelle structure:

    python orchestrator.py
    
  3. Corriger les erreurs d'import potentielles: Si des erreurs d'import surviennent, les corriger manuellement en utilisant le modèle suivant:

    • from utils.xxx import yyyfrom module_approprié.xxx import yyy
    • module_approprié est l'un des modules: odoo, formatters, loaders, core
  4. Suppression définitive du dossier utils_old/: Une fois que tous les tests sont validés et que l'application fonctionne normalement:

    rm -rf utils_old
    

Points d'attention particuliers

  1. Imports circulaires: Vérifier qu'il n'y a pas d'imports circulaires entre les modules. Si c'est le cas, les corriger en utilisant des imports locaux ou en restructurant légèrement le code.

  2. Fichier retrieve_ticket.py à la racine: Ce fichier semble être un doublon de odoo/retrieve_ticket.py. Vérifier s'il peut être supprimé ou s'il contient des fonctionnalités différentes qui doivent être préservées.

  3. Tests supplémentaires: Plusieurs fichiers de test existent à la racine du projet (test_*.py). Vérifier s'ils fonctionnent toujours correctement avec la nouvelle structure ou s'ils nécessitent des mises à jour.

Avantages de la nouvelle structure

Cette restructuration offre plusieurs avantages:

  • Meilleure organisation: Code regroupé par fonctionnalité plutôt que par type
  • Maintenance facilitée: Plus facile de trouver et de corriger le code
  • Évolutivité améliorée: Plus facile d'ajouter de nouvelles fonctionnalités
  • Réduction des dépendances circulaires: Structure plus claire des dépendances entre modules