bemade-addons/unifi_integration/doc/examples/models.md

Documentation des Modèles d'Intégration UniFi

Ce document décrit les modèles de données utilisés dans le module d'intégration UniFi pour Odoo 17.0.

Modèles Principaux

Site UniFi (udm.site)

Représente un site UniFi géré par un UDM/UDR ou un contrôleur logiciel.

Champs:

• name (Char): Nom du site
• site_id (Char): Identifiant du site dans UniFi (toujours 'default')
• description (Text): Description du site
• address (Text): Adresse physique
• active (Boolean): Statut actif
• controller_type (Selection): Type de contrôleur (UDM/UDR, Software)
• host (Char): Adresse IP ou nom d'hôte du contrôleur
• port (Integer): Numéro de port (par défaut: 443)
• username (Char): Nom d'utilisateur pour l'authentification
• password (Char): Mot de passe pour l'authentification
• mfa_token (Char): Code d'authentification à deux facteurs
• timestamp (Datetime): Horodatage de la dernière mise à jour
• raw_data (Text): Données de configuration brutes au format JSON

Relations:

• system_info_id (Many2one): Informations système
• network_ids (One2many): Configurations réseau
• vlan_ids (One2many): Configurations VLAN
• device_ids (One2many): Appareils connectés
• user_ids (One2many): Comptes utilisateur
• settings_id (Many2one): Paramètres généraux
• firewall_rule_ids (One2many): Règles de pare-feu
• port_forward_ids (One2many): Règles de redirection de port
• dns_config_id (Many2one): Configuration DNS
• routing_config_id (Many2one): Configuration de routage
• dashboard_ids (One2many): Métriques du tableau de bord
• statistic_ids (One2many): Statistiques

Modèles de Réseau

Network (udm.network)

Représente une configuration réseau.

Champs:

• name (Char): Nom du réseau
• purpose (Selection): Objectif du réseau (entreprise, invité, etc.)
• subnet (Char): Sous-réseau
• vlan_enabled (Boolean): Statut VLAN
• vlan_id (Integer): Identifiant VLAN
• dhcp_enabled (Boolean): Statut DHCP
• dhcp_start (Char): Adresse de début DHCP
• dhcp_stop (Char): Adresse de fin DHCP
• domain_name (Char): Nom de domaine du réseau
• raw_data (Text): Données réseau brutes

VLAN (udm.vlan)

Stocke la configuration VLAN.

Champs:

• vlan_id (Integer): Identifiant VLAN
• name (Char): Nom du VLAN
• raw_data (Text): Données VLAN brutes

Modèles de Sécurité

Firewall Rule (udm.firewall.rule)

Définit les règles du pare-feu.

Champs:

• name (Char): Nom de la règle
• description (Text): Description de la règle
• action (Selection): Action (accepter, rejeter, bloquer)
• protocol (Char): Protocole réseau
• source (Char): Adresse/réseau source
• destination (Char): Adresse/réseau de destination
• enabled (Boolean): Statut de la règle
• raw_data (Text): Données de règle brutes

Port Forward (udm.port.forward)

Définit les règles de redirection de port.

Champs:

• name (Char): Nom de la règle
• enabled (Boolean): Statut de la règle
• src_port (Char): Port source
• dst_port (Char): Port de destination
• protocol (Selection): Protocole (TCP, UDP, les deux)
• dst_address (Char): Adresse de destination
• raw_data (Text): Données de règle brutes

Modèles Système

System Info (udm.system.info)

Stocke les informations système de l'UDM Pro.

Champs:

• hostname (Char): Nom d'hôte du système
• version (Char): Version du firmware
• model (Char): Modèle de l'appareil
• uptime (Integer): Temps de fonctionnement
• serial (Char): Numéro de série
• mac_address (Char): Adresse MAC
• raw_data (Text): Données système brutes

Settings (udm.settings)

Stocke les paramètres généraux de l'UDM Pro.

Champs:

• timezone (Char): Fuseau horaire du système
• ntp_servers (Char): Liste des serveurs NTP
• dns_servers (Char): Liste des serveurs DNS
• raw_data (Text): Données de paramètres brutes

DNS Config (udm.dns.config)

Stocke la configuration DNS.

Champs:

• enabled (Boolean): Statut du service DNS
• filters_enabled (Boolean): Statut du filtrage de contenu
• custom_dns (Char): Serveurs DNS personnalisés
• raw_data (Text): Configuration DNS brute

Routing Config (udm.routing.config)

Stocke la configuration de routage.

Champs:

• ospf_enabled (Boolean): Statut OSPF
• static_routes (Text): Liste des routes statiques
• raw_data (Text): Données de routage brutes

Modèles Utilisateur

User (udm.user)

Représente un compte utilisateur UniFi.

Champs:

• name (Char): Nom d'utilisateur
• email (Char): Adresse email
• role (Char): Rôle de l'utilisateur
• enabled (Boolean): Statut du compte
• raw_data (Text): Données utilisateur brutes

Device (udm.device)

Représente un appareil réseau.

Champs:

• name (Char): Nom de l'appareil
• mac (Char): Adresse MAC
• ip (Char): Adresse IP
• device_type (Char): Type d'appareil
• model (Char): Modèle de l'appareil
• last_seen (Datetime): Dernier horodatage de connexion
• raw_data (Text): Données de l'appareil brutes