Documentation PE suite à la mise en place de la V2 expérimentale

docs/AvisPoursuiteEtudes.md

@@ -1,345 +1,217 @@
-# Jury et avis de Poursuites d'Etudes
+# Jury de Poursuites d'Etudes
 
-**Attention: cette fonction a été révisée pour le BUT en janvier 2024 et est en
-cours de travaux. merci de vos retours.**
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
 
-*Les documents en LaTeX ne sont plus générés dans la nouvelle version: seul un
-classeur excel est calculé.*
 
-Partant d'un semestre sélectionné, l'onglet **Statistiques > Documents Avis de
-Poursuite d'Etudes** (ci-dessous appelé **outil PE**) propose une aide à la
-tenue du jury et à l'édition des avis de poursuites d'études pour les étudiants
-de DUT.
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred"></i> **Attention** : cette **fonctionnalité** est en cours de révision pour le BUT depuis janvier 2024 ; les documents (avis) en LaTeX ne sont plus générés dans cette nouvelle version : seul des classeurs excel sont générés. Merci de vos retours.
 
-## Les tags
+## Cadre d'usage et nomenclature
 
-Les avis (demandés par les différents établissements post-DUT) attendent
-fréquemment des moyennes transverses aux modules voire aux semestres du PPN :
-par exemple, moyenne sur les matières théoriques, les matières techniques,
-moyenne en français, etc...
+Un jury de Poursuites d'Etudes émet des avis sur la capacité des étudiants à intégrer une formation post-BUT (master, écoles d'ingénieur, écoles de commerce, ...) en s'appuyant sur l'ensemble des résultats qu'ont obtenus les étudiants au cours de leur scolarité de BUT.
 
-L'outil PE permet le calcul de ces moyennes en utilisant des **tags** affectés
-aux modules dans le **Programme** de formation. Tous les modules portant le même
-tag (attention à la casse et à l'accentuation) seront intégrés ensemble dans le
-calcul de la moyenne.
+Les étudiants considérés sont ceux d'une **promotion** : 
 
-Voici l'exemple du programme du DUT RT taggué (figure ci-dessous), où par
-exemple, le tag *mathématiques* est affecté à tous les modules du programme en
-lien avec des maths.
+> Une **promotion** est l'ensemble des étudiants qui recevront leur **diplôme** la même année, quelque soit leurs _semestres_, leurs _parcours_, leurs _modalités_ d'apprentissage (formation initiale ou apprentissage) ou leurs redoublements éventuels.   
 
-Les tags peuvent également faire mention d'un coefficient servant à la
-pondération des modules dans le calcul de la moyenne (cf. section coefficient).
-Le tag sera alors de la forme : `nom_du_tag:coeff_entier`.
 
-Un tag *dut* reprenant la moyenne de l'étudiant à chaque semestre est
-automatiquement ajouté.
+Les avis émis s'appuient sur différents critères (**notes moyennes/classements**) obtenus :
 
-![programmeRTtaggue.png](screens/programmeRTtaggue.png)
+* sur des **moyennes prévues dans le règlement des études** : moyenne par **UE**, par **niveau de compétence** (regroupement cohérent d'UE)
+* sur des **moyennes _personnalisées_** (cf. tag), souvent demandées par les formations post-BUT dans les dossiers de candidature des étudiants : moyenne en anglais, en mathématiques, en français, ...
+* à **différents instants de la scolarité** (cf. regroupement cohérent de semestres) des étudiants : moyenne en 1ère année, en 2ème année, sur 3 ans, ... 
+* sur des **interclassements**, classant les étudiants indépendamment du _chemin_ (parcours, modalité, redoublement, ...) qu'ils ont parcouru au cours de leur scolarité de BUT.
 
-## Les moyennes
-
-### Les moyennes intra et inter semestres
+Ces critères variant d'un établissement à un autre et d'un dossier de candidature à un autre, la fonctionnalité **Jury de Poursuites d'Etudes** de Scodoc (appelée ci-dessous **outil PE**) fournit un **ensemble de notes moyennes/classements le plus large possible** centralisé dans des tableurs xlsx, pour en avoir différentes vues. 
 
-Au delà du "thème" des moyennes, les avis attendent parfois que ces moyennes
-soient calculées sur plusieurs semestres : moyenne en 1ère année, en 2ème année
-voire (pour le jury) sur l'ensemble du parcours de l'étudiant. 8 plages de
-calculs temporelles sont donc prévus pour ces moyennes : pour chaque tag,
+> A vous de _piocher_ dans les données fournies en fonction de vos besoins pour construire votre tableur  émettre vos avis et renseigner les dossiers de candidature de vos étudiants.
 
-* le label **S1** (respectivement S2, S3, S4) désigne une moyenne sur ce tag
-  calculée sur le **S1** (respectivement S2, S3, S4) - ou plus précisément sur
-  les modules du **S1** (respectivement S2, S3, S4) ayant été associé au tag
-  considéré
-* le label **1A** (respectivement 2A) désigne une moyenne sur ce tag calculée
-  sur la **première année** (respectivement la deuxième année) - ou plus
-  précisément sur tous les modules **du S1 et du S2** (respectivement du S3 et
-  du S4) ayant été associé au tag considéré
-* le label **3S** (souvent utilisé dans un jury de poursuites d'études se tenant
-  juste après le S3) désigne une moyenne sur ce tag calculée sur l'**ensemble du
-  parcours allant du S1 au S3** (inclus) - ou plus précisément sur tous les
-  modules **du S1, S2, S3** ayant été associé à ce tag.
-* le label **4S** désigne une moyenne sur ce tag calculée sur l'**ensemble du
-  parcours allant du S1 au S4** (inclus) - donc plus précisément sur tous les
-  modules du programme ayant été associé à ce tag.
-
-#### Les coefficients de pondération
-
-Par défaut, les moyennes calculées sur les modules associés à un tag donné utilisent
-les coefficients de pondération des modules dans le programme DUT, ramenés au total des
-coefficients dans les semestres qui les concernent : partant d'un semestre \(i\), en notant :
-
-* \(m_{i,j}\) la note d'un étudiant à un module associé au tag dans le semestre
- \(i\) (\(j\) donnant donc le numéro du module au sein du semestre parmi les
- modules associés au tag),
-* \(c_{i,j}\) le coefficient du module \(m_{i,j}\) dans le programme de formation
-
-alors la moyenne \(M_i\) associée au tag pour le semestre \(i\) est calculée avec :
-
-$$
-M_i = \frac{ \sum_{j} c_{i,j} m_{i,j} }{ \sum_{j} c_{i,j} }
-$$
-
-En notant ensuite \(c_i\) la somme des coefficients des modules du semestre
-\(i\) associé au tag considéré (ici \(c_i = \sum_{j} c_{i,j}\)) et \(C_i\) la
-somme des coefficients de tous les modules (y compris ceux n'étant pas associés
-au tag considéré) du semestre \(i\) (donc \(C_i \geq c_i\)), la moyenne \(M\)
-associée au tag sur les 4 semestres de formation (donc de label **4S**) est
-calculée avec :
-
-$$ M = \frac{ \sum_{i} \frac{c_i}{C_i} M_i }{ \sum_{i}
-\frac{c_i}{C_i} } $$
-
-Plus simplement, le poids des modules associés au tag au
-sein d'un semestre est conservé dans le calcul de la moyenne.
-
-L'outil PE offre la possibilité de recoefficienter les modules associés au tag
-dans le calcul de la moyenne en leur joignant un (éventuel) coefficient de
-pondération supplémentaire entier \(p_{i,j}\) (voir section Les tags).
-
-Dans ce cas, la moyenne \(M_i\) associée au tag sur le semestre \(i\) est
-impactée avec :
-
-$$
-M_i = \frac{ \sum_{j} p_{i,j} c_{i,j} m_{i,j} }{ \sum_{j} p_{i, j} c_{i,j} }
-$$
-
-La somme des coefficients des modules dans le semestre \(c_i\) devient \(c_i =
-\sum_{j} p_{i,j} c_{i,j}\) mais la somme des coefficients de tous les modules
-\(C_i\) reste inchangée.
-
-Plus simplement, l'idée de cette pondération est de conserver le poids des
-modules au sein du semestre tout en accord plus d'importance
-(lorsque \(p_{i,j} > 1\)) à la note obtenue par l'étudiant.
-
-Le calcul des moyennes intra-semestres (1A, 2A ou 3S) est basée sur le même
-principe en n'utilisant que les semestres concernés.
-
-### Cas des étudiants redoublants
-
-Dans le cas des étudiants redoublants (par exemple ayant fait 2 semestres S1),
-ne sont conservés que les notes obtenues dans les UE validées par les décisions
-de jury : dans l'exemple, il s'agira (le plus souvent) des notes du S1 le plus
-récent, sauf pour un étudiant qui aurait capitalisé une UE et dont une partie
-des notes proviendrait de son UE capitalisée.
-
-## Les classements et les statistiques
-
-Les avis demandent souvent le classement associé à la moyenne obtenue sur un tag
-et pour un temps donné (label 1A, 2A, ...) avec l'ambiguïté de la cohorte
-considérée. Ce classement peut aller de pair avec des données statistiques
-(nombre d'étudiants, note minimum, maximum, moyenne sur la cohorte). L'outil PE
-propose deux cohortes et donc deux séries de classement/statistique par tag et
-label temporel.
-
-### La "cohorte" filière
-
-Est appelé filière l'ensemble des étudiants inscrits dans le même semestre
-temporel que le dernier impliqué dans la moyenne calculée. Prenons l'exemple
-d'une moyenne sur le tag mathématiques portant sur le label 3S (c'est à dire sur
-les semestres S1, S2, et S3). La filière sera l'ensemble des étudiants inscrits
-dans le S3. Dans ce S3, pourront se trouver des étudiants de différents parcours
-comme :
-
- * des étudiants "standards" avec S1 validé, S2 validé, S3 validé (du premier coup)
- * des étudiants redoublants avec (par exemple) un parcours de la forme S1
-   validé, S2 non validé, S3 non validé, S2 validé, S3 validé (dont étant entrés
-   à l'IUT un an avant les étudiants "standards").
-
-De fait, les notes prises en compte pour les étudiants standards et les
-étudiants redoublant pourront provenir de modules ne s'étant pas tenus aux même
-universitaires. Les seuls modules communs garantis seront ceux du S3 (aka le
-dernier semestre de l'ensemble S1+S2+S3).
-
-### La "cohorte" promo
+***
 
-Est appelé promo 20XX l'ensemble des étudiants susceptibles de valider leur
-diplôme DUT en date de juillet 20XX quelque soit le programme de formation DUT
-suivi.
+## Premiers pas
 
-Par exemple, la promo 2017 inclut les étudiants qui valideront leur S4 en
-juillet 2017 ; ceux ayant validé leur S4 en juillet 2016 appartiennent à la
-promo 2016. Parmi les étudiants de la promo 2017, on retrouve les étudiants
-"standards" étant entrés à l'IUT en septembre 2015 avec un parcours S1 validé,
-S2 validé, S3 validé et S4 validé. On retrouve également les étudiants entrés à
-l'IUT en septembre 2014 et ayant redoublé 1 à 2 semestres donc validant leur S4
-entre janvier et juillet 2017. Les étudiants ayant démissionnés ou s'étant
-réorientés (aka ne s'étant pas réinscrit dans un semestre DUT là où il aurait
-"du" le faire) sont exclus de la promo.
+<i class="fas fa-eye" style="color: teal"></i> Dans la suite, sera pris l'exemple du jury des poursuites d'études **2024**, qui traitera TOUS les étudiants qui termineront leur scolarité (généralement en juin) 2024 : vos diplômés de la **promotion 2024**. 
 
-Remarque: les calculs des étudiants de la promo fonctionnent à condition que les
-dates des semestres de début d'année universitaire s'étalent sur 2 années
-civiles (par exemple S1 de septembre 2016 à janvier 2017) et que les dates des
-semestres de fin d'année universitaire sont limitées à une année civile (par
-exemple S2 de janvier à juillet 2017).
+### Générer l'archive zip des documents standards
 
-### Les classements
+1. Editer n'importe lequel des semestres Scodoc dans lequel à étudier un étudiant de la promotion (quelque soit sa _modalité d'apprentissage_ ou son _parcours_). <i class="fas fa-eye" style="color: teal"></i> Par exemple, un semestre 5 2023-2024.
+2. Partant du semestre sélectionné, l'onglet `Statistiques` > `Documents Avis de Poursuite d'Etudes`.
+3. `Générer les documents` pour télécharger l'archive zip du jury. <i class="fas fa-eye" style="color: teal"></i> Dans notre exemple, <i class="fa-solid fa-file" style="color: orange"></i> `Jury_PE_2024.zip`
 
-Un élève au regard de sa moyenne à un tag, sur un laps de temps donné (label S1,
-1A, 3S, ...) est donc classé soit sur sa filière soit sur la promo. Les
-statistiques du groupe (que ce soit la filière ou la promo), plus précisément la
-note minimum, maximum et la moyenne du groupe sont également fournies.
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred; font-size: 200%"></i> L'outil PE n'analyse pas seulement les futurs diplômés ; il analyse également TOUS les étudiants que vos diplômés ont cotoyés dans leur scolarité, mais qui ont démissionné, abandonné, redoublé (cf. <i class="fa-solid fa-file" style="color: orange"></i>`Jury_PE_2024.zip` > `details/etudiants.xlsx`) car ils impactent les classements. De fait, <i class="fas fa-eye" style="color: teal"></i> pour un jury de semestre 5 :
+* si vous avez commencé à peupler des semestres 6, assurez-vous que tous vos diplômés y soient inscrits, au risque que l'outil les croit démissionnaires. 
+* si vous avez créé les semestres 6 mais sans étudiant inscrits, pas de souci !
 
-## L'export du tableur récapitulatif
+### Contenu de l'archive zip
 
-L'onglet PE renvoie une archive zip pour une promotion d'élèves diplômés en
-20XX, contenant notamment un fichier `Jury_PE_20XXjurySyntheseDict_20XX_v2.xlsx`.
+L'archive obtenue contient plusieurs tableurs :
 
-Ce fichier récapitule l'ensemble des moyennes, des classements et des
-statistiques des élèves dont le S4 sera (prévisiblement) validé en 20XX. Le
-fichier contient un onglet par tag saisi dans le programme. Par défaut, un tag est
-présent : le tag dut. En plus des données numériques, on retrouve pour chaque
-élève la liste des semestres parcourues (colonne P1 à P6).
+1. <i class="fa-solid fa-file" style="color: orange"></i> `synthese_jury_par_tag.xlsx` : résume les données du jury de votre promotion dans différents onglets :
+ 
+   * l'onglet `but` s'appuie sur des moyennes de semestre (cf. plus bas)
+   * plusieurs onglets nommés `comp. <titre_competence>` (dépendant des _parcours_ de votre formation) retraçent les moyennes/classements obtenues dans les différentes UE rattachées à la `competence`
 
-## Les avis PE au format LaTeX (non proposés en v2 BUT)
+   Il peut être utilisé pour :
 
-L'archive zip contient également un export des données de poursuites d'études de
-la promotion d'élèves au format LaTeX (fichier .tex) pour permettre (après
-compilation latex à faire sur votre machine) de générer des avis de poursuites
-d'études des étudiants "quasi prêts à l'emploi" (pour impression ou envoi par
-mail).
+   * préparer (en piochant) les moyennes/classements qui vous intéressent
+   * intégrer une solution de publipostage (non proposée par l'outil PE) pour générer les **fiches d'avis PE** à transmettre aux étudiants pour leur dossier de candidature
 
-## Arborescence LaTeX
+2. <i class="fa-solid fa-file" style="color: orange"></i> `synthese_jury_par_etudiants.xslx` : résume les données de chaque étudiant dans un onglet qui lui est propre. Il peut être utilisé pour communiquer/transmettre à l'étudiant ses moyennes/classements pour préparer ses dossiers
 
-Les sources latex (fournies ici dans le fichier zip exporté par ScoDoc)
-s'articulent autour de l'arborescence suivante :
+3. des tableurs dans `details` qui traduisent les différentes étapes de calcul faites par l'outil et sont plutôt destinés aux <i class="fa-solid fa-bullseye" style="color: violet"></i> développeurs
 
-```
-avis.tex                                    # Fichier principal point d'entrée du compilateur latex
-avis_poursuite.tex                          # Fichier permettant d'inclure les avis des étudiants et fourni par ScoDoc
-avis_poursuite_nom_prenom_identifiant.tex   # Avis de poursuite d'études d'un étudiant généré suivant le template
-avisPE.cls                                  # Classe LaTex pour paramètrant la mise en page du document
-README.txt                                  # Informations de configuration pour les administrateurs de ScoDoc
-logos                                       # Répertoire contenant les figures (375 x 256 où toutes autres proportions équivalentes)
-    + logo_header.png                       # Le logo de l'établissement à adapter à vos besoins
-    + logo_footer.png                       # Un second logo pour le pied de page
-modeles                                     # Répertoire contenant des macros pour la mise en forme latex
-    + un_avis.tex                           # Modèle pour la génération de avis_poursuite_nom_prenom_EID0000.tex
-    + parcourstimeline.tex                  # Ligne temporelle retraçant le parcours d'un étudiant
-    + un_footer.tex                         # Modèle pour le pied de page des avis PE
-```
+## Moyennes personnalisées : les tags¶
 
-La compilation pourra se lancer avec : `pdflatex avis.tex`
+Pour obtenir des **moyennes personnalisées** (par exemple moyenne en mathématiques, en anglais, en expression-communication, ...), l'outil s'appuie sur un système de **tags**. 
 
-## Template LaTeX
+> Les tags sont des _mots-clés_ (courts et sans caractères spéciaux) affectés à des modules (ressources ou SAEs) dans le `Programme de formation`. <i class="fa-solid fa-triangle-exclamation" style="color: darkred"></i> Ils ne peuvent pas être `but` ni `comp. <titre_competence>` (réservés par l'outil). 
 
-Les avis LaTeX sont générés à partir de deux *templates latex*, dont le contenu
-est fourni dans `modeles/un_avis.tex`` et `modeles/un_footer.tex`` de l'archive
-`avis.zip``.
+Tous les modules portant le même tag (<i class="fa-solid fa-triangle-exclamation" style="color: darkred"></i> à la casse et à l'accentuation) seront _intégrés_ ensemble dans le calcul de moyennes/classements pour ce tag. Elles apparaitront sous la forme d'un nouvel onglet dans <i class="fa-solid fa-file" style="color: orange"></i> `synthese_jury_par_etudiants.xslx`. 
 
-Ces templates sont livrés avec l'installation standard de ScoDoc.
+### Renseigner les tags
 
-Vous pouvez également copier leur contenu dans les paramètres de ScoDoc, onglet
-**Paramétrage > Template LaTeX des avis** pour le modèle un_avis.tex et onglet
-**Paramétrage > Code LaTeX en fin d'avis** pour le modèle un_footer.tex. Vous
-pourrez ainsi par la suite les modifier à votre guise en respectant le format
-décrit ci-dessous.
+Après avoir sélectionné un _programme de formation_ depuis le menu `Programmes` :
 
-## Signataire des avis de PE
+![Ajouter des tags](img/ajouter_tags.png)
 
-Le nom du signataire qui sera apposé sur les avis de poursuites d'études est à
-saisir dans les paramètres de ScoDoc, onglet **Paramétrage > Nom du responsable
-des poursuites d'études**.
+1. Cochez `Montrer les tags...`
+2. Renseigner pour chaque module le ou les tags souhaités (<i class="fa-solid fa-bullseye" style="color: violet"></i> ici 3 tags : réseaux, ressources, techniques )
 
+<i class="fa-solid fa-lightbulb" style="color: gold"></i> Le menu `Tagguer tous les modules par leur type (tag res, sae)` (après la description des ressources et des SAEs) permettant de tagguer automatiquement les ressources avec le tag `res` et les SAEs avec le tag `sae`. 
 
-## Les sources LaTeX fournis par l'outil PE
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred; font-size: 200%"></i> Si vos étudiants ont suivi plusieurs programmes de formation différents, tous leurs programmes doivent être taggués. 
 
-L'outil PE renvoie dans l'archive `Jury_PE_20XX.zip` de la promotion d'élèves
-diplômés en 20XX, où vous trouverez :
+### Paramètrer les coefficients des tags
 
- 1. un fichier par étudiant de la promotion. Ce fichier est nommé sous la forme `avis_poursuite_nom_prenom_identifiant.tex` ; il synthétise les résultats et les moyennes de l'étudiant au cours de sa scolarité DUT en suivant les *templates latex* un_avis.tex et un_footer.tex.
+Les tags peuvent faire mention d'un **coefficient** servant à la pondération des modules dans le calcul de la moyenne (cf. section coefficient). Le tag sera alors de la forme : `nom_du_tag:coeff_entier`.
 
- 2. un fichier `avis_poursuite.tex` qui liste tous les avis des étudiants à compiler (inclusion des fichiers latex de chaque étudiant).
+## Regroupements cohérents de semestre
 
 
-### Pour obtenir le document PDF
+Les moyennes (quelque soit le tag) peuvent être calculées sur plusieurs semestres appelés **regroupements cohérents de semestres** : moyenne en 1ère année, en 2ème année voire (pour le jury) sur l'ensemble des semestres (même redoublés) qu'a suivi un étudiant. 
 
-1. Ouvrez  l'archive zip renvoyée par ScoDoc dans votre *répertoire de travail*.
+> Un **regroupement cohérent de semestres** (RCS) est un ensemble de semestres suivis par les étudiants formant un tout cohérent pour calculer une moyenne sur plusieurs semestres. 
 
-2. Dans une invite de commande (cmd en Windows, terminal en linux) dont le répertoire courant est celui créé à l'ouverture de l'archive (commande `cd Jury_PE_...`), lancez la compilation des avis en exécutant la commande :
+Globalement, 3 types de regroupements cohérents de semestres sont fournis : 
 
-```
-pdflatex avis.tex
-```
+* Les RCS `Semestre <n>` (avec `<n>` le numéro du semestre parmi 1, 2, 3, 4, 5, 6) désignent la moyenne (pour chaque tag) calculée en utilisant les notes du (ou des) semestre `<n>`. 
 
-Le résultat est le classeur **avis.pdf**.
+* Les RCS `BUT<a>` (avec `<a>` le numéro de l'année parmi 1, 2, 3) désignent la moyenne calculée sur les deux semestres d'une même année `<a>`. 
 
-Cette compilation déclenche celle de `avis_poursuite.tex` qui elle-même lancera
-celle des avis par étudiants `avis_poursuite_nom_prenom_identifiant.tex` faisant
-partie de la promotion ciblée (on pourra commenter les avis des étudiants que
-l'on ne souhaite pas compiler en faisant débuter la ligne d'inclusion de leur
-avis dans `avis_poursuite.tex` d'un %).
+* Les RCS `Moyenne du semestre <ini> à <final>` désignent les moyennes calculées en utilisant toutes les notes du semestre <ini> au semestre <final>. Plus particulièrement :
 
-## Le rendu PDF du template proposé
+    * Le RCS `Moyenne du semestre 1 à 5` (intégrant les semestres S1+S2+S3+S4+S5) peut être utile pour une vue d'ensemble des résultats - sur 5 semestres - lors d'un jury se tenant au S5 pour des avis de poursuites d'études
 
-Le template proposé permet un résultat similaire à celui de la capture d'écran :
+    * Le RCS `Moyenne du semestre 1 à 3` (intégrant les semestres S1+S2+S3) peut être utile pour une vue d'ensemble des résultats - sur 3 semestres - lors d'un jury se tenant au S3 pour des avis de _réorientation_ (pour rester _politiquement correct_).
 
- * page1 : ![avis1.png](screens/avis1.png)
 
- * page2 : ![avis2.png](screens/avis2.png)
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred; font-size: 200%"></i> Dans le cas des étudiants redoublants, seront **systématiquement** pris en compte les notes des semestres redoublés : 
 
-En l'état, il fournit pour chaque étudiant :
 
- * son nom, son prénom, son âge;
- * une frise temporelle décrivant tous les semestres DUT dans lesquels il a été inscrit (avec la nomenclature que vous avez choisi dans ScoDoc);
- * un bilan synthétique de ses moyennes aux différents semestres (avec ses classements dans son groupe et dans sa promo - voir section "les classements et les statistiques" pour l'interprétation des cohortes);
- * une zone d'annotation permettant un commentaire individualisé, l'annotation étant recherchée parmi les annotations du profil ScoDoc de l'étudiant (cf. section "L'annotation PE").
+Le mode de calcul des moyennes de chaque regroupement cohérent de semestres dépend du regroupement et du tag (cf. décription à suivre).
 
-## L'annotation PE
 
-Lorsqu'on édite la fiche d'un étudiant, il est possible de saisir des annotations à son sujet. Ces annotations sont aussi utilisées ici pour saisir un commentaire individualisé à apposer sur l'avis de poursuites d'études au format LaTeX de l'étudiant. Pour distinguer ce commentaire des annotations plus standards, l'annotation doit débutée par un mot-clé (ici PE:) comme le montre la capture d'écran ci-dessous :
+Les données de ces regroupements cohérents de semestres sont fournis, en colonne, dans <i class="fa-solid fa-file" style="color: orange"></i> `synthese_jury_par_tag.xslx`. 
 
-   ![annotation_PE.png](screens/annotation_PE.png)
+![Regroupements cohérents de semestre](img/regroupement_coherent_semestre.png)
 
-Cette annotation sera alors automatiquement ajoutée à l'avis LaTeX de l'étudiant (cf. `avis_poursuite_nom_prenom_identifiant.tex`).
+## Mode de calcul des moyennes
 
-L'annotation peut bien entendue être remodifiée (ou ajoutée si manquante) à la main dans le fichier `avis_poursuite_nom_prenom_identifiant.tex` avant compilation en pdf.
+Les moyennes de poursuites d'études (contrairement aux moyennes d'UE ou de regroupement cohérent d'UE) ne sont pas règlementées par l'arrêté du BUT. Leur mode de calcul (décrit ci-dessous) a été choisi pour **comparer les étudiants**, sachant la diversité des parcours, la complexité et les contraintes des coefficients du programme, en étant le plus cohérent possible.  
 
-Plusieurs annotations ayant trait à un commentaire PE peuvent également être mémorisées dans ScoDoc (à condition de les faire toutes précéder du tag "PE:"). Dans ce cas, seule la plus récente sera ajoutée à l'avis LaTeX de l'étudiant.
+> <i class="fa-solid fa-triangle-exclamation" style="color: darkred; font-size: 200%"></i> Dans le cas des étudiants redoublants, seront **systématiquement** pris en compte les notes de tous ses semestres y compris redoublés. L'outil ne se focalise pas sur les _meilleures notes_ mais sur la _moyenne_. 
+> 
+> <i class="fa-solid fa-comment" style="color: darkgreen"></i> Ce choix trouve un équilibre entre _pénaliser_ un étudiant en situation de redoublement par rapport à un autre ayant réussi _du premier coup_ et permettre à l'étudiant redoublant d'améliorer sa moyenne.
 
-Enfin, il est possible de modifier le tag (ici "PE:") identifiant les commentaires PE dans les annotations en allant dans l'onglet **Paramètrage > Tag désignant l'avis PE** et en y saisissant votre tag (éviter les caractères spéciaux propres au HTML, comme le ">").
+### Moyennes des RCS `Semestre <n>`
 
-## Personnaliser son template
+Rappelons que les RCS `Semestre <n>` (avec `<n>` le numéro du semestre parmi 1, 2, 3, 4, 5, 6) désignent la moyenne (pour chaque tag) calculée en utilisant les notes du (ou des) semestre `<n>`. <i class="fas fa-eye" style="color: teal"></i> Par exemple, `Semestre 1` désigne la moyenne obtenue en partant de toutes les notes du S1.
 
-### Les patterns de base
+#### Moyenne `comp. <titre_competence>` au RCS `Semestre <n>`
 
-Les templates d'avis (un_avis et un_footer) sont des codes LaTeX classiques que
-vous pouvez adaptez à loisir à vos besoins.
+La moyenne des tags (automatiques) `comp. <titre_competence>` (déduit de votre référentiel de compétaire) pour un `Semestre <n>` est une recopie de la moyenne de l'UE associée à la compétence (utilisant les modules et leurs coefficients du programme pédagogique).
 
-Ils interprètent également une série de **patterns**, reconnaissables au fait
-qu'elles sont toutes encapsulées par deux séries de doubles * ; ces patterns
-sont traitées par ScoDoc pour accéder aux données de l'étudiant. Ainsi:
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred"></i> Dans le cas des étudiants redoublants est fourni la moyenne des UEs des deux semestres qu'il a suivis (souvent l'une validée l'autre non) : par exemple, pour le `Semestre 1` :  $moy_ue_au_semestre1 = (moy_ue_semestre1_non_valide + moy_ue_semestre1_valide)/2$
 
- * `**nom**` sera remplacé par le nom de l'étudiant
- * `**prenom**` par le prénom
- * `**age**` par son age (à la date de création des fichiers tex)
- * `**sexe**` par son genre
+#### Moyenne `but` au RCS `Semestre <n>`
 
-Plusieurs **patterns/macros** sont proposées :
+La moyenne du tag (automatique) `but` pour un `Semestre <n>` est similaire à la moyenne de semestre donnée à titre indicatif par Scodoc dans les notes/jury du semestre. Elle utilise tous les modules, leurs coefficients par UE définis dans le programme pédagogique pour calculer les moyennes par UE. Puis elle fournit une moyenne pondérée des UEs en utilisant les crédits ECTS associés à chaque UE. Pour faire court : 
 
- * `**parcourstimeline**` ajoute le code LaTeX pour retracer le parcours de
-   l'étudiant (les différents semestres dans lesquels il a été inscrit) sous la
-   forme d'une frise temporelle (cf. capture d'écran précédente)
- * `**bilanParTag**` ajoute le code LaTeX d'un tableau, qui synthétise - pour tous les tags (sauf le tag *dut*) que vous avez affecté aux semestres de l'étudiant (cf. section Les tags) ses résultats aux différents aggrégats proposés (S1, S2, S3, S4, 1ère année, 2ème année, S1+S2+S3 et totalité du DUT)
+$$moy_but_au_semestre = (UE1 x ects1 + UE2 x ects2 + ...)/(ects1 + ects2 + ...)$$
 
-### Les patterns personnalisées
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred"></i> Dans le cas des étudiants redoublants est fourni la moyenne aux deux semestres qu'il a suivi (souvent l'un validé l'autre non) : par exemple, pour le `Semestre 1` :  $moy_but_au_semestre1 = (moy_but_au_semestre1_non_valide + moy_but_au_semestre1_valide)/2$
 
-Tous les éléments calculés pour le jury de poursuite d'études sont également
-accessibles sous la forme *aggregat:cohorte:tag:critere** où :
+#### Moyenne des tags personnalisés au RCS `Semestre <n>`
 
- * aggregat est l'un des aggrégats parmi S1, S2, S3, S4, 1A, 2A, 3S ou 4S;
- * cohorte est soit groupe soit promo (suivant la "cohorte" que l'on souhaite
-   prendre en compte);
- * tag est l'un des tags que vous avez déclarés dans ScoDoc (dut étant proposé par défaut);
- * critere est l'un des calculs faits pour établir le jury parmi note (la note
-   de l'étudiant), rang (le rang dans la cohorte), min, max, moy (le minimum, le
-   maximum ou la moyenne de la cohorte).
+Pour les moyennes aux tags que vous avez ajoutés dans le programme de formation, le calcul est similaire à celle de la moyenne `but` en n'utilisant cette fois que les modules qui portent le tag visé. 
 
-Par exemple,
+<i class="fas fa-eye" style="color: teal"></i> Par exemple, si le semestre 1 a deux modules d'anglais taggué `anglais`, est calculé : la moyenne dans chaque UE avec les notes des modules d'anglais pondérés par leur coefficients (coefficients du programme + coefficients d'évaluation dirigeant les notes vers une UE ou une autre). Les moyennes dans chaque UE sont ensuite intégrée dans une moyenne globale en utilisant les crédits ECTS : 
 
- * **S2:groupe:mathématiques:note** sera remplacé par la note-moyenne de
-   l'étudiant en mathématiques pour le S2;
- * **4S:promo:dut:rang** sera remplacé par le rang de l'étudiant, calculé au
-   sein de la promo, sur sa note moyenne de DUT (moyenne calculée sur les 4
-   semestres S1+S2+S3+S4);
- * **1A:promo:physique:min** sera remplacé par la plus petite note de la promo
-   obtenue en physique (moyenne de tous les modules tagués physique) sur toute
-   la 1ère année (S1+S2).
+$$moy_anglais_au_semestre = (UE1_anglais x ects1 + UE2_anglais x ects2 + ...)/(ects1 + ects2 + ...)$$
+
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred"></i> Il vous est possible (via la déclaration du tag de la forme `nom_tag:coefficient_entier`) d'ajouter une **pondération supplémentaire** qui s'ajoute (par multiplication) aux coefficients du programme des modules taggués. 
+
+### Moyennes des RCS `BUT<a>`
+
+Les RCS `BUT<a>` (avec `<a>` le numéro de l'année parmi 1, 2, 3) regroupent deux semestres d'une même année `<a>` : par exemple, `BUT1` regroupent le `Semestre 1` et le `Semestre 2`.
+
+Quelque soit le tag (`comp. <titre_compétence>`, `but` ou personnalisés), les moyennes _annuelles_ calculées ici s'appuient sur les moyennes des deux semestres regroupés (dont le mode de calcul est décrit au dessus) et fournissent la moyenne des deux semestres avec équipndération. 
+
+<i class="fas fa-eye" style="color: teal"></i> Par exemple, pour l'anglais et le RCS `BUT1`
+$moy_anglais_BUT1 = (moy_anglais_S1 + moy_anglais_S2)/2$ (où `moy_anglais_S1` désigne la moyenne d'anglais du RCS `Semestre 1` et `moy_anglais_S2` du RCS `Semestre 2`).
+
+### Moyennes des RCS `Moyenne du semestre <ini> à <fin>`
+
+Le principe est le même que les moyennes des RCS `BUT<a>` mais en considérant tous les semestres allant du semestre `<ini>` au semestre `<fin>` et en moyennant les résultats semestre par semestre avec équipondération. 
+
+<i class="fas fa-eye" style="color: teal"></i> Par exemple, pour l'anglais et le RCS `Moyenne du semestre <ini> à <fin>` :
+$moy_anglais = (moy_anglais_S1 + moy_anglais_S2 + moy_anglais_S3 + moy_anglais_S4 + moy_anglais_S5)/5$
+
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred"></i> Si un semestre n'a pas de modules associé au tag visé, il n'est pas pris en compte. 
+
+<i class="fas fa-eye" style="color: teal"></i> Par exemple, pour l'anglais et le RCS `Moyenne du semestre <ini> à <fin>` mais pour lequel il n'y a pas de notes au S4 :
+$moy_anglais = (moy_anglais_S1 + moy_anglais_S2 + moy_anglais_S3 + moy_anglais_S5)/4$
+
+## Classements et statistiques¶
+
+Les moyennes (pour chaque tag et chaque RCs) sont généralement associée à des **classements** et à des statistiques (note **minimum**, note **moyenne**, note **maximum**) qui dépendent de la **cohorte** considérée. 
+
+### Cohortes de classement
+
+L'outil PE propose plusieurs cohortes pour ces classements et ces statistiques.
+
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred; font-size:200%"></i> L'outil PE ne fonctionne que si :
+
+* les dates des semestres de début d'année universitaires (généralement des semestres impairs) s'étalent sur 2 années civiles (par exemple S1 de septembre 2021 à janvier 2022) 
+* les dates des semestres de fin d'année universitaire (généralement des semestres pairs) sont limitées à une année civile (par exemple S2 de janvier à juillet 2022).
+
+#### La cohorte `groupe¶`
+
+> La cohorte `groupe` est l'ensemble des étudiants inscrits dans le même semestre que le dernier impliqué dans la moyenne calculée. 
+
+<i class="fas fa-eye" style="color: teal"></i> Par exemple, pour le tag `maths` portant sur le RCS `Moyenne du semestre 1 à 3` c'est-à-dire sur les semestres S1, S2, et pour finir S3, le groupe est constitué des élèves ayant tous été inscrits au S3 final. Dans ce groupe, il peut y avoir des redoublants qui débuté un an plus tôt et ont fait un S1+S2+S1+S2 avant d'atteindre ce S3.
+
+De fait, les notes prises en compte pour les moyennes pourront provenir de modules ne s'étant pas tenus aux même universitaires. 
+
+#### La cohorte `promo`
+
+> La cohorte `promo 20XX` est l'ensemble des étudiants susceptibles de valider leur diplôme BUT à l'année `20XX` indépendamment de leur parcours (en supposant qu'ils ne redoublent plus).
+
+<i class="fas fa-eye" style="color: teal"></i> Par exemple, si votre département propose un _parcours A_ et un _parcours B_, la promo 2024 inclut les étudiants qui valideront leur S6 en juillet 2024 (voire en décembre 2024 en cas de semestres décalés). 
+
+<i class="fas fa-eye" style="color: teal"></i> Autre exemple, la promo 2025 : parmi les étudiants de la promo 2025, on retrouve les étudiants "standards" étant entrés à l'IUT en septembre 2022 avec un parcours sans redoublement. On retrouve également les étudiants entrés à l'IUT en septembre 2021 et ayant redoublé 2 semestres (de BUT1 ou de BUT2). Les étudiants ayant démissionnés ou s'étant réorientés (aka ne s'étant pas réinscrit dans un semestre BUT là où il aurait "du" le faire) sont exclus de la promo. (cf. tableur <i class="fa-solid fa-file" style="color: orange"></i> `Jury_PE_2024.zip > details/etudiants_20XX.xlsx`)
+
+#### La cohorte `parcours` (à venir)
+
+> La cohorte `parcours 20XX` est l'ensemble des étudiants susceptibles de valider leur diplôme BUT à l'année `20XX` et ayant suivi le même parcours (du référentiel de compétences).
+
+### Classements par cohorte
+
+<i class="fa-solid fa-triangle-exclamation" style="color: darkred; font-size:200%"></i> Dans une même cohorte et pour certains tags (notamment ceux des `comp. <titre_compétence>`), les étudiants peuvent avoir suivi des modules différents (par exemple parce qu'ils sont prévu dans le parcours A mais pas dans le parcours B). Les classements dans la cohorte sont donc systématiquement ramenés au nombre d'étudiants inscrits dans les modules raccrochés au tag visé.
+
+### Statistiques par cohorte
+
+Pour chaque cohorte et chaque tag (considérant les inscrits aux modules rattachés aux tags) des statistiques sont fournies : 
+
+* `min` la plus petite note (moyenne du tag) obtenu par les étudiants de la cohorte
+* `max` la plus grande note (moyenne du tag) obtenu par les étudiants de la cohorte
+* `moy` la moyenne des notes (au tag) de la cohorte