123 lines
3.9 KiB
Markdown
123 lines
3.9 KiB
Markdown
# Spécifications du module OpenWebUI Integration Product
|
|
|
|
## Objectif
|
|
Ce module étend les fonctionnalités d'OpenWebUI Integration pour ajouter des capacités d'IA spécifiques à la gestion des produits dans Odoo. Il permet d'automatiser et d'optimiser différents aspects de la gestion des produits grâce à l'intelligence artificielle.
|
|
|
|
## Architecture du Module
|
|
|
|
### Structure des Répertoires
|
|
```
|
|
openwebui_integration_product/
|
|
├── controllers/ # Contrôleurs pour les endpoints web spécifiques aux produits
|
|
├── models/ # Modèles de données pour les produits et l'historique
|
|
├── security/ # Fichiers de sécurité et accès
|
|
├── static/ # Ressources statiques (JS, CSS)
|
|
└── views/ # Vues XML Odoo pour les produits
|
|
```
|
|
|
|
## Composants Principaux
|
|
|
|
### 1. Intégration Produit (`product.integration`)
|
|
Extension du modèle `product.template` pour ajouter les fonctionnalités d'IA.
|
|
|
|
#### Fonctionnalités clés:
|
|
- Héritage du mixin `openwebui.bot.mixin`
|
|
- Gestion des suggestions de catégories
|
|
- Historique des suggestions
|
|
- Interface utilisateur intégrée
|
|
|
|
#### Méthodes principales:
|
|
- `_get_product_context()`: Prépare le contexte produit pour l'IA
|
|
- `suggest_category()`: Déclenche l'analyse IA pour les suggestions
|
|
- `apply_suggestion()`: Applique une suggestion validée
|
|
- `_process_category_suggestion()`: Traite la réponse de l'IA
|
|
|
|
### 2. Historique des Suggestions (`category.suggestion.history`)
|
|
Gère l'historique des suggestions de catégories.
|
|
|
|
#### Caractéristiques:
|
|
- Traçabilité des suggestions
|
|
- Scores de confiance
|
|
- Statut des suggestions (appliquée/rejetée)
|
|
- Métadonnées de contexte
|
|
|
|
#### Champs principaux:
|
|
- `product_id`: Produit concerné
|
|
- `suggested_category_id`: Catégorie suggérée
|
|
- `confidence_score`: Score de confiance
|
|
- `status`: État de la suggestion
|
|
- `applied_date`: Date d'application
|
|
- `user_id`: Utilisateur ayant traité la suggestion
|
|
|
|
### 3. Configuration Spécifique
|
|
Extension des paramètres de configuration d'OpenWebUI.
|
|
|
|
#### Paramètres configurables:
|
|
- `product_suggestion_threshold`: Seuil minimum de confiance
|
|
- `max_suggestions_per_product`: Nombre maximum de suggestions
|
|
- `suggestion_retention_days`: Durée de conservation de l'historique
|
|
- `auto_apply_threshold`: Seuil pour application automatique
|
|
|
|
## Processus de Suggestion de Catégorie
|
|
|
|
### Flux de Données
|
|
1. Collecte des données produit
|
|
- Informations de base (nom, description)
|
|
- Caractéristiques techniques
|
|
- Historique des achats
|
|
- Catégories existantes
|
|
|
|
2. Préparation du Contexte
|
|
- Formatage des données
|
|
- Ajout du contexte entreprise
|
|
- Inclusion des paramètres de configuration
|
|
|
|
3. Analyse IA
|
|
- Envoi à OpenWebUI
|
|
- Traitement de la réponse
|
|
- Calcul des scores de confiance
|
|
|
|
4. Validation et Application
|
|
- Vérification des seuils
|
|
- Présentation à l'utilisateur
|
|
- Enregistrement dans l'historique
|
|
|
|
## Sécurité et Gestion des Erreurs
|
|
|
|
### Sécurité
|
|
- Droits d'accès spécifiques aux produits
|
|
- Validation des suggestions
|
|
- Protection contre les suggestions malveillantes
|
|
- Traçabilité des modifications
|
|
|
|
### Gestion des Erreurs
|
|
- Validation des données produit
|
|
- Gestion des timeouts
|
|
- Traitement des réponses invalides
|
|
- Rollback en cas d'échec
|
|
|
|
## Intégration et Utilisation
|
|
|
|
### Installation
|
|
1. Installation des dépendances
|
|
2. Configuration des paramètres produit
|
|
3. Attribution des droits d'accès
|
|
4. Test initial des suggestions
|
|
|
|
### Développement d'Extensions
|
|
1. Héritage des modèles existants
|
|
2. Ajout de nouveaux critères d'analyse
|
|
3. Personnalisation des suggestions
|
|
4. Extension des fonctionnalités
|
|
|
|
## Dépendances
|
|
- Module `openwebui_integration`
|
|
- Module `product`
|
|
- Python 3.x
|
|
- Bibliothèques de traitement de texte
|
|
|
|
## Notes Techniques
|
|
- Optimisation des requêtes IA
|
|
- Cache des suggestions fréquentes
|
|
- Support multi-langue
|
|
- Extensible pour d'autres types d'analyses
|