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

95 lines
No EOL
2.9 KiB
Markdown

# 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