DocScoDoc/docs/ApiCreationParcours.md

50 lines
2.2 KiB
Markdown
Raw Normal View History

2020-09-21 16:30:27 +02:00
# Cursus ScoDoc
2020-09-21 16:30:27 +02:00
Les cursus pédagogiques sont définis dans ScoDoc par des classes de "cursus" qui
définissent les paramètres: nombre de semestres, modalités de validation des UE,
etc.
2020-09-21 16:30:27 +02:00
Plusieurs cursus sont définis dans ScoDoc, l'utilisateur choisi l'un d'entre eux
pour chacun des programmes pédagogique (menu **Type de parcours**). Les cursus
existants incluent les suivants:
2020-09-21 16:30:27 +02:00
* BUT (*Bachelor Universitaire de Technologie*, usuellement en 6 semestres)
* DUT (*Diplôme Universitaire de Technologie*, en quatre semestres)
* Licence Professionnelle
* Licence
* Master (différents types)
* etc.
2020-09-21 16:30:27 +02:00
Il est possible d'ajouter des cursus adaptés en ajoutant du code Python.
Toutefois, afin de ne pas perturber les mises à jours et de garantir la
pérennité des modifications, il est très recommandé de partager les
modifications pour inclusion dans le code ScoDoc. Contacter pour cela les
développeurs ([Contacts](Contact.md)).
2020-09-21 16:30:27 +02:00
## Quelques indications pour les programmeurs
2020-09-21 16:30:27 +02:00
Les parcours sont définis dans le module `codes_cursus.py`. Chaque parcours
correspond à une sous-classe de `TypeCursus`, définissant des paramètres et
quelques méthodes.
2020-09-21 16:30:27 +02:00
Les paramètres (déclarés comme des variables de classe) sont les suivants:
Nom | Type |  
--- | ---- | ---
TYPE_PARCOURS| `int` | id du parcours (un entier unique, à demander sur scodoc-devel)
NAME| `string` | nom du parcours présenté à l'utilisateur (requis)
NB_SEM| `int` | durée en semestres (1)
BARRE_MOY | `float` | seuil validation semestre (10/20)
BARRE_UE_DEFAULT | `float` | seuil moy UE pour valider semestre (8/20)
BARRE_UE | `dict { ue : seuil }`| seuil par UE (`{}`)
NOTES_BARRE_VALID_UE_TH | `float` | seuil validation UE (10./20)
ALLOW_SEM_SKIP| `bool` | passage: autorise-t-on les sauts de semestres ? (`False`)
SESSION_NAME| `string` | nom des sessions (`'semestre'`)
SESSION_ABBRV | `string` | `'S' -> S1, S2, ...`
UNUSED_CODES | `set` | ensemble des codes jury non autorisés dans ce parcours (`set()`)
UE_IS_MODULE| `bool` | un seul module par UE (si plusieurs modules, etudiants censéments inscrits à un seul d'entre eux) (`False`)
ECTS_ONLY| `bool` | parcours avec progression basée uniquement sur les ECTS (`False`)
ALLOWED_UE_TYPES | `set` | types d'UE autorisés dans ce parcours
2020-09-21 16:30:27 +02:00