Module de retour Client

Conception

• Django
• Bootstrap
• JQuery 3.5.1

Installation

1 - Ajouter le package dans les requirements

2 - Ajouter dans votre .env :

=> Pour la préprod/Prod :

#====================================== RETOUR CLIENT =======================================
EMAIL_CLIENT_RETOUR='test@test.fr'
SIREN_CLIENT='1245648'
DATE_MISE_EN_PRODUCTION='2024-12-30'
DATE_FIN_GARANTIE='2024-12-30'

# Assistant IA - serveur vLLM Revolucy (optionnel)
IA_API_KEY='xxxxx'

3 - Ajouter dans votre fichier settings.py :

INSTALLED_APPS = [
    'retour_client',
]

'context_processors': [
    'retour_client.context_processors.formulaire_retour_client',
]

########### Configuration RETOUR CLIENT.
EMAIL_CLIENT_RETOUR = env('EMAIL_CLIENT_RETOUR')
SIREN_CLIENT = env('SIREN_CLIENT')
DATE_MISE_EN_PRODUCTION = env('DATE_MISE_EN_PRODUCTION')
DATE_FIN_GARANTIE = env('DATE_FIN_GARANTIE')

# Configuration Assistant IA (optionnel - pour le chatbot IA)
IA_API_KEY = env('IA_API_KEY', default=None)
IA_API_URL = 'https://api.revolucy.link/v1'  # Serveur vLLM Revolucy (défaut)
IA_MODEL = 'qwen3.6'  # Modèle par défaut

4 - Ajouter dans votre fichier urls.py :

 path('retour-client/', include("retour_client.urls")),

5 - Ajouter dans le footer.html de votre base :

<!-- AJOUT POPUP RETOUR CLIENT -->
{% include 'retour_client.html' %}

6 - Ajouter un cron :

Journalier 09h00 sur le serveur pour envoi des mails en préprod

Commande : envoi_mail_retour_client_preprod

Mensuel 09h00 le premier jour du mois sur le serveur pour envoi des mails

Commande : envoi_mail_tickets_en_attente

Licence

Revolucy

Versionning

• V1.0.0 | Création du module de retour
• V1.0.1 | Modification des versions des requirements
• V1.0.2 | Correction bug correspondance Python 3.9
• V1.0.3 | Correction bug buttons admin
• V1.0.4 | Correction bug date
• V1.0.5 | Correction bug
• V1.0.6 | Ajout d'un cockpit de gestion statistique
• V1.0.7 | Amélioration CSS
• V1.1.0 | Intégration de l'IA Claude pour aide à la rédaction et analyse des tickets via un chatbot
• V1.1.4 | Correction bug
• V1.1.5 | Ajout utilisateurs Is Staff sur l'accès au module en production
• V1.1.6 | Correction bug
• V1.1.7 | Correction bug Python > 3.11 pour capture d'écran
• V1.1.8 | Correction bug Python > 3.11 pour capture d'écran
• V1.1.9 | Amélioration d'affichage
• V1.3.1 | Amélioration d'affichage
• V1.3.2 | Ajout du temps facturé sur les stats
• V1.3.4 | Ajout du temps facturé sur les stats
• V1.3.5 | Ajout de la commande envoi_mail_tickets_en_attente
• V1.3.6 | Correction des chemins de templates mails
• V1.3.7 | Correction des filtres des retours à traiter
• V1.3.8 | Ajout de btn de copie de numéro de ticket
• V1.4.1 | Ajout de cahier de test en Préproduction
• V1.4.2 | Ajout API Lucy Projet
• V1.4.3 | Modification du front
• V1.4.4 | Correction bug Ancienne Version Python
• V1.4.5 | Correction du module de capture
• V1.4.6 | Ajout de l'export Markdown des tickets en attente
• V1.4.7 | Correction du responsive de la popup retour client
• V1.5.0 | Pièce jointe image dans la popup, renommage des pièces jointes, rafraîchissement HTMX de la liste, assistant IA basculé sur le serveur vLLM Revolucy
• V1.5.1 | Reprise du front

Fonctionnalités IA (V1.1.0+)

Chatbot Assistant IA

Accessible depuis la page /retour-client/pipeline-retours/ via un bouton fixe sur la droite.

Fonctionnalités :

• Recherche de tickets par mots-clés, statut, type, priorité
• Analyse statistique des tickets (tendances, pages problématiques, etc.)
• Identification de patterns et bugs récurrents
• Réponses contextuelles basées sur l'historique des tickets
• Historique des conversations par utilisateur

Cahier de test

Cahier de test quand le projet est en Préproduction permettant au client d'avoir la liste de ce qu'il doit tester et de valider ou non chaque point

Fonctionnalités :

• Import du cahier de test du dossier de conception et création automatique des "Todos"
• Liste des tests à réaliser avec la possibilité de les valider ou non
• Possibilité d'ajouter des scénarios de tests reliés aux tickets

Flux

PREPROD :

=> Module de retour visible pour tous les utilisateurs

1 - Création d'un ticket par le client :

• Enregistrement du ticket sur le site
• 2 Mails (Client / Chef de projet revo) journalier avec liste des tickets en attente de traitement avec les retours via un Batch

PRODUCTION - EN PERIODE DE GARANTIE :

=> Module de retour visible pour les administrateurs et les utilisateurs is_staff seulement => Affichage du compteur de jours restant de garantie

1 - Création d'un ticket par le client :

• Enregistrement du ticket sur le site
• 2 Mails (Client / Chef de projet revo) journalier avec liste des tickets en attente de traitement avec les retours via un Batch

PRODUCTION - HORS PERIODE DE GARANTIE :

=> Module de retour visible pour les administrateurs et les utilisateurs is_staff seulement => Affichage du compteur de nombre de crédit ticket restant => Si moins d’1H de crédit : Ajout d'un lien pour prendre un pack de crédit 5H ou 10H, puis création de la facture associée dans Lucy

1 - Création d'un ticket par le client :

• Enregistrement du ticket sur le site
• Mail Chef de projet revo à l'ajout du ticket

2 - Réponse par le chef de projet :

• Indication du nombre d'heure passé
• Déduction du crédit de temps dans Lucy par API
• Mail Client à l'ajout d'une réponse au ticket

Lancement du mode test du module de retour

1. Appliquer les migrations (première fois ou après changement de modèles)

python testproject/manage.py makemigrations python testproject/manage.py migrate

2. Créer un superuser si besoin (pour accéder à l'admin)

python testproject/manage.py createsuperuser

3. Lancer le serveur

python testproject/manage.py runserver

Ensuite, accède à :

• Page de test : http://localhost:8000/
• Module retour client : http://localhost:8000/retour/
• Admin Django : http://localhost:8000/admin/

Ce que fait le testproject

C'est un mini-projet Django autonome qui :

• Utilise SQLite (pas besoin de PostgreSQL)
• Importe directement le code source de retour_client via sys.path (pas besoin de pip install)
• Est configuré en environnement "recette" (préprod)
• Inclut déjà le context processor et les URLs du module

Etapes Déploiement Pypi

pip install build twine
python -m build
python -m twine upload dist/*
Indiquer le token présent dans 1Password