État actuel du module d'intégration UniFi

Ce document présente l'état actuel du module d'intégration UniFi pour Odoo, en date du 23 mars 2025.

Structure du module

Le module est structuré selon les standards Odoo, avec les répertoires suivants :

models/ : Contient les définitions des modèles de données
views/ : Contient les vues XML pour l'interface utilisateur
wizards/ : Contient les assistants pour les processus guidés
security/ : Contient les règles d'accès et de sécurité
data/ : Contient les données par défaut
doc/ : Contient la documentation du module
static/ : Contient les ressources statiques (CSS, JS, images)

Modèles implémentés

Le module a implémenté plusieurs modèles pour représenter les différentes composantes d'un environnement UniFi :

udm.site : Modèle central représentant un site UniFi, contenant les informations de connexion et les paramètres généraux
udm.system_info : Informations système du contrôleur UniFi
udm.network : Configurations réseau définies sur le contrôleur
udm.vlan : Configurations VLAN
udm.device : Appareils UniFi (points d'accès, switches, etc.)
udm.user : Utilisateurs/clients sur le réseau
udm.firewall : Règles de pare-feu
udm.port_forward : Règles de redirection de port
udm.dns et udm.dns_config : Configurations DNS
udm.routing et udm.routing_config : Configurations de routage
udm.dashboard_metric, udm.dashboard_stat, udm.dashboard_data_point : Métriques pour le tableau de bord

État des fonctionnalités

Fonctionnalités implémentées

Structure de base du module : Le module a une structure complète avec tous les répertoires nécessaires.
Modèles de données : Les principaux modèles de données sont définis avec leurs champs et relations.
Assistant d'importation de site basique : Un assistant simple pour ajouter un site UDM Pro est implémenté.
Vues de base : Des vues pour afficher et gérer les sites, réseaux, appareils et utilisateurs sont en place.
Intégration avec l'API UDM Pro : Le code pour se connecter à l'API UDM Pro est implémenté.

Fonctionnalités en cours de développement ou manquantes

Choix du type d'API : L'assistant actuel ne permet pas de choisir entre l'API Site Manager (distante) et l'API Controller (locale).
Support de l'authentification à deux facteurs : Bien qu'un wizard MFA existe (udm_mfa_wizard.py), son intégration complète n'est pas terminée.
Sélection des sites pour l'API Site Manager : La fonctionnalité pour afficher et sélectionner les sites disponibles via l'API distante n'est pas implémentée.
Support complet des différents types de contrôleurs : La distinction entre UDM Pro/UCG Max et les contrôleurs UniFi standard n'est pas complètement implémentée.
Synchronisation automatique des données : Les mécanismes pour synchroniser périodiquement les données ne sont pas entièrement implémentés.
Gestion des erreurs robuste : La gestion des erreurs et des exceptions pourrait être améliorée.
Documentation utilisateur : La documentation pour les utilisateurs finaux est incomplète.

État de l'interface utilisateur

Menu principal : Le menu principal du module est défini dans views/udm_menu_views.xml.
Vues des sites : Les vues pour afficher et gérer les sites UniFi sont définies dans views/udm_site_views.xml.
Vues des appareils : Les vues pour afficher les appareils UniFi sont définies dans views/udm_device_views.xml.
Vues des réseaux : Les vues pour afficher les configurations réseau sont définies dans views/udm_network_views.xml.
Assistant d'importation : L'assistant pour importer un site est défini dans wizards/udm_site_import_wizard_views.xml.

Prochaines étapes

Pour atteindre les objectifs définis dans le fichier objectifs.md, les prochaines étapes devraient inclure :

Amélioration de l'assistant d'ajout de site :
- Ajouter le choix entre l'API Site Manager et l'API Controller
- Implémenter les flux spécifiques pour chaque type d'API
- Intégrer complètement l'authentification à deux facteurs
Support complet de l'API Site Manager :
- Implémenter l'authentification via l'API cloud
- Ajouter la fonctionnalité pour lister et sélectionner les sites disponibles
Amélioration de la gestion des données :
- Implémenter des mécanismes de synchronisation automatique
- Ajouter des fonctionnalités pour comparer les configurations dans le temps
Documentation et tests :
- Compléter la documentation utilisateur
- Ajouter des tests automatisés pour garantir la fiabilité

Conclusion

Le module d'intégration UniFi est dans un état fonctionnel de base, avec les modèles et vues principaux implémentés. Cependant, plusieurs fonctionnalités clés définies dans les objectifs sont encore en développement ou manquantes. Le module nécessite des améliorations significatives pour atteindre tous les objectifs fixés, en particulier concernant le support des différents types d'API et l'amélioration de l'assistant d'ajout de site.

5.2 KiB Raw Blame History