📖 Guide d'utilisation — Suivi dynamique des bases Odoo

Ce document d'aide détaille le fonctionnement de l'application de gestion des bases Odoo pour étudiants et groupes, la structure attendue pour l'importation des données ainsi que les bonnes pratiques d'utilisation au quotidien.

1. Description générale de l'application

L'application est un outil autonome conçu pour les enseignants afin de piloter et évaluer les travaux pratiques sur Odoo. Ses principales fonctionnalités incluent :

Tableau de bord dynamique : Filtrage par modèle, classe et version, avec tri multi-colonnes interactif.
Suivi pédagogique individualisé : Historique des notes (sur 20) et remarques/commentaires par étudiant ou groupe.
Export PDF & E-mail : Impression de la fiche de suivi au format PDF et intégration directe des commentaires dans le corps d'un e-mail pré-rempli à destination de l'étudiant.
Administration complète : Personnalisation de l'établissement, de l'année, du professeur référent, du logo et gestion de la visibilité des colonnes.
Sauvegarde et Restauration : Export et import global au format JSON, ainsi qu'une persistance locale automatique via le navigateur.

2. Structure et importation des fichiers (CSV ou TXT)

Pour initialiser ou actualiser les données des étudiants, l'application utilise un fichier au format CSV ou TXT (séparé par des points-virgules ;) doté d'une ligne d'en-tête.

Ordre exact des colonnes :

Modèle (Maître) : Le nom du modèle de base Odoo de référence.
Nom de la base : L'identifiant ou le nom technique de la base de l'étudiant.
Étudiant / Groupe : Le nom de l'étudiant ou l'intitulé du groupe.
Classe : La promotion ou classe concernée.
URL de la base : Le lien d'accès direct vers l'instance Odoo.
E-mail : L'adresse e-mail de l'étudiant (nécessaire pour l'envoi du suivi).
Version Odoo *(Optionnel)* : Version cible (ex: V18, V19, V20).
Langue *(Optionnel)* : Langue principale (ex: Français, Anglais).

Exemple de contenu :

Modele;Base;Etudiant;Classe;URL;Email;Version;Langue
Base_Comptabilite;db_dupont;Jean Dupont;BTS SIO 1;https://dupont.odoo.com;jean.dupont@email.com;V18;Français
Base_Vente;gr_alpha;Groupe Alpha;BTS SIO 2;https://alpha.odoo.com;alpha@email.com;V19;Anglais

Import intelligent et gestion des doublons

Lorsque vous importez un nouveau fichier de bases (en complément des bases existantes) :

Préservation des évaluations : Le tableau existant en mémoire n'est pas effacé, garantissant qu'aucune note ou remarque saisie précédemment n'est perdue.
Contrôle automatique de l'existence : Le système vérifie pour chaque ligne du fichier importé si la base existe déjà pour cet étudiant.
Sécurité des notes : Si une base existe déjà, elle est ignorée pour protéger son historique d'évaluation. Seules les nouvelles bases sont ajoutées.
Rapport final d'importation : À la fin de l'import, une fenêtre d'alerte s'affiche pour vous indiquer le nombre exact de nouvelles bases importées ainsi que la liste de celles qui ont été ignorées.

⚠️ Note importante : Les lignes vides sont ignorées lors du chargement, et la première ligne (en-tête) est automatiquement écartée du traitement des données.

3. Guide d'utilisation pas à pas

Étape 1 : Importer les données

Rendez-vous dans l'onglet ⚙️ Paramètres d'administration.
Sous la section Gestion des données, sélectionnez votre fichier CSV ou TXT.
Prenez connaissance du rapport d'importation affiché à la fin du chargement.

Étape 2 : Filtrer et naviguer

Utilisez les sélecteurs du haut pour filtrer l'affichage par Modèle, Classe ou Version.
Cliquez sur les en-têtes du tableau pour trier les colonnes par ordre alphabétique ou numérique.
Cliquez sur l'icône de liaison 🔗 pour ouvrir directement l'instance Odoo de l'étudiant.

Étape 3 : Évaluer, imprimer et envoyer par e-mail

Cliquez sur le bouton crayon ✏️ d'une ligne pour ouvrir la modale de suivi.
Saisissez une note (sur 20) et/ou un commentaire pédagogique, puis cliquez sur ➕ Ajouter cette évaluation. La moyenne de l'étudiant se met à jour automatiquement.
Impression PDF : Cliquez sur 🖨️ Imprimer en PDF pour générer et enregistrer une fiche propre de la progression de l'étudiant.
Envoi par e-mail : Cliquez sur ✉️ Envoyer par Mail pour ouvrir votre client de messagerie. L'adresse de l'étudiant, l'objet ainsi que l'intégralité de l'historique des notes et remarques s'intègrent automatiquement dans le corps du texte du message.

Étape 4 : Sauvegarder et restaurer

Pour archiver l'état complet du suivi (incluant notes et paramètres), utilisez le bouton 📦 Exporter toutes les données (JSON) depuis l'administration.
Pour réimporter une sauvegarde ultérieurement, utilisez l'option de restauration JSON correspondante.