Reformatte doc PE + typos

docs/AvisPoursuiteEtudes.md

@@ -1,345 +1,398 @@
-# Jury et avis de Poursuites d'Etudes
+# Jury de Poursuites d'Etudes BUT
 
-**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">
+
+
+<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 documents en LaTeX ne sont plus générés dans la nouvelle version: seul un
-classeur excel est calculé.*
+## Cadre d'usage et nomenclature
 
-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.
+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.
 
-## Les tags
+Les étudiants considérés sont ceux d'une **promotion** :
+
+> 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 avis émis s'appuient sur différents critères (**notes moyennes/classements**) obtenus :
+
+* 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 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...
+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.
 
-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.
+> 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.
 
-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.
+***
 
-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`.
+## Premiers pas
 
-Un tag *dut* reprenant la moyenne de l'étudiant à chaque semestre est
-automatiquement ajouté.
+<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**.
 
-![programmeRTtaggue.png](screens/programmeRTtaggue.png)
+### Générer l'archive zip des documents standards
 
-## Les moyennes
-
-### Les moyennes intra et inter semestres
+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`
 
-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,
+<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 !
 
-* 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
+### Contenu de l'archive zip
 
-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.
+L'archive obtenue contient plusieurs tableurs :
 
-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.
+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 :
 
-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).
+   * 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) retracent les moyennes/classements obtenues
+     dans les différentes UE rattachées à la `competence`
 
-### Les classements
+   Il peut être utilisé pour :
 
-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.
+   * 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
 
-## L'export du tableur récapitulatif
+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
 
-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`.
+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
 
-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).
+## Moyennes personnalisées : les tags¶
 
-## Les avis PE au format LaTeX (non proposés en v2 BUT)
+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**.
 
-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).
+> 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).
 
-## Arborescence LaTeX
+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`.
 
-Les sources latex (fournies ici dans le fichier zip exporté par ScoDoc)
-s'articulent autour de l'arborescence suivante :
+### Renseigner les tags
 
-```
-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
-```
+Après avoir sélectionné un _programme de formation_ depuis le menu `Programmes` :
 
-La compilation pourra se lancer avec : `pdflatex avis.tex`
+![Ajouter des tags](img/ajouter_tags.png)
 
-## Template LaTeX
+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 )
 
-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``.
+<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`.
 
-Ces templates sont livrés avec l'installation standard de ScoDoc.
+<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.
 
-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.
+### Paramètrer les coefficients des tags
 
-## Signataire des avis de PE
+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`.
 
-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**.
+## Regroupements cohérents de semestre
 
 
-## Les sources LaTeX fournis par l'outil PE
+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.
 
-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 :
+> 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.
 
- 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.
+Globalement, 3 types de regroupements cohérents de semestres sont fournis :
 
- 2. un fichier `avis_poursuite.tex` qui liste tous les avis des étudiants à compiler (inclusion des fichiers latex de chaque étudiant).
+* 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>`.
 
+* 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>`.
 
-### Pour obtenir le document PDF
+* 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:
 
-1. Ouvrez  l'archive zip renvoyée par ScoDoc dans votre *répertoire de travail*.
+    * 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
 
-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 :
+    * 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_).
 
-```
-pdflatex avis.tex
-```
 
-Le résultat est le classeur **avis.pdf**.
+<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 :
 
-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 %).
 
-## Le rendu PDF du template proposé
+Le mode de calcul des moyennes de chaque regroupement cohérent de semestres
+dépend du regroupement et du tag (cf. décription à suivre).
 
-Le template proposé permet un résultat similaire à celui de la capture d'écran :
 
- * page1 : ![avis1.png](screens/avis1.png)
+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`.
 
- * page2 : ![avis2.png](screens/avis2.png)
+![Regroupements cohérents de semestre](img/regroupement_coherent_semestre.png)
 
-En l'état, il fournit pour chaque étudiant :
+## Mode de calcul des moyennes
 
- * 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").
+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.
 
-## L'annotation PE
+> <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.
 
-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 :
+### Moyennes des RCS `Semestre <n>`
 
-   ![annotation_PE.png](screens/annotation_PE.png)
+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.
 
-Cette annotation sera alors automatiquement ajoutée à l'avis LaTeX de l'étudiant (cf. `avis_poursuite_nom_prenom_identifiant.tex`).
+#### Moyenne `comp. <titre_competence>` au RCS `Semestre <n>`
 
-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.
+La moyenne des tags (automatiques) `comp. <titre_competence>` (déduit de votre
+référentiel de compétence) 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).
 
-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"></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` :
 
-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 ">").
+$$moy\_ue\_au\_semestre1 = (moy\_ue\_semestre1\_non\_valide + moy\_ue\_semestre1\_valide)/2$$
 
-## Personnaliser son template
+#### Moyenne `but` au RCS `Semestre <n>`
 
-### Les patterns de base
+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 :
 
-Les templates d'avis (un_avis et un_footer) sont des codes LaTeX classiques que
-vous pouvez adaptez à loisir à vos besoins.
+$$moy\_but\_au\_semestre = (UE1 \times ects1 + UE2 \times ects2 + ...)/(ects1 + ects2 + ...)$$
 
-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 aux deux semestres qu'il a
+suivi (souvent l'un validé l'autre non) : par exemple, pour le `Semestre 1` :
 
- * `**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
+$$moy\_but\_au\_semestre1 = (moy\_but\_au\_semestre1\_non\_valide + moy\_but\_au\_semestre1\_valide)/2$$
 
-Plusieurs **patterns/macros** sont proposées :
+#### Moyenne des tags personnalisés au RCS `Semestre <n>`
 
- * `**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)
+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é.
 
-### Les patterns personnalisées
+<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 :
 
-Tous les éléments calculés pour le jury de poursuite d'études sont également
-accessibles sous la forme *aggregat:cohorte:tag:critere** où :
+$$moy\_anglais\_au\_semestre = (UE1\_anglais \times ects1 + UE2\_anglais \times ects2 + ...)/(ects1 + ects2 + ...)$$
 
- * 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).
+<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.
 
-Par exemple,
+### Moyennes des RCS `BUT<a>`
 
- * **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).
+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 équipondé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