From ab649db42980235deac607a1f1595fbabac354ae Mon Sep 17 00:00:00 2001
From: viennet <emmanuel.viennet@gmail.com>
Date: Fri, 4 Oct 2024 08:49:36 +0200
Subject: [PATCH] API: decisions_jury

---
 docs/ScoDoc9API.md | 61 +++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 60 insertions(+), 1 deletion(-)

diff --git a/docs/ScoDoc9API.md b/docs/ScoDoc9API.md
index f2199fcc4..749846e96 100644
--- a/docs/ScoDoc9API.md
+++ b/docs/ScoDoc9API.md
@@ -1477,7 +1477,8 @@ Pour uniformiser les résultats des exemples, ceux sont soumis à quelques post-
     * `ine ou nip` : code d'un étudiant: ramène alors tous les semestres auxquels il est inscrit.
     * `etat` : 0 si verrouillé, 1 sinon
 * **Description:** Retourne les formsemestres filtrés par étape Apogée ou année scolaire
-    ou département (acronyme ou id) ou état ou code étudiant.
+    ou département (acronyme ou id) ou état ou code étudiant. Si
+    `annee_scolaire`, ne sélectionne que les formsemestres de cette année scolaire.
 
 
 
@@ -1686,6 +1687,64 @@ Pour uniformiser les résultats des exemples, ceux sont soumis à quelques post-
 * **Permission:** `ScoView`
 * **Description:** Décisions du jury des étudiants du formsemestre.
 
+Exemple abrégé de résultat pour un semestre BUT S1:
+
+```json
+[
+  {
+    "etudid": 16375,
+    "code_nip": "16375",
+    "code_ine": null,
+    "is_apc": true,
+    "etat": "I",
+    "nb_competences": 3,
+    "rcues": [
+      {
+        "ue_1": {
+          "ue_id": 1896,
+          "moy": 10.317715802881702,
+          "code": "ADM"
+        },
+        "ue_2": {
+          "ue_id": 2458,
+          "moy": 11.11946734181982,
+          "code": "ADM"
+        },
+        "moy": 10.71859157235076,
+        "code": "ADM"
+      },
+      ...
+    ],
+    "ues": [
+      {
+        "ue_id": 1896,
+        "code": "ADM",
+        "ects": 11.0
+      },
+      ...
+    ],
+    "semestre": {},
+    "annee": {
+      "code": "ADM",
+      "ordre": 1,
+      "annee_scolaire": 2022
+    },
+    "autorisations": [
+      {
+        "etudid": 16375,
+        "id": 35998,
+        "origin_formsemestre_id": 1105,
+        "formation_code": "VRET",
+        "semestre_id": 2,
+        "date": "2024-03-22T19:33:36.868001+01:00"
+      }
+    ]
+  },
+  ...
+]
+```
+
+
 * **Exemple de résultat:** [decisions_jury.json](./samples/sample_decisions_jury.json.md)