Evaluations bonus

docs/CalculNotes.md

@@ -26,13 +26,13 @@ Plus de détails ci-dessous.
 
 Chaque évaluation produit des notes de différents types:
 
-* note numérique (positive ou nulle): sera normalisée entre 0 et 20
+- note numérique (positive ou nulle): sera normalisée entre 0 et 20
 
-* note absente: considérée comme zéro
+- note absente: considérée comme zéro
 
-* note en attente: non prise en compte
+- note en attente: non prise en compte
 
-* note excusée: non pris en compte
+- note excusée: non pris en compte
 
 Chaque étudiant a donc un nombre variable de notes à prendre en compte dans
 chaque module. Chaque note est associée à un coefficient: le coefficient de
@@ -115,6 +115,23 @@ Lors de la création (ou modification) de l'évaluation, indiquer le type
 Pour chaque étudiant, la note obtenue à l'évaluation de rattrapage remplace la
 moyenne du module, seulement si elle est supérieure à celle-ci.
 
+## Notes de deuxième session
+
+Les notes de l'évaluation de "deuxième session" remplacent, lorsqu'elles sont
+saisies, la moyenne de l'étudiant à ce module, même si la note de deuxième
+session est plus faible.
+
+## Évaluation bonus
+
+On peut aussi définir dans chaque module des évaluations "bonus":
+
+- la valeur est ajoutée à la moyenne du module;</li>
+- le bonus peut être négatif (malus);
+- le bonus ne s'applique pas aux notes de rattrapage et deuxième session;
+- le coefficient est ignoré, mais en BUT le bonus vers une UE est multiplié par
+  le poids correspondant (par défaut égal à 1);
+- les notes de bonus sont prises en compte même si incomplètes.
+
 ## Bonus sport/culture
 
 Ce bonus s'applique directement sur la **moyenne générale** et/ou sur les
@@ -132,7 +149,7 @@ suivre des enseignements optionnels de l'U.H.A.  (sports, musique, deuxième
 langue, culture, etc) non rattachés à une unité d'enseignement. Les points
 au-dessus de 10 sur 20 obtenus dans chacune des matières optionnelles sont
 cumulés dans la limite de 10 points. 5% de ces points cumulés s'ajoutent à la
-moyenne générale du semestre déjà obtenue par l'étudiant.* 
+moyenne générale du semestre déjà obtenue par l'étudiant.*
 
 L'administrateur peut changer la fonction de calcul du bonus sport via le
 formulaire de configuration accessible (aux admin) depuis la page d'accueil. Si
@@ -160,7 +177,7 @@ Pour valider une RCUE, on vérifie que moy_rcue > sco_codes.BUT_RCUE_SUFFISANT
 
 où est défini comme BUT_RCUE_SUFFISANT = 8.0 - NOTES_TOLERANCE.
 
-avec 
+avec
 NOTES_TOLERANCE = 0.00499999999999
 ```
 

docs/ScoDoc9API.md

@@ -723,7 +723,7 @@ Sur l'application, elles sont affichées et modifiables sur la fiche de l'étudi
 | date_debut                  | datetime (iso)                                 | date et heure de début (tous groupes)             |
 | date_fin                    | datetime (iso)                                 | date et heure de fin (tous groupes)               |
 | description                 | string                                         | texte libre                                       |
-| evaluation_type             | int                                            | 0 normale, 1 rattrapage, 2 "2eme session"         |
+| evaluation_type             | int                                            | 0 normale, 1 rattrapage, 2 "2eme session", 3 "bonus"         |
 | moduleimpl_id               | int                                            | moduleimpl                                        |
 | note_max                    | float                                          | barème (20 points)                                |
 | numero                      | int                                            | ordre présentation                                |