diff --git a/docs/AdminUsers.md b/docs/AdminUsers.md
index d4b3bd8ab..1622b27cd 100644
--- a/docs/AdminUsers.md
+++ b/docs/AdminUsers.md
@@ -217,4 +217,4 @@ Pour la signification des rôles et l'utilisation du département, voir
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [Configuration des envois d'emails](ConfigEmail.md)
- [FAQ](FAQ.md)
- - [Contacts](Contact.md).
+ - [Contacts](Contact.md)
diff --git a/docs/BUT.md b/docs/BUT.md
index 6be54ef36..63179ab25 100644
--- a/docs/BUT.md
+++ b/docs/BUT.md
@@ -324,4 +324,12 @@ de décisions ad-hoc (compensations plus simples, moins de cas de mise en attent
- Règles de compensation au sein de chaque niveau, pour validation de l'année.
+!!! note "Voir aussi"
+
+ - [Guide utilisateur](GuideUtilisateur.md)
+ - [Guide du responsable de formation](GuideAdminFormation.md)
+ - [Tutoriels vidéo](https://www.youtube.com/channel/UCb0JYCBRi0CsE4XFp4ByhXg)
+ - [FAQ](FAQ.md)
+ - [Contacts](Contact.md)
+
diff --git a/docs/CalculNotes.md b/docs/CalculNotes.md
index b151779db..303223a4c 100644
--- a/docs/CalculNotes.md
+++ b/docs/CalculNotes.md
@@ -1,14 +1,13 @@
-## Calcul des notes
+# Calcul des notes
*Tout ce que vous avez toujours voulu savoir sur le calcul des moyennes...*
-**Attention :** Les informations ci-dessous s'appliquent aux formations traditionnelles.
-Pour les formations par compétences, voir [la page dédiée au BUT](BUT.md).
+Pour les formations par compétences, voir aussi [la page dédiée au BUT](BUT.md).
-### En résumé:
+## En résumé
-A chaque instant, ScoDoc prend en compte les notes des évaluations "complètes"
+À chaque instant, ScoDoc prend en compte les notes des évaluations "complètes"
(dans lesquelles toutes les notes ont été saisies ou bien signalées "en attente"
avec le code ATT. Les évaluations partiellement saisies ne sont pas prises en
compte, sauf si l'option "*prise en compte immédiate*" a été cochée sur
@@ -21,41 +20,50 @@ Les moyennes d'UE et générale sont calculées à partir des moyennes de module
en utilisant les coefficients du programme pédagogique (dénommé dans ScoDoc
"formation").
-
Plus de détails ci-dessous.
-
-### Calcul des moyennes de modules
+## Calcul des moyennes de modules
Chaque évaluation produit des notes de différents types:
- * note numérique (positive ou nulle): sera normalisée entre 0 et 20
+* note numérique (positive ou nulle): sera normalisée entre 0 et 20
- * note absente: considérée comme zéro
+* note absente: considérée comme zéro
- * note en attente: non prise en compte
+* note en attente: non prise en compte
- * note excusée: non pris en compte
+* note excusée: non pris en compte
Chaque étudiant a donc un nombre variable de notes à prendre en compte dans
chaque module. Chaque note est associée à un coefficient: le coefficient de
l'évaluation dans le module.
+### En formation classique (hors approches par compétences, BUT)
+
La moyenne de module est la somme pondérée par le coefficient des évaluations
des notes aux évaluations prises en compte, sauf si on a défini une formule
spécifique.
+### En BUT
-#### Formules de calcul spéciales
+Comme expliqué en détail sur [la page dédiée au BUT](BUT.md), chaque module
+(ressource ou SAÉ) peut produire des notes différentes pour chaque UE. Le
+programme pédagogique (adapté du Programme National publié au BO) défini des
+coefficients permettant le calcul des moyennes d'UE.
-Il est possible de définir des formules de calcul spéciales pour calculer les
-moyennes. Ces formules sont alors utilisées par ScoDoc à la place de la moyenne
-pondérée standard. Voir
-[FormulesCalculUtilisateur](FormulesCalculUtilisateur.md)
-pour plus d'informations.
+De façon plus fine, chaque évaluation peut s'adresser à un sous-ensemble
+d'apprentissages critiques, et donc être associée à une ou plusieurs UE avec des
+pondérations différentes: les poids de l'évaluation.
+On a donc **pour chaque évaluation**:
-### Moyennes d'UE
+- des poids, un par UE, qui sont par défaut égaux à 1 pour les UE concernées
+ (c'est à dire ayant un coefficient non nul);
+- un coefficient.
+
+Le calcul de la moyenne du module vers les UEs s'effectue en *multipliant* les poids par le coefficient.
+
+## Moyennes d'UE
moyenne_ue = moyenne pondérée des moyennes de modules de l'UE (- malus)
@@ -66,18 +74,9 @@ Le malus appliqué à la moyenne d'UE est donné par la somme des notes du ou de
modules de malus de cette UE (un type spécial de modules, voir
[ModulesMalus](ModulesMalus.md)).
-Comme pour le calcul des moyennes de modules, il est possible de définir une
-formule ad-hoc pour le calcul de la moyenne d'UE (cela est toutefois rarement
-nécessaire, et il est recommandé de ne pas abuser de cette fonctionnalité: la
-présence de formules ralentit considérablement les calculs).
-La syntaxe et les variables sont les mêmes que pour les modules; ici, le vecteur
-de notes est celui des moyennes de modules (et non des évaluations). Voir
-[FormulesCalculUtilisateur](FormulesCalculUtilisateur.md).
+## Calcul de la moyenne générale
-La présence de formules d'UE est signalée sur le tableau de bord du semestre.
-
-
-### Calcul de la moyenne générale
+### En formations classiques
moyenne = moyenne pondérée des moyennes d'UE + bonus sport/culture
@@ -98,8 +97,14 @@ Les modules des UEs de type "Sport & Culture" ne sont évidemment pas pris en
compte dans la moyenne pondérée: ils sont utilisés pour calculer le bonus, comme
expliqué ci-dessous.
+### Moyenne générale en BUT
-### Notes de rattrapage
+En BUT, on calcule des notes pour les Unités d'Enseignement, et la moyenne
+générale n'est pas définie. Toutefois, ScoDoc calcule une *moyenne indicative*,
+qui est la moyenne des moyennes des UE du semestre pondérée par leurs ECTS. Voir
+détails [sur la page BUT](BUT.md#moyenne-generale)
+
+## Notes de rattrapage
Dans chaque module, il est possible de définir une évaluation de "rattrapage".
Lors de la création (ou modification) de l'évaluation, indiquer le type
@@ -110,9 +115,7 @@ Lors de la création (ou modification) de l'évaluation, indiquer le type
Pour chaque étudiant, la note obtenue à l'évaluation de rattrapage remplace la
moyenne du module, seulement si elle est supérieure à celle-ci.
-
-
-### Bonus sport/culture
+## Bonus sport/culture
Ce bonus s'applique directement sur la **moyenne générale** et/ou sur les
moyennes d'UE (notamment en BUT).
@@ -121,7 +124,7 @@ Les notes des UEs de type spécial "Sport & Culture" sont utilisées pour calcul
Pour qu'un étudiant bénéficie de ce bonus, il doit être inscrit à un module
d'une UE de type "Sport&Culture". Cette UE et modules associés doivent donc être
-prévu dans le programme pédagogique.
+prévu dans le programme pédagogique.
La règle appliquée dépend de l'établissement. Par exemple, l'Université de
Haute Alsace appliquait le règlement suivant: *Les étudiants de l'IUT peuvent
@@ -137,3 +140,44 @@ vous souhaitez disposer d'une nouvelle règle, il faut contacter l'équipe de
développement en indiquant (en français) le règlement en vigueur dans votre
établissement. Le code correspondant sera ajouté via une mise à jour.
+## Arrondis et affichages
+
+ScoDoc calcule les notes en haute précision. On peut saisir des notes comme
+`12,3456789 / 20` (convenons que c'est un peu ridicule, mais possible).
+
+Les résultats sont en général affichés avec 4 chiffres (12,34/20), soit 1 millième de précision.
+Le nombre de chiffres exportés vers Apogée (dans des fichiers textes) est paramétrable.
+Les exports vers Excel conservent la précision maximale (types numériques).
+
+Les décisions prises par ScoDoc (`ADM` automatique par exemple) sont calculées
+avec une *tolérance* pour éviter que les étudiants ne soient victimes d'erreurs
+d'arrondis: par exemple:
+
+```text
+Pour valider une RCUE, on vérifie que moy_rcue > sco_codes.BUT_RCUE_SUFFISANT
+
+où est défini comme BUT_RCUE_SUFFISANT = 8.0 - NOTES_TOLERANCE.
+
+avec
+NOTES_TOLERANCE = 0.00499999999999
+```
+
+Donc un étudiant avec 7.996 (affichée `08.00` dans les tableaux) validera mais un autre avec 7.995 (affichée `07.99`) ne validera pas.
+
+⚠️ Attention: il y a deux façon d'exporter vers Excel:
+
+1- l'une est fournie par le navigateur (javascript) et part de la version
+affichée. C'est commode et conserve la mise en forme du tableau affiché, mais on
+n'a pas toute la précision.
+
+2- la seconde est exportée par ScoDoc qui veille à conserver le maximum d'information.
+
+![menu export excel](fig/menu-export-excel.png)
+
+
+!!! note "Voir aussi"
+
+ - [Guide utilisateur](GuideUtilisateur.md)
+ - [Calculs spécifiques en BUT](BUT.md)
+ - [FAQ](FAQ.md)
+ - [Contacts](Contact.md)
diff --git a/docs/CompensationSemestre.md b/docs/CompensationSemestre.md
index 992973393..8f543ab77 100644
--- a/docs/CompensationSemestre.md
+++ b/docs/CompensationSemestre.md
@@ -1,17 +1,26 @@
-## Compensation des semestres
-L'[arrêté du 3 août 2005](http://www.education.gouv.fr/bo/2005/31/MENS0501754A.htm) définit les modalités des parcours de DUT.
+# Compensation des semestres DUT
-L'article 20 (b) stipule "*Lorsque les conditions posées ci-dessus ne sont pas remplies, la
-validation est assurée, sauf opposition de l'étudiant, par une
-compensation organisée entre deux semestres consécutifs sur la base
-d'une moyenne générale égale ou supérieure à 10 sur 20 et d'une
-moyenne égale ou supérieure à 8 sur 20 dans chacune des unités
-d'enseignement constitutives de ces semestres. Le semestre servant à
-compenser ne peut être utilisé qu'une fois au cours du cursus.*".
+L'[arrêté du 3 août
+2005](http://www.education.gouv.fr/bo/2005/31/MENS0501754A.htm) définit les
+modalités des parcours de DUT.
+
+L'article 20 (b) stipule "*Lorsque les conditions posées ci-dessus ne sont pas
+remplies, la validation est assurée, sauf opposition de l'étudiant, par une
+compensation organisée entre deux semestres consécutifs sur la base d'une
+moyenne générale égale ou supérieure à 10 sur 20 et d'une moyenne égale ou
+supérieure à 8 sur 20 dans chacune des unités d'enseignement constitutives de
+ces semestres. Le semestre servant à compenser ne peut être utilisé qu'une fois
+au cours du cursus.*".
-ScoDoc propose automatiquement la compensation du semestre *n+1* avec le semestre *n* lorsque c'est possible: le code décision est alors ADC, et on mémorise que le semestre *n* a été utilisé pour compenser.
+ScoDoc propose automatiquement la compensation du semestre *n+1* avec le
+semestre *n* lorsque c'est possible: le code décision est alors ADC, et on
+mémorise que le semestre *n* a été utilisé pour compenser.
- cette possibilité n'est offerte que lorsque l'option "*proposer compensations de semestres (parcours DUT)*" (menu "*Modifier le semestre*") est activée (en effet, la règle de compensation est spécifique aux DUT et ne s'applique pas à toutes les formations LMD).
+ cette possibilité n'est offerte que lorsque l'option "*proposer
+compensations de semestres (parcours DUT)*" (menu "*Modifier le semestre*") est
+activée (en effet, la règle de compensation est spécifique aux DUT et ne
+s'applique pas à toutes les formations LMD).
diff --git a/docs/ConfigCAS.md b/docs/ConfigCAS.md
index 7eed3248c..0c836064e 100644
--- a/docs/ConfigCAS.md
+++ b/docs/ConfigCAS.md
@@ -146,6 +146,16 @@ Exemples:
INFO: CAS login denied for cas_id=prenom.nom (unknown or inactive)
```
+## Accès via l'API
+
+L'authentification des clients de l'API utilise un jeton (*token*), qui est
+demandé par l'appel `/ScoDoc/api/tokens` (qui lui même appelle
+`User.get_token()`). Ce mécanisme ne passe jamais par le CAS, à condition que le
+compte utilisateur utilisé par l'API soit "*Autorisé à se connecter via ScoDoc*"
+(voir le formulaire plus haut, [configuration des
+utilisateurs](#configuration-des-utilisateurs)).
+
+
!!! note "Voir aussi"
- [Gestion des utilisateurs](AdminUsers.md)
@@ -154,4 +164,4 @@ INFO: CAS login denied for cas_id=prenom.nom (unknown or inactive)
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [API pour ScoDoc 9](ScoDoc9API.md)
- [FAQ](FAQ.md)
- - [Contacts](Contact.md).
+ - [Contacts](Contact.md)
diff --git a/docs/ConfigPermissionsDept.md b/docs/ConfigPermissionsDept.md
index 6f6eb8cc8..cbf8fcc9a 100644
--- a/docs/ConfigPermissionsDept.md
+++ b/docs/ConfigPermissionsDept.md
@@ -70,4 +70,4 @@ Peuvent saisir des notes dans une évaluation située dans un module:
- [Config. des rôles et permissions en ligne de commande](GuideConfig.md#creation-dun-nouveau-role)
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [FAQ](FAQ.md)
- - [Contacts](Contact.md).
+ - [Contacts](Contact.md)
diff --git a/docs/Contribuer.md b/docs/Contribuer.md
index 0d00bf91f..6023830cc 100644
--- a/docs/Contribuer.md
+++ b/docs/Contribuer.md
@@ -5,8 +5,8 @@ peut aider, en améliorant la documentation (page, vidéos), en rejoignant le
serveur Discord (voir [contacts](Contact.md)) pour y aider les
collègues, ou en développant ou testant le logiciel.
-Les canaux de communication entre développeurs sont [indiqués sur cette
-page](Contact.md). Vous pouvez demander un compte sur le [git du
+Les canaux de communication entre développeurs sont
+[indiqués sur cette page](Contact.md). Vous pouvez demander un compte sur le [git du
projet](https://scodoc.org/git), consulter/ajouter des tickets, proposer votre
code (*pull requests*).
@@ -19,11 +19,19 @@ La documentation est constituée de deux parties:
Proposez de nouvelles vidéos, c'est très facile à faire !
- Les pages Web comme celle que vous lisez actuellement. La documentation est
- générée via `MkDocs, un système très simple basé sur le format
+ générée via `MkDocs`, un système très simple basé sur le format
[Markdown](https://www.markdownguide.org/basic-syntax/). Toutes les sources
sont sur le [dépôt git DocScoDoc](https://scodoc.org/git/viennet/DocScoDoc).
## Contribuer au logiciel
Le [dépôt principal](https://scodoc.org/git/viennet/ScoDoc) comporte plusieurs
-branches. Voir le [guide pour les développeurs](GuideDeveloppeurs.md).
\ No newline at end of file
+branches. Voir le [guide pour les développeurs](GuideDeveloppeurs.md).
+
+
+!!! note "Voir aussi"
+
+ - [Guide développeurs](GuideDeveloppeurs.md)
+ - [Guide administrateur ScoDoc](GuideAdminSys.md)
+ - [FAQ](FAQ.md)
+ - [Contacts](Contact.md)
diff --git a/docs/FAQ.md b/docs/FAQ.md
index be5cda9cb..412375041 100644
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -38,8 +38,8 @@ affichage sur leur ENT en général, cet affichage pouvant être désactivé dep
ScoDoc pour un semestre particulier). A défaut, il faut leur envoyer leurs
bulletins par mail.
+### Comment supprimer une évaluation ?
-### Comment supprimer une évaluation ?
1. Supprimer toutes les notes saisies dans cette évaluation, s'il y en a: passer
par la page "Saisie des notes" et suivre le lien "Effacer toutes les notes de
cette évaluation".
@@ -48,42 +48,46 @@ bulletins par mail.
bord du module: cliquer dessus pour supprimer l'évaluation.
-### En IUT, comment gérer les licences professionnelles ?
- * On peut créer un département regroupant les licences, ou bien rattacher
- chaque licence à un département existant. Cette dernière solution est
- préférable si des étudiants de DUT poursuivent en licence (ainsi, on a
- automatiquement accès à leur parcours complet).
+### En IUT, comment gérer les licences professionnelles ?
- * La plupart des licences pro durent un an, mais sont gérées comme un seul
- semestre (pas de jury à mi-parcours). Indiquer "*pas de semestre*" dans
- l'option "*Semestre dans la formation*" (page "*modification du semestre*").
+* On peut créer un département regroupant les licences, ou bien rattacher
+chaque licence à un département existant. Cette dernière solution est
+préférable si des étudiants de DUT poursuivent en licence (ainsi, on a
+automatiquement accès à leur parcours complet).
+
+* La plupart des licences pro durent un an, mais sont gérées comme un seul
+semestre (pas de jury à mi-parcours). Indiquer "*pas de semestre*" dans
+l'option "*Semestre dans la formation*" (page "*modification du semestre*").
### Comment gérer les étudiants les démissionnaires ?
- * Sur la fiche d'un étudiant, on peut choisir plusieurs options:
- * *Supprimer cet étudiant* : il sera totalement supprimé de la base, sans
- remède. Cette option n'est en principe jamais utile, sauf pour corriger
- une fausse manœuvre au moment des inscriptions.
+Sur la fiche d'un étudiant, on peut choisir plusieurs options:
- Ou bien au niveau de son inscription dans un semestre, via le menu *Scolarité*:
+* *Supprimer cet étudiant* : il sera totalement supprimé de la base, sans
+ remède. Cette option n'est en principe jamais utile, sauf pour corriger
+ une fausse manœuvre au moment des inscriptions.
- * *Démission* : l'étudiant restera dans le semestre, mais sera indiqué comme
- démissionnaire. C'est ce qu'il faut faire quand un étudiant signale son
- abandon en cours d'année, passé le délai légal ou il peut se désengager
- (typiquement, après le 15 octobre).
-
- * *Désinscrire (en cas d'erreur)* : l'étudiant reste dans ScoDoc, ses
- données (et ses notes) sont conservées, mais il n'est plus inscrit au
- semestre et n'apparait plus dans les listes. C'est ce qu'il faut choisir
- en début d'année, soit en cas d'erreur de manipulation, soit si l'étudiant
- abandonne en tout début d'année (il ne sera alors pas compté dans les
- inscrits).
+Ou bien au niveau de son inscription dans un semestre, via le menu *Scolarité*:
+
+* *Démission* : l'étudiant restera dans le semestre, mais sera indiqué comme
+ démissionnaire. C'est ce qu'il faut faire quand un étudiant signale son
+ abandon en cours d'année, passé le délai légal ou il peut se désengager
+ (typiquement, après le 15 octobre).
+
+* *Désinscrire (en cas d'erreur)* : l'étudiant reste dans ScoDoc, ses
+ données (et ses notes) sont conservées, mais il n'est plus inscrit au
+ semestre et n'apparait plus dans les listes. C'est ce qu'il faut choisir
+ en début d'année, soit en cas d'erreur de manipulation, soit si l'étudiant
+ abandonne en tout début d'année (il ne sera alors pas compté dans les
+ inscrits).
### Mes données sont erronées, que faire ?
+
En cas de problème (bug, erreur de manipulation, suspicion de piratage),
différents journaux peuvent être consultés.
Les utilisateurs autorisés peuvent facilement voir:
+
* les opérations effectuées sur un étudiant (inscriptions, saisies d'absences,
...), accessibles via le menu "Etudiant" / "Voir le journal..." en haut de sa
fiche individuelle.
@@ -93,42 +97,44 @@ Les utilisateurs autorisés peuvent facilement voir:
l'identité de l'utilisateur ayant effectué la saisie).
Les administrateurs (informaticiens) peuvent aussi consulter les journaux (logs)
-du serveur, voir plus loin.s
+du serveur, voir ["où sont les journaux"](#ou-sont-les-journaux-logs).
### Comment signaler un problème ?
+
Nous vous remercions de nous signaler tous les problèmes que vous rencontrez:
erreurs, comportement bizarre ou malcommode. Nous ne promettons pas de les
régler rapidement, ni même plus tard: le logiciel est fourni sans aucune
garantie. Mais nous faisons de notre mieux:
- - si vous êtes utilisateurs, écrire à
- [notes@listes.univ-paris13.fr](mailto:notes@listes.univ-paris13.fr).
- ou joindre le canal Discord Assistance.
+* si vous êtes utilisateurs, écrire à
+ [notes@listes.univ-paris13.fr](mailto:notes@listes.univ-paris13.fr).
+ ou joindre le canal Discord Assistance.
- - si vous êtes informaticien et voulez évoquer un problème technique
- (développement, installation), écrire à
- [scodoc-devel@listes.univ-paris13.fr](mailto:scodoc-devel@listes.univ-paris13.fr).
-
+* si vous êtes informaticien et voulez évoquer un problème technique
+ (développement, installation), écrire à
+ [scodoc-devel@listes.univ-paris13.fr](mailto:scodoc-devel@listes.univ-paris13.fr).
-## Configuration
-### Comment changer les logos sur les documents PDF (PV...)
+## Configuration
+
+### Comment changer les logos sur les documents PDF (PV...)
Il faut avoir un compte (web) administrateur sur ScoDoc, et passer
par l'onglet "configuration" accessible sur la page d'accueil.
-Voir [la page sur la gestion des logos et images ](GestionLogos.md).
+Voir [la page sur la gestion des logos et images](GestionLogos.md).
-### Administration
+### Administration
-### Quel système d'exploitation ?
-ScoDoc est accessible depuis n'importe quel navigateur Web (Firefox, Chrome, ...).
+### Quel système d'exploitation ?
+
+ScoDoc est accessible depuis n'importe quel navigateur Web (Firefox, Chrome, ...).
Le serveur ScoDoc fonctionne sous Linux. Il n'est testé qu'avec Debian (stable).
Le script d'installation ([GuideInstallDebian11](GuideInstallDebian11.md))
assure l'installation de tout les éléments nécessaires au bon fonctionnement de
-ScoDoc.
+ScoDoc.
+### Quand et comment mettre à jour le logiciel ?
-### Quand et comment mettre à jour le logiciel ?
Les mises à jour sont normalement automatiquement appliquées chaque nuit,
assurant la sécurité et l'actualisation de ScoDoc.
@@ -136,27 +142,27 @@ Des améliorations et corrections sont fréquemment introduites. Les plus
importantes sont annoncées sur la liste de diffusion
"[scodoc-annonces](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-annonces)".
-Voir aussi la page [MisesAJour](MisesAJour.md).
+Voir aussi la page [MisesAJour](MisesAJour.md).
+### Quelles sauvegardes des données ?
-
-### Quelles sauvegardes des données ?
Voir [SauvegardesBases](SauvegardesBases.md).
-
-### Où sont les journaux (logs) ?
+### Où sont les journaux (logs) ?
Les administrateurs du serveur peuvent consulter:
- * Le journal du serveur Web (nginx)
-```
+
+* Le journal du serveur Web (nginx)
+
+```text
/var/log/nginx/scodoc*.log
```
- * le fichier `/opt/scodoc-data/log/scodoc.log` reçoit des messages de déboggage
- de ScoDoc.
+* le fichier `/opt/scodoc-data/log/scodoc.log` reçoit des messages de déboggage
+ de ScoDoc.
+### J'ai installé ScoDoc mais je n'ai pas de certificat SSL !
-### J'ai installé ScoDoc mais je n'ai pas de certificat SSL !
Il est de plus en plus important d'installer un certificat SSL; les navigateurs
Web sont de plus en plus méfiants et vos utilisateurs seront très gênés si votre
ScoDoc n'a pas de certificat valide. Si votre établissement (par exemple via
@@ -168,17 +174,18 @@ Pour vos tests en local, avec Chrome, modifier le paramétrage en réglant:
`chrome://flags/#allow-insecure-localhost` (et/ou taper "thisisunsafe" sur la
page bloquée).
+### Comment supprimer un département ?
-
-### Comment supprimer un département ?
Voir les commandes d'administration dans [GuideConfig](GuideConfig.md)
-
### Comment contribuer au projet ?
-[Voir la page](Contribuer.md).
+[Voir la page "contribuer"](Contribuer.md).
!!! note "Voir aussi"
- - [Contacts](Contact.md).
+ - [Guide administrateur ScoDoc](GuideAdminSys.md)
+ - [Guide du responsable de formation](GuideAdminFormation.md)
+ - [Guide utilisateur](GuideUtilisateur.md)
+ - [Contacts](Contact.md)
- Tutoriels sur YouTube
diff --git a/docs/FormulesCalculUtilisateur.md b/docs/FormulesCalculUtilisateur.md
index 9a674f2cc..3cee63516 100644
--- a/docs/FormulesCalculUtilisateur.md
+++ b/docs/FormulesCalculUtilisateur.md
@@ -1,4 +1,4 @@
-# Obsolète, non disponible en ScoDoc 9.
+# Obsolète, non disponible en ScoDoc 9
**Les formules utilisateurs, disponibles à titre expérimental en
@@ -6,88 +6,111 @@ ScoDoc version 7,
posaient maints problèmes de performance et de maintenance, et ne sont plus
utilisées en ScoDoc 9.**
-## Formules utilisateurs pour le calcul des moyennes
-Dans certains cas (assez rares), on veut calculer la note d'un module autrement qu'avec une simple moyenne des notes pondérée par les
-coefficients des évaluations. Par exemple, on veut parfois prendre la meilleure note de deux évaluations. On peut alors définir une formule ad-hoc pour le calcul de la moyenne du module.
+## Formules utilisateurs pour le calcul des moyennes
+
+Dans certains cas (assez rares), on veut calculer la note d'un module autrement
+qu'avec une simple moyenne des notes pondérée par les coefficients des
+évaluations. Par exemple, on veut parfois prendre la meilleure note de deux
+évaluations. On peut alors définir une formule ad-hoc pour le calcul de la
+moyenne du module.
Les formules sont aussi utilisable pour calculer la moyenne d'une Unité d'Enseignement (UE).
- Attention: l'utilisation de formules ralenti considérablement les traitements, et devrait être réservé à des cas exceptionnels.
+ Attention: l'utilisation de formules ralenti considérablement les
+traitements, et devrait être réservé à des cas exceptionnels.
+### Détails
-### Détails
-Le problème est compliqué par le fait que les notes à traitées ne sont pas toujours des nombres: absences, notes en attentes ou manquantes...
+Le problème est compliqué par le fait que les notes à traitées ne sont pas
+toujours des nombres: absences, notes en attentes ou manquantes...
La formule reçoit donc:
- * Un tableau (vecteur) de notes (noté "notes"), de taille fixe et égale au nombre d'évaluations définies. Dans ce tableau, les notes "manquantes" ou "neutralisée" sont remplacées par des zéros. Les valeurs sont toujours entre 0 et 20. Toutes les évaluations sont présentes, même celle des évaluation incomplètes (mais leurs notes sont mises à zéro, même celles des étudiants qui ont une note note).
+* Un tableau (vecteur) de notes (noté "notes"), de taille fixe et égale au
+ nombre d'évaluations définies. Dans ce tableau, les notes "manquantes" ou
+ "neutralisée" sont remplacées par des zéros. Les valeurs sont toujours entre 0
+ et 20. Toutes les évaluations sont présentes, même celle des évaluation
+ incomplètes (mais leurs notes sont mises à zéro, même celles des étudiants qui
+ ont une note note).
- * Un tableau des coefficients de chaque évaluation, dans lequel les valeurs correspondants aux notes "manquantes" sont nulles.
+* Un tableau des coefficients de chaque évaluation, dans lequel les valeurs
+ correspondants aux notes "manquantes" sont nulles.
-Dans ces tableaux, les évaluations sont ordonnées en fonction de leur place sur le tableau de bord du module: l'ordre des évaluation (par défaut par date) peut être modifié par l'utilisateur en utilisant les flèches.
+Dans ces tableaux, les évaluations sont ordonnées en fonction de leur place sur
+le tableau de bord du module: l'ordre des évaluation (par défaut par date) peut
+être modifié par l'utilisateur en utilisant les flèches.
-Ainsi, si on a pour un étudiant deux évaluations de coefficients 2 et
-3 avec les notes (12/20 et 16/20), on aura:
-```
+Ainsi, si on a pour un étudiant deux évaluations de coefficients 2 et 3 avec les
+notes (12/20 et 16/20), on aura:
+
+```py
notes = [ 12., 20. ]
coefs = [ 2., 3. ]
```
-Quelques fonctions sont définies: `abs, cmp, dot, len, map, max, min, pow, reduce, round, sum, ifelse`.
+Quelques fonctions sont définies:
+`abs, cmp, dot, len, map, max, min, pow, reduce, round, sum, ifelse`.
Exemples:
- * Le max de deux évaluations: `max( notes[0], notes[1] )` (*voir une meilleure approche plus bas*)
- * La moyenne classique: `dot( notes, coefs ) / sum(coefs)` (la fonction dot est le produit scalaire habituel)
- * Ajouter 1 à la moyenne: `ifelse(moy_is_valid, min(moy_val + 1, 20), moy)`
- * `ifelse(condition, valeur_si_vrai, valeur_si_faux)`
- * on utilise `min` car le résultat ne doit en aucun cas dépasser 20
- * pour le calcul, on utilise la variable `moy_val` (un nombre)
- * si la moyenne n'est pas valide, on renvoie la valeur `moy` (ce qui permet de garder le bon code)
- * Le max de deux évaluations, en résistant aux notes manquantes: `ifelse(moy_is_valid, max(notes[0], notes[1]), moy)`
-
+* Le max de deux évaluations: `max( notes[0], notes[1] )` (*voir une meilleure approche plus bas*)
+* La moyenne classique: `dot( notes, coefs ) / sum(coefs)` (la fonction dot est le produit scalaire habituel)
+* Ajouter 1 à la moyenne: `ifelse(moy_is_valid, min(moy_val + 1, 20), moy)`
+ * `ifelse(condition, valeur_si_vrai, valeur_si_faux)`
+ * on utilise `min` car le résultat ne doit en aucun cas dépasser 20
+ * pour le calcul, on utilise la variable `moy_val` (un nombre)
+ * si la moyenne n'est pas valide, on renvoie la valeur `moy` (ce qui permet de garder le bon code)
+* Le max de deux évaluations, en résistant aux notes manquantes: `ifelse(moy_is_valid, max(notes[0], notes[1]), moy)`
Autres variables définies dans les formules:
- * moy : la valeur de la moyenne calculée classiquement (somme pondérée) *attention, ce n'est pas forcément un nombre !*
- * moy_val: la valeur de la moyenne (moy) (toujours un nombre, valant 0 si moyenne invalide)
- * moy_is_valid: vrai si la moyenne (moy) est valide (numérique). Par exemple, si absence EXCusée, la moyenne n'est pas valide.
- * cmask : un vecteur de 0/1, 0 si l'évaluation correspondante n'a pas de note, 1 sinon.
- * nbabs : nombre d'absences de l'étudiant dans le semestre (en demi-journées)
- * nbabs_just: nombre d'absences *justifiées* de l'étudiant dans le semestre (en demi-journées)
- * nbabs_nojust : nombre d'absences *non justifiées* de l'étudiant dans le semestre (en demi-journées)
+* moy : la valeur de la moyenne calculée classiquement (somme pondérée) *attention, ce n'est pas forcément un nombre !*
+* moy_val: la valeur de la moyenne (moy) (toujours un nombre, valant 0 si moyenne invalide)
+* moy_is_valid: vrai si la moyenne (moy) est valide (numérique). Par exemple, si absence EXCusée, la moyenne n'est pas valide.
+* cmask : un vecteur de 0/1, 0 si l'évaluation correspondante n'a pas de note, 1 sinon.
+* nbabs : nombre d'absences de l'étudiant dans le semestre (en demi-journées)
+* nbabs_just: nombre d'absences *justifiées* de l'étudiant dans le semestre (en demi-journées)
+* nbabs_nojust : nombre d'absences *non justifiées* de l'étudiant dans le semestre (en demi-journées)
-Attention: pour les conditions, on utilisera la fonction `ifelse`: comme pour tout appel de fonction python, les arguments cette dernière sont évalués avant l'appel, ce qui implique que les deux branches (vraie et faux) sont toujours évaluées. Ce détail est important si l'une d'entre elle déclenche une exception !
+Attention: pour les conditions, on utilisera la fonction `ifelse`: comme pour
+tout appel de fonction python, les arguments cette dernière sont évalués avant
+l'appel, ce qui implique que les deux branches (vraie et faux) sont toujours
+évaluées. Ce détail est important si l'une d'entre elle déclenche une exception!
+### Calcul des moyennes d'UE
-
-### Calcul des moyennes d'UE
-Dans les formules de calcul des moyennes d'UE, on peut utiliser soit le vecteur de notes soit avec des indices numériques (comme ci-dessus, les moyennes de modules étant accessibles dans l'ordre sous lequel elle apparaissent dans les bulletins de notes), soit en utilisant le code du module.
+Dans les formules de calcul des moyennes d'UE, on peut utiliser soit le vecteur
+de notes soit avec des indices numériques (comme ci-dessus, les moyennes de
+modules étant accessibles dans l'ordre sous lequel elle apparaissent dans les
+bulletins de notes), soit en utilisant le code du module.
Ainsi, la moyenne du module `BD1` serait aussi accessible comme la variable `notes['BD1']`.
-Exemple: dans une UE, on veut ajouter la note du module SPORT (qui aurait été défini avec un coefficient nul dans le programme), on écrira:
-```
+Exemple: dans une UE, on veut ajouter la note du module SPORT (qui aurait été
+défini avec un coefficient nul dans le programme), on écrira:
+
+```py
ifelse(moy_is_valid, min(moy_val+notes['SPORT'], 20), moy)
```
+### Traitement des erreurs
-### Traitement des erreurs
-La formule doit ramener une valeur numérique entre 0 et 20, sans quoi
-ScoDoc considère la note erronée et la remplace par le code 'ERR' (qui
-se voit dans le tableau récapitulatif des notes et sur les bulletins).
-Idem pour tout autre erreur de calcul pouvant se produire.
-Si vous voyez des 'ERR', corrigez votre formule ! (message d'erreur affiché sur le tableau de bord du semestre)
+La formule doit ramener une valeur numérique entre 0 et 20, sans quoi ScoDoc
+considère la note erronée et la remplace par le code 'ERR' (qui se voit dans le
+tableau récapitulatif des notes et sur les bulletins). Idem pour tout autre
+erreur de calcul pouvant se produire. Si vous voyez des 'ERR', corrigez votre
+formule ! (message d'erreur affiché sur le tableau de bord du semestre)
+## Exemples de formules de calcul utiles
-
-## Exemples de formules de calcul utiles
-### Exemple (contribué par Cédric C., IUT de Bordeaux)
+### Exemple (contribué par Cédric C., IUT de Bordeaux)
*J'ai réussi à faire mon calcul de moyenne pour une évaluation ayant pour calcul :* `moyenne(DS5, TD4, moyenne(TP1,TP2,TP3))`
-*Si cela vous intéresse, voici le détail : *
+*Si cela vous intéresse, voici le détail :*
+
```
Moyenne des [TPs](TPs.md)
(notes[1]*coefs[1]+notes[2]*coefs[2]+notes[3]*coefs[3])/(coefs[1]+coefs[2]+coefs[3])
@@ -110,9 +133,4 @@ Ifelse(max(max(max(max(cmask[1], cmask[2]), cmask[3]), cmask[4]), cmask[5]),monc
Soit la formule finale de moyenne de production
ifelse(max(max(max(max(cmask[1], cmask[2]), cmask[3]), cmask[4]), cmask[5]), ((notes[5]*coefs[5]+notes[4]*coefs[4]+ (notes[1]*coefs[1]+notes[2]*coefs[2]+notes[3]*coefs[3])/( ifelse(max(max(cmask[1],cmask[2]),cmask[3]), coefs[1]+coefs[2]+coefs[3],1)
)))/max(coefs[5]+coefs[4]+max(max(cmask[1],cmask[2]),cmask[3]),1) ,moy)
-```
-
-
-### Autres exemples
-*à compléter, n'hésitez pas à envoyer vos exemples !*
-
+```
\ No newline at end of file
diff --git a/docs/GestionLogos.md b/docs/GestionLogos.md
index d203d0a8d..78244ac6c 100644
--- a/docs/GestionLogos.md
+++ b/docs/GestionLogos.md
@@ -2,13 +2,13 @@
# Gestions des logos et fonds de documents
Images (logos ou autre) à afficher sur des documents PDF générés par ScoDoc:
-
- * Sur les PV, `logo_header.jpg` est affiché en haut, et `logo_header.jpg` en bas de la page.
- * Sur les bulletins de notes, c'est configurable (et on peut utiliser d'autres
- logos), voir [ParametrageBulletins](ParametrageBulletins.md)
- * Fonds de page: charger une image nommée `pvjury_background` pour les PV de
- jury (en format paysage) ou `letter_background`pour les bulletins et lettres
- de jury (en format portrait). Voir [paramétrage des PV](ParametragePV.md).
+
+* Sur les PV, `logo_header.jpg` est affiché en haut, et `logo_header.jpg` en bas de la page.
+* Sur les bulletins de notes, c'est configurable (et on peut utiliser d'autres
+ logos), voir [ParametrageBulletins](ParametrageBulletins.md)
+* Fonds de page: charger une image nommée `pvjury_background` pour les PV de
+ jury (en format paysage) ou `letter_background`pour les bulletins et lettres
+ de jury (en format portrait). Voir [paramétrage des PV](ParametragePV.md).
Ces images peuvent être chargées ou modifiées par l'administrateur via le menu
"*configuration*" sur la page d'accueil de ScoDoc.
@@ -18,20 +18,22 @@ Ces images peuvent être chargées ou modifiées par l'administrateur via le men
Normalement, l'administrateur n'a pas besoin d'intervenir dans les répertoires
mentionnés ci-dessous (sauf pour veiller à ce que `/opt/scodoc-data` soit bien
-sauvegardé ou transféré lors des migrations).
+sauvegardé ou transféré lors des migrations).
La totalité des opérations nécessaires à l'utilisation de ScoDoc peuvent être
-réalisées par le menu de configuration des logos.
+réalisées par le menu de configuration des logos.
### Fichiers et répertoires associés aux logos
-Les images (logos et fonds de document) sont enregistrées dans le répertoire `/opt/scodoc-data/config/logos` et ses sous-répertoires.
+Les images (logos et fonds de document) sont enregistrées dans le répertoire
+`/opt/scodoc-data/config/logos` et ses sous-répertoires.
-Les images ajoutées par les utilisateurs ont toutes un nom de la forme `logo_.png` ou `logo_.jpg`
-(`` représente le nom d'usage du logo : *header*, *footer*, signature, ... au choix de l'utilisateur)
-Les sous-répertoires ont des noms de la forme `logos_` où `` est
-l'identifiant numérique du département
-(la commande `flask list-depts` donne la correspondance cf. [Administration en ligne de commande](GuideConfig.md)).
+Les images ajoutées par les utilisateurs ont toutes un nom de la forme
+`logo_.png` ou `logo_.jpg` (`` représente le nom d'usage du logo:
+*header*, *footer*, signature, ... au choix de l'utilisateur) Les
+sous-répertoires ont des noms de la forme `logos_` où `` est
+l'identifiant numérique du département (la commande `flask list-depts` donne la
+correspondance cf. [Administration en ligne de commande](GuideConfig.md)).
Les **fonds de page** se distinguent uniquement des logos par leur nom (`` peut être soit `jpg`ou `png`) :
@@ -51,3 +53,8 @@ exceptionnellement prise en compte. Bien évidemment, si un fichier scodoc9 (don
avec le préfixe `logo_`) est présent, il est prioritaire sur le fond de page
"historique".
+!!! note "Voir aussi"
+
+ - [Guide administrateur ScoDoc](GuideAdminSys.md)
+ - [FAQ](FAQ.md)
+ - [Contacts](Contact.md)
diff --git a/docs/GuideAdminFormation.md b/docs/GuideAdminFormation.md
index abf685ee5..34093045e 100644
--- a/docs/GuideAdminFormation.md
+++ b/docs/GuideAdminFormation.md
@@ -128,11 +128,11 @@ fichiers sur la page
!!! note "Voir aussi"
- - [Guide utilisateurs](GuideUtilisateur.md)
+ - [Guide utilisateur](GuideUtilisateur.md)
- [Tutoriels vidéo](https://www.youtube.com/channel/UCb0JYCBRi0CsE4XFp4ByhXg)
- [Gestion des UE Bonus](https://www.youtube.com/watch?v=SVbjuDpq-lI)
- [Mise en place des parcours BUT](https://www.youtube.com/watch?v=OnuOXJo-3ro)
- [Saisie des codes Apogée](https://www.youtube.com/watch?v=MW0nNhbBjDM)
- [Du DUT au BUT: comment transformer un programme](https://www.youtube.com/watch?v=9HizGTvYgck)
- [FAQ](FAQ.md)
- - [Contacts](Contact.md).
+ - [Contacts](Contact.md)
diff --git a/docs/GuideAdminSys.md b/docs/GuideAdminSys.md
index a558d194b..d192904e8 100644
--- a/docs/GuideAdminSys.md
+++ b/docs/GuideAdminSys.md
@@ -40,4 +40,4 @@ Utilisez un **serveur virtuel** ou un container Docker si vous n'avez pas de mac
- [Guide pour les développeurs](GuideDeveloppeurs.md)
- [FAQ](FAQ.md)
- - [Contacts](Contact.md).
+ - [Contacts](Contact.md)
diff --git a/docs/GuideConfig.md b/docs/GuideConfig.md
index 0f5d0ee29..201c58154 100644
--- a/docs/GuideConfig.md
+++ b/docs/GuideConfig.md
@@ -1,11 +1,10 @@
-## Prise en main et paramétrage de ScoDoc 9
+# Prise en main et paramétrage de ScoDoc 9
Ce document suppose que le logiciel a été installé suivant la procédure décrite dans
[GuideInstallDebian11](GuideInstallDebian11.md).
-
-## Administration en ligne de commande
+## Administration en ligne de commande
Les opérations d'administration se résument à la création de départements, et la
création d'utilisateurs "super admin", c'est à dire admin pour tous les
@@ -64,6 +63,7 @@ Il s'agit d'un utilisateur ayant tous les droits, comme s'il était
où `admin2` est ici le pseudo du nouvel admin.
### Changement du mot de passe d'un utilisateur
+
Cette opération peut s'effectuer via la page de gestion web des
utilisateurs, mais il est parfois commode de le faire depuis la
console:
@@ -111,6 +111,7 @@ départements (utile pour certains compte administrateurs ou utilisés en lectur
par des clients de l'API).
### Migration des données de ScoDoc 7
+
Les données dans ScoDoc 9 ayant un format et une organisation très différents
de ScoDoc 7, une étape de conversion (migration) est nécessaire. Elle est automatique
mais prend du temps.
@@ -128,6 +129,7 @@ départements.
flask import-scodoc7-users
#### Départements
+
Pour migrer un seul département:
flask import-scodoc7-dept DEPT DBNAME
@@ -327,7 +329,7 @@ Options:
(*la liste ci-dessus est générée à l'aide de la commande* `flask dumphelp`).
-### Changement des logos apparaissant sur les documents
+### Changement des logos apparaissant sur les documents
*Note: après migration, vos logos de ScoDoc 7 sont installés dans ScoDoc 9*.
@@ -339,12 +341,24 @@ distribués. Pour les changer, passer par la page d'administration (lien
## Utilisation via le Web
- * Connectez-vous au site: `https://votre.site.fr/`
+* Connectez-vous au site: `https://votre.site.fr/`
+
+Vous allez voir la page d'accueil de ScoDoc, vous permettant de choisir le
+département où travailler.
+
+ Surtout, évitez de travailler comme "admin" (super admin): prenez
+le temps de créer un utilisateur "chef de département !" dans chaque
+département, qui à son tour peut déléguer des droits.
-Vous allez voir la page d'accueil de ScoDoc, vous permettant de choisir le département
-où travailler.
+!!! note "Voir aussi"
- Surtout,
-évitez de travailler comme "admin" (super admin): prenez le temps de créer un utilisateur
-"chef de département !" dans chaque département, qui à son tour peut déléguer des droits.
+ - [Guide installation](GuideInstallDebian11.md)
+ - [Gestion des utilisateurs](AdminUsers.md)
+ - [Rôles et permissions](ConfigPermissionsDept.md)
+ - [Configuration des envois d'emails](ConfigEmail.md)
+ - [Configuration des logos et fonds de documents](GestionLogos.md)
+ - [Guide administrateur ScoDoc](GuideAdminSys.md)
+ - [FAQ](FAQ.md)
+ - [Contacts](Contact.md)
diff --git a/docs/GuideDeveloppeurs.md b/docs/GuideDeveloppeurs.md
index 1199df4ad..526b340b5 100644
--- a/docs/GuideDeveloppeurs.md
+++ b/docs/GuideDeveloppeurs.md
@@ -34,6 +34,8 @@ tout commit (configurez votre éditeur pour appeler `black` à l'enregistrement)
On pourra adopter le style "Google":
Exemple:
+
+```py
"""Description résumée de la fonction
blah blah sur la fonction
@@ -54,6 +56,7 @@ Exemple:
b'Zim': ('Irk', 'Invader'),
b'Lrrr': ('Omicron Persei 8', 'Emperor')}
"""
+```
### Git
@@ -71,20 +74,22 @@ Ci-dessous quelques pense-bête qui peuvent servir.
Pour les développeurs internes (écriture sur le dépôt master), un exemple
basique illustrant le cycle de développement:
- # Créer une branche
- # si besoin (travail en cours), utiliser git stash avant
- git checkout master
- git branch hotfix
- git checkout hotfix
- ... dev, test ...
- git add ...
- git commit -m "fixed ..."
- git checkout master
- git merge hotfix
- git branch -d hotfix
- # publication
+```bash
+ # Créer une branche
+ # si besoin (travail en cours), utiliser git stash avant
+ git checkout master
+ git branch hotfix
+ git checkout hotfix
+ ... dev, test ...
+ git add ...
+ git commit -m "fixed ..."
+ git checkout master
+ git merge hotfix
+ git branch -d hotfix
+ # publication
- # éventuellement: git stash pop
+ # éventuellement: git stash pop
+```
Dans la plupart des cas, on travaillera sur son propre dépôt (clone du dépt
origine), et on proposera une *pull request* (PR, *demande d'ajout* en français).
@@ -107,7 +112,7 @@ mises à jour de `master` (remote), faire:
Lint tous les fichiers modifiés:
-```bash
+```bash
git status | grep modified | grep .py | awk '{print $2}' | xargs pylint -E
```
@@ -128,14 +133,15 @@ Prépare un sed pour renommer les variables non définies:
Restore les modes au besoin (SAMBA les changent parfois):
-```bash
+```bash
git diff -p -R --no-color | grep -E "^(diff|(old|new) mode)" --color=never | git apply
```
-
Note pour travailler sur VirtualBox:
- addgroup scodoc vboxsf
+```text
+ addgroup scodoc vboxsf
+```
### Préparation d'une PR (Pull Request)
@@ -161,7 +167,8 @@ demande d'ajout (*pull request*, dite "PR"):
Les manipulations sont décrites selon quatre phases du développement : l'installation,
la mise en place, le suivi et la livraison.
-##### l'installation
+##### L'installation
+
Il est pratique d'avoir en ligne les deux dépôts git distants que vous pouvez
utiliser : votre dépôt personnel (`https://scodoc.org/git//.git`) et
le dépôt officiel (`https://scodoc.org/git/ScoDoc/ScoDoc.git`).
@@ -207,10 +214,10 @@ principale évolue pendant ce temps.
Pour garder la cohérence, il est nécessaire de réintégrer en local les
modifications de la branche principale. Ceci peut se faire de deux façons.
-- Une fusion (`merge`) applique toutes les modifications en un seul commit).
+* Une fusion (`merge`) applique toutes les modifications en un seul commit).
C'est la méthode couramment utilisée.
-- Un `rebase` rejoue tous les commits de la nouvelle branche par dessus l'état
+* Un `rebase` rejoue tous les commits de la nouvelle branche par dessus l'état
le plus à jour de la branche principale (il en résulte un historique plus
linéaire).
@@ -266,7 +273,7 @@ exemple):
```
Utilisateurs Windows : Vérifiez bien que les réglages de fin de ligne suivent
-bien les règles Linux (pas de retour chariot (noté CR ou `\r`) en fin de ligne
+bien les règles Linux: pas de retour chariot (noté CR ou `\r`) en fin de ligne
mais un seul caractère line feed (noté LF ou `\n`). Le cas échéant, réglez
votre IDE pour cela.
@@ -302,7 +309,8 @@ commandes :
git rebase --continue # pour poursuivre le processus
git rebase --abort # pour tout abandonner
```
-_vous permettront de résoudre ces problèmes exceptionnels_.
+
+*vous permettront de résoudre ces problèmes exceptionnels*.
Application:
@@ -370,7 +378,7 @@ Quand vous sortez de l'éditeur, git effectue toutes les opérations demandées.
* toutes les différences entre officiel/master et votre branche locale sont
signifiantes.
-##### Étape 4 :
+##### Étape 4
Vous pouvez maintenant pousser votre branche locale sur votre dépôt personnel
(vers une branche de même nom):
@@ -435,7 +443,7 @@ bibliothèques, ou autres expériences de ce genre, vous pouvez le récréer ain
Puis soit vous installez les versions "officielles" (testées)
-```
+```bash
pip install -r requirements-3.9.txt
```
@@ -445,6 +453,7 @@ faire ceci est:
```bash
cut -d= -f 1 requirements-3.9.txt | xargs pip install
```
+
à adapter selon vos objectifs.
Pour régénérer le fichier indiquant la liste des paquets:
@@ -456,15 +465,11 @@ Pour régénérer le fichier indiquant la liste des paquets:
Note: la mise à jour par `apt` recrée le virtualenv à chaque fois.
## Roadmap
-Sujets **prioritaires** en 2021-2022:
-- Modernisation du code: Flask, Python 3: achevé août 2021.
+ * [voir les tickets](https://scodoc.org/git/viennet/ScoDoc/issues)
-- Prise en compte du Bachelor (BUT): SAÉ, suivi compétences, validations des
- blocs, UE, semestres selon la cadrage et l'arrêté Licence Pro 2020. (achevé
- avec ScoDoc 9.2 puis complété en 9.3 et 9.4)
-- Définition et développement nouvelle API (achevé avec 9.3 en juillet 22)
-
-Autres sujets:
- - [voir les tickets](https://scodoc.org/git/viennet/ScoDoc/issues)
+!!! note "Voir aussi"
+
+ - [FAQ](FAQ.md)
+ - [Contacts](Contact.md)
\ No newline at end of file
diff --git a/docs/GuideInstallDebian11.md b/docs/GuideInstallDebian11.md
index 89b0d41e3..2e0b7a53c 100644
--- a/docs/GuideInstallDebian11.md
+++ b/docs/GuideInstallDebian11.md
@@ -12,30 +12,29 @@ système Linux.
Cette documentation est prévue pour installer ScoDoc version 9 sur un système
[Debian](http://www.debian.org) 11 (Bullseye, stable) s'exécutant sur une
-machine intel-like **64bits** (architecture **AMD64**). Debian s'installe
-facilement en cinq minutes, sur une machine normale ou un serveur
-virtualisé. Il est **vivement déconseillé** de tenter l'installation sur une
-autre version.
+machine intel-like **64bits** (architecture **AMD64** sur Intel/AMD, ou
+**aarch64** sur Apple ARM). Debian s'installe facilement en cinq minutes, sur
+une machine normale ou un serveur virtualisé. Il est **vivement déconseillé** de
+tenter l'installation sur une autre version.
Si vous mettez à jour un serveur existant (ScoDoc 7 sur Debian 10), voir [la page
sur les migrations](https://scodoc.org/MigrationScoDoc7a9/#2-upgrade-debian).
Merci de signaler tout problème [sur le Discord](https://discord.gg/ybw6ugtFsZ)
-ou éventuellement la liste [scodoc-devel](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-devel) ).
+ou éventuellement la liste [scodoc-devel](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-devel).
- Note: l'image du CD d'installation de Debian (amd64) peut se trouver ici:
[https://www.debian.org/distrib/netinst](https://www.debian.org/distrib/netinst.md),
choisir la version "petits CD" pour **amd64**
(*Il est indispensable d'utiliser une version 64 bits !*)
-
🚸 **Important:**
+
La procédure d'installation décrite ci-dessous suppose que ScoDoc va s'exécuter
sur un serveur dédié. Pour faire des tests, utilisez un serveur virtuel (comme
-VirtualBox ou VMWare). L'installation ci-dessous va en effet modifier de
-nombreux paramètres de votre système Linux (serveur web, firewall, serveur SQL,
-messagerie, ...).
-
+VirtualBox ou VMWare, ou UTM sur Mac). L'installation ci-dessous va en effet
+modifier de nombreux paramètres de votre système Linux (serveur web, firewall,
+serveur SQL, messagerie, ...).
## 1) Préalable: configurer un serveur linux
@@ -145,7 +144,6 @@ redémarrer le service:
[ce post sur Stack Overflow](
https://stackoverflow.com/questions/9445489/performing-http-requests-with-curl-using-proxy).
-
#### Note sur l'install dans un container LXC
Il y a deux possibilités :
@@ -308,3 +306,10 @@ bloquage des envois de mails). Au besoin, il est possible de désactiver IPv6
- Mettez en place des [sauvegardes](SauvegardesBases.md)
- Abonnez-vous au moins à la liste d'annonces: voir [contacts](Contact.md)
+
+!!! note "Voir aussi"
+
+ - [Guide configuration](GuideConfig.md)
+ - [Guide administrateur ScoDoc](GuideAdminSys.md)
+ - [FAQ](FAQ.md)
+ - [Contacts](Contact.md)
diff --git a/docs/GuideUtilisateur.md b/docs/GuideUtilisateur.md
index c60d26834..527009dc4 100644
--- a/docs/GuideUtilisateur.md
+++ b/docs/GuideUtilisateur.md
@@ -1,46 +1,66 @@
# Utilisation de ScoDoc
-ScoDoc contrôle les opérations via un mécanisme de permissions facile à mettre en œuvre et permettant de bien répartir les rôles entre les utilisateurs: responsables, enseignants, secrétariats.
+ScoDoc contrôle les opérations via un mécanisme de permissions facile à mettre
+en œuvre et permettant de bien répartir les rôles entre les utilisateurs:
+responsables, enseignants, secrétariats.
## Pour le responsable de formation
-La définition des programmes, l'inscription des étudiants et certains paramétrages ne sont accessibles qu'au responsable de formation, ou chef de département.
-- [Guide pour le responsable de formation](GuideAdminFormation.md)
- * [Modification d'un programme pédagogique et versions](VersionProgrammes.md)
- * [Exemples et partages de programmes pédagogiques entre établissements](ExemplesProgrammesPedagogiques.md)
- * [Importation des étudiants](ImportationEtuds.md)
+La définition des programmes, l'inscription des étudiants et certains
+paramétrages ne sont accessibles qu'au responsable de formation, ou chef de
+département.
+
+* [Guide pour le responsable de formation](GuideAdminFormation.md)
+ * [Modification d'un programme pédagogique et versions](VersionProgrammes.md)
+ * [Exemples et partages de programmes pédagogiques entre établissements](ExemplesProgrammesPedagogiques.md)
+
+* [Importation des étudiants](ImportationEtuds.md)
+
* [Synchronisation des inscrits avec Apogée](SynchroApogee.md)
* [Procédure d'inscription des étudiants via Apogée](InscriptionsEtudApogee.md)
* [Données sur l'origine des étudiants](DonneesAdmissions.md)
* [Gestion des photos des étudiants](GestionPhotos.md)
* [Coordonnées des étudiants](GestionAdresses.md)
- * [Opérations en fin de semestre (jury, ré-inscriptions, ...)](TransitionSemestre.md)
- * [Export des résultats et décisions de jury vers Apogée](ScoDocApogee.md)
- * [Utilisation des rôles et permissions](ConfigPermissionsDept.md)
-## Pour les enseignants et administratifs:
+* [Opérations en fin de semestre (jury, ré-inscriptions, ...)](TransitionSemestre.md)
+* [Export des résultats et décisions de jury vers Apogée](ScoDocApogee.md)
+* [Utilisation des rôles et permissions](ConfigPermissionsDept.md)
- * [Édition des bulletins de notes](BulletinsNotes.md)
+## Pour les enseignants et administratifs
+
+* [Édition des bulletins de notes](BulletinsNotes.md)
* [paramétrage des bulletins pdf](ParametrageBulletins.md)
- * [Édition des PV de jury](ParametragePV.md)
- * Comment sont calculées les moyennes : [Calcul des notes](CalculNotes.md)
+
+* [Édition des PV de jury](ParametragePV.md)
+* Comment sont calculées les moyennes : [Calcul des notes](CalculNotes.md)
## Opérations diverses
-#### Tenue des jurys et commissions
- * [Saisie des décisions](SaisieDecisionsJury.md)
- * [Gestion des commissions et jurys, édition des PV](GestionJury.md)
- * [Capitalisation des UE](CapitalisationUE.md)
- * [Compensation automatique des semestres](CompensationSemestre.md)
+### Tenue des jurys et commissions
-#### Suivi de l'assiduité
+* [Saisie des décisions](SaisieDecisionsJury.md)
+* [Gestion des commissions et jurys, édition des PV](GestionJury.md)
+* [Capitalisation des UE](CapitalisationUE.md)
- * [Suivi de l'assiduité des étudiants](GestionAbsences.md)
+### Spécificités du BUT
-#### Rapports, avis et tableaux de bords
+(documentation à venir)
- * [Rapports, suivi de cohortes, parcours](RapportsStatistiques.md)
- * [Génération des avis de poursuite d'études](AvisPoursuiteEtudes.md)
+### Spécificités du DUT
-## Questions fréquentes
-Voir la [FAQ](FAQ.md)
+* [Compensation automatique des semestres](CompensationSemestre.md)
+
+### Suivi de l'assiduité
+
+* [Suivi de l'assiduité des étudiants](GestionAbsences.md)
+
+### Rapports, avis et tableaux de bords
+
+* [Rapports, suivi de cohortes, parcours](RapportsStatistiques.md)
+* [Génération des avis de poursuite d'études](AvisPoursuiteEtudes.md)
+
+!!! note "Voir aussi"
+
+ - [Guide du responsable de formation](GuideAdminFormation.md)
+ - [FAQ](FAQ.md)
+ - [Contacts](Contact.md).
diff --git a/docs/MisesAJour.md b/docs/MisesAJour.md
index d404bfbb2..2099bea70 100644
--- a/docs/MisesAJour.md
+++ b/docs/MisesAJour.md
@@ -1,11 +1,14 @@
+# Mise à jour de ScoDoc 9
+
Il est nécessaire de mettre à jour très fréquemment votre installation ScoDoc.
-
-# Mise à jour de ScoDoc 9
-
À partir de ScoDoc 9, les mises à jour sont automatiques. Au besoin, on peut en
lancer une à tout moment avec la commande
apt update && apt-get upgrade
+!!! note "Voir aussi"
+
+ - [Guide administrateur ScoDoc](GuideAdminSys.md)
+ - [Contacts](Contact.md)
\ No newline at end of file
diff --git a/docs/ParametrageBulletins.md b/docs/ParametrageBulletins.md
index 8d3760f9d..2f688ee0a 100644
--- a/docs/ParametrageBulletins.md
+++ b/docs/ParametrageBulletins.md
@@ -1,37 +1,50 @@
-# Paramétrage des bulletins de notes
-Ces réglages permettent de configurer la présentation des relevés de notes au format PDF.
+# Paramétrage des bulletins de notes
+
+Ces réglages permettent de configurer la présentation des relevés de notes au
+format PDF.
Le bulletin est constitué de plusieurs zones:
- * Le titre;
- * le tableau des notes;
- * les absences et appréciations (immédiatement sous le tableau des notes; les absences ne sont mentionnés que si la case "Indiquer les absences sur les bulletins" est cochée);
- * la situation de l'étudiant (inscription, décision de jury, validations d'UE);
- * la signature de gauche et celle de droite;
- * le pied de page.
-
-Le contenu et la présentation des zones titre, situation et signatures sont paramétrables à l'aide de formats utilisant un balisage XML assez simple.
+* Le titre;
+* le tableau des notes;
+* les absences et appréciations (immédiatement sous le tableau des notes; les
+ absences ne sont mentionnés que si la case "Indiquer les absences sur les
+ bulletins" est cochée);
+* la situation de l'étudiant (inscription, décision de jury, validations d'UE);
+* la signature de gauche et celle de droite;
+* le pied de page.
+Le contenu et la présentation des zones titre, situation et signatures sont
+paramétrables à l'aide de formats utilisant un balisage XML assez simple.
+
+## Marges et position du pied de page
-## Marges et position du pied de page
Les bulletins sont formattés pour du papier A4.
-Les marges sont réglables via les valeurs dans la section "Marges additionnelles des bulletins". Ces valeurs s'ajoutent aux marges par défaut qui sont assez étroites.
+Les marges sont réglables via les valeurs dans la section "Marges additionnelles
+des bulletins". Ces valeurs s'ajoutent aux marges par défaut qui sont assez
+étroites.
-Le pied de page (*Edité par ScoDoc le ...*) n'est pas affecté par le réglage des marges, et est positionné à l'aide des paramètres "Position horizontale du pied de page pdf" (resp. verticale) dans la section "Mise en forme des documents PDF". Ces valeurs affectent tous les documents PDF générés par ScoDoc.
+Le pied de page (*Edité par ScoDoc le ...*) n'est pas affecté par le réglage des
+marges, et est positionné à l'aide des paramètres "Position horizontale du pied
+de page pdf" (resp. verticale) dans la section "Mise en forme des documents
+PDF". Ces valeurs affectent tous les documents PDF générés par ScoDoc.
+## Valeurs remplacées
-## Valeurs remplacées
-Dans les formats, les balises de la forme `%(X)s` sont remplacées par la valeur (texte) de la variable X si elle existe. Les variables définies apportent différentes informations:
+Dans les formats, les balises de la forme `%(X)s` sont remplacées par la valeur
+(texte) de la variable X si elle existe. Les variables définies apportent
+différentes informations:
+### Préférences
-### Préférences
-Toutes les préférences pour le semestre considéré (ou définies globalement) sont utilisables par leur nom.
-Voir la liste complète sur [NomsPreferences](NomsPreferences.md).
+Toutes les préférences pour le semestre considéré (ou définies globalement) sont
+utilisables par leur nom. Voir la liste complète sur
+[NomsPreferences](NomsPreferences.md).
+### Informations sur le semestre
-### Informations sur le semestre
Variable | Valeur
---------|-------
titre_num | Le titre du semestre
@@ -42,8 +55,8 @@ date_debut | 01/09/2008
date_fin | 05/07/2009
responsable | Nom du responsable du semestre (dir. des études)
+### Informations sur l'étudiant
-### Informations sur l'étudiant
Variable | Valeur (exemple)
---------|-------
nom| DUPONT
@@ -63,6 +76,11 @@ decisions_ue | noms (acronymes) des UE validées, séparées par des virgul
descr_decisions_ue| " UE acquises: UE1, UE2", ou vide si pas de dec. ou paramétrage
mention| Mention, calculée d'après la moyenne générale (vide en BUT)
|
+**Parcours et référentiel BUT** |
+ parcours_titre | "Cybersécurité"
+ parcours_code | "Cyber"
+ refcomp_specialite | "RT"
+ refcomp_specialite_long| "Réseaux et Télécommunications"
**Jurys de BUT:** |
descr_decision_annee | vide ou "Décision année: ADM" (code annuel: `ADM`, `PASD`, `DEF`...)
descr_decisions_rcue | vide ou nom de la compétence et code jury RCUE: "Administrer 1: ADM, Connecter 1: ADJ"
@@ -73,38 +91,41 @@ nbabs| nombre d'absences (en demi-journées)
nbabsjust| nombre d'abs. justifiées
|
**Autres champs:**|
-date_naissance | date, au format jj/mm/aaaa
-lieu_naissance | format libre
+date_naissance | date, au format jj/mm/aaaa
+lieu_naissance | format libre
domicile | adresse, format libre
-codepostaldomicile |
-codelycee | code national français
+codepostaldomicile |
+codelycee | code national français
|
-**Groupes:**|
+**Groupes:**|
groupes | indique les groupes auxquels appartient l'étudiant dans le semestre
group_0 | nom du groupe principal (1ère partition)
group_ | nom du group de la n-ième partition
+### Autres informations
-### Autres informations
Variable |
---------|-------
date_dmy | date courante, au format jj/mm/aaaa
date_iso | date courante, au format aaaa-mm-jj
+## Balises XML utilisées dans les formats
+Le balisage XML est celui de [ReportLab](http://www.reportlab.com/)
+(intra-paragraph markup, voir page 70 du [guide
+utilisateur](http://www.reportlab.com/docs/reportlab-userguide.pdf)). La balise
+`` n'est pas utilisable.
-## Balises XML utilisées dans les formats
-Le balisage XML est celui de [ReportLab](http://www.reportlab.com/) (intra-paragraph markup, voir page 70 du [guide utilisateur](http://www.reportlab.com/docs/reportlab-userguide.pdf)). La balise `` n'est pas utilisable.
+### Logos
-
-### Logos
Une balise supplémentaire est interprétée par ScoDoc pour insérer des logos (images).
Les logos sont des images au format JPEG (extension `.jpg` ou `.jpeg`) ou PNG
(extension `.png`), téléversés sur le serveur scodoc et intégrables dans les
-documents PDF. [Plus d'information sur la gestion des logos ici](GestionLogos.md).
+documents PDF. [Plus d'information sur la gestion des logos
+ici](GestionLogos.md).
-Principes généraux :
+Principes généraux:
* Un logo est désigné par un identifiant (nom) et peut être défini soit globalement, soit pour un département;
@@ -116,12 +137,15 @@ c'est le logo du département qui sera utilisé en lieu et place de logo global;
* les logos de nom '`header`' et '`footer`' définis globalement ne peuvent être supprimés (mais peuvent être redéfinis).
-L'enregistrement, la modification ou la suppression d'un logo peut être réalisé via la page de configuration qui est accessible aux
-administrateurs Scodoc depuis la page d'accueil.
+L'enregistrement, la modification ou la suppression d'un logo peut être réalisé
+via la page de configuration qui est accessible aux administrateurs Scodoc
+depuis la page d'accueil.
-Ce formulaire comporte une section pour les définitions globales plus une section par département.
+Ce formulaire comporte une section pour les définitions globales plus une
+section par département.
-Une section présente la liste des logos avec leurs propriétés (la dimension est donnée à titre indicatif quand elle est disponible).
+Une section présente la liste des logos avec leurs propriétés (la dimension est
+donnée à titre indicatif quand elle est disponible).
Pour chaque logo, les actions disponibles sont :
@@ -131,21 +155,25 @@ Pour chaque logo, les actions disponibles sont :
* l'ajout d'un nouveau logo dans une section (global ou département) et indiquant le nom.
-*NB*. Quelle que soit l'opération effectuée, le nom du fichier téléversé n'a aucune importance
-(Seul le nom indiqué dans le formulaire est pris en compte et le format du fichier est déduit des données propres du fichier)
+*NB*. Quelle que soit l'opération effectuée, le nom du fichier téléversé n'a
+aucune importance (Seul le nom indiqué dans le formulaire est pris en compte et
+le format du fichier est déduit des données propres du fichier)
-La balise ``, placée dans un paragraphe, insère le logo de nom `xxx` avec les dimensions indiquées.
-Le paramètre `valign` règle le positionnement vertical par rapport à la ligne de texte courante.
+La balise ``, placée
+dans un paragraphe, insère le logo de nom `xxx` avec les dimensions indiquées.
+Le paramètre `valign` règle le positionnement vertical par rapport à la ligne de
+texte courante.
-Notez qu'il est possible de ne préciser que l'une des deux dimensions hauteur ou largeur.
-Dans ce cas, la dimension manquante est déduite du ratio (rapport hauteur/largeur) de l'image originale.
-Voir un exemple d'utilisation plus bas.
+Notez qu'il est possible de ne préciser que l'une des deux dimensions hauteur ou
+largeur. Dans ce cas, la dimension manquante est déduite du ratio (rapport
+hauteur/largeur) de l'image originale. Voir un exemple d'utilisation plus bas.
### Fond de page.
Les modalités d'utilisation des fonds de pages sont similaires pour les PV, les lettres individuelles de décision et les bulletins.
Celles-ci sont décrites ici: [Paramétrage des PV. Images de fond de page](ParametragePV.md)
-## Exemples
+## Exemples
+
### Exemple 1: Bulletins par défaut
Les bulletins édités par défaut sont obtenus avec:
diff --git a/docs/UtilisateursScoDoc.md b/docs/UtilisateursScoDoc.md
index 82da0b9e2..f6dbddf8b 100644
--- a/docs/UtilisateursScoDoc.md
+++ b/docs/UtilisateursScoDoc.md
@@ -1,186 +1,197 @@
# Établissements utilisant ScoDoc
-Cette page tente de lister les utilisateurs connus de ScoDoc. Le logiciel étant libre, nous ne sommes pas en mesure de dresser une liste exhaustive. Si vous utilisez le logiciel, merci d'envoyer un mail à .
+
+Cette page tente de lister les utilisateurs connus de ScoDoc. Le logiciel étant
+libre, nous ne sommes pas en mesure de dresser une liste exhaustive. Si vous
+utilisez le logiciel, merci d'envoyer un mail à .
## Établissements membres de l'association (2020-2021) [liste non à jour]
- * [IUT d'Annecy](https://www.iut-acy.univ-smb.fr);
+* [IUT d'Annecy](https://www.iut-acy.univ-smb.fr);
- * [IUT de Besançon-Vesoul](http://iut-bv.univ-fcomte.fr), depuis 2013;
+* [IUT de Besançon-Vesoul](http://iut-bv.univ-fcomte.fr), depuis 2013;
- * [IUT de Bordeaux](http://www.iut.u-bordeaux.fr), départements GMP, GEII, GCCD, INFO, MP, HSE, SGM, GLT, GEA;
+* [IUT de Bordeaux](http://www.iut.u-bordeaux.fr), départements GMP, GEII, GCCD, INFO, MP, HSE, SGM, GLT, GEA;
- * [IUT de Cachan](http://www.iut-cachan.u-psud.fr) (Université Paris-Saclay, depuis 2009);
+* [IUT de Cachan](http://www.iut-cachan.u-psud.fr) (Université Paris-Saclay, depuis 2009);
- * [IUT de Cergy-Pontoise](http://www.iut.u-cergy.fr) tous les départements (GB, GCCD, GEII x 2, GLT, QLIO, MMI, TC x 2), DUT, LP, années spéciales et FC : plus de 1600 étudiants en 2018, utilise ScoDoc depuis 2015;
+* [IUT de Cergy-Pontoise](http://www.iut.u-cergy.fr) tous les départements (GB, GCCD, GEII x 2, GLT, QLIO, MMI, TC x 2), DUT, LP, années spéciales et FC : plus de 1600 étudiants en 2018, utilise ScoDoc depuis 2015;
- * [IUT de Chartres](https://www.univ-orleans.fr/iut-chartres/);
+* [IUT de Chartres](https://www.univ-orleans.fr/iut-chartres/);
- * [IUT1 Grenoble - Alpes](https://iut1.univ-grenoble-alpes.fr): cinq départements (GMP, GTHE, GEII, RT, GCCD), déploiement en 2011;
+* [IUT1 Grenoble - Alpes](https://iut1.univ-grenoble-alpes.fr): cinq départements (GMP, GTHE, GEII, RT, GCCD), déploiement en 2011;
- * [IUT de Nantes](http://www.iutnantes.univ-nantes.fr/), départements Informatique, GEA, GEII, GMP, GTE, QLIO et SGM (DUT et Licences Pro, depuis 2008);
+* [IUT de Nantes](http://www.iutnantes.univ-nantes.fr/), départements Informatique, GEA, GEII, GMP, GTE, QLIO et SGM (DUT et Licences Pro, depuis 2008);
- * [IUT d'Orléans](http://www.univ-orleans.fr/iut-orleans/) depuis rentrée 2009, tous les départements (GTE, GEA, GMP, Chimie, QLIO), pour les DUT et LP (environ 1100 étudiants en sept. 2012);
+* [IUT d'Orléans](http://www.univ-orleans.fr/iut-orleans/) depuis rentrée 2009, tous les départements (GTE, GEA, GMP, Chimie, QLIO), pour les DUT et LP (environ 1100 étudiants en sept. 2012);
- * [IUT de Perpignan](http://www.iut-perpignan.fr) depuis 2013, départements GB, GEA, GIM, GLT sur Perpignan CJ et GCGP sur Narbonne et TC et STID sur Carcassonne;
+* [IUT de Perpignan](http://www.iut-perpignan.fr) depuis 2013, départements GB, GEA, GIM, GLT sur Perpignan CJ et GCGP sur Narbonne et TC et STID sur Carcassonne;
- * [IUT de Poitiers](http://iutp.univ-poitiers.fr/);
+* [IUT de Poitiers](http://iutp.univ-poitiers.fr/);
- * [IUT de Vélizy-Rambouillet](https://www.iut-velizy-rambouillet.uvsq.fr/) utilisateur depuis 2009, sur deux sites;
+* [IUT de Vélizy-Rambouillet](https://www.iut-velizy-rambouillet.uvsq.fr/) utilisateur depuis 2009, sur deux sites;
- * [IUT Sénart-Fontainebleau](http://www.iutsf.u-pec.fr).
+* [IUT Sénart-Fontainebleau](http://www.iutsf.u-pec.fr).
- * [IUT de Saint-Etienne](http://www.iut.univ-st-etienne.fr/);
+* [IUT de Saint-Etienne](http://www.iut.univ-st-etienne.fr/);
### Départements membres de l'association (2020-2021)
- * Département d'Informatique de l'IUT d'Aix en Provence;
+* Département d'Informatique de l'IUT d'Aix en Provence;
- * département Informatique de l'[IUT Grand Ouest Normandie](http://iut-caen.unicaen.fr/presentation/4-sites-geographiques/site-d-ifs-campus-iii/), site d'Ifs;
-
- * département Génie Biologique de l'[IUT de La Roche-sur-Yon](http://www.iutlaroche.univ-nantes.fr/) (utilisateur depuis 2009);
+* département Informatique de l'[IUT Grand Ouest Normandie](http://iut-caen.unicaen.fr/presentation/4-sites-geographiques/site-d-ifs-campus-iii/), site d'Ifs;
- * département GEA de l'[IUT de Tours](http://iut.univ-tours.fr/);
-
- * départements GIM et GMP de l'[IUT de Mantes](http://www.iut-mantes.uvsq.fr) (Université de Versailles St Quentin en Yvelines).
+* département Génie Biologique de l'[IUT de La Roche-sur-Yon](http://www.iutlaroche.univ-nantes.fr/) (utilisateur depuis 2009);
- * département Informatique de l'[IUT de Montpellier-Sète](https://iut-montpellier-sete.edu.umontpellier.fr/dut-informatique/)
+* département GEA de l'[IUT de Tours](http://iut.univ-tours.fr/);
+
+* départements GIM et GMP de l'[IUT de Mantes](http://www.iut-mantes.uvsq.fr) (Université de Versailles St Quentin en Yvelines).
+
+* département Informatique de l'[IUT de Montpellier-Sète](https://iut-montpellier-sete.edu.umontpellier.fr/dut-informatique/)
### Autres membres
- * [IUT de La Rochelle](http://www.iut-larochelle.fr/).
- * [IUT de Villetaneuse](http://www.iutv.univ-paris13.fr/) (Université Sorbonne Paris Nord), départements Informatique, CJ, GEA, GEII, R&T, STID Formation Continue (1600 étudiants, depuis 2005);
+* [IUT de La Rochelle](http://www.iut-larochelle.fr/).
-## IUT utilisateurs
- * [IUT d'Aix en Provence (GEII)](http://iut.univ-amu.fr/diplomes/dut-genie-electrique-informatique-industrielle-dut-geii),
- (site de Salon);
-
- * [IUT Aix-Marseille](http://iut.univ-amu.fr/), Mesures Physiques (depuis 2012) et Informatique;
-
- * [IUT d'Amiens](http://www.iut-amiens.fr/) tous les départements (6, soit 1850
- étudiants), depuis 2014;
-
- * [IUT d'Annecy](https://www.iut-acy.univ-smb.fr);
+* [IUT de Villetaneuse](http://www.iutv.univ-paris13.fr/) (Université Sorbonne Paris Nord), départements Informatique, CJ, GEA, GEII, R&T, STID Formation Continue (1600 étudiants, depuis 2005);
- * [IUT de Belfort-Montbéliard](http://www.iut-bm.univ-fcomte.fr/) (MP, R&T), depuis 2013;
+## IUT utilisateurs ou adhérents
- * [IUT de Béthune](http://www.iutbethune.org) (Université d'Artois), tous départements (Chimie, GCCD, GEII, GMP, QLIO et R&T);
+* [IUT d'Aix en Provence (GEII)](http://iut.univ-amu.fr/diplomes/dut-genie-electrique-informatique-industrielle-dut-geii),
+(site de Salon);
- * [IUT de Béziers](http://www.iutbeziers.fr) depuis 2014 (RT, MMI, CS, TC);
+* [IUT Aix-Marseille](http://iut.univ-amu.fr/), Mesures Physiques (depuis 2012) et Informatique;
- * [IUT de Blagnac](https://www.iut-blagnac.fr/fr/), CS, GIM, INFO, RT + 4 LP ; depuis 2017, environ 600 étudiants/an;
+* [IUT d'Amiens](http://www.iut-amiens.fr/) tous les départements (6, soit 1850
+ étudiants), depuis 2014;
- * [IUT de Bordeaux](http://www.iut.u-bordeaux.fr), départements GMP, GEII, GCCD, INFO, MP, HSE, SGM, MLT, GEA;
+* [IUT d'Annecy](https://www.iut-acy.univ-smb.fr);
- * [IUT de Brest](http://www.iut-brest.fr) depuis 2009, 4 départements (DUT et licences pro) à Brest et 2 à Morlaix, environ 1350 étudiants/an;
+* [IUT de Belfort-Montbéliard](http://www.iut-bm.univ-fcomte.fr/) (MP, R&T), depuis 2013;
- * [IUT de Bourges](http://www.univ-orleans.fr/iut-bourges/) départements GEA, QLIO, MP, CS, 2 années spéciales et 2 licences pro;
+* [IUT de Béthune](http://www.iutbethune.org) (Université d'Artois), tous départements (Chimie, GCCD, GEII, GMP, QLIO et R&T);
- * IUT de Calais;
+* [IUT de Béziers](http://www.iutbeziers.fr) depuis 2014 (RT, MMI, CS, TC);
- * [IUT de Cergy-Pontoise](http://www.iut.u-cergy.fr), tous les départements
- (GB, GCCD, GEII x 2, MLT, QLIO, MMI, TC x 2), DUT, LP, années spéciales et FC
- : plus de 1600 étudiants en 2018, utilise ScoDoc depuis 2015;
-
- * [IUT de Colmar](http://www.iutcolmar.uha.fr) (Université de Haute Alsace), département R&T et GB (depuis 2006);
+* [IUT de Blagnac](https://www.iut-blagnac.fr/fr/), CS, GIM, INFO, RT + 4 LP ; depuis 2017, environ 600 étudiants/an;
- * [IUT d'Évry Val d’Essonne](http://www.iut-evry.fr), départements GMP, QLIO,
- SGM, GEA et MLT;
+* [IUT de Bordeaux](http://www.iut.u-bordeaux.fr), départements GMP, GEII, GCCD, INFO, MP, HSE, SGM, MLT, GEA;
- * IUT de Fontainebleau;
+* [IUT de Brest](http://www.iut-brest.fr) depuis 2009, 4 départements (DUT et licences pro) à Brest et 2 à Morlaix, environ 1350 étudiants/an;
- * [IUT de Kourou](http://iut.univ-ag.fr/) (Guyane, depuis 2011);
+* [IUT de Bourges](http://www.univ-orleans.fr/iut-bourges/) départements GEA, QLIO, MP, CS, 2 années spéciales et 2 licences pro;
- * [IUT de l'Indre](http://www.univ-orleans.fr/iut-indre/), départements GEA, GEII, MLT, TC, depuis 2015;
+* IUT de Calais;
- * [IUT de Lannion](http://www.iut-lannion.fr/), 5 DUT et 5 LP, sur 4 départements;
+* [IUT de Cergy-Pontoise](http://www.iut.u-cergy.fr), tous les départements
+ (GB, GCCD, GEII x 2, MLT, QLIO, MMI, TC x 2), DUT, LP, années spéciales et FC
+ : plus de 1600 étudiants en 2018, utilise ScoDoc depuis 2015;
- * [IUT de La Rochelle](http://www.iut-larochelle.fr/), 5 départements (généralisé en 2017): 1070 étudiants de DUT et 9 LP (180 étudiants);
+* [IUT de Colmar](http://www.iutcolmar.uha.fr) (Université de Haute Alsace), département R&T et GB (depuis 2006);
- * [IUT de La Roche-sur-Yon](http://www.iutlaroche.univ-nantes.fr/),
- départements GEA, IC, R&T, GB et licences pro, soit 550 étudiants/ans depuis
- 2009;
-
- * [IUT Le Havre](http://www-iut.univ-lehavre.fr/), 10 départements et 3 années spéciales, soit environ 1800 étudiants;
+* [IUT d'Évry Val d’Essonne](http://www.iut-evry.fr), départements GMP, QLIO,
+ SGM, GEA et MLT;
- * [IUT Le Mans](https://iut.univ-lemans.fr), 4 départements (GEA, CHIMIE, GMP, MP), environ 1000 étudiants;
+* IUT de Fontainebleau;
- * [IUT A de Lille](http://www-iut.univ-lille1.fr), (depuis 2010) 7
- départements;
-
- * [IUT du Littoral Côte d'Opale](http://www.iut.univ-littoral.fr), tous les départements (2018);
+* [IUT de Kourou](http://iut.univ-ag.fr/) (Guyane, depuis 2011);
- * [IUT de Lorient & Pontivy](http://www-iutlorient.univ-ubs.fr), départements
- GTE, GIML, QLIO, GCGP, HSE;
+* [IUT de l'Indre](http://www.univ-orleans.fr/iut-indre/), départements GEA, GEII, MLT, TC, depuis 2015;
- * [IUT de Mantes](http://www.iut-mantes.uvsq.fr), départements GIM et GMP (Université de Versailles St Quentin en Yvelines);
+* [IUT de Lannion](http://www.iut-lannion.fr/), 5 DUT et 5 LP, sur 4 départements;
- * [IUT de Marseille](http://iut.univ-amu.fr/), depuis 2007;
+* [IUT de La Rochelle](http://www.iut-larochelle.fr/), 5 départements (généralisé en 2017): 1070 étudiants de DUT et 9 LP (180 étudiants);
- * [IUT de Metz](http://www.iut.univ-metz.fr), depuis 2011, départements GMP, TC;
+* [IUT de La Roche-sur-Yon](http://www.iutlaroche.univ-nantes.fr/),
+ départements GEA, IC, R&T, GB et licences pro, soit 550 étudiants/ans depuis
+ 2009;
+
+* [IUT Le Havre](http://www-iut.univ-lehavre.fr/), 10 départements et 3 années spéciales, soit environ 1800 étudiants;
+
+* [IUT Le Mans](https://iut.univ-lemans.fr), 4 départements (GEA, CHIMIE, GMP, MP), environ 1000 étudiants;
+
+* [IUT A de Lille](http://www-iut.univ-lille1.fr), (depuis 2010) 7
+ départements;
+
+* [IUT du Littoral Côte d'Opale](http://www.iut.univ-littoral.fr), tous les départements (2018);
+
+* [IUT de Lorient & Pontivy](http://www-iutlorient.univ-ubs.fr), départements
+ GTE, GIML, QLIO, GCGP, HSE;
+
+* [IUT de Mantes](http://www.iut-mantes.uvsq.fr), départements GIM et GMP (Université de Versailles St Quentin en Yvelines);
+
+* [IUT de Marseille](http://iut.univ-amu.fr/), depuis 2007;
+
+* [IUT de Metz](http://www.iut.univ-metz.fr), depuis 2011, départements GMP, TC;
+
+* [IUT de Mulhouse](http://www.iutmulhouse.uha.fr/), depuis 2014, départements
+ GEA, GEII, MLT, GMP;
- * [IUT de Mulhouse](http://www.iutmulhouse.uha.fr/), depuis 2014, départements
- GEA, GEII, MLT, GMP;
-
* [IUT de Nantes](http://www.iutnantes.univ-nantes.fr/), départements Informatique, GEA, GEII, GMP, GTE, QLIO et SGM (DUT et Licences Pro, depuis 2008);
- * [IUT de Nouvelle Calédonie](https://unc.nc/formation/formation-a-l-iut/linstitut-universitaire-de-technologie/);
+* [IUT de Nouvelle Calédonie](https://unc.nc/formation/formation-a-l-iut/linstitut-universitaire-de-technologie/);
- * [IUT de Nîmes](https://iut-nimes.edu.umontpellier.fr/), depuis 2019, GEII,
- GMP, SGM, et [Polytech Montpellier](https://www.polytech.umontpellier.fr);
+* [IUT de Nîmes](https://iut-nimes.edu.umontpellier.fr/), depuis 2019, GEII,
+ GMP, SGM, et [Polytech Montpellier](https://www.polytech.umontpellier.fr);
- * [IUT d'Orléans](http://www.univ-orleans.fr/iut-orleans/), depuis rentrée 2009, tous les départements (GTE, GEA, GMP, Chimie, QLIO), pour les DUT et LP (environ 1100 étudiants en sept. 2012).
+* [IUT d'Orléans](http://www.univ-orleans.fr/iut-orleans/), depuis rentrée 2009, tous les départements (GTE, GEA, GMP, Chimie, QLIO), pour les DUT et LP (environ 1100 étudiants en sept. 2012).
- * [IUT d'Orsay](https://www.iut-orsay.universite-paris-saclay.fr/);
+* [IUT d'Orsay](https://www.iut-orsay.universite-paris-saclay.fr/);
- * [IUT Paris Descartes](http://www.iut.parisdescartes.fr);
+* [IUT Paris Descartes](http://www.iut.parisdescartes.fr);
- * [IUT Paris Diderot](https://universite.univ-paris-diderot.fr/structures/iut-paris-diderot),
- Mesures Physiques;
+* [IUT Paris Diderot](https://universite.univ-paris-diderot.fr/structures/iut-paris-diderot),
+ Mesures Physiques;
- * [IUT de Perpignan](http://www.iut-perpignan.fr), depuis 2013, départements GB, GEA, GIM, MLT à Perpignan CJ et GCGP à Narbonne et TC et STID à Carcassonne;
+* [IUT de Perpignan](http://www.iut-perpignan.fr), depuis 2013, départements GB, GEA, GIM, MLT à Perpignan CJ et GCGP à Narbonne et TC et STID à Carcassonne;
- * [IUT de Poitiers](http://iutp.univ-poitiers.fr/);
+* [IUT de Poitiers](http://iutp.univ-poitiers.fr/);
- * [IUT de Rennes](https://iut-rennes.univ-rennes1.fr/) départements GEII, GMP, Chimie et Génie Civil Construction durable (2015);
+* [IUT de Rennes](https://iut-rennes.univ-rennes1.fr/) départements GEII, GMP, Chimie et Génie Civil Construction durable (2015);
- * [IUT de Roanne](http://portail.univ-st-etienne.fr/bienvenue/utilitaires/iut-de-roanne-26151.kjsp), dépt. Génie Industriel et Maintenance (GIM), environ 70 étudiants/an (2012);
+* [IUT de Roanne](http://portail.univ-st-etienne.fr/bienvenue/utilitaires/iut-de-roanne-26151.kjsp), dépt. Génie Industriel et Maintenance (GIM), environ 70 étudiants/an (2012);
- * [IUT de Saint-Denis (Université Sorbonne Paris Nord)](https://iutsd.univ-paris13.fr), départements HSE, GIM, GMP, TC, depuis 2009;
+* [IUT de Saint-Denis (Université Sorbonne Paris Nord)](https://iutsd.univ-paris13.fr), départements HSE, GIM, GMP, TC, depuis 2009;
- * [IUT de Saint-Dié des Vosges](http://www.iutsd.uhp-nancy.fr) depuis 2009);
+* [IUT de Saint-Dié des Vosges](http://www.iutsd.uhp-nancy.fr) depuis 2009);
- * [IUT de Saint-Malo](https://iut-stmalo.univ-rennes1.fr/);
+* [IUT de Saint-Malo](https://iut-stmalo.univ-rennes1.fr/);
- * [IUT de Saint-Nazaire](http://www.iut-sn.univ-nantes.fr/) tous les départements (GLT, GCCD, GIM, GCH, MP, TC) et 8 LP, 1400 étudiants, rentrée 2013. Et aussi Formation Continue, 1 DU PFST, 2 formations DUT par apprentissage (TC et GIM);
+* [IUT de Saint-Nazaire](http://www.iut-sn.univ-nantes.fr/) tous les départements (GLT, GCCD, GIM, GCH, MP, TC) et 8 LP, 1400 étudiants, rentrée 2013. Et aussi Formation Continue, 1 DU PFST, 2 formations DUT par apprentissage (TC et GIM);
- * [IUT de Tours](http://iut.univ-tours.fr/): départements GEII et TC2A: 450 étudiants/an, 2 DUT, 4 Licences Pro, 1 année spéciale, (ScoDoc depuis 2012);
+* [IUT de Tours](http://iut.univ-tours.fr/): départements GEII et TC2A: 450 étudiants/an, 2 DUT, 4 Licences Pro, 1 année spéciale, (ScoDoc depuis 2012);
- * [IUT de Tremblay](http://www.iu2t.univ-paris8.fr/) (U. Paris 8, dépt. GIM, 2010);
+* [IUT de Tremblay](http://www.iu2t.univ-paris8.fr/) (U. Paris 8, dépt. GIM, 2010);
- * [IUT de Valenciennes](https://www.uphf.fr/IUT) 9 départements (en FI, FA, FC) - DUT & 20 LP;
+* [IUT de Valenciennes](https://www.uphf.fr/IUT) 9 départements (en FI, FA, FC) - DUT & 20 LP;
- * [IUT de Vannes](https://www.iutvannes.fr/) département Informatique (DUT et LP, 200 étudiants) depuis sept. 2014, et GEA (400 étudiants) et TC depuis 2016, STID depuis 2019;
+* [IUT de Vannes](https://www.iutvannes.fr/) département Informatique (DUT et LP, 200 étudiants) depuis sept. 2014, et GEA (400 étudiants) et TC depuis 2016, STID depuis 2019;
- * [IUT de Vélizy-Rambouillet](https://www.iut-velizy-rambouillet.uvsq.fr/), utilisateur depuis 2009, sur deux sites;
-
- * [IUT de Villetaneuse](http://www.iutv.univ-paris13.fr/), (Université Sorbonne Paris Nord), départements Informatique, CJ, GEA, GEII, R&T, STID Formation Continue (1600 étudiants, depuis 2005);
+* [IUT de Vélizy-Rambouillet](https://www.iut-velizy-rambouillet.uvsq.fr/), utilisateur depuis 2009, sur deux sites;
- * [IUT de Villeurbanne (Lyon 1)](http://iut.univ-lyon1.fr/), département GEII, environ 220 inscrits/an.
+* [IUT de Villetaneuse](http://www.iutv.univ-paris13.fr/), (Université Sorbonne Paris Nord), départements Informatique, CJ, GEA, GEII, R&T, STID Formation Continue (1600 étudiants, depuis 2005);
-## Autres établissements utilisateurs (hors IUT)
- * Licence de sciences (SPI) à L'Université de Bretagne Occidentale (UBO);
+* [IUT de Villeurbanne (Lyon 1)](http://iut.univ-lyon1.fr/), département GEII, environ 220 inscrits/an.
- * Masters de sciences, Institut Galilée, Université Sorbonne Paris Nord;
+## Autres établissements utilisateurs (hors IUT)
- * Master ISB, Université Sorbonne Paris Nord;
+* Licence de sciences (SPI) à L'Université de Bretagne Occidentale (UBO);
- * [IFAG de Sofia](http://www.ifag.auf.org), Bulgarie (masters administration et
- gestion, AUF);
+* Masters de sciences, Institut Galilée, Université Sorbonne Paris Nord;
- * ILEPS, Cergy-Pontoise.
+* Master ISB, Université Sorbonne Paris Nord;
- * [Université Catholique d'Afrique Centrale](http://www.ucac-icy.net/) (UCAC, Yaoundé, Cameroun): Licences, Masters (2011);
+* [IFAG de Sofia](http://www.ifag.auf.org), Bulgarie (masters administration et
+ gestion, AUF);
- * [École Supérieure des Sciences et Technologies de l'Ingénieur de Nancy](http://www.esstin.univ-lorraine.fr) (jusqu'en 2013);
+* ILEPS, Cergy-Pontoise.
+* [Université Catholique d'Afrique Centrale](http://www.ucac-icy.net/) (UCAC, Yaoundé, Cameroun): Licences, Masters (2011);
+
+* [École Supérieure des Sciences et Technologies de l'Ingénieur de Nancy](http://www.esstin.univ-lorraine.fr) (jusqu'en 2013);
+
+
+!!! note "Voir aussi"
+
+ - [FAQ](FAQ.md)
+ - [Contacts](Contact.md)
diff --git a/docs/fig/config-cas.png b/docs/fig/config-cas.png
index 2dc05cebd..5516063cf 100644
Binary files a/docs/fig/config-cas.png and b/docs/fig/config-cas.png differ
diff --git a/docs/fig/formations_versions_association.jpg b/docs/fig/formations_versions_association.jpg
new file mode 100644
index 000000000..c9d469467
Binary files /dev/null and b/docs/fig/formations_versions_association.jpg differ