ScoDoc/DocScoDoc
5
2
Fork 10
Code Issues 1 Pull Requests 1 Projects Releases Wiki Activity

mise a jour de la cart (entree referentiel_competance)

Browse Source 
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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

424
docs/ScoDoc9API.md
View File

@ -133,7 +133,7 @@ systèmes, voir plus haut pour la ême chose avec la commande `http`):
où `SERVEUR` est l'adresse (IP ou nom) de votre serveur. où `SERVEUR` est l'adresse (IP ou nom) de votre serveur.
La réponse doit ressembler à ceci: La réponse doit ressembler à ceci:
``` ```json
{ {
"token": "LuXXxk+i74TXYZZl8MulgbiCGmVHXXX" "token": "LuXXxk+i74TXYZZl8MulgbiCGmVHXXX"
} }
@ -163,47 +163,47 @@ par le serveur ScoDoc.
## Départements ## 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`** #### **`departements_ids`**
* **Méthode:** GET * **Méthode:** GET
* **Routes:** `/departements_ids` * **Routes:** `/departements_ids`
* **Résultat:** Liste des id départements (visibles ou non). * **Résultat:** Liste des id départements (visibles ou non).
* **Exemple de résultat:** * **Exemple de résultat:**
``` ```json
[ 1888, 999, 165 ] [ 1888, 999, 165 ]
``` ```
#### **`departement`** #### **`departement`**
* **Méthode:** GET * **Méthode:** GET
* **Routes:** * **Routes:**
* `/departement/id/<int:dept_id>` * `/departement/id/<int:dept_id>`
* `/departement/<string:dept>` * `/departement/<string:dept>`
* **Résultat:** Un département * **Résultat:** Un département
* **Exemple de résultat:** * **Exemple de résultat:**
``` ```json
{ {
"id": 1, "id": 1,
"acronym": "TAPI", "acronym": "TAPI",
"description": null, "description": null,
"visible": true, "visible": true,
"date_creation": "Fri, 15 Apr 2022 12:19:28 GMT" "date_creation": "Fri, 15 Apr 2022 12:19:28 GMT"
}, },
``` ```
#### **`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** #### **Étudiants d'un département**
@ -217,7 +217,7 @@ par le serveur ScoDoc.
On peut spécifier l'acronyme du département ("MMI") ou son id (un entier). 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. Attention, la liste peut être longue: requête coûteuse à éviter.
* **Exemple de résultat:** * **Exemple de résultat:**
``` ```json
[ [
{ {
"civilite": "M", // M, F ou X "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 * **Méthode:** GET
* **Paramètres:** `dept` * **Paramètres:** `dept`
@ -245,7 +245,7 @@ par le serveur ScoDoc.
* **Exemple de résultat:** * **Exemple de résultat:**
```[ 28, 99, 3 ]``` ```[ 28, 99, 3 ]```
#### **Formsemestre en cours d'un département** #### **Formsemestres en cours d'un département**
* **Méthode:** GET * **Méthode:** GET
* **Paramètres:** `dept` * **Paramètres:** `dept`
@ -254,41 +254,41 @@ par le serveur ScoDoc.
* `/departement/<string:dept>/formsemestres_courants` * `/departement/<string:dept>/formsemestres_courants`
* **Exemple d'utilisation:** `/api/departement/MMI/formsemestres_courants` * **Exemple d'utilisation:** `/api/departement/MMI/formsemestres_courants`
* **Résultat:** Liste des id des formsemestres en cours d'un département donné. * **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, "block_moyennes": false,
"bul_bgcolor": "white", "bul_bgcolor": "white",
"bul_hide_xml": false, "bul_hide_xml": false,
"date_debut_iso": "2021-09-01", "date_debut_iso": "2021-09-01",
"date_debut": "01/09/2021", "date_debut": "01/09/2021",
"date_fin_iso": "2022-08-31", "date_fin_iso": "2022-08-31",
"date_fin": "31/08/2022", "date_fin": "31/08/2022",
"dept_id": 1, "dept_id": 1,
"elt_annee_apo": "V7HU", "elt_annee_apo": "V7HU",
"elt_sem_apo": null, "elt_sem_apo": null,
"ens_can_edit_eval": false, "ens_can_edit_eval": false,
"etat": true, "etat": true,
"formation_id": 1, "formation_id": 1,
"formsemestre_id": 1, "formsemestre_id": 1,
"gestion_compensation": false, "gestion_compensation": false,
"gestion_semestrielle": false, "gestion_semestrielle": false,
"id": 1, "id": 1,
"modalite": "FI", "modalite": "FI",
"resp_can_change_ens": true, "resp_can_change_ens": true,
"resp_can_edit": false, "resp_can_edit": false,
"responsables": [ "responsables": [
12, 12,
42 42
], ],
"scodoc7_id": null, "scodoc7_id": null,
"semestre_id": 1, "semestre_id": 1,
"titre_num": "BUT MMI semestre 1", "titre_num": "BUT MMI semestre 1",
"titre": "BUT MMI", "titre": "BUT MMI",
"titre_formation": "BUT MMI" "titre_formation": "BUT MMI"
}, },
... ...
] ]
``` ```
@ -303,7 +303,8 @@ par le serveur ScoDoc.
* **Exemple d'utilisation:** `/api/formsemestre/1` * **Exemple d'utilisation:** `/api/formsemestre/1`
* **Résultat:** Données d'un formsemestre spécifié par son id. * **Résultat:** Données d'un formsemestre spécifié par son id.
* **Exemple de résultat:** * **Exemple de résultat:**
```{ ```json
{
"block_moyennes": false, "block_moyennes": false,
"bul_bgcolor": "white", "bul_bgcolor": "white",
"bul_hide_xml": false, "bul_hide_xml": false,
@ -345,7 +346,8 @@ par le serveur ScoDoc.
* **Exemple d'utilisation:** `/api/formsemestres/query?etapeapo=V7HU1&annee_scolaire=2021` * **Exemple d'utilisation:** `/api/formsemestres/query?etapeapo=V7HU1&annee_scolaire=2021`
* **Résultat:** Données d'un formsemestre spécifié par son id. * **Résultat:** Données d'un formsemestre spécifié par son id.
* **Exemple de résultat:** * **Exemple de résultat:**
```{ ```json
{
"block_moyennes": false, "block_moyennes": false,
"bul_bgcolor": "white", "bul_bgcolor": "white",
"bul_hide_xml": false, "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 * **Méthode:** GET
* **Paramètres:** `formsemestre_id` * **Paramètres:** `formsemestre_id`
* **Route:** `/formsemestres/bulletins * **Route:** `/formsemestres/<int:formsemestre_id>/bulletins
* **Exemple d'utilisation:** `/api/formsemestre/1/bulletins` * **Exemple d'utilisation:** `/api/formsemestre/1/bulletins`
* **Résultat:** Bulletins d'un formsemestre spécifié par son id. * **Résultat:** Bulletins d'un formsemestre spécifié par son id.
* **Exemple de résultat:** * **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** #### **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` * **Exemple d'utilisation:** `/api/formsemestre/1/programme`
* **Résultat:** Liste des UEs, ressources et SAE d'un formsemestre spécifié par son id. * **Résultat:** Liste des UEs, ressources et SAE d'un formsemestre spécifié par son id.
* **Exemple de résultat:** * **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** #### **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` * **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 * **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:** * **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** #### **Etat des évaluations d'un formsemestre**
* **Méthode:** GET * **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 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_. mais pas JSON compliant à cause des _NaN_.
* **Exemple de résultat:** * **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 ## Étudiants
#### **`etudiants_courant`** #### **`etudiants_courant`**
@ -468,12 +735,15 @@ mais pas JSON compliant à cause des _NaN_.
* **Méthode:** GET * **Méthode:** GET
* **Paramètres:** `etudid`, `nip`, `ine` * **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` * **Exemple d'utilisation:** `/api/etudiant/nip/1`
* **Résultat:** Retourne les informations sur l'étudiant correspondant à * **Résultat:** Retourne les informations sur l'étudiant correspondant à
l'id passé en paramètres. l'id passé en paramètres.
Les codes INE et NIP sont uniques au sein d'un département. Les codes INE et NIP sont uniques au sein d'un département.
Si plusieurs objets étudiant ont le même code, on ramène le plus récemment inscrit. Si plusieurs objets étudiant ont le même code, on ramène le plus récemment inscrit.
* **Exemple de résultat:** * **Exemple de résultat:**
``` ```
{ {
@ -825,6 +1095,8 @@ mais pas JSON compliant à cause des _NaN_.
] ]
``` ```
## Programmes de formations ## Programmes de formations
#### **`formation`** #### **`formation`**
@ -1255,7 +1527,7 @@ des informations suivantes:
* **Paramètres:** `formsemestre_id` * **Paramètres:** `formsemestre_id`
* **Routes:** `/formsemestre/<int:formsemestre_id>/etat_evals` * **Routes:** `/formsemestre/<int:formsemestre_id>/etat_evals`
* **Exemple d'utilisation:** `/ScoDoc/api/formsemestre/1/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:** * **Exemple de résultat:**
``` ```
{ {

BIN
docs/img/API_Chart.odg
View File

Binary file not shown.

BIN
docs/img/API_Chart.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 265 KiB

After

Width:  |  Height:  |  Size: 260 KiB

2100
docs/img/API_Chart.svg
View File

File diff suppressed because it is too large Load Diff
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 249 KiB

After

Width:  |  Height:  |  Size: 245 KiB

4
mkdocs.yml
View File

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