django-lucy-assist 0.1.0__py3-none-any.whl

django_lucy_assist-0.1.0.dist-info/METADATA

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: django-lucy-assist
+Version: 0.1.0
+Summary: Assistant IA intelligent Revolucy pour outil métier
+Author-email: Revolucy <hello@revolucy.fr>
+Maintainer-email: Maxence <hello@revolucy.fr>
+License: MIT
+Project-URL: Homepage, https://github.com/revolucy/django-lucy-assist
+Project-URL: Documentation, https://github.com/revolucy/django-lucy-assist#readme
+Project-URL: Repository, https://github.com/revolucy/django-lucy-assist.git
+Project-URL: Issues, https://github.com/revolucy/django-lucy-assist/issues
+Keywords: django,chatbot,ai,claude,anthropic,assistant,crm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: Django>=4.0
+Requires-Dist: anthropic>=0.20.0
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-django>=4.5.0; extra == "dev"
+Requires-Dist: factory-boy>=3.3.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Provides-Extra: gitlab
+Requires-Dist: python-gitlab>=3.15.0; extra == "gitlab"
+
+# Django Lucy Assist
+
+Assistant IA intelligent basé sur Claude d'Anthropic, intégrable dans n'importe quelle application Django.
+
+## Installation
+
+```bash
+pip install django-lucy-assist
+```
+
+## Configuration
+
+### 1. Ajouter l'application à INSTALLED_APPS
+
+```python
+INSTALLED_APPS = [
+    ...
+    'lucy_assist',
+]
+```
+
+### 2. Configurer les variables d'environnement
+
+Ajouter dans votre fichier `.env` :
+
+```bash
+# ======================================== LUCY ASSIST ========================================
+# Clé API Claude
+ANTHROPIC_API_KEY=sk-ant-...
+
+# Configuration GitLab pour l'analyse de bugs (optionnel)
+GITLAB_URL=https://gitlab.example.com
+GITLAB_TOKEN=glpat-...
+GITLAB_PROJECT_ID=123
+
+# SIREN client pour l'API Lucy CRM  (Si non présent via le module de retour)
+SIREN_CLIENT=123456789
+```
+
+Puis dans votre `settings.py` :
+
+```python
+import os
+
+# Lucy Assist
+ANTHROPIC_API_KEY = os.getenv('ANTHROPIC_API_KEY')
+GITLAB_URL = os.getenv('GITLAB_URL')
+GITLAB_TOKEN = os.getenv('GITLAB_TOKEN')
+GITLAB_PROJECT_ID = os.getenv('GITLAB_PROJECT_ID')
+SIREN_CLIENT = os.getenv('SIREN_CLIENT')
+
+# Configuration avancée (optionnel)
+LUCY_ASSIST = {
+    # Modèle de base personnalisé
+    'BASE_MODEL': 'mon_app.models.MonModeleBase',
+    # Préfixe des apps du projet pour le mapping modèle -> app
+    'PROJECT_APPS_PREFIX': 'apps.',
+}
+```
+
+### 3. Ajouter les URLs
+
+```python
+# urls.py
+from django.urls import path, include
+
+urlpatterns = [
+    ...
+    path('lucy-assist/', include('lucy_assist.urls')),
+]
+```
+
+### 4. Ajouter le context processor
+
+```python
+# settings.py
+TEMPLATES = [
+    {
+        ...
+        'OPTIONS': {
+            'context_processors': [
+                ...
+                'lucy_assist.context_processors.lucy_assist_context',
+            ],
+        },
+    },
+]
+```
+
+### 5. Inclure le template dans votre base.html
+
+```html
+<!-- templates/base.html -->
+{% include 'lucy_assist/chatbot_sidebar.html' %}
+```
+
+### 6. Exécuter les migrations
+
+```bash
+python manage.py migrate lucy_assist
+```
+
+## Utilisation
+
+Une fois installé et configuré, Lucy Assist apparaîtra automatiquement sur toutes les pages de votre application avec un bouton flottant en bas à droite.
+
+### Fonctionnalités
+
+- **Chat IA contextuel** : Lucy comprend le contexte de la page actuelle
+- **Actions CRUD** : Lucy peut créer, modifier, rechercher et supprimer des objets
+- **Analyse de bugs** : Connexion à GitLab pour analyser les problèmes signalés
+- **Historique des conversations** : Sauvegarde automatique des conversations
+- **Gestion des tokens** : Suivi de la consommation des tokens Claude
+
+## Configuration avancée
+
+### Modèle de base personnalisé
+
+Si vous utilisez un modèle de base personnalisé avec des champs d'audit (created_date, updated_date, etc.), vous pouvez le configurer :
+
+```python
+LUCY_ASSIST = {
+    'BASE_MODEL': 'mon_app.models.MonModeleBase',
+}
+```
+
+### Personnalisation des questions fréquentes
+
+```python
+LUCY_ASSIST = {
+    'QUESTIONS_FREQUENTES_DEFAULT': [
+        "Comment créer un nouveau membre ?",
+        "Comment effectuer un paiement ?",
+        "Comment exporter des données ?",
+    ],
+}
+```
+
+## API
+
+Lucy Assist expose plusieurs endpoints API :
+
+- `GET /lucy-assist/api/conversations/` - Liste des conversations
+- `POST /lucy-assist/api/conversations/` - Créer une conversation
+- `GET /lucy-assist/api/conversations/<id>/` - Détail d'une conversation
+- `POST /lucy-assist/api/conversations/<id>/messages/` - Ajouter un message
+- `POST /lucy-assist/api/conversations/<id>/completion/` - Générer une réponse (streaming)
+- `GET /lucy-assist/api/tokens/status/` - Statut des tokens
+
+## Licence
+
+[Revolucy](https://www.revolucy.fr)
+
+## Versionning
+
+- V1.0.0 | Création du module Lucy
+
+## Déploiement Pypi
+
+1. `pip install build twine`
+2. `python -m build`
+3. `python -m twine upload dist/*`
+4. Indiquer le token présent dans 1Password

django_lucy_assist-0.1.0.dist-info/RECORD

@@ -0,0 +1,44 @@
+lucy_assist/__init__.py,sha256=vTA2UPlEX6UiMaOIpDAPAKife5f2KyDOhxGiTQu5lio,335
+lucy_assist/admin.py,sha256=-hNfuwuMfxgZVFQc_ODy6WcyZPxrM_8TfKsRMd0fj38,694
+lucy_assist/apps.py,sha256=zHZtlBXs5ML4CKtGg7xDyptSWzLfB1ks2VvbXF50hdo,264
+lucy_assist/conf.py,sha256=S24BxpkMrT54YfYgQcFjgNZY8y_wu8u7wfKcegUaH1Q,3535
+lucy_assist/constantes.py,sha256=YppDWi1DQueMwJk3jmeGPDi-UTmSUUDSwR6sW7QzBn4,4083
+lucy_assist/context_processors.py,sha256=mDrr9G5XztDfJLGq_75X1rkJbVI5De08ys_pW3y12Dw,2210
+lucy_assist/signals.py,sha256=aQA84oe9JNL72eeV5kURTTV-9CcQpqakDle1Lv3dnFY,861
+lucy_assist/urls.py,sha256=Qr8jJjEyC_EFGAeiZnjhgTc-9P4Y-TqKDaYicWRp_GQ,1451
+lucy_assist/migrations/0001_initial.py,sha256=_3ARg4hFA76pfrJV7RI6nMNaygwcCL5JA_-21LGroWQ,5015
+lucy_assist/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lucy_assist/models/__init__.py,sha256=JQMr50P94sBrKwwcNArRE_qnk7dLnknMKCabeRLskJc,415
+lucy_assist/models/base.py,sha256=Ql2AY7bzvcxZhxsPdCpbVEKvtWD-NBkHTLYZX4TjT3s,1532
+lucy_assist/models/configuration.py,sha256=oFVIh2RYl1TmutXBmjH3xGg7TFw_EHeJ_C9qZdZopwg,6300
+lucy_assist/models/conversation.py,sha256=psx2AQtQ5SFP-AJD7wbGabpXXLIGYngdVZfeoTlgKtQ,1849
+lucy_assist/models/message.py,sha256=kf-ffMtLYNFhXYUrB3QSL97KKDJUOMrKaPjKeOcJa_o,1492
+lucy_assist/models/project_context_cache.py,sha256=Bnb0VU7pv7QEvjOI6JSLEPvL4BxskCQ0ojWGxO7YDSM,6530
+lucy_assist/services/__init__.py,sha256=I0brW674WNIKkGHj2lj4sGEDD7HUAr5Z254dsbirdLk,691
+lucy_assist/services/bug_notification_service.py,sha256=BkY-xqeC153j6p5GWrc70W5jBKkBFD2Zx68qguNUOrU,6999
+lucy_assist/services/claude_service.py,sha256=QJIo983cSQ0k_9IKxYB50DxlRDJGPuEbrFGdzs6hl2c,15873
+lucy_assist/services/context_service.py,sha256=GaZzUHNlJf9-0Mas4_nfi2RgycNLoWjYHCJxCoiwUnA,11997
+lucy_assist/services/crud_service.py,sha256=E8-xRxPXXbUuPakGXPsbZfImEJWZx4BZq5DhM5q2I08,11436
+lucy_assist/services/gitlab_service.py,sha256=uH83fwRSCwiRItznENpYQG4aPckjafYIV9z6OChUrZg,8056
+lucy_assist/services/project_context_service.py,sha256=bIuqTanc59gP_BLod3oQgWplxpiCgByg-kbUMe_57CQ,14053
+lucy_assist/services/tool_executor_service.py,sha256=fXLH4Aaip-HPX1nNRs8UQ1N77rGloBahSwOR9gPmjfU,13583
+lucy_assist/services/tools_definition.py,sha256=xUJCtFZ1uROxB7jNHY0X75fs5nzFAKr4VpSHtKgepxU,8974
+lucy_assist/static/lucy_assist/css/lucy-assist.css,sha256=VLsebnECg36dOykBldJALBKHW3CZUfukz_nq94rKklI,3333
+lucy_assist/static/lucy_assist/image/icon-lucy.png,sha256=FOYlwXAt40Gr9jsWFmhgPivYOBFWKeYW0lxJI5Up-GM,6710
+lucy_assist/static/lucy_assist/js/lucy-assist.js,sha256=dmXtSPQ38LisoRWZd3R1Ms6OvVaEk3OrYKcVM0OMb_Q,28207
+lucy_assist/templates/lucy_assist/chatbot_sidebar.html,sha256=ptShZL89SPH4xk0RvFJheoZLJ-kWDSiPMvEqpbvnQVI,19827
+lucy_assist/templates/lucy_assist/partials/documentation_content.html,sha256=byA2EvQT1GaMB5yTQHNt5ZfJKEew9_LxutU8s5muM9s,4143
+lucy_assist/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lucy_assist/tests/test_lucy_assist.py,sha256=KBvuED10_gOJWdaRS2zMigM3W5Kp00KhMEwaR8tvhUc,6949
+lucy_assist/tests/factories/__init__.py,sha256=cDkgr4aPFKwbPo6JLY2s22pHrGWPI_vqG4IafWAhSmE,376
+lucy_assist/tests/factories/lucy_assist_factories.py,sha256=Mz1EN7xtMpIDJPNMledDbjR6X6dsBNv7JWczjD9-_MQ,3674
+lucy_assist/utils/__init__.py,sha256=FnL0QF7pyhjHCOywVAkZq3dl4IEgT39prJk1FtXMBDc,129
+lucy_assist/utils/log_utils.py,sha256=gdjaKg5PNUYlDVCQNFXQJG3vsLKay_aWX6AJxoHtiG4,1720
+lucy_assist/utils/message_utils.py,sha256=kABNVlfJTzmbRTVdauKPN5HVRqyw352xu_rlQrb279Q,3323
+lucy_assist/utils/token_utils.py,sha256=rxe9jHjcRJcaIlcw0QuVmYXOjscTsUsxnhhI6RMBzDM,2608
+lucy_assist/views/__init__.py,sha256=uUPYpuHlBC8j7zKS_DDoWjwpCpRnOIXETY-S2-Ss0cY,288
+lucy_assist/views/api_views.py,sha256=C8Ftut7qNSauzFNoZ4yPMhiADeEma7aiqrQrN9Gx9Yk,23281
+django_lucy_assist-0.1.0.dist-info/METADATA,sha256=Otc1eK9jUnClf5Jy63wgJmAOcmjuMnfBpA20a3Totlw,5752
+django_lucy_assist-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+django_lucy_assist-0.1.0.dist-info/top_level.txt,sha256=T-UCiwpn5yF3Oem3234TUpSVnEgbkrM2rGz9Tz5N-QA,12
+django_lucy_assist-0.1.0.dist-info/RECORD,,

django_lucy_assist-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

django_lucy_assist-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+lucy_assist

lucy_assist/__init__.py

@@ -0,0 +1,11 @@
+"""
+Lucy Assist - Assistant IA intelligent pour applications Django.
+
+Un chatbot IA basé sur Claude d'Anthropic, intégrable dans n'importe quelle
+application Django pour fournir une assistance contextuelle aux utilisateurs.
+"""
+
+__version__ = '0.1.0'
+__author__ = 'Revolucy'
+
+default_app_config = 'lucy_assist.apps.LucyAssistConfig'

lucy_assist/admin.py

@@ -0,0 +1,22 @@
+from django.contrib import admin
+
+from lucy_assist.models import Conversation, Message, ConfigurationLucyAssist
+
+
+class BlockMessage(admin.StackedInline):
+    model = Message
+    extra = 1
+
+
+@admin.register(Conversation)
+class ConversationAdmin(admin.ModelAdmin):
+    list_display = ('id', 'utilisateur', 'titre', 'created_date', 'is_active')
+    list_filter = ('is_active', 'created_date')
+    search_fields = ('utilisateur__email', 'titre')
+    ordering = ('-created_date',)
+    inlines = [BlockMessage]
+
+
+@admin.register(ConfigurationLucyAssist)
+class ConfigurationLucyAssistAdmin(admin.ModelAdmin):
+    list_display = ('id', 'tokens_disponibles', 'prix_par_million_tokens', 'updated_date')

lucy_assist/apps.py

@@ -0,0 +1,10 @@
+from django.apps import AppConfig
+
+
+class LucyAssistConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "lucy_assist"
+    verbose_name = "Lucy Assist - Chatbot IA"
+
+    def ready(self):
+        import lucy_assist.signals  # noqa

lucy_assist/conf.py

@@ -0,0 +1,103 @@
+"""
+Configuration de Lucy Assist.
+Permet de personnaliser le comportement via les settings Django.
+"""
+from django.conf import settings
+
+
+class LucyAssistSettings:
+    """
+    Classe de configuration pour Lucy Assist.
+    Lit les settings depuis LUCY_ASSIST dans settings.py.
+    """
+
+    # Valeurs par défaut
+    DEFAULTS = {
+        # Modèle de base pour les modèles Lucy Assist (None = utilise le modèle par défaut)
+        # Peut être une string "mon_app.models.MonModele" ou une classe directement
+        'BASE_MODEL': None,
+
+        # Clé API Claude (peut aussi être définie via ANTHROPIC_API_KEY)
+        'CLAUDE_API_KEY': None,
+
+        # Modèle Claude à utiliser
+        'CLAUDE_MODEL': 'claude-sonnet-4-20250514',
+
+        # Configuration GitLab pour l'analyse de bugs
+        'GITLAB_URL': None,
+        'GITLAB_TOKEN': None,
+        'GITLAB_PROJECT_ID': None,
+
+        # SIREN du client pour l'API Lucy CRM
+        'SIREN_CLIENT': None,
+
+        # Email de fallback pour les feedbacks
+        'FEEDBACK_EMAIL': 'support@revolucy.fr',
+
+        # Préfixe des apps du projet pour le mapping modèle -> app
+        # Ex: 'apps.' pour filtrer les apps commençant par 'apps.'
+        'PROJECT_APPS_PREFIX': None,
+
+        # URL de base de l'API Lucy CRM
+        'LUCY_CRM_API_URL': 'https://app.lucy-crm.fr',
+
+        # Prix par million de tokens (en euros)
+        'PRIX_PAR_MILLION_TOKENS': 10.0,
+
+        # Nombre moyen de tokens par conversation
+        'TOKENS_MOYENS_PAR_CONVERSATION': 2000,
+
+        # Questions fréquentes par défaut
+        'QUESTIONS_FREQUENTES_DEFAULT': [
+            "Comment créer un nouveau membre ?",
+            "Comment effectuer un paiement ?",
+            "Comment exporter des données ?",
+            "Comment modifier mon profil ?",
+            "Où trouver la liste des adhésions ?",
+        ],
+    }
+
+    def __init__(self):
+        self._settings = getattr(settings, 'LUCY_ASSIST', {})
+
+    def __getattr__(self, name):
+        if name in self.DEFAULTS:
+            # Vérifier d'abord dans LUCY_ASSIST settings
+            if name in self._settings:
+                return self._settings[name]
+
+            # Cas spéciaux pour les settings qui peuvent être définis au niveau global
+            if name == 'CLAUDE_API_KEY':
+                # Chercher dans plusieurs variables possibles
+                return (
+                    getattr(settings, 'CLAUDE_LUCY_ASSIST_API_KEY', None) or
+                    getattr(settings, 'ANTHROPIC_API_KEY', None) or
+                    self.DEFAULTS[name]
+                )
+
+            if name == 'SIREN_CLIENT':
+                return getattr(settings, 'SIREN_CLIENT', None) or self.DEFAULTS[name]
+
+            if name == 'GITLAB_URL':
+                return getattr(settings, 'GITLAB_URL', None) or self.DEFAULTS[name]
+
+            if name == 'GITLAB_TOKEN':
+                return getattr(settings, 'GITLAB_TOKEN', None) or self.DEFAULTS[name]
+
+            if name == 'GITLAB_PROJECT_ID':
+                return getattr(settings, 'GITLAB_PROJECT_ID', None) or self.DEFAULTS[name]
+
+            return self.DEFAULTS[name]
+
+        raise AttributeError(f"'{type(self).__name__}' object has no attribute '{name}'")
+
+    def get(self, name, default=None):
+        """Récupère une valeur de configuration avec une valeur par défaut."""
+        try:
+            return getattr(self, name)
+        except AttributeError:
+            return default
+
+
+# Instance singleton des settings
+lucy_assist_settings = LucyAssistSettings()

lucy_assist/constantes.py

@@ -0,0 +1,120 @@
+"""
+Constantes pour Lucy Assist
+"""
+
+
+class LucyAssistConstantes:
+    """Constantes générales de Lucy Assist"""
+
+    # Prix par million de tokens (en euros)
+    PRIX_PAR_MILLION_TOKENS = 10.0
+
+    # Nombre moyen de tokens par conversation
+    TOKENS_MOYENS_PAR_CONVERSATION = 2000
+
+    # Nombre de conversations estimées pour 1 million de tokens
+    CONVERSATIONS_PAR_MILLION = 500  # 1_000_000 / 2000
+
+    class Repondant:
+        """Types de répondants dans une conversation"""
+        UTILISATEUR = 'UTILISATEUR'
+        CHATBOT = 'CHATBOT'
+
+        tuples = [
+            (UTILISATEUR, 'Utilisateur'),
+            (CHATBOT, 'Lucy Assist'),
+        ]
+
+    class TypeAction:
+        """Types d'actions que Lucy Assist peut effectuer"""
+        AIDE_NAVIGATION = 'AIDE_NAVIGATION'
+        RECHERCHE = 'RECHERCHE'
+        CRUD = 'CRUD'
+        ANALYSE_BUG = 'ANALYSE_BUG'
+        EXPLICATION = 'EXPLICATION'
+
+        tuples = [
+            (AIDE_NAVIGATION, 'Aide à la navigation'),
+            (RECHERCHE, 'Recherche d\'objets'),
+            (CRUD, 'Création/Modification/Suppresion d\'objets'),
+            (ANALYSE_BUG, 'Analyse de bug'),
+            (EXPLICATION, 'Explication de fonctionnalité'),
+        ]
+
+    class StatutConversation:
+        """Statuts possibles d'une conversation"""
+        ACTIVE = 'ACTIVE'
+        ARCHIVEE = 'ARCHIVEE'
+
+        tuples = [
+            (ACTIVE, 'Active'),
+            (ARCHIVEE, 'Archivée'),
+        ]
+
+    # Prompts système pour Claude
+    SYSTEM_PROMPTS = {
+        'default': """Tu es Lucy, un assistant IA intégré dans un CRM métier (UNAF-CRM).
+Tu as la capacité d'EXÉCUTER des actions directement dans l'application grâce aux tools disponibles.
+
+## COMPORTEMENT PRIORITAIRE - ACTION FIRST
+
+RÈGLE FONDAMENTALE : Quand l'utilisateur te demande de faire quelque chose (créer, modifier, rechercher, supprimer),
+tu dois EXÉCUTER L'ACTION IMMÉDIATEMENT en utilisant les tools disponibles.
+
+❌ NE FAIS PAS : Expliquer comment faire, rediriger vers une page, dire que tu ne peux pas
+✅ FAIS : Utiliser le tool approprié pour exécuter l'action demandée
+
+## Exemples de comportement attendu
+
+Utilisateur : "Crée un membre Maxence Dupont"
+→ Tu utilises le tool create_object avec les données {{"nom": "Dupont", "prenom": "Maxence"}}
+
+Utilisateur : "Cherche les membres de Paris"
+→ Tu utilises le tool search_objects avec query="Paris" et model_name="Membre"
+
+Utilisateur : "Modifie l'adresse du membre 42"
+→ Tu utilises le tool update_object avec l'object_id et les nouvelles données
+
+## Quand NE PAS agir directement
+
+- Si l'utilisateur demande explicitement "comment faire" ou "explique-moi"
+- Si tu n'as pas assez d'informations (dans ce cas, demande les infos manquantes)
+- Pour les suppressions : demande une confirmation avant d'exécuter
+
+## Contexte de la page actuelle
+{page_context}
+
+## Permissions de l'utilisateur
+{user_permissions}
+
+## Modèles principaux disponibles
+- Membre (membre) : nom, prenom, email, telephone, adresse, structure
+- Structure (structure) : nom, adresse, type, siret
+- Adhesion (adhesion) : membre, structure, date_debut, date_fin, montant
+- Paiement (paiement) : membre, montant, date, mode_paiement
+
+## Format de réponse après action
+
+Après avoir exécuté une action, confirme brièvement :
+"✅ [Action effectuée] - [Détail bref]"
+
+Exemple : "✅ Membre créé - Maxence Dupont (ID: 123)"
+""",
+        'crud': """Tu dois aider l'utilisateur à créer ou modifier un objet.
+Formulaire disponible : {form_info}
+Champs requis : {required_fields}
+""",
+        'bug_analysis': """Analyse le problème signalé par l'utilisateur.
+Code source pertinent : {code_context}
+Erreur rapportée : {error_message}
+""",
+    }
+
+    # Questions fréquentes par défaut (utilisées si non configurées dans le modèle)
+    QUESTIONS_FREQUENTES_DEFAULT = [
+        "Comment créer un nouveau membre ?",
+        "Comment effectuer un paiement ?",
+        "Comment exporter des données ?",
+        "Comment modifier mon profil ?",
+        "Où trouver la liste des adhésions ?",
+    ]

lucy_assist/context_processors.py

@@ -0,0 +1,65 @@
+"""
+Context Processors pour Lucy Assist.
+
+Ces fonctions injectent automatiquement les données Lucy Assist
+dans le contexte de tous les templates Django.
+"""
+from django.conf import settings
+
+from lucy_assist.models import ConfigurationLucyAssist
+
+
+def lucy_assist_context(request):
+    """
+    Context processor pour injecter Lucy Assist dans toutes les pages.
+
+    Ajoute au contexte:
+    - lucy_assist_enabled: bool indiquant si Lucy Assist est activé
+    - lucy_assist_config: configuration de Lucy Assist
+    - lucy_assist_user_has_conversations: bool si l'utilisateur a des conversations
+
+    Usage dans template:
+        {% if lucy_assist_enabled %}
+            {% include "chatbot_sidebar.html" %}
+        {% endif %}
+    """
+    context = {
+        'lucy_assist_enabled': False,
+        'lucy_assist_config': None,
+        'lucy_assist_user_has_conversations': False,
+    }
+
+    # Vérifier si l'utilisateur est authentifié
+    if not request.user.is_authenticated:
+        return context
+
+    try:
+        # Récupérer la configuration
+        config = ConfigurationLucyAssist.get_config()
+
+        # Vérifier si Lucy Assist est configuré (clé API présente)
+        api_key_configured = bool(getattr(settings, 'CLAUDE_LUCY_ASSIST_API_KEY', ''))
+
+        if config and config.actif:
+            context['lucy_assist_enabled'] = True
+            context['lucy_assist_config'] = {
+                'tokens_disponibles': config.tokens_disponibles,
+                'tokens_en_euros': round(config.tokens_restants_en_euros, 2),
+                'conversations_estimees': config.conversations_estimees,
+                'actif': config.actif,
+                'api_configured': api_key_configured,
+                'avatar_url': config.avatar.url if config.avatar else None,
+            }
+
+            # Vérifier si l'utilisateur a des conversations
+            from lucy_assist.models import Conversation
+            context['lucy_assist_user_has_conversations'] = Conversation.objects.filter(
+                utilisateur=request.user,
+                is_active=True
+            ).exists()
+
+    except Exception:
+        # En cas d'erreur, Lucy Assist reste désactivé
+        pass
+
+    return context