bemade-addons/bemade_mailcow_integration/migration18.md
2025-05-29 21:35:47 -04:00

2.9 KiB

Migration vers Odoo 18.0 - bemade_mailcow_integration

Description

Module d'intégration entre Mailcow et Odoo pour la gestion des boîtes aux lettres et des alias email.

Analyse Technique

Fonctionnalités Actuelles

  1. API Mailcow

    • Gestion des connexions API avec Mailcow
    • Authentification via clé API
    • Gestion des requêtes HTTP (GET, POST, DELETE, PUT)
  2. Modèles

    • mail.mailcow : Modèle abstrait pour l'API
    • mail.mailcow.mailbox : Gestion des boîtes aux lettres
    • mail.mailcow.alias : Gestion des alias
    • mail.mailcow.blacklist : Gestion de la liste noire
    • Extension de res.users pour la synchronisation
  3. Configuration

    • Paramètres système pour l'URL et la clé API
    • Options de création automatique
    • Interface de configuration dans les paramètres

Changements dans Odoo 18.0

  1. Architecture Mail

    • Le système de mail reste similaire
    • Les alias sont toujours gérés via mail.alias
    • Les utilisateurs sont liés aux boîtes mail
  2. Modifications Nécessaires

    • Vérifier la compatibilité des API HTTP
    • Adapter les vues pour les nouvelles conventions
    • Mettre à jour les dépendances

Plan de Migration

Phase 1 : Analyse et Préparation

  1. Révision du Code

    • Vérifier les changements dans l'API Mailcow
    • Tester la compatibilité des requêtes HTTP
    • Identifier les potentiels conflits
  2. Tests

    • Créer des cas de test pour l'API
    • Documenter le comportement attendu
    • Préparer des scénarios de synchronisation

Phase 2 : Migration

  1. Mise à Jour du Code

    • Adapter les appels API si nécessaire
    • Mettre à jour les vues XML
    • Vérifier les dépendances (bemade_user_password_bundle)
  2. Tests et Validation

    • Tester la création de boîtes aux lettres
    • Tester la synchronisation des alias
    • Vérifier la gestion de la liste noire

État de la Migration

En cours d'analyse - Migration modérée requise

Notes Importantes

  • La fonctionnalité reste pertinente dans Odoo 18.0
  • L'intégration avec Mailcow est stable
  • Les tests de connexion seront cruciaux
  • Dépendance avec bemade_user_password_bundle

Prochaines Étapes

  1. Valider l'approche avec l'équipe
  2. Vérifier les changements dans l'API Mailcow
  3. Mettre à jour les tests
  4. Tester avec différents scénarios

Notes de Version

  • Version originale: 17.0.1.0.1
  • Dernière analyse: 26/01/2025

Points d'Attention Particuliers

  1. Sécurité

    • Gestion sécurisée des clés API
    • Protection des données sensibles
    • Validation des entrées utilisateur
  2. Performance

    • Optimisation des appels API
    • Gestion du cache
    • Traitement asynchrone si possible
  3. Maintenance

    • Documentation des endpoints API
    • Gestion des erreurs améliorée
    • Logs détaillés pour le débogage