API etudiant/create,edit

This commit is contained in:
Emmanuel Viennet 2023-11-23 17:43:44 +01:00
parent 3a9d58f9e0
commit 6976a485b2
3 changed files with 93 additions and 12 deletions

View File

@ -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
@ -8,7 +8,7 @@ Toutes les opérations décrites sur cette page sont effectuées par ce script.
Cette page est donc destinée aux curieux et futurs développeurs. Se référer au
script lui même pour les détails.
## Activation du firewall
## Activation du firewall
(optionnel, recommandé)

View File

@ -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

View File

@ -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,11 +48,11 @@ 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
nouveau système de gestion des absences ("assiduités"), beaucoup plus riche que
nouveau système de gestion des absences ("assiduités"), beaucoup plus riche que
l'ancien.
**Il est conseillé de migrer au plus vite**: voir [la procédure de mise à
@ -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
Orléans, LP IUT Villetaneuse):
- 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:
fichier, contacts, stages, alternance (publiée en août 2022);
- refonte du module de gestion des absences (en cours en 2022-2023).
Depuis 2021, de nombreux étudiants ont été recrutés par l'association (BUT R&T
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'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, puis 2023-2024).
### Stagiaires