API etudiant/create,edit

docs/GuideInstallDebian11Advanced.md

@@ -1,4 +1,4 @@
-#  Configuration manuelle de ScoDoc sur Debian 11 (Bullseye) 
+# Configuration manuelle de ScoDoc sur Debian 11 (Bullseye)
 
 Instructions pour utilisateurs ne souhaitant pas utiliser le script
 

docs/ScoDoc9API.md

@@ -310,6 +310,8 @@ Ce tableau est trié selon le type des informations renvoyées:
 | etudiant**`*`**         |                                         | GET     | [group-etudiants-query](#group-etudiants)                                 | ScoView             |
 | etudiant**`*`**         |                                         | GET     | [group-etudiants-query](#group-etudiants-query)                           |
 | etudiant                |                                         | GET     | [etudiant](#etudiant)                                                     | ScoView             |
+| etudiant:CREATE         |                                         | GET     | [etudiant-create](#etudiant-create)                                       | ScoEtudInscrit      |
+| etudiant:EDIT           |                                         | GET     | [etudiant-edit](#etudiant-edit)                                          | ScoEtudInscrit      |
 | bulletin**`*`**         |                                         | GET     | [formsemestre-bulletin](#formsemestre-bulletin)                           | ScoView             |
 | bulletin                |                                         | GET     | [etudiant-formsemestre-bulletin](#etudiant-formsemestre-bulletin)         | ScoView             |
 | programme               |                                         | GET     | [formsemestre-programme](#formsemestre-programme)                         | ScoView             |
@@ -524,6 +526,87 @@ Pour uniformiser les résultats des exemples, ceux sont soumis à quelques post-
 * **Note:** Cette fonction est utilisée pour la complétion des champs de formulaire
   (choix d'un étudiant).
 
+#### **`etudiant-create`**
+
+* **Méthode: POST**
+* **Permission: `ScoEtudInscrit`**
+* **Paramètres:** ``
+* **Data:**
+
+```json
+  {
+    "boursier" : <bool>,
+    "civilite" : <string>, // M, F, X
+    "civilite_etat_civil" : <string>,
+    "code_ine" : <string>,
+    "code_nip" : <string>,
+    "date_naissance" : <string>, // format ISO
+    "dept" : <string>, // acronyme du département
+    "dept_naissance" : <string>,
+    "lieu_naissance" : <string>,
+    "nationalite" : <string>,
+    "nom" : <string>,  // requis
+    "nom_usuel" : <string>,
+    "prenom" : <string>,
+    "prenom_etat_civil" : <string>,
+
+    // Données concernant l'admission (avant son cursus ScoDoc)
+    "admission" : {
+      "annee" : <string>,
+      "bac" : <string>,
+      "specialite" : <string>,
+      "annee_bac" : <string>,
+      "math" : <string>,
+      "physique" : <string>,
+      "anglais" : <string>,
+      "francais" : <string>,
+      // Rang dans les voeux du candidat (non connu avec Parcoursup)
+      "rang" : <int>,
+      // Qualité et décision du jury d'admission (ou de l'examinateur)
+      "qualite" : <float>, // mesure arbitraire local
+      "rapporteur":<string>, // chaine libre
+      "decision":<string>,// chaine libre
+      "score":<float>, // score arbitraire local
+      "commentaire":<string>,
+      // Lycée d'origine:
+      "nomlycee" : <string>,
+      "villelycee" : <string>,
+      "codepostallycee" : <string>,
+      "codelycee" : <string>,
+    },
+
+    "adresses" : [ // liste mais seule la première est utilisée !
+      {
+        "email" : <string>, // email universitaire en général
+        "emailperso" : <string>, // email personnel (exterieur)
+        "domicile" : <string>,
+        "codepostaldomicile" : <string>,
+        "villedomicile" : <string>,
+        "paysdomicile" : <string>,
+        "telephone" : <string>,
+        "telephonemobile" : <string>,
+        "description" : <string>,
+      }
+    ]
+  }
+```
+
+* **Routes:** `/etudiant/create`, `/etudiant/create/force`
+* **Exemple d'utilisation:** `/etudiant/create`
+* **Résultat:** Crée un étudiant dans le département indiqué.
+
+
+#### **`etudiant-edit`**
+
+* **Méthode: POST**
+* **Permission: `ScoEtudInscrit`**
+* **Paramètres:** ``
+* **Data:** exactement comme `etudiant/create`, seuls les données passées sont modifiées.
+* **Routes:** `/etudiant/edit.
+* **Résultat:** Modifie les données de l'étudiant.
+
+
+
 #### **departement-etudiants**
 
 * **Méthode:** GET

docs/index.md

@@ -1,6 +1,5 @@
 # ScoDoc: un logiciel libre pour le suivi de la scolarité
 
-
 ScoDoc est un logiciel libre créé par Emmanuel Viennet pour suivre la scolarité
 des étudiants universitaires. Il est principalement utilisé dans les IUT, mais
 aussi apprécié par plusieurs Écoles et Masters en France et à l'étranger. Il
@@ -49,7 +48,7 @@ retourner à `Emmanuel.Viennet at gmail.com`.
 
 ## Actualités
 
-### Parution de ScoDoc 9.6.x pour Debian 12
+### Septembre 2023: parution de ScoDoc 9.6.x pour Debian 12
 
 **9.6.x** est la version en production de ScoDoc. Y sont régulièrement intégrées
 des améliorations et de nouvelles fonctionnalités. Elle inclue notamment le
@@ -81,14 +80,13 @@ gestion du *[Bachelor Universitaire de Technologie (BUT)](BUT.md)*.
 
 ### Contrats d'apprentissage
 
-Depuis 2021, plusieurs étudiants ont été recrutés (BUT R&T Lannion, LP IUT
+Depuis 2021, de nombreux étudiants ont été recrutés par l'association (BUT R&T
-Orléans, LP IUT Villetaneuse):
+Lannion, LP IUT Orléans, LP IUT Villetaneuse, BUT Informatique Lannion):
 
- - développement d'une nouvelle API pour ScoDoc 9 (mise en service en juillet 2022);
+- développement d'une nouvelle API pour ScoDoc 9 (mise en service en juillet 2022);
- - développement d'un nouveau module de gestion des relations entreprises:
+- développement d'un nouveau module de gestion des relations entreprises:
    fichier, contacts, stages, alternance (publiée en août 2022);
- - refonte du module de gestion des absences (en cours en 2022-2023).
+- refonte du module de gestion des absences (en cours en 2022-2023, puis 2023-2024).
-
 
 ### Stagiaires