mise a jour de la cart (entree referentiel_competance)

complement de la doc (departement, formsemestres ok, etudiants à verifier, partition, groupes à faire, ...)
This commit is contained in:
Jean-Marie PLACE 2022-07-25 16:58:14 +02:00
parent 62f5e261ce
commit 66e5d75c41
5 changed files with 1376 additions and 1152 deletions

View File

@ -133,7 +133,7 @@ systèmes, voir plus haut pour la ême chose avec la commande `http`):
`SERVEUR` est l'adresse (IP ou nom) de votre serveur.
La réponse doit ressembler à ceci:
```
```json
{
"token": "LuXXxk+i74TXYZZl8MulgbiCGmVHXXX"
}
@ -163,39 +163,24 @@ par le serveur ScoDoc.
## Départements
#### **`departements`**
* **Méthode:** GET
* **Routes:** `/departements`
* **Exemple d'utilisation:** `/api/departements`
* **Résultat:** Liste des tous les départements (visibles ou non).
* **Exemple de résultat:**
```
[
{ un département }
...
]
```
#### **`departements_ids`**
* **Méthode:** GET
* **Routes:** `/departements_ids`
* **Résultat:** Liste des id départements (visibles ou non).
* **Exemple de résultat:**
```
```json
[ 1888, 999, 165 ]
```
#### **`departement`**
* **Méthode:** GET
* **Routes:**
* **Méthode:** GET
* **Routes:**
* `/departement/id/<int:dept_id>`
* `/departement/<string:dept>`
* **Résultat:** Un département
* **Exemple de résultat:**
```
* **Résultat:** Un département
* **Exemple de résultat:**
```json
{
"id": 1,
"acronym": "TAPI",
@ -205,6 +190,21 @@ par le serveur ScoDoc.
},
```
#### **`departements`**
* **Méthode:** GET
* **Routes:** `/departements`
* **Exemple d'utilisation:** `/api/departements`
* **Résultat:** Liste des tous les départements (visibles ou non).
* **Exemple de résultat:**
```json
[
{ un département }
...
]
```
chaque département est décrit selon [departement](ScoDoc9API.md#departement)
#### **Étudiants d'un département**
* **Méthode:** GET
@ -217,7 +217,7 @@ par le serveur ScoDoc.
On peut spécifier l'acronyme du département ("MMI") ou son id (un entier).
Attention, la liste peut être longue: requête coûteuse à éviter.
* **Exemple de résultat:**
```
```json
[
{
"civilite": "M", // M, F ou X
@ -233,7 +233,7 @@ par le serveur ScoDoc.
...
]
```
#### **Formsemestre d'un département**
#### **Formsemestres d'un département**
* **Méthode:** GET
* **Paramètres:** `dept`
@ -245,7 +245,7 @@ par le serveur ScoDoc.
* **Exemple de résultat:**
```[ 28, 99, 3 ]```
#### **Formsemestre en cours d'un département**
#### **Formsemestres en cours d'un département**
* **Méthode:** GET
* **Paramètres:** `dept`
@ -254,8 +254,8 @@ par le serveur ScoDoc.
* `/departement/<string:dept>/formsemestres_courants`
* **Exemple d'utilisation:** `/api/departement/MMI/formsemestres_courants`
* **Résultat:** Liste des id des formsemestres en cours d'un département donné.
* **Exemple de résultat:**
```
* **Exemple de résultat:**
```json
[
{
"block_moyennes": false,
@ -303,7 +303,8 @@ par le serveur ScoDoc.
* **Exemple d'utilisation:** `/api/formsemestre/1`
* **Résultat:** Données d'un formsemestre spécifié par son id.
* **Exemple de résultat:**
```{
```json
{
"block_moyennes": false,
"bul_bgcolor": "white",
"bul_hide_xml": false,
@ -345,7 +346,8 @@ par le serveur ScoDoc.
* **Exemple d'utilisation:** `/api/formsemestres/query?etapeapo=V7HU1&annee_scolaire=2021`
* **Résultat:** Données d'un formsemestre spécifié par son id.
* **Exemple de résultat:**
```{
```json
{
"block_moyennes": false,
"bul_bgcolor": "white",
"bul_hide_xml": false,
@ -384,10 +386,135 @@ Le `titre`est celui donné par l'utilisateur dans le formsemestre, tandis que le
* **Méthode:** GET
* **Paramètres:** `formsemestre_id`
* **Route:** `/formsemestres/bulletins
* **Route:** `/formsemestres/<int:formsemestre_id>/bulletins
* **Exemple d'utilisation:** `/api/formsemestre/1/bulletins`
* **Résultat:** Bulletins d'un formsemestre spécifié par son id.
* **Exemple de résultat:**
```
[
{
"type": "classic",
"version": "0",
"etudid": 9586,
"formsemestre_id": 829,
"date": "2022-07-25T14:44:03.305430",
"publie": true,
"etapes": [
"3RETAL"
],
"etape_apo": "3RETAL",
"etudiant": {
"etudid": 9586,
"code_nip": "42021436",
"code_ine": "081377224FD",
"nom": "WUILMART",
"prenom": "Jade",
"civilite": "Mme",
"photo_url": "/ScoDoc/INFO/Scolarite/get_photo_image?etudid=9586&amp;size=small",
"email": "jade.wuilmart.etu@univ-lille.fr",
"emailperso": "jeufir@gmail.com",
"sexe": "Mme"
},
"note": {
"value": "12.54",
"min": "01.55",
"max": "15.30",
"moy": "12.80"
},
"rang": {
"value": "9",
"ninscrits": 10
},
"rang_group": [
{
"group_type": "cgir",
"group_name": "alt",
"value": "",
"ninscrits": 0
}
],
"note_max": {
"value": 20
},
"bonus_sport_culture": {
"value": 0.0
},
"ue": [
{
"id": 1188,
"numero": "1",
"acronyme": "BCC1",
"titre": "Concevoir et maintenir une infrastructure réseau",
"note": {
"value": "11.65",
"min": "00.00",
"max": "16.10",
"moy": "12.52"
},
"rang": "8",
"effectif": 10,
"ects": " 6",
"code_apogee": "",
"module": [
{
"id": 13240,
"code": "rsxip",
"coefficient": 6.0,
"numero": 1,
"titre": "Technologies IP",
"abbrev": "None",
"note": {
"value": "11.65",
"moy": "12.52",
"max": "16.10",
"min": "00.00",
"nb_notes": 10,
"nb_missing": 0,
"nb_valid_evals": 4
},
"code_apogee": "",
"evaluation": [
{
"jour": "2021-11-09",
"heure_debut": "08:00:00",
"heure_fin": "08:00:00",
"coefficient": 1.5,
"evaluation_type": 0,
"evaluation_id": 24782,
"description": "DS Réseaux IP",
"note": "16.00"
},
...
]
}
]
},
...
],
"ue_capitalisee": [],
"situation": "Inscrit le 06/09/2021. UE acquises: BCC1, BCC2, BCC3, BCC 4, BCC 5, BCC 6, BCC8. Décision jury: Validé Diplôme obtenu.",
"decision": {
"code": "ADM",
"etat": "I",
"date": "2022-07-11",
"compense_formsemestre_id": null
},
"decision_ue": [
{
"ue_id": 1188,
"numero": 1,
"acronyme": "BCC1",
"titre": "Concevoir et maintenir une infrastructure réseau",
"code": "ADM",
"ects": 6.0
},
...
],
"autorisation_inscription": [],
"appreciation": []
},
]
```
#### **Programme d'un formsemestre**
@ -397,6 +524,67 @@ Le `titre`est celui donné par l'utilisateur dans le formsemestre, tandis que le
* **Exemple d'utilisation:** `/api/formsemestre/1/programme`
* **Résultat:** Liste des UEs, ressources et SAE d'un formsemestre spécifié par son id.
* **Exemple de résultat:**
```json
{
"ues": [
{
"formation_id": 328,
"ue_code": "UCOD74",
"id": 1188,
"ects": 6.0,
"acronyme": "BCC1",
"is_external": false,
"numero": 1,
"code_apogee": "",
"titre": "Concevoir et maintenir une infrastructure réseau",
"coefficient": 0.0,
"semestre_idx": null,
"coef_rcue": 1.0,
"type": 0,
"color": null,
"niveau_competence_id": null,
"ue_id": 1188,
"module_ue_coefs": []
},
...
],
"ressources": [],
"saes": [],
"modules": [
{
"id": 13240,
"formsemestre_id": 829,
"computation_expr": null,
"module_id": 7591,
"responsable_id": 397,
"module": {
"id": 7591,
"ects": null,
"module_type": 0,
"titre": "Technologies IP",
"ue_id": 1188,
"abbrev": null,
"formation_id": 328,
"code": "rsxip",
"matiere_id": 3499,
"heures_cours": 0.0,
"semestre_id": 1,
"heures_td": 0.0,
"numero": 1,
"heures_tp": 0.0,
"code_apogee": "",
"coefficient": 6.0,
"parcours": [],
"app_critiques": [],
"module_id": 7591
},
"moduleimpl_id": 13240,
"ens": []
},
...
]
}
```
#### **Etudiants d'un formsemestre**
@ -409,7 +597,46 @@ Le `titre`est celui donné par l'utilisateur dans le formsemestre, tandis que le
* **Exemple d'utilisation:** `/api/formsemestre/1/etudiants`
* **Résultat:** Etudiants d'un formsemestre spécifié par son id. Liste est restreinte aux étudiants démissionnaires/défaillants si l'option correspondante est ajoutée au chemin
* **Exemple de résultat:**
```json
[
{
"id": 9586,
"nip": "42021436",
"ine": "081377224FD",
"nom": "WUILMART",
"nom_usuel": null,
"prenom": "JADE",
"civilite": "F",
"groups": [
{
"partition_id": 1731,
"id": 3770,
"formsemestre_id": 829,
"partition_name": null,
"numero": 401,
"bul_show_rank": false,
"show_in_lists": true,
"groups_editable": true,
"group_id": 3770,
"group_name": null
},
{
"partition_id": 1735,
"id": 3784,
"formsemestre_id": 829,
"partition_name": "cgir",
"numero": 405,
"bul_show_rank": false,
"show_in_lists": true,
"groups_editable": true,
"group_id": 3784,
"group_name": "alt"
}
]
},
...
]
```
#### **Etat des évaluations d'un formsemestre**
* **Méthode:** GET
@ -431,7 +658,47 @@ pour un formsemestre spécifié par son id.
Par défaut les valeurs numériques sont formattées en chaînes. Si format=raw, valeurs numériques
mais pas JSON compliant à cause des _NaN_.
* **Exemple de résultat:**
```json
[
{
"etudid": 11607,
"code_nip": "41804612",
"rang": "1",
"civilite_str": "M.",
"nom_disp": "ANONYMOUS",
"prenom": "SIMON",
"nom_short": "DESMARETS Si.",
"moy_gen": 15.301055555555555,
"moy_ue_1188": 15.160000000000002,
"moy_mod_13240_1188": 15.16,
"moy_ue_1189": 18.25,
"moy_mod_13243_1189": 18.25,
"moy_ue_1190": 15.425925925925927,
"moy_mod_13163_1190": 16.5,
"moy_mod_13165_1190": 14.083333333333334,
"moy_ue_1191": 15.003333333333332,
"moy_mod_13166_1191": 15.003333333333332,
"moy_ue_1192": 13.0,
"moy_mod_13167_1192": 13.0,
"moy_ue_1193": 16.0,
"moy_mod_13168_1193": 16.0,
"moy_ue_1196": 14.666666666666666,
"moy_mod_13169_1196": 14.666666666666666,
"ues_validables": "7/7",
"part_1735": "alt",
"bac": "STI2D MENTION BIEN",
"specialite": "SYSTEME INFORMATIQUE ET NUMERIQUE",
"type_admission": "Inconnue",
"classement": "",
"partitions": {
"1731": 3770,
"1735": 3784
}
},
...
]
```
## Étudiants
#### **`etudiants_courant`**
@ -468,7 +735,10 @@ mais pas JSON compliant à cause des _NaN_.
* **Méthode:** GET
* **Paramètres:** `etudid`, `nip`, `ine`
* **Routes:** `/etudiant/etudid/<int:etudid>` ou `/etudiant/nip/<string:nip>` ou `/etudiant/ine/<string:ine>`
* **Routes:**
* `/etudiant/etudid/<int:etudid>` ou
* `/etudiant/nip/<string:nip>` ou
* `/etudiant/ine/<string:ine>`
* **Exemple d'utilisation:** `/api/etudiant/nip/1`
* **Résultat:** Retourne les informations sur l'étudiant correspondant à
l'id passé en paramètres.
@ -825,6 +1095,8 @@ mais pas JSON compliant à cause des _NaN_.
]
```
## Programmes de formations
#### **`formation`**
@ -1255,7 +1527,7 @@ des informations suivantes:
* **Paramètres:** `formsemestre_id`
* **Routes:** `/formsemestre/<int:formsemestre_id>/etat_evals`
* **Exemple d'utilisation:** `/ScoDoc/api/formsemestre/1/etat_evals`
* **Résultat:** Retourne les informations sur l'état des évaluations d'un semestre donnée
* **Résultat:** Retourne les informations sur l'état des évaluations d'un semestre donné
* **Exemple de résultat:**
```
{

Binary file not shown.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 265 KiB

After

Width:  |  Height:  |  Size: 260 KiB

File diff suppressed because it is too large Load Diff

Before

Width:  |  Height:  |  Size: 249 KiB

After

Width:  |  Height:  |  Size: 245 KiB

View File

@ -1,8 +1,8 @@
site_name: ScoDoc
theme:
# name: mkdocs
name: material
name: mkdocs
# name: material
navigation_depth: 3
features:
- navigation.tabs