Compare commits

..

No commits in common. "f6cbeccd61591b88e92671c608be3ad590c47b25" and "6631a408913924e67be8f19be41afea86ef80e06" have entirely different histories.

50 changed files with 851 additions and 1658 deletions

View File

@ -1,52 +1,56 @@
# Gestion des utilisateurs dans ScoDoc
ScoDoc gère sa propre base d'utilisateurs (enseignants, administratifs, ## Gestion des utilisateurs dans ScoDoc
secrétaires). Rappelons que les étudiants ne sont pas des utilisateurs, ils ScoDoc gère sa liste d'utilisateurs (enseignants, secrétaires) dans
n'ont pas d'accès direct au logiciel. une base de données SQL.
## Principes généraux ### Principes généraux
Les utilisateurs sont associés à: Depuis ScoDoc 9.0, la liste des utilisateurs est enregistrée dans la base de
données unique SCODOC (en production) (voir la partie implémentation pour plus
de détails).
- un identifiant unique (`user_name`), propre à ScoDoc; Les entités gérées par scodoc sont :
- une adresse email; - Les utilisateurs;
- un ensemble de rôles; - les rôles;
- un département ScoDoc de rattachement (optionnel); - en liaison avec les départements.
- un statut actif/inactif.
- d'autres attributs, comme l'identifiant CAS (voir [Configuration du CAS](ConfigCAS.md))
### Rôles et permissions #### L'entité utilisateur
- possède les propriétés habituelles (nom, prénom, user_name, email);
- peut être associé à un département ou pas (cas d'un administrateur gérant
plusieurs départements);
- assure un ou plusieurs rôles.
Les rôles sont eux-même associés à des permissions: on donne une permission (ex: #### L'entité rôle
"enregistrer des absences") à un ou plusieurs rôles, et on associe chaque compte Un rôle est le regroupement d'un certain nombre de privilèges.
utilisateur à un ou plusieurs rôles. Ce système est à la fois flexible et facile C'est généralement la combinaison d'un département et d'un type d'utilisation.
à configurer. Plus de détails [sur la page dédiée](ConfigPermissionsDept.md). Actuellement au nombre de quatre (d'autres sont prévus, notamment pour le module
relations entreprises) :
- Administrateur
- Secrétariat
- Enseignant
- Observateur
Un rôle permet de grouper un ensemble de permissions nécessaire pour remplir des Par ailleurs, le contexte d'utilisation donne certains privilèges (par exemple
tâches données (secrétariat, responsable de formation, intervenant enseignant, la faculté de saisir des notes, de justifier des absences, de modifier la
...). définition des programmes, ...).
Un utilisateur peut être associé à un nombre quelconque de rôle, chaque _Exemple:_
association étant valable pour un département donné (ou bien éventuellement
tous). Il peut ainsi être "Responsable" dans un département et "Enseignant" dans
un autre.
### Département de rattachement L'utilisateur 'Dupont' est responsable ScoDoc pour son département *RT* mais
intervient également en enseignement au département *GEII*.
On pourra lui attribuer les rôles `AdminRT` et `EnsGEII`, ce qui lui permettra :
Le département de rattachement est utilisé pour afficher rapidement la liste des - de gérer les utilisateurs du (seul) département RT :
comptes d'un département (accès par un responsable de formation, chef de Privilèges associés : `Gérer les utlisateurs (Sco Users Manage)`, `Changer les
département, ...). Certains comptes ne sont pas rattachés à un département formations (Sco Change Formation)`, ...
(administrateurs). - d'accéder aux vues enseignant pour le département GEII :
Privilèges associés : `Voir les parties pour les enseignants (Sco View Ens)`,
`Saisir des absences (Sco Change Absences)`, ...
### Fermeture des comptes Pour une description plus fine des privilèges, voir
[ConfigPermissions](ConfigPermissions.md)
En principe, on ne **supprime** pas de compte utilisateur s'ils ont déjà été ### Opérations et cycle de vie des utilisateurs
utilisés. En effet, afin de permettre la traçabilité des opérations, ScoDoc
conserve des références aux utilisateurs. Pour fermer un compte, on le rend
**inactif**. Un utilisateur inactif ne peut plus se connecter, et n'apparait pas
dans les listes par défaut.
## Opérations et cycle de vie des utilisateurs
Un compte utilisateur peut être modifié par 3 types d'utilisateurs : Un compte utilisateur peut être modifié par 3 types d'utilisateurs :
@ -56,11 +60,11 @@ Un compte utilisateur peut être modifié par 3 types d'utilisateurs :
Les opérations existantes sont : Les opérations existantes sont :
- La création; - La création;
- la demande de renouvellement de mot de passe; - la demande de renouvellement de mot de passe;
- la désactivation. - la désactivation.
### Notes #### Notes:
- La suppression d'un utilisateur est impossible (nécessité de garder la trace - La suppression d'un utilisateur est impossible (nécessité de garder la trace
des anciens historiques), mais on peut le rendre inactif (il n'apparait alors des anciens historiques), mais on peut le rendre inactif (il n'apparait alors
@ -69,11 +73,10 @@ Les opérations existantes sont :
mot de passe par mail) a été remplacé par l'ajout de la mention suivante dans mot de passe par mail) a été remplacé par l'ajout de la mention suivante dans
le formulaire de connexion : le formulaire de connexion :
```text
En cas d'oubli de votre mot de passe cliquez ici pour le réinitialiser.
```
### Création d'un utilisateur (par formulaire) ` En cas d'oubli de votre mot de passe cliquez ici pour le réinitialiser. `
#### Création d'un utilisateur (par formulaire)
La création d'un utilisateur peut être faite par un administrateur ou super La création d'un utilisateur peut être faite par un administrateur ou super
administrateur. Le lien `Ajouter un utlisateur` permettant cela se trouve dans administrateur. Le lien `Ajouter un utlisateur` permettant cela se trouve dans
@ -97,18 +100,20 @@ scenarii suivants :
Une case à cocher `envoyer un mail d'accueil à l'utlisateur` permet de choisir Une case à cocher `envoyer un mail d'accueil à l'utlisateur` permet de choisir
la troisième option (si décochée), sinon la case suivante `indiquer par mail de la troisième option (si décochée), sinon la case suivante `indiquer par mail de
changer le mot de passe initial` permet de choisir entre l'option 1 et l'option changer le mot de passe initial` permet de choisir entre l'option 1 et l'option
2.
Dans tous les cas les mails seront envoyés avec l'adresse de réponse précisée par la valeur de la variable d'environnement
`SCODOC_MAIL_FROM` (par défaut `no-reply@{serveur_mail}`). Cette variable peut être initialisée dans le fichier .env par exemple avec la ligne:
Dans tous les cas les mails seront envoyés avec l'adresse de réponse précisée ```bash
par la valeur de la variable de configuration `email_from_addr`, qui peut être SCODOC_MAIL_FROM=no-reply@univ-exemple.fr
spécifié au niveau général ou département par département (voir ```
[Configuration des envois d'emails](ConfigEmail.md))
**Le département d'appartenance** peut être choisi si le créateur est **Le département d'appartenance** peut être choisi si le créateur est
administrateur pour plusieurs départements. Il aura alors le loisir administrateur pour plusieurs départements. Il aura alors le loisir
de sélectionner l'un des départements qu'il administre (liste déroulante). de sélectionner l'un des départements qu'il administre (liste déroulante).
### Création en masse (fichier xlsx) #### Création en masse (fichier xlsx)
Le super-administrateur (et lui seulement) peut également créer des comptes en Le super-administrateur (et lui seulement) peut également créer des comptes en
masse par téléversement d'un fichier au format `.xlsx` par le biais du lien masse par téléversement d'un fichier au format `.xlsx` par le biais du lien
@ -125,18 +130,17 @@ Les colonnes à remplir sont les suivantes :
- `email`: l'email de l'utilisateur; (obligatoire, unique dans scodoc) - `email`: l'email de l'utilisateur; (obligatoire, unique dans scodoc)
- `roles`: le ou les rôles attribués à l'utilisateur séparés par des virgules (exemple `Admin_RT, Ens_GEII`) - `roles`: le ou les rôles attribués à l'utilisateur séparés par des virgules (exemple `Admin_RT, Ens_GEII`)
- `dept`: le département de rattachement de l'utilisateur (acronyme, en lettres capitales). - `dept`: le département de rattachement de l'utilisateur (acronyme, en lettres capitales).
- `cas_id`, ...: optionnel, voir [Configuration du CAS](ConfigCAS.md)
_Note_: _Note_:
- Tous les utilisateurs sont créés ou bien aucun. - Tous les utilisateurs sont créés ou bien aucun.
- Un mail est envoyé à chaque utilisateur nouvellement créé. - Un mail est envoyé à chaque utilisateur nouvellement créé.
### Changement du mot de passe #### Changement du mot de passe
Deux circonstances sont envisagées. Deux circonstances sont envisagées.
#### Oubli de mot de passe ##### Oubli de mot de passe
Lorsqu'un utilisateur a perdu son mot de passe, il a la possibilité de retrouver Lorsqu'un utilisateur a perdu son mot de passe, il a la possibilité de retrouver
son accès sans intervention d'un administrateur. Il lui suffit de demander la son accès sans intervention d'un administrateur. Il lui suffit de demander la
@ -145,15 +149,15 @@ de son email (qui est maintenant identifiant dans scodoc), un mail lui est
envoyé. ce mail contient un lien comportant un jeton à durée limitée. Ce lien envoyé. ce mail contient un lien comportant un jeton à durée limitée. Ce lien
renvoie vers la page permettant de redéfinir le mot de passe de l'utilisateur. renvoie vers la page permettant de redéfinir le mot de passe de l'utilisateur.
#### Édition du profil ##### Edition du profil
Si l'utilisateur peut se connecter, il peut éditer son profil (et par là, Si l'utilisateur peut se connecter, il peut éditer son profil (et par là,
modifier son email et/ou son mot de passe). La barre latérale de l'écran modifier son email et/ou son mot de passe). La barre latérale de l'écran
principal de scodoc affiche dans le coin supérieur gauche la version courante de principal de scodoc affiche dans le coin supérieur gauche la version courante de
scodoc ainsi que l'identification de l'utilisateur actuel. Un clic sur le nom scodoc ainsi que l'identification de l'utilisateur actuel. Un clic sur le nom
permet à l'utilisateur d'éditer son profil. permet à l'utilsateur d'éditer son profil.
### Activation/désactivation #### Activation/désactivation
Une fois créé, le compte utilisateur conserve son existence. Il peut cependant être rendu inactif: Une fois créé, le compte utilisateur conserve son existence. Il peut cependant être rendu inactif:
@ -165,7 +169,7 @@ n'est donc pas possible de créer un nouveau compte associé au même email). Il
est simplement impossible de se connecter ou de modifier le profil de ce compte est simplement impossible de se connecter ou de modifier le profil de ce compte
par l'utilisateur lui-même. par l'utilisateur lui-même.
## Implémentation (pour les développeurs) ### Implémentation (pour les développeurs)
Le graphe d'état ci-dessous explicite les différents états que peux prendre un Le graphe d'état ci-dessous explicite les différents états que peux prendre un
compte utilisateur en fonction des opérations qu'il subit. compte utilisateur en fonction des opérations qu'il subit.
@ -179,6 +183,7 @@ On notera:
3. Que les états `créé`et `créé + ticket`permettent la connexion (sous réserve 3. Que les états `créé`et `créé + ticket`permettent la connexion (sous réserve
de la connaissance du mot de passe). de la connaissance du mot de passe).
<img src="/fig/GrapheUser.png" /> <img src="/fig/GrapheUser.png" />
**SCODOC**. **SCODOC**.
@ -204,17 +209,11 @@ La table **user** contient:
|token | text | dernier token émis (changement de mot de passe) | 1a, 3 | |token | text | dernier token émis (changement de mot de passe) | 1a, 3 |
|token_expiration | timestamp without time zone | date d'expiration du dernier token émis | 1a, 3 | |token_expiration | timestamp without time zone | date d'expiration du dernier token émis | 1a, 3 |
(les champs utilisé pour le CAS ne sont pas mentionnés ici)
🚸 encodage `utf-8`, sauf si vous avez modifié l'installation.
<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
alt="/!\" /> encodage `utf-8`, sauf si vous avez modifié l'installation.
Pour la signification des rôles et l'utilisation du département, voir Pour la signification des rôles et l'utilisation du département, voir
[ConfigPermissions](ConfigPermissions.md). [ConfigPermissions](ConfigPermissions.md).
!!! note "Voir aussi"
- [Configuration du CAS](ConfigCAS.md)
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [Configuration des envois d'emails](ConfigEmail.md)
- [FAQ](FAQ.md)
- [Contacts](Contact.md)

View File

@ -1,32 +1,21 @@
# Cursus ScoDoc
Les cursus pédagogiques sont définis dans ScoDoc par des classes de "cursus" qui # Parcours ScoDoc
définissent les paramètres: nombre de semestres, modalités de validation des UE, Les cursus pédagogiques sont définis dans ScoDoc par des classes de "parcours" qui définissent les paramètres: nombre de semestres, modalités de validation des UE, etc.
etc.
Plusieurs cursus sont définis dans ScoDoc, l'utilisateur choisi l'un d'entre eux Plusieurs parcours sont définis dans ScoDoc, l'utilisateur choisi l'un d'entre eux pour chacun des programmes pédagogique (menu **Type de parcours**).
pour chacun des programmes pédagogique (menu **Type de parcours**). Les cursus Les parcours existants incluent les suivants:
existants incluent les suivants:
* BUT (*Bachelor Universitaire de Technologie*, usuellement en 6 semestres)
* DUT (*Diplôme Universitaire de Technologie*, en quatre semestres) * DUT (*Diplôme Universitaire de Technologie*, en quatre semestres)
* Licence Professionnelle * Licence Professionnelle
* Licence
* Master (différents types) * Master (différents types)
* etc. * etc.
Il est possible d'ajouter des cursus adaptés en ajoutant du code Python. Il est possible d'ajouter des parcours 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 la liste scodoc-devel ([listes de diffusion](ListesDeDiffusion.md)).
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)).
## Quelques indications pour les programmeurs ## Quelques indications pour les programmeurs
Les parcours sont définis dans le module `sco_codes_parcours.py`. Chaque parcours correspond à une sous-classe de `TypeParcours`, définissant des paramètres et quelques méthodes.
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.
Les paramètres (déclarés comme des variables de classe) sont les suivants: Les paramètres (déclarés comme des variables de classe) sont les suivants:

View File

@ -229,14 +229,6 @@ sur les semestres auxquels l'étudiant est ou a été inscrit.
`etud['sems']`est une liste de dictionnaire représentants les `etud['sems']`est une liste de dictionnaire représentants les
semestres auxquels est ou a été inscrit l'étudiant. semestres auxquels est ou a été inscrit l'étudiant.
#### Parcours et référentiel BUT
Type | Nom | Description | Exemple de valeur
--------| ---------------------- | ---- | ---
string | parcours_titre | titre du parcours | "Cybersécurité"
string | parcours_code | code du parcours | "Cyber"
string | refcomp_specialite | code spécialité | "RT"
string | refcomp_specialite_long| spécialité | "Réseaux et Télécommunications"
### Résultats (notes) de l'étudiant dans le semestre ### Résultats (notes) de l'étudiant dans le semestre
Quelques infos sur les résultats. Le détail des notes est dans la Quelques infos sur les résultats. Le détail des notes est dans la

View File

@ -10,11 +10,6 @@ gérer avec ScoDoc. Pour les curieux, la page
[modélisation des parcours BUT](ModelisationParcoursBUT.md) [modélisation des parcours BUT](ModelisationParcoursBUT.md)
donne quelques détails sur la façon dont ScoDoc organise les objets du BUT. donne quelques détails sur la façon dont ScoDoc organise les objets du BUT.
De nombreux aspects sont aussi décrits dans les
<a
href="https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7PzOD8GDW3kG1"
target="_blank">Tutoriels sur YouTube <img src="/img/tube.png" alt=""
style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a>
## UE, modules, évaluations ## UE, modules, évaluations
@ -324,12 +319,4 @@ 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. - 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)

View File

@ -1,45 +0,0 @@
# Exports des résultats BUT vers Apogée
Les exports des résultats du BUT vers Apogée (et dans le futur vers Pégase)
posent un certain nombre de problèmes spécifiques liés aux caractéristiques
atypiques du BUT. Nous listons ci-dessous quelques points qu'il est important
d'avoir à l'esprit.
## Pas de moyennes générales en BUT
En BUT, les seules notes définies sans ambigüité sont:
- les moyennes d'UE dans chaque semestre;
- les moyennes de ressources et SAÉ *vers chaque UE* (une note par couple
UE/ressource ou UE/SAÉ);
- les notes d'évaluations.
En conséquence, aucune moyenne générale d'année ou de semestre ne devrait
logiquement figurer sur des documents officiels comme les procès verbaux de jury
ou les exports Apogée (utilisés en général pour éditer les diplômes).
Pour la même raison, il n'y a pas de classement par ordre de mérite en BUT (même
si ScoDoc propose moyennes indicatives et classements).
## Résultats semestriels et annuels
En général, les établissement ont l'habitude d'exporter les résultats de ScoDoc
vers Apogée en fin de semestre. Ce n'est pas strictement nécessaire en BUT après
les semestres impairs (S1, S3, S5), mais c'est possible.
Après un semestre impair, on peut donc exporter les résultats aux UEs (décisions
de jury et notes), ainsi bien entendu que les résultats plus fins (ressources,
évaluations).
Après les jurys de fin d'année scolaire (juillet), on peut exporter, outre les
résultats aux UEs:
- la décision annuelle (à l'étape): code jury (pas de note en BUT);
- les décisions RCUEs (niveaux de compétences) [**note: pas encore disponible en
ScoDoc 9.4.x** : personne ne l'a demandé !].
!!! note "Voir aussi"
- [Interfaces ScoDoc / Apogée](ScoDocApogee.md)
- [Le Bachelor Universitaire de Technologie (BUT)](BUT.md)
- [Contacts](Contact.md)

View File

@ -1,13 +1,14 @@
# Calcul des notes ## Calcul des notes
*Tout ce que vous avez toujours voulu savoir sur le calcul des moyennes...* *Tout ce que vous avez toujours voulu savoir sur le calcul des moyennes...*
Pour les formations par compétences, voir aussi [la page dédiée au BUT](BUT.md). **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).
## En résumé ### En résumé:
À chaque instant, ScoDoc prend en compte les notes des évaluations "complètes" A 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" (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 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 compte, sauf si l'option "*prise en compte immédiate*" a été cochée sur
@ -20,9 +21,11 @@ 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 en utilisant les coefficients du programme pédagogique (dénommé dans ScoDoc
"formation"). "formation").
Plus de détails ci-dessous. 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: Chaque évaluation produit des notes de différents types:
@ -38,32 +41,21 @@ 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 chaque module. Chaque note est associée à un coefficient: le coefficient de
l'évaluation dans le module. 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 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 des notes aux évaluations prises en compte, sauf si on a défini une formule
spécifique. spécifique.
### En BUT
Comme expliqué en détail sur [la page dédiée au BUT](BUT.md), chaque module #### Formules de calcul spéciales
(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.
De façon plus fine, chaque évaluation peut s'adresser à un sous-ensemble Il est possible de définir des formules de calcul spéciales pour calculer les
d'apprentissages critiques, et donc être associée à une ou plusieurs UE avec des moyennes. Ces formules sont alors utilisées par ScoDoc à la place de la moyenne
pondérations différentes: les poids de l'évaluation. pondérée standard. Voir
[FormulesCalculUtilisateur](FormulesCalculUtilisateur.md)
pour plus d'informations.
On a donc **pour chaque évaluation**:
- des poids, un par UE, qui sont par défaut égaux à 1 pour les UE concernées ### Moyennes d'UE
(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) moyenne_ue = moyenne pondérée des moyennes de modules de l'UE (- malus)
@ -74,9 +66,18 @@ 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 modules de malus de cette UE (un type spécial de modules, voir
[ModulesMalus](ModulesMalus.md)). [ModulesMalus](ModulesMalus.md)).
## Calcul de la moyenne générale 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).
### En formations classiques La présence de formules d'UE est signalée sur le tableau de bord du semestre.
### Calcul de la moyenne générale
moyenne = moyenne pondérée des moyennes d'UE + bonus sport/culture moyenne = moyenne pondérée des moyennes d'UE + bonus sport/culture
@ -97,14 +98,8 @@ 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 compte dans la moyenne pondérée: ils sont utilisés pour calculer le bonus, comme
expliqué ci-dessous. expliqué ci-dessous.
### Moyenne générale en BUT
En BUT, on calcule des notes pour les Unités d'Enseignement, et la moyenne ### Notes de rattrapage
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". 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 Lors de la création (ou modification) de l'évaluation, indiquer le type
@ -115,7 +110,9 @@ 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 Pour chaque étudiant, la note obtenue à l'évaluation de rattrapage remplace la
moyenne du module, seulement si elle est supérieure à celle-ci. 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 Ce bonus s'applique directement sur la **moyenne générale** et/ou sur les
moyennes d'UE (notamment en BUT). moyennes d'UE (notamment en BUT).
@ -140,44 +137,3 @@ 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 développement en indiquant (en français) le règlement en vigueur dans votre
établissement. Le code correspondant sera ajouté via une mise à jour. é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)

View File

@ -1,24 +1,17 @@
# Compensation des semestres DUT ## 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.
L'[arrêté du 3 août L'article 20 (b) stipule "*Lorsque les conditions posées ci-dessus ne sont pas remplies, la
2005](http://www.education.gouv.fr/bo/2005/31/MENS0501754A.htm) définit les validation est assurée, sauf opposition de l'étudiant, par une
modalités des parcours de DUT. 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'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 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.
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. <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> 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).
<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
alt="/!\" /> 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).

View File

@ -1,167 +0,0 @@
# Configuration de l'authentification CAS
*Cette page s'adresse aux administrateurs système en charge de ScoDoc.*
Le CAS, *Central Authentication Service* CAS est un système d'authentification
unique (SSO) très utilisé dans les universités. Il permet à l'utilisateur de
s'identifier sur un site unique (souvent appelé "ENT" en raccourci), pour
ensuite accéder aux différents services. Il évite de s'authentifier à
chaque fois qu'on accède à une application en mettant en place un système de
ticket.
Notons que le CAS peut introduire des faiblesses dans l'application:
- indisponibilité ou lenteur du service;
- vulnérabilité si le serveur CAS (ou l'annuaire sur lequel il s'appuie) venait
à être piraté.
Il est donc conseillé de s'assurer du bon fonctionnement et de la sécurisation de
son service CAS avant d'aller plus loin.
## Comptes utilisateurs ScoDoc et CAS
Rappel: voir [Gestion des utilisateurs](AdminUsers.md)
Pour simplifier, l'utilisateur va partir de ScoDoc, passer par le site CAS (redirection), puis
revenir si l'authentification réussi, avec un jeton et un identifiant CAS. À ce moment, ScoDoc cherche s'il a un
utilisateur ayant l'identifiant donné, dans le champ `cas_id`de sa base
utilisateur. Si oui, il ouvre une session pour cet utilisateur, avec ses rôles
et permissions.
## Paramètres spécifiques pour le CAS
### Configuration générale
Les pages de configuration générale de ScoDoc sont accessibles via la page
d'accueil, uniquement lorsqu'on est connecté comme super-admin.
![accès au panneau de config](fig/config-accueil.png)
De cette page, on accède à la page consacrée au CAS:
![config du CAS](fig/config-cas.png)
Page sur laquelle on va pouvoir spécifier:
- si on active le CAS (ce qui permet aussi de le désactiver globalement);
- si on force son utilisation;
- l'URL complète du serveur CAS (exemple: `https://mon.serveur.cas.fr:1234/cas/`);
- un attribut pour l'identification (laisser vide normalement);
- si on veut vérifier le certificat SSL (normalement oui, par sécurité, et
fournir le fichier certificat PEM dans le champ suivant).
Si l'option **Forcer l'utilisation du CAS** est activée, l'utilisateur qui tente
de se connecter sera immédiatement redirigé vers la page du CAS. Sinon, il aura
le choix via le formulaire classique, avec un lien en plus:
![login scodoc avec CAS](fig/config-cas-cnx.png)
🚸 Attention, le lien de réinitialisation du mot de passe ne concerne évidemment
pas le mot de passe du CAS, mais celui de ScoDoc. C'est ennuyeux.
À ce stade, CAS est utilisable, mais on n'a aucun utilisateur reconnu !
### Configuration des utilisateurs
ScoDoc doit connaitre l'identifiant CAS de ses utilisateurs. A défaut d'un
annuaire, il va falloir saisir ces identifiants pour chaque compte. On peut le
faire via le formulaire habituel de paramétrage du compte utilisateur, ou bien
par import Excel.
Cette configuration n'est accessible qu'au super-admin.
![form. config. utilisateur](fig/config-cas-user.png)
Ici trois champs nous intéressent:
- **Identifiant CAS**: nécessaire
- **Autorise connexion via CAS**: spécifie si ce compte peut ou non se connecter via CAS.
- **Autorise connexion via ScoDoc**: spécifie si cet utilisateur peut se connecter via
ScoDoc, sans CAS, lorsque le CAS est activé et forcé. Ceci est nécessaire par
exemple pour des comptes utilisés pour l'API, ou bien pour des personnes
extérieures à l'établissement et qui ne seraient pas (encore) dans le CAS.
En cas de besoin, les comptes "super-admin" peuvent toujours se connecter à ScoDoc sans CAS: si le
forçage est activé, il leur faut passer par une adresse spéciale:
```text
https://votre.serveur.scodoc.fr/auth/login_scodoc
```
(remplacer `https://votre.serveur.scodoc.fr` par le début de l'adresse de votre serveur).
🚸 **Attention**: en général, les **clients d'API** (et notamment la
"passerelle") n'utilisent pas le CAS: si vous forcez les utilisateurs à utiliser
le CAS, pensez à autoriser les comptes de l'API à se connecter sur ScoDoc sans
CAS.
## Sécurité: permissions et informations
L'utilisateur connecté via CAS a exactement les mêmes permissions que s'il
s'était connecté via ScoDoc.
### Permission
Le paramétrage CAS au niveau général nécessite la permission `Super Administrateur`.
Il est naturel de déléguer la création des comptes utilisateurs ScoDoc aux
responsables de département ou à leur représentant. Toutefois, le réglage CAS
pourrait créer des problèmes de sécurité (par exemple affecter à un département
un utilisateur CAS qui n'en fait pas réellement partie).
Le CAS ajoute une permission ScoDoc `ScoUsersChangeCASId` qui contrôle la
possibilité de changer l'identifiant CAS d'un compte. Cette permission peut ou
non être associée au rôle `Admin` d'un département, selon la politique de
l'établissement.
Les réglages par compte **Autorise connexion via CAS**
et **Autorise connexion via ScoDoc** sont réservés au `Super Administrateur`.
### Informations sur un utilisateur
Le super-administrateur (et elle seule) peut visualiser les dates de:
- dernière utilisation (date du dernier chargement de page);
- dernière connexion (login) via CAS.
dans les tables d'utilisateurs et sur la page de chaque compte:
![Informations sur un utilisateur](fig/config-user-view.png)
### Logs
Les connexions et tentatives de connexions via CAS sont logguées au niveau
`INFO`, qui arrive par défaut dans `/opt/scodoc-data/scodoc.log`.
Exemples:
- Connexion réussie:
```text
INFO: CAS: login user_name
```
- Tentative de connexion CAS réussie mais utilisateur non reconnu par ScoDoc:
```text
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)
- [Rôles et permissions](ConfigPermissionsDept.md)
- [Config. des rôles et permissions en ligne de commande](GuideConfig.md#creation-dun-nouveau-role)
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [API pour ScoDoc 9](ScoDoc9API.md)
- [FAQ](FAQ.md)
- [Contacts](Contact.md)

View File

@ -1,42 +0,0 @@
# Configuration des envois d'emails
ScoDoc envoie ou peut envoyer des emails, ou e-mails, ou courriels à de
nombreuses occasions, par exemple:
- comptes utilisateurs (réinitialisation mot de passe);
- envois de bulletins par mail aux étudiants;
- envois de notifications (notamment concernant l'assiduité);
- messages de diagnostic lors d'erreurs logicielles pour les développeurs.
Il est donc important de bien configurer le système de messagerie du serveur
ScoDoc. Ce point ne peut pas être documenté ici, car il dépend de
l'environnement local: relais de messagerie, politiques de filtrage, etc.
Par défaut, ScoDoc utilise le service SMTP Postfix, qui doit donc être configuré
pour relayer les messages vers la passerelle de l'établissement: voir la page
[envoi des courriers électroniques](ProblemesMail.md).
Une fois cela fait, l'utilisateur (administrateur) de ScoDoc a peu de réglages a
effectuer.
## Adresse d'origine (From)
On peut spécifier l'adresse d'origine (le champ `From`) de tous les mails émis.
![Réglage de l'adresse origine](fig/config-generale-mail.png)
Ce réglage peut être modifié au niveau de chaque département, via la page
**Paramétrage**:
![Réglage de l'adresse origine sur un département](fig/config-dept-mail.png)
## Notifications d'absences
Les notifications liées à l'absentéisme (fréquences, contenu) peuvent être
réglées via via la page **Paramétrage** de chaque département:
![Réglage des notifications](fig/config-dept-abs.png)
!!! note "Voir aussi"
- Configuration système: [Envoi des courriers électroniques](ProblemesMail.md)
- Installation, flux réseaux et configuration: [Guide d'installation](GuideInstallDebian11.md)
- [Contacts](Contact.md)

View File

@ -1,16 +1,12 @@
# Rôles définis dans l'installation standard ## Rôles définis dans l'installation standard
🚧 *cette page est ancienne et à revoir*.
Voir aussi sur les rôles et leur utilisation la page [ConfigPermissionsDept](ConfigPermissionsDept.md) Voir aussi sur les rôles et leur utilisation la page [ConfigPermissionsDept](ConfigPermissionsDept.md)
Les informations ci-dessous ne sont utiles que pour les développeurs ou pour des usages avancés de ScoDoc. Les informations ci-dessous ne sont utiles que pour les développeurs ou pour des usages avancés de ScoDoc.
## Principales permissions et fonctions associées ## Principales permissions et fonctions associées
### Liste des permissions Zope ### Liste des permissions Zope
Les permissions utilisées par ScoDoc ont des noms qui commencent par "Sco", de façon à les grouper dans l'interface de Zope (ZMI), qui est peu pratique. Les permissions utilisées par ScoDoc ont des noms qui commencent par "Sco", de façon à les grouper dans l'interface de Zope (ZMI), qui est peu pratique.
Pour changer ces permissions (plus précisément pour associer les permissions à des rôles), aller dans l'onglet "Security" du dossier "Dept" (celui qui *contient* l'instance de ScoDoc, habituellement nommée "Scolarite"). Pour changer ces permissions (plus précisément pour associer les permissions à des rôles), aller dans l'onglet "Security" du dossier "Dept" (celui qui *contient* l'instance de ScoDoc, habituellement nommée "Scolarite").

View File

@ -1,34 +1,3 @@
# Rôles et permissions dans ScoDoc
ScoDoc défini par défaut quatre rôles principaux (d'autres sont prévus, notamment pour le module
relations entreprises):
- Administrateur
- Secrétariat
- Enseignant
- Observateur
Par ailleurs, le contexte d'utilisation donne certains privilèges (par exemple
la faculté de saisir des notes, de justifier des absences, de modifier la
définition des programmes, ...).
## Exemple
L'utilisateur 'Dupont' est responsable ScoDoc pour son département *RT* mais
intervient également en enseignement au département *GEII*.
On pourra lui attribuer les rôles `AdminRT` et `EnsGEII`, ce qui lui permettra :
- de gérer les utilisateurs du (seul) département RT :
Privilèges associés : `Gérer les utlisateurs (Sco Users Manage)`, `Changer les
formations (Sco Change Formation)`, ...
- d'accéder aux vues enseignant pour le département GEII :
Privilèges associés : `Voir les parties pour les enseignants (Sco View Ens)`,
`Saisir des absences (Sco Change Absences)`, ...
Pour une description plus fine des permissions, voir
[ConfigPermissions](ConfigPermissions.md).
## Rôles définis dans l'installation standard ## Rôles définis dans l'installation standard
@ -50,12 +19,12 @@ Le département de rattachement est utile pour indiquer qui (quel administrateur
Le fait d'être, ou non, associé à un département est important pour les responsables (rôle `AdminXXX`. En effet, si le responsable est associé à un département, il ne pourra créer des utilisateurs que dans ce département (c'est en général ce qu'on veut pour un chef de département, qui "recrute" des enseignant uniquement dans son département). Le fait d'être, ou non, associé à un département est important pour les responsables (rôle `AdminXXX`. En effet, si le responsable est associé à un département, il ne pourra créer des utilisateurs que dans ce département (c'est en général ce qu'on veut pour un chef de département, qui "recrute" des enseignant uniquement dans son département).
## Permissions dépendantes du contexte
## Permissions dépendantes du contexte
Outre les rôles associés à chaque utilisateur, le calcul des autorisations dépend du contexte de l'opération. Par exemple, un responsable de semestre a des droits particulier sur ce semestre, ou encore un responsable de module sur la saisie des notes dans ce module. Outre les rôles associés à chaque utilisateur, le calcul des autorisations dépend du contexte de l'opération. Par exemple, un responsable de semestre a des droits particulier sur ce semestre, ou encore un responsable de module sur la saisie des notes dans ce module.
### Qui peut saisir des notes ?
### Qui peut saisir des notes ?
Peuvent saisir des notes dans une évaluation située dans un module: Peuvent saisir des notes dans une évaluation située dans un module:
* le ou les administrateurs (rôle `AdminXXX`, où `XXX` est le département); * le ou les administrateurs (rôle `AdminXXX`, où `XXX` est le département);
@ -63,11 +32,5 @@ Peuvent saisir des notes dans une évaluation située dans un module:
* le responsable du module; * le responsable du module;
* les enseignants "associés" au module (en général des collègues désignés par le responsable de module ou le directeur des études). * les enseignants "associés" au module (en général des collègues désignés par le responsable de module ou le directeur des études).
!!! note "Voir aussi" ----
Voir aussi la page [ConfigPermissions](ConfigPermissions.md) pour plus de détails sur les permissions (pour les développeurs).
- [ConfigPermissions](ConfigPermissions.md) pour plus de détails sur les permissions (pour les développeurs)
- [Gestion des utilisateurs](AdminUsers.md)
- [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)

View File

@ -1,51 +0,0 @@
# Contacter le projet ScoDoc
La plate-forme Discord est le principal canal de communication entre les
utilisateurs et entre les développeurs:
[rejoindre le discord ScoDoc Assistance](https://discord.gg/ybw6ugtFsZ)
Il existe aussi un autre salon Discord réservé aux développeurs, n'hésitez pas à
demander à le rejoindre.
## Liste de diffusion
* [scodoc-annonces](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-annonces) liste à très faible trafic, en lecture seule, seules des annonces importantes sont postées (quelques messages par an), tous les utilisateurs sont encouragés à s'y abonner. Indispensable aux administrateurs du logiciel.
## Signaler un problème (bug logiciel)
Tous les utilisateurs sont encouragés à signaler les erreurs qu'ils rencontrent,
afin qu'elles soient rapidement corrigées.
Pour cela, il existe un canal dédié sur le Discord: [🐞 bugs](https://discord.gg/BvAFnZU6UA)
Pour signaler un bug, il faut donner le maximum d'informations pour que nous
puissions le reproduire. Le mieux est d'envoyer les données d'assistance (lien
en bas de la page d'accueil du département) et d'indiquer quelle page ou
étudiant ou opération pose problème. Les données d'assistance ne contiennent pas
les noms, adresses et autres données personnelles: il faut donc indiquer
l'adresse de la page et jamais le nom d'un étudiant. Par exemple
`QLIO/Scolarite/Notes/formsemestre_bulletinetud?formsemestre_id=123&etudid=123456`
permet d'indiquer le semestre et l'étudiant à regarder.
![Envoi des données d'assistance](fig/envoi-assistance.png)
## Développeurs
Vous trouverez les sources du projet, les tickets (*issues*) et autres outils sur
* [gitea](https://scodoc.org/git/)
Vous pouvez demander un compte sur cette plate-forme pour ajouter des tickets,
proposer votre code (*pull requests*).
(Nous avons choisi le logiciel libre [Gitea](https://gitea.io) et non GitHub
afin de ne pas dépendre d'une plate-forme commerciale et de garder un contrôle
complet sur nos travaux).
## Anciennes listes de diffusion
Ces listes ne sont plus utilisées, remplacées par le Discord.
* [Notes](https://listes.univ-paris13.fr/mailman/listinfo/notes) discussions ou questions liées à l'utilisation du logiciel, entraide entre utilisateurs: vous pouvez y intervenir librement (les messages sont modérés pour éviter le spam).
* [scodoc-devel](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-devel) échanges entre développeurs. Abonnez-vous si vous êtes intéressés par le développement du logiciel, souhaitez participer ou poser des questions techniques.

View File

@ -1,14 +1,15 @@
# Contribuer à ScoDoc # Contribuer à ScoDoc
ScoDoc est un logiciel libre, et repose sur des volontaires comme vous. Chacun ScoDoc est un logiciel libre, et repose sur des volontaires comme vous. Chacun
peut aider, en améliorant la documentation (page, vidéos), en rejoignant le peut aider, en améliorant la documentation (page, vidéos), en s'abonnant à la
serveur Discord (voir [contacts](Contact.md)) pour y aider les liste Notes (voir [listes de diffusion](ListesDeDiffusion.md)) pour y aider les
collègues, ou en développant ou testant le logiciel. collègues, ou en développant ou testant le logiciel.
Les canaux de communication entre développeurs sont Les canaux de communication entre développeurs sont d'une part la liste de
[indiqués sur cette page](Contact.md). Vous pouvez demander un compte sur le [git du diffusion mail [scodoc-devel](ListesDeDiffusion.md), d'autre part un serveur
projet](https://scodoc.org/git), consulter/ajouter des tickets, proposer votre Discord (accès sur invitation, demander par mail). Vous pourrez demander un
code (*pull requests*). compte sur le [git du projet](https://scodoc.org/git), consulter/ajouter des
tickets, proposer votre code (*pull requests*).
## Contribuer à la documentation ## Contribuer à la documentation
@ -19,19 +20,11 @@ La documentation est constituée de deux parties:
Proposez de nouvelles vidéos, c'est très facile à faire ! Proposez de nouvelles vidéos, c'est très facile à faire !
- Les pages Web comme celle que vous lisez actuellement. La documentation est - 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 [Markdown](https://www.markdownguide.org/basic-syntax/). Toutes les sources
sont sur le [dépôt git DocScoDoc](https://scodoc.org/git/viennet/DocScoDoc). sont sur le [dépôt git DocScoDoc](https://scodoc.org/git/viennet/DocScoDoc).
## Contribuer au logiciel ## Contribuer au logiciel
Le [dépôt principal](https://scodoc.org/git/viennet/ScoDoc) comporte plusieurs Le [dépot principal](https://scodoc.org/git/viennet/ScoDoc) comporte plusieurs
branches. Voir le [guide pour les développeurs](GuideDeveloppeurs.md). 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)

View File

@ -1,27 +1,15 @@
# Échanges de programmes pédagogiques entre établissements # Echanges de programmes pédagogiques entre établissements
ScoDoc permet d'exporter et d'importer des programmes pédagogiques, échangés sous forme de fichiers XML.
ScoDoc permet d'exporter et d'importer des programmes pédagogiques, échangés Pour importer un programme, suivre le lien "Importer une formation" sur la page "Programmes".
sous forme de fichiers XML.
Pour importer un programme, suivre le lien "Importer une formation" sur la page A titre d'exemple, quelques programmes de DUT, donnés sans aucune garantie d'exactitude ! Ces programmes peuvent être importés dans ScoDoc puis modifiés pour s'adapter à vos besoins.
"Programmes".
A titre d'exemple, quelques programmes de DUT, donnés sans aucune garantie
d'exactitude ! Ces programmes peuvent être importés dans ScoDoc puis modifiés
pour s'adapter à vos besoins.
🚸 *S'il est possible, et nécessaire, de modifier localement les programmes de
formation, il est interdit de modifier les référentiels de compétences BUT, qui
sont publiés par le ministère et non adaptables.*
## Diplôme Universitaire des Technologie (PPN DUT) (par ordre alphabétique) ## Diplôme Universitaire des Technologie (PPN DUT) (par ordre alphabétique)
* DUT Carrières Sociales option AS (IUT du Havre, juillet 2013) : <a * DUT Carrières Sociales option AS (IUT du Havre, juillet 2013) : <a class="attachment" href="/attachments/formation_CS_OptionAS.xml" download>formation_CS_OptionAS.xml</a> + version 2014: <a class="attachment" href="/attachments/formation_exportCS_AS_LeHavre.xml" download>formation_exportCS_AS_LeHavre.xml</a> (voir mise à jour plus bas)
class="attachment" href="/attachments/formation_CS_OptionAS.xml"
download>formation_CS_OptionAS.xml</a> + version 2014: <a class="attachment"
href="/attachments/formation_exportCS_AS_LeHavre.xml"
download>formation_exportCS_AS_LeHavre.xml</a> (voir mise à jour plus bas)
* DUT Carrières Sociales option ASSC (IUT du Havre, juillet 2013) : <a class="attachment" href="/attachments/formation_CS_OptionASSC.xml" download>formation_CS_OptionASSC.xml</a> + version 2014: <a class="attachment" href="/attachments/formation_exportCS_ASSC_LeHavre.xml" download>formation_exportCS_ASSC_LeHavre.xml</a> (voir mise à jour plus bas) * DUT Carrières Sociales option ASSC (IUT du Havre, juillet 2013) : <a class="attachment" href="/attachments/formation_CS_OptionASSC.xml" download>formation_CS_OptionASSC.xml</a> + version 2014: <a class="attachment" href="/attachments/formation_exportCS_ASSC_LeHavre.xml" download>formation_exportCS_ASSC_LeHavre.xml</a> (voir mise à jour plus bas)
@ -67,9 +55,7 @@ sont publiés par le ministère et non adaptables.*
* DUT Réseaux et Télécommunications (PPN juillet 2008): <a class="attachment" href="/attachments/DUT_RT_PPN2008_v4.xml" download>DUT_RT_PPN2008_v4.xml</a> * DUT Réseaux et Télécommunications (PPN juillet 2008): <a class="attachment" href="/attachments/DUT_RT_PPN2008_v4.xml" download>DUT_RT_PPN2008_v4.xml</a>
* DUT Techniques de commercialisation (TC) (IUT du Havre, sept 2013) : <a * DUT Techniques de commercialisation (TC) (IUT du Havre, sept 2013) : <a class="attachment" href="/attachments/maquetteS1_S2_TC2013.xml" download>maquetteS1_S2_TC2013.xml</a>
class="attachment" href="/attachments/maquetteS1_S2_TC2013.xml"
download>maquetteS1_S2_TC2013.xml</a>
Et aussi: 11 programmes pédagogiques utilisés à l'IUT du Havre, à jour en mars 2015: HSE, TC, InfoCom, GEA, CS_AS, GC, GLT, GMP, INFO, GEII: <a class="attachment" href="/attachments/PPN-LeHavre2015.zip" download>PPN-LeHavre2015.zip</a> (contribution Dominique Soudière) Et aussi: 11 programmes pédagogiques utilisés à l'IUT du Havre, à jour en mars 2015: HSE, TC, InfoCom, GEA, CS_AS, GC, GLT, GMP, INFO, GEII: <a class="attachment" href="/attachments/PPN-LeHavre2015.zip" download>PPN-LeHavre2015.zip</a> (contribution Dominique Soudière)
@ -85,3 +71,6 @@ Et aussi: 11 programmes pédagogiques utilisés à l'IUT du Havre, à jour en ma
* Licence professionnelle Réseaux et Télécommunications, option Administration et Sécurité des Réseaux (ASUR) : <a class="attachment" href="/attachments/lp_assur.xml" download>lp_assur.xml</a>: * Licence professionnelle Réseaux et Télécommunications, option Administration et Sécurité des Réseaux (ASUR) : <a class="attachment" href="/attachments/lp_assur.xml" download>lp_assur.xml</a>:
---- ----
Dominique Soudiere (IUT du Havre) a développé une macro Excel pour faciliter la saisie des programmes pédagogiques: <a class="attachment" href="/attachments/MaquetteVersion2017.xlsm" download>MaquetteVersion2017.xlsm</a>

View File

@ -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 ScoDoc pour un semestre particulier). A défaut, il faut leur envoyer leurs
bulletins par mail. 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 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 par la page "Saisie des notes" et suivre le lien "Effacer toutes les notes de
cette évaluation". cette évaluation".
@ -49,7 +49,6 @@ bulletins par mail.
### En IUT, comment gérer les licences professionnelles ? ### En IUT, comment gérer les licences professionnelles ?
* On peut créer un département regroupant les licences, ou bien rattacher * On peut créer un département regroupant les licences, ou bien rattacher
chaque licence à un département existant. Cette dernière solution est 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 préférable si des étudiants de DUT poursuivent en licence (ainsi, on a
@ -60,8 +59,7 @@ semestre (pas de jury à mi-parcours). Indiquer "*pas de semestre*" dans
l'option "*Semestre dans la formation*" (page "*modification du semestre*"). l'option "*Semestre dans la formation*" (page "*modification du semestre*").
### Comment gérer les étudiants les démissionnaires ? ### Comment gérer les étudiants les démissionnaires ?
* Sur la fiche d'un étudiant, on peut choisir plusieurs options:
Sur la fiche d'un étudiant, on peut choisir plusieurs options:
* *Supprimer cet étudiant* : il sera totalement supprimé de la base, sans * *Supprimer cet étudiant* : il sera totalement supprimé de la base, sans
remède. Cette option n'est en principe jamais utile, sauf pour corriger remède. Cette option n'est en principe jamais utile, sauf pour corriger
@ -82,12 +80,10 @@ Ou bien au niveau de son inscription dans un semestre, via le menu *Scolarité*:
inscrits). inscrits).
### Mes données sont erronées, que faire ? ### Mes données sont erronées, que faire ?
En cas de problème (bug, erreur de manipulation, suspicion de piratage), En cas de problème (bug, erreur de manipulation, suspicion de piratage),
différents journaux peuvent être consultés. différents journaux peuvent être consultés.
Les utilisateurs autorisés peuvent facilement voir: Les utilisateurs autorisés peuvent facilement voir:
* les opérations effectuées sur un étudiant (inscriptions, saisies d'absences, * les opérations effectuées sur un étudiant (inscriptions, saisies d'absences,
...), accessibles via le menu "Etudiant" / "Voir le journal..." en haut de sa ...), accessibles via le menu "Etudiant" / "Voir le journal..." en haut de sa
fiche individuelle. fiche individuelle.
@ -97,25 +93,24 @@ Les utilisateurs autorisés peuvent facilement voir:
l'identité de l'utilisateur ayant effectué la saisie). l'identité de l'utilisateur ayant effectué la saisie).
Les administrateurs (informaticiens) peuvent aussi consulter les journaux (logs) Les administrateurs (informaticiens) peuvent aussi consulter les journaux (logs)
du serveur, voir ["où sont les journaux"](#ou-sont-les-journaux-logs). du serveur, voir plus loin.s
### Comment signaler un problème ? ### Comment signaler un problème ?
Nous vous remercions de nous signaler tous les problèmes que vous rencontrez: Nous vous remercions de nous signaler tous les problèmes que vous rencontrez:
erreurs, comportement bizarre ou malcommode. Nous ne promettons pas de les 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 régler rapidement, ni même plus tard: le logiciel est fourni sans aucune
garantie. Mais nous faisons de notre mieux: garantie. Mais nous faisons de notre mieux:
* si vous êtes utilisateurs, écrire à - si vous êtes utilisateurs, écrire à
[notes@listes.univ-paris13.fr](mailto:notes@listes.univ-paris13.fr). [notes@listes.univ-paris13.fr](mailto:notes@listes.univ-paris13.fr).
ou joindre le canal Discord Assistance. ou joindre le canal Discord Assistance.
* si vous êtes informaticien et voulez évoquer un problème technique - si vous êtes informaticien et voulez évoquer un problème technique
(développement, installation), écrire à (développement, installation), écrire à
[scodoc-devel@listes.univ-paris13.fr](mailto:scodoc-devel@listes.univ-paris13.fr). [scodoc-devel@listes.univ-paris13.fr](mailto:scodoc-devel@listes.univ-paris13.fr).
## Configuration
## Configuration
### Comment changer les logos sur les documents PDF (PV...) ### Comment changer les logos sur les documents PDF (PV...)
Il faut avoir un compte (web) administrateur sur ScoDoc, et passer Il faut avoir un compte (web) administrateur sur ScoDoc, et passer
@ -125,7 +120,6 @@ Voir [la page sur la gestion des logos et images](GestionLogos.md).
### Administration ### Administration
### Quel système d'exploitation ? ### Quel système d'exploitation ?
ScoDoc est accessible depuis n'importe quel navigateur Web (Firefox, Chrome, ...). 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 serveur ScoDoc fonctionne sous Linux. Il n'est testé qu'avec Debian (stable).
@ -133,8 +127,8 @@ Le script d'installation ([GuideInstallDebian11](GuideInstallDebian11.md))
assure l'installation de tout les éléments nécessaires au bon fonctionnement de 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, Les mises à jour sont normalement automatiquement appliquées chaque nuit,
assurant la sécurité et l'actualisation de ScoDoc. assurant la sécurité et l'actualisation de ScoDoc.
@ -144,25 +138,25 @@ importantes sont annoncées sur la liste de diffusion
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). Voir [SauvegardesBases](SauvegardesBases.md).
### Où sont les journaux (logs) ? ### Où sont les journaux (logs) ?
Les administrateurs du serveur peuvent consulter: Les administrateurs du serveur peuvent consulter:
* Le journal du serveur Web (nginx) * Le journal du serveur Web (nginx)
```
```text
/var/log/nginx/scodoc*.log /var/log/nginx/scodoc*.log
``` ```
* le fichier `/opt/scodoc-data/log/scodoc.log` reçoit des messages de déboggage * le fichier `/opt/scodoc-data/log/scodoc.log` reçoit des messages de déboggage
de ScoDoc. 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 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 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 ScoDoc n'a pas de certificat valide. Si votre établissement (par exemple via
@ -174,18 +168,11 @@ 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 `chrome://flags/#allow-insecure-localhost` (et/ou taper "thisisunsafe" sur la
page bloquée). page bloquée).
### Comment supprimer un département ?
### Comment supprimer un département ?
Voir les commandes d'administration dans [GuideConfig](GuideConfig.md) Voir les commandes d'administration dans [GuideConfig](GuideConfig.md)
### Comment contribuer au projet ? ### Comment contribuer au projet ?
[Voir la page](Contribuer.md).
[Voir la page "contribuer"](Contribuer.md).
!!! note "Voir aussi"
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [Guide du responsable de formation](GuideAdminFormation.md)
- [Guide utilisateur](GuideUtilisateur.md)
- [Contacts](Contact.md)
- <a href="https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7PzOD8GDW3kG1" target="_blank">Tutoriels sur YouTube <img src="/img/tube.png" alt="" style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a>

View File

@ -1,4 +1,4 @@
# Obsolète, non disponible en ScoDoc 9 # Obsolète, non disponible en ScoDoc 9.
<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
alt="/!\" /> **Les formules utilisateurs, disponibles à titre expérimental en alt="/!\" /> **Les formules utilisateurs, disponibles à titre expérimental en
@ -7,50 +7,33 @@ posaient maints problèmes de performance et de maintenance, et ne sont plus
utilisées en ScoDoc 9.** <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> utilisées en ScoDoc 9.** <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" />
## Formules utilisateurs pour le calcul des moyennes ## 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
Dans certains cas (assez rares), on veut calculer la note d'un module autrement 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.
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). Les formules sont aussi utilisable pour calculer la moyenne d'une Unité d'Enseignement (UE).
<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> Attention: l'utilisation de formules ralenti considérablement les traitements, et devrait être réservé à des cas exceptionnels.
alt="/!\" /> 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: La formule reçoit donc:
* Un tableau (vecteur) de notes (noté "notes"), de taille fixe et égale au * 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).
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 * Un tableau des coefficients de chaque évaluation, dans lequel les valeurs correspondants aux notes "manquantes" sont nulles.
correspondants aux notes "manquantes" sont nulles.
Dans ces tableaux, les évaluations sont ordonnées en fonction de leur place sur 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.
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 Ainsi, si on a pour un étudiant deux évaluations de coefficients 2 et
notes (12/20 et 16/20), on aura: 3 avec les notes (12/20 et 16/20), on aura:
```
```py
notes = [ 12., 20. ] notes = [ 12., 20. ]
coefs = [ 2., 3. ] coefs = [ 2., 3. ]
``` ```
Quelques fonctions sont définies: Quelques fonctions sont définies: `abs, cmp, dot, len, map, max, min, pow, reduce, round, sum, ifelse`.
`abs, cmp, dot, len, map, max, min, pow, reduce, round, sum, ifelse`.
Exemples: Exemples:
@ -63,6 +46,7 @@ Exemples:
* si la moyenne n'est pas valide, on renvoie la valeur `moy` (ce qui permet de garder le bon code) * 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, en résistant aux notes manquantes: `ifelse(moy_is_valid, max(notes[0], notes[1]), moy)`
Autres variables définies dans les formules: Autres variables définies dans les formules:
* moy : la valeur de la moyenne calculée classiquement (somme pondérée) <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> *attention, ce n'est pas forcément un nombre !* * moy : la valeur de la moyenne calculée classiquement (somme pondérée) <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> *attention, ce n'est pas forcément un nombre !*
@ -74,43 +58,36 @@ Autres variables définies dans les formules:
* nbabs_nojust : nombre d'absences *non 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 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 !
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']`. 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é 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:
défini avec un coefficient nul dans le programme), on écrira: ```
```py
ifelse(moy_is_valid, min(moy_val+notes['SPORT'], 20), moy) ifelse(moy_is_valid, min(moy_val+notes['SPORT'], 20), moy)
``` ```
### Traitement des erreurs
La formule doit ramener une valeur numérique entre 0 et 20, sans quoi ScoDoc ### Traitement des erreurs
considère la note erronée et la remplace par le code 'ERR' (qui se voit dans le La formule doit ramener une valeur numérique entre 0 et 20, sans quoi
tableau récapitulatif des notes et sur les bulletins). Idem pour tout autre ScoDoc considère la note erronée et la remplace par le code 'ERR' (qui
erreur de calcul pouvant se produire. Si vous voyez des 'ERR', corrigez votre se voit dans le tableau récapitulatif des notes et sur les bulletins).
formule ! (message d'erreur affiché sur le tableau de bord du semestre) 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))` *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) Moyenne des [TPs](TPs.md)
(notes[1]*coefs[1]+notes[2]*coefs[2]+notes[3]*coefs[3])/(coefs[1]+coefs[2]+coefs[3]) (notes[1]*coefs[1]+notes[2]*coefs[2]+notes[3]*coefs[3])/(coefs[1]+coefs[2]+coefs[3])
@ -134,3 +111,8 @@ 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) 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) )))/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 !*

View File

@ -25,15 +25,13 @@ réalisées par le menu de configuration des logos.
### Fichiers et répertoires associés aux logos ### Fichiers et répertoires associés aux logos
Les images (logos et fonds de document) sont enregistrées dans le répertoire Les images (logos et fonds de document) sont enregistrées dans le répertoire `/opt/scodoc-data/config/logos` et ses sous-répertoires.
`/opt/scodoc-data/config/logos` et ses sous-répertoires.
Les images ajoutées par les utilisateurs ont toutes un nom de la forme Les images ajoutées par les utilisateurs ont toutes un nom de la forme `logo_<nom>.png` ou `logo_<nom>.jpg`
`logo_<nom>.png` ou `logo_<nom>.jpg` (`<nom>` représente le nom d'usage du logo: (`<nom>` représente le nom d'usage du logo : *header*, *footer*, signature, ... au choix de l'utilisateur)
*header*, *footer*, signature, ... au choix de l'utilisateur) Les Les sous-répertoires ont des noms de la forme `logos_<dept>``<dept>` est
sous-répertoires ont des noms de la forme `logos_<dept>``<dept>` est l'identifiant numérique du département
l'identifiant numérique du département (la commande `flask list-depts` donne la (la commande `flask list-depts` donne la correspondance cf. [Administration en ligne de commande](GuideConfig.md)).
correspondance cf. [Administration en ligne de commande](GuideConfig.md)).
Les **fonds de page** se distinguent uniquement des logos par leur nom (`<ext>` peut être soit `jpg`ou `png`) : Les **fonds de page** se distinguent uniquement des logos par leur nom (`<ext>` peut être soit `jpg`ou `png`) :
@ -53,8 +51,3 @@ 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 avec le préfixe `logo_`) est présent, il est prioritaire sur le fond de page
"historique". "historique".
!!! note "Voir aussi"
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [FAQ](FAQ.md)
- [Contacts](Contact.md)

View File

@ -10,110 +10,32 @@ département IUT, responsable de filières, ...). Nous allons apprendre à:
* inscrire des étudiants à un semestre de formation * inscrire des étudiants à un semestre de formation
## Définir un programme pédagogique ## Définir un programme pédagogique
Le programme pédagogique d'une formation défini les unités d'enseignement; il est destiné à être utilisé par plusieurs sessions de formation (semestres). On doit apporter un soin particulier à la définition du programme, et éviter de le modifier une fois que des semestres sont créés (il est toutefois possible d'en créer de nouvelles *versions* pour permettre des modifications ultérieures sans affecter les semestres achevés: voir [VersionProgrammes](VersionProgrammes.md)).
Le programme pédagogique d'une formation défini les unités d'enseignement; il On définira en général dans le programme l'ensemble des enseignements d'un diplôme (les 4 semestres d'un DUT par exemple). C'est dans une phase ultérieure que l'on mettra en place les différents semestres.
est destiné à être utilisé par plusieurs sessions de formation (semestres). On
doit apporter un soin particulier à la définition du programme, et éviter de le
modifier une fois que des semestres sont créés (il est toutefois possible d'en
créer de nouvelles *versions* pour permettre des modifications ultérieures sans
affecter les semestres achevés: voir [VersionProgrammes](VersionProgrammes.md)).
On définira en général dans le programme l'ensemble des enseignements d'un Les programmes pédagogiques ScoDoc sont structurés en Unités d'Enseignements (UE), Matières et Modules.
diplôme (les 4 semestres d'un DUT par exemple). C'est dans une phase ultérieure Un module appartient forcément à une matière, qui appartient elle même à une UE. Les modules représentent les cours ("mathématique", "anglais", ...) et sont associées à un volume horaire (cours/TD/TP) et à un coefficient: chaque module produit une note moyenne (en général obtenue à travers plusieurs *évaluations* ou contrôles). La note moyenne d'une UE est obtenue en calculant une moyenne pondérée par les coefficients des notes moyennes de modules.
que l'on mettra en place les différents semestres.
Les programmes pédagogiques ScoDoc sont structurés en Unités d'Enseignements Les matières n'ont pas d'autre utilité que d'aider à structurer le programme. Par exemple, on pourrait définir dans un programme une matière "Sciences" réunissant les modules de "mathématiques" et de "physique". Les matières n'ont pas de coefficient. Si l'on ne souhaite pas utiliser de matière, il suffit d'en créer une pour chaque module avec le même nom, ou au contraire (plus simplement) de créer une matière par UE et d'y placer tous les modules.
(UE), Matières et Modules. Un module appartient forcément à une matière, qui
appartient elle même à une UE. Les modules (déclinés en *ressources*, *SAÉs* en
BUT) représentent les cours ("mathématique", "anglais", ...) et sont associés à
un volume horaire (cours/TD/TP) et à un coefficient: chaque module produit une
note moyenne (en général obtenue à travers plusieurs *évaluations* ou
contrôles). La note moyenne d'une UE est obtenue en calculant une moyenne
pondérée par les coefficients des notes moyennes de modules.
🚸 En BUT, c'est un peu différent, puisque les modules ont une note *pour chaque Les UE jouent un rôle particulier dans l'évaluation. En effet, selon les règles du LMD, les UE sont *capitalisables* (voir [CapitalisationUE](CapitalisationUE.md)). De plus, l'obtention de droit des semestres d'un DUT est soumise à une moyenne supérieure à 8/20 dans chacune des UE.
UE*: la moyenne d'un module n'est pas définie. Voir [BUT](BUT.md)
Les matières n'ont pas d'autre utilité que d'aider à structurer le programme. Notons qu'une UE ne possède pas de coefficient. Le coefficient d'une UE n'est autre que la somme des coefficient des modules qui composent cette UE. Par conséquent, le coefficient d'UE est potentiellement variable d'un étudiant à l'autre, si les étudiants ne sont pas inscrits aux mêmes modules (options ou parcours).
Par exemple, on pourrait définir dans un programme une matière "Sciences"
réunissant les modules de "mathématiques" et de "physique". Les matières n'ont
pas de coefficient. Si l'on ne souhaite pas utiliser de matière, il suffit d'en
créer une pour chaque module avec le même nom, ou au contraire (plus simplement)
de créer une matière par UE et d'y placer tous les modules.
Les UE jouent un rôle particulier dans l'évaluation. En effet, selon les règles Vous trouverez plus d'informations sur la définition des programmes sur la page [VersionProgrammes](VersionProgrammes.md).
du LMD, les UE sont *capitalisables* (voir
[CapitalisationUE](CapitalisationUE.md)). De plus, l'obtention de droit des
semestres d'un DUT est soumise à une moyenne supérieure à 8/20 dans chacune des
UE.
Notons qu'une UE ne possède pas de coefficient. Le coefficient d'une UE n'est
autre que la somme des coefficient des modules qui composent cette UE. Par
conséquent, le coefficient d'UE est potentiellement variable d'un étudiant à
l'autre, si les étudiants ne sont pas inscrits aux mêmes modules (options ou
parcours).
Vous trouverez plus d'informations sur la définition des programmes sur la page
[VersionProgrammes](VersionProgrammes.md).
## Versions des programmes de formation
Chaque semestre ("FormSemestre" dans le jargon ScoDoc) se réfère à un programme
pédagogique, appelé sa *formation*. cette formation définit l'ensemble des UE et
modules, leurs intitulés, et leurs coefficients et ECTS.
Les programmes sont le plus souvent adaptés localement, et peuvent varier d'une
année sur l'autre. Lorsqu'une formation est modifié (par exemple, un changement
de coefficient), ScoDoc doit recalculer l'ensemble des notes de tous les
semestres utilisant cette formation. De même, si un intitulé change, il faut
re-générer les bulletins et procès-verbaux. On conçoit donc que la modification
d'une formation ne s'aborde pas à la légère. ScoDoc empêche d'ailleurs toute
modification d'une formation (ou partie de, selon les cas) lorsqu'un semestre a
été verrouillé (ce qui indique en général qu'il est achevé et que l'on souhaite
conserver ses données et résultats inchangés pour utilisation future dans des
jurys ou avis).
Si vous devez modifier une formation pour la nouvelle année scolaire, vous
pouvez créer une nouvelle version d'une formation existante afin d'éviter
d'avoir à saisir de nouveau l'ensemble des éléments. Il arrive même que, l'année
scolaire déjà commencée, on se rende compte que l'on doit modifier la formation
d'un semestre en cours (bien sûr, cela ne devrait pas arriver, les modalités
d'évaluation étant souvent votées par des instances officielles avant le début
de l'année, mais le monde n'est pas parfait et de petites corrections sont
parfois nécessaires). Dans ce cas, ScoDoc vous permet d'associer un ou plusieurs
semestres existants dans une formation à une nouvelle version de celle-ci, créée
par copie.
![menu formsemestre](fig/menu-formsemestre-assoc.png)
La figure suivante montre la distinction entre formations et semestres, et les opérations possibles:
![menu formsemestre](fig/formations_versions_association.jpg)
![association nouvelle version](fig/sem-assoc-formation.png)
### Changement de la formation d'un semestre
Il peut arriver que l'on ai créé deux versions de formations, qui sont encore
identique, et que l'on souhaite rattacher un formsemestre de l'une à l'autre.
C'est possible, à condition que les deux formations soient vraiment identiques
(mêmes UEs, titres, coefficients, etc). Le lien est accessible en bas de la page
"Associer à une nouvelle version du programme" mentionnée ci-dessus.
![change formation](fig/sem-change-formation.png)
## Créer un semestre de formation ## Créer un semestre de formation
Pour créer un semestre de formation, on va partir d'un programme pédagogique donné et y choisir un (sous)ensemble de modules. Le semestre sera associé à une date de début, une date de fin, et un responsable (*directeur des études* dans le langage IUT).
* Options de paramétrage d'un semestre: [ParametrageSemestre](ParametrageSemestre.md)
Pour créer un semestre de formation, on va partir d'un programme pédagogique
donné et y choisir un (sous)ensemble de modules. Le semestre sera associé à une
date de début, une date de fin, et un responsable (*directeur des études* dans
le langage IUT).
* Options de paramétrage d'un semestre: [Paramétrage Semestre](ParametrageSemestre.md)
## Inscrire des étudiants ## Inscrire des étudiants
* [ Importer des listes d'étudiants](ImportationEtuds.md) (en début d'année ou de semestre) * [ Importer des listes d'étudiants](ImportationEtuds.md) (en début d'année ou de semestre)
* [ Synchroniser avec une étape Apogée](SynchroApogee.md) * [ Synchroniser avec une étape Apogée](SynchroApogee.md)
@ -124,28 +46,20 @@ le langage IUT).
* [ Données sur scolarité antérieure et admission](DonneesAdmissions.md) * [ Données sur scolarité antérieure et admission](DonneesAdmissions.md)
## Suivi de la Scolarité
## Suivi de la Scolarité
* [ Récapitulatif des opérations en fin de semestre et début du suivant](TransitionSemestre.md) * [ Récapitulatif des opérations en fin de semestre et début du suivant](TransitionSemestre.md)
* [ Note sur la capitalisation des UE](CapitalisationUE.md) * [ Note sur la capitalisation des UE](CapitalisationUE.md)
* [ Note sur la compensation des semestres](CompensationSemestre.md) (DUT) * [ Note sur la compensation des semestres](CompensationSemestre.md) (DUT)
## Échanges de programmes pédagogiques entre établissements
ScoDoc permet d'exporter et d'importer des programmes pédagogiques: voir des ## Echanges de programmes pédagogiques entre établissements
fichiers sur la page ScoDoc permet d'exporter et d'importer des programmes pédagogiques: voir des fichiers sur la page [ExemplesProgrammesPedagogiques](ExemplesProgrammesPedagogiques.md)
[Exemples Programmes Pédagogiques](ExemplesProgrammesPedagogiques.md)
!!! note "Voir aussi" <br>
- [Édition des programmes de formation](VersionProgrammes.md) ---
- [Guide utilisateur](GuideUtilisateur.md) - [Retour au 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)

View File

@ -10,14 +10,15 @@ Utilisez un **serveur virtuel** ou un container Docker si vous n'avez pas de mac
* Migration d'un serveur ScoDoc 7 vers la nouvelle version Scodoc 9: [MigrationScoDoc7a9](MigrationScoDoc7a9.md) * Migration d'un serveur ScoDoc 7 vers la nouvelle version Scodoc 9: [MigrationScoDoc7a9](MigrationScoDoc7a9.md)
## Mises à jour et sauvegardes ## Mises à jour et sauvegardes
* [Mettre à jour du logiciel (nouvelles versions)](MisesAJour.md) * [Mettre à jour du logiciel (nouvelles versions)](MisesAJour.md)
* [Mise en place de sauvegardes des bases de données](SauvegardesBases.md) * [Mise en place de sauvegardes des bases de données](SauvegardesBases.md)
## Configuration et préférences ## Configuration et préférences
* [Gestion des comptes utilisateurs](AdminUsers.md)
* [Administration en ligne de commande](GuideConfig.md) * [Administration en ligne de commande](GuideConfig.md)
* [ConfigPermissions](ConfigPermissions.md) : description des permissions et rôles utilisés par le système. * [ConfigPermissions](ConfigPermissions.md) : description des permissions et rôles utilisés par le système.
* [Paramétrage](PreferencesScoDoc.md): réglage des préférences * [Paramétrage](PreferencesScoDoc.md): réglage des préférences
@ -33,11 +34,8 @@ Utilisez un **serveur virtuel** ou un container Docker si vous n'avez pas de mac
* [Interfaçage avec Apogée](ScoDocApogee.md) * [Interfaçage avec Apogée](ScoDocApogee.md)
* [API](ScoDoc9API.md) : API JSON ou XML pour interfaçage avec d'autres applications * [API](ScoDoc9API.md) : API JSON ou XML pour interfaçage avec d'autres applications
* [ServicesXml](ServicesXml.md) : web services XML pour interfaçage avec d'autres applications (obsolète). * [ServicesXml](ServicesXml.md) : web services XML pour interfaçage avec d'autres applications (obsolète).
* [AdminUsers](AdminUsers.md) : gestion des utilisateurs
* [InterrogationPortail](InterrogationPortail.md) : liaison avec portail * [InterrogationPortail](InterrogationPortail.md) : liaison avec portail
Voir aussi le [guide pour les développeurs](GuideDeveloppeurs.md) et la [FAQ](FAQ.md).
!!! note "Voir aussi"
- [Guide pour les développeurs](GuideDeveloppeurs.md)
- [FAQ](FAQ.md)
- [Contacts](Contact.md)

View File

@ -1,9 +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 Ce document suppose que le logiciel a été installé suivant la procédure décrite dans
[GuideInstallDebian11](GuideInstallDebian11.md). [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 Les opérations d'administration se résument à la création de départements, et la
@ -63,7 +64,6 @@ Il s'agit d'un utilisateur ayant tous les droits, comme s'il était
`admin2` est ici le pseudo du nouvel admin. `admin2` est ici le pseudo du nouvel admin.
### Changement du mot de passe d'un utilisateur ### Changement du mot de passe d'un utilisateur
Cette opération peut s'effectuer via la page de gestion web des Cette opération peut s'effectuer via la page de gestion web des
utilisateurs, mais il est parfois commode de le faire depuis la utilisateurs, mais il est parfois commode de le faire depuis la
console: console:
@ -111,7 +111,6 @@ départements (utile pour certains compte administrateurs ou utilisés en lectur
par des clients de l'API). par des clients de l'API).
### Migration des données de ScoDoc 7 ### Migration des données de ScoDoc 7
Les données dans ScoDoc 9 ayant un format et une organisation très différents 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 de ScoDoc 7, une étape de conversion (migration) est nécessaire. Elle est automatique
mais prend du temps. mais prend du temps.
@ -129,7 +128,6 @@ départements.
flask import-scodoc7-users flask import-scodoc7-users
#### Départements #### Départements
Pour migrer un seul département: Pour migrer un seul département:
flask import-scodoc7-dept DEPT DBNAME flask import-scodoc7-dept DEPT DBNAME
@ -343,22 +341,10 @@ distribués. Pour les changer, passer par la page d'administration (lien
* 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.
<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" Vous allez voir la page d'accueil de ScoDoc, vous permettant de choisir le département
alt="/!\" /> Surtout, évitez de travailler comme "admin" (super admin): prenez où travailler.
le temps de créer un utilisateur "chef de département !" dans chaque
département, qui à son tour peut déléguer des droits.
<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> Surtout,
!!! note "Voir aussi" é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)

View File

@ -4,8 +4,8 @@ Informations pour les développeurs souhaitant étendre ou modifier ScoDoc.
## Informations générales ## Informations générales
* Voir [contacts](Contact.md). Il y a aussi un serveur Discord ouvert sur * S'abonner aux [listes de diffusion](ListesDeDiffusion.md). Il y a aussi
invitation aux développeur actifs. Contacter Emmanuel Viennet. un serveur Discord ouvert sur invitation aux développeur actifs. Contacter Emmanuel.
* [Générer de nouveaux formats de bulletins PDF](ApiGenerationBulletinsPdf.md) * [Générer de nouveaux formats de bulletins PDF](ApiGenerationBulletinsPdf.md)
* [Créer de nouveaux types de "parcours"](ApiCreationParcours.md) * [Créer de nouveaux types de "parcours"](ApiCreationParcours.md)
* [API](ScoDoc9API.md) : API JSON ou XML pour interfaçage avec d'autres applications * [API](ScoDoc9API.md) : API JSON ou XML pour interfaçage avec d'autres applications
@ -26,7 +26,7 @@ Quelques conseils, indications et mémos pour les développeurs sur ScoDoc versi
L'ancienneté de la base de code a rendu le style un peu incohérent, mais cela L'ancienneté de la base de code a rendu le style un peu incohérent, mais cela
s'est nettement amélioré avec ScoDoc 9 (respect PEP 8). s'est nettement amélioré avec ScoDoc 9 (respect PEP 8).
Le code DOIT être formaté avec [`black`](https://black.readthedocs.io/) avant Le code DOIT être formatté avec [`black`](https://black.readthedocs.io/) avant
tout commit (configurez votre éditeur pour appeler `black` à l'enregistrement). tout commit (configurez votre éditeur pour appeler `black` à l'enregistrement).
#### Documentation #### Documentation
@ -34,8 +34,6 @@ tout commit (configurez votre éditeur pour appeler `black` à l'enregistrement)
On pourra adopter le style "Google": <https://google.github.io/styleguide/pyguide.html#383-functions-and-methods> On pourra adopter le style "Google": <https://google.github.io/styleguide/pyguide.html#383-functions-and-methods>
Exemple: Exemple:
```py
"""Description résumée de la fonction """Description résumée de la fonction
blah blah sur la fonction blah blah sur la fonction
@ -56,7 +54,6 @@ Exemple:
b'Zim': ('Irk', 'Invader'), b'Zim': ('Irk', 'Invader'),
b'Lrrr': ('Omicron Persei 8', 'Emperor')} b'Lrrr': ('Omicron Persei 8', 'Emperor')}
""" """
```
### Git ### Git
@ -74,7 +71,6 @@ Ci-dessous quelques pense-bête qui peuvent servir.
Pour les développeurs internes (écriture sur le dépôt master), un exemple Pour les développeurs internes (écriture sur le dépôt master), un exemple
basique illustrant le cycle de développement: basique illustrant le cycle de développement:
```bash
# Créer une branche # Créer une branche
# si besoin (travail en cours), utiliser git stash avant # si besoin (travail en cours), utiliser git stash avant
git checkout master git checkout master
@ -89,7 +85,6 @@ basique illustrant le cycle de développement:
# publication # 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 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). origine), et on proposera une *pull request* (PR, *demande d'ajout* en français).
@ -137,11 +132,10 @@ Restore les modes au besoin (SAMBA les changent parfois):
git diff -p -R --no-color | grep -E "^(diff|(old|new) mode)" --color=never | git apply git diff -p -R --no-color | grep -E "^(diff|(old|new) mode)" --color=never | git apply
``` ```
Note pour travailler sur VirtualBox: Note pour travailler sur VirtualBox:
```text
addgroup scodoc vboxsf addgroup scodoc vboxsf
```
### Préparation d'une PR (Pull Request) ### Préparation d'une PR (Pull Request)
@ -167,8 +161,7 @@ demande d'ajout (*pull request*, dite "PR"):
Les manipulations sont décrites selon quatre phases du développement : l'installation, Les manipulations sont décrites selon quatre phases du développement : l'installation,
la mise en place, le suivi et la livraison. 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 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/<user>/<dépôt>.git`) et utiliser : votre dépôt personnel (`https://scodoc.org/git/<user>/<dépôt>.git`) et
le dépôt officiel (`https://scodoc.org/git/ScoDoc/ScoDoc.git`). le dépôt officiel (`https://scodoc.org/git/ScoDoc/ScoDoc.git`).
@ -214,10 +207,10 @@ principale évolue pendant ce temps.
Pour garder la cohérence, il est nécessaire de réintégrer en local les 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. 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. 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 le plus à jour de la branche principale (il en résulte un historique plus
linéaire). linéaire).
@ -273,7 +266,7 @@ exemple):
``` ```
Utilisateurs Windows : Vérifiez bien que les réglages de fin de ligne suivent 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 mais un seul caractère line feed (noté LF ou `\n`). Le cas échéant, réglez
votre IDE pour cela. votre IDE pour cela.
@ -309,8 +302,7 @@ commandes :
git rebase --continue # pour poursuivre le processus git rebase --continue # pour poursuivre le processus
git rebase --abort # pour tout abandonner 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: Application:
@ -378,7 +370,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 * toutes les différences entre officiel/master et votre branche locale sont
signifiantes. signifiantes.
##### Étape 4 ##### Étape 4 :
Vous pouvez maintenant pousser votre branche locale sur votre dépôt personnel Vous pouvez maintenant pousser votre branche locale sur votre dépôt personnel
(vers une branche de même nom): (vers une branche de même nom):
@ -443,7 +435,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) Puis soit vous installez les versions "officielles" (testées)
```bash ```
pip install -r requirements-3.9.txt pip install -r requirements-3.9.txt
``` ```
@ -453,7 +445,6 @@ faire ceci est:
```bash ```bash
cut -d= -f 1 requirements-3.9.txt | xargs pip install cut -d= -f 1 requirements-3.9.txt | xargs pip install
``` ```
à adapter selon vos objectifs. à adapter selon vos objectifs.
Pour régénérer le fichier indiquant la liste des paquets: Pour régénérer le fichier indiquant la liste des paquets:
@ -465,11 +456,15 @@ Pour régénérer le fichier indiquant la liste des paquets:
Note: la mise à jour par `apt` recrée le virtualenv à chaque fois. Note: la mise à jour par `apt` recrée le virtualenv à chaque fois.
## Roadmap ## Roadmap
Sujets **prioritaires** en 2021-2022:
* [voir les tickets](https://scodoc.org/git/viennet/ScoDoc/issues) - Modernisation du code: Flask, Python 3: achevé août 2021.
- 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)
!!! note "Voir aussi" - Définition et développement nouvelle API (achevé avec 9.3 en juillet 22)
- [FAQ](FAQ.md) Autres sujets:
- [Contacts](Contact.md) - [voir les tickets](https://scodoc.org/git/viennet/ScoDoc/issues)

View File

@ -1,6 +1,5 @@
# Installation de ScoDoc 9 sur Debian 11 (Bullseye) # Installation de ScoDoc 9 sur Debian 11 (Bullseye)
Ce document décrit la procédure d'installation et de configuration de ScoDoc 9. Ce document décrit la procédure d'installation et de configuration de ScoDoc 9.
Cette procédure doit être effectué sur la machine serveur avec un accès Cette procédure doit être effectué sur la machine serveur avec un accès
administrateur (root). administrateur (root).
@ -12,32 +11,35 @@ système Linux.
Cette documentation est prévue pour installer ScoDoc version 9 sur un système 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 [Debian](http://www.debian.org) 11 (Bullseye, stable) s'exécutant sur une
machine intel-like **64bits** (architecture **AMD64** sur Intel/AMD, ou machine intel-like **64bits** (architecture **AMD64**). Debian s'installe
**aarch64** sur Apple ARM). Debian s'installe facilement en cinq minutes, sur facilement en cinq minutes, sur une machine normale ou un serveur
une machine normale ou un serveur virtualisé. Il est **vivement déconseillé** de virtualisé. Il est **vivement déconseillé** de tenter l'installation sur une
tenter l'installation sur une autre version. autre version.
Si vous mettez à jour un serveur existant (ScoDoc 7 sur Debian 10), voir [la page 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). sur les migrations](https://scodoc.org/MigrationScoDoc7a9/#2-upgrade-debian).
Merci de signaler tout problème [sur le Discord](https://discord.gg/ybw6ugtFsZ) Merci de signaler tout problème (emmanuel.viennet@gmail.com
ou éventuellement la liste [scodoc-devel](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-devel). ou [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:
- Note 1: 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), [https://www.debian.org/distrib/netinst](https://www.debian.org/distrib/netinst.md),
choisir la version "petits CD" pour **amd64** choisir la version "petits CD" pour **amd64** (*Il est indispensable
(*Il est indispensable d'utiliser une version 64 bits !*) d'utiliser une version 64 bits ! *)
🚸 **Important:** - Note 2: une version Docker serait utile: avis aux volontaires.
<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> Important:
La procédure d'installation décrite ci-dessous suppose que ScoDoc va s'exécuter 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 sur un serveur dédié. Pour faire des tests, utilisez un serveur virtuel (comme
VirtualBox ou VMWare, ou UTM sur Mac). L'installation ci-dessous va en effet VirtualBox ou VMWare). L'installation ci-dessous va en effet modifier de
modifier de nombreux paramètres de votre système Linux (serveur web, firewall, nombreux paramètres de votre système Linux (serveur web, firewall, serveur SQL,
serveur SQL, messagerie, ...). messagerie, ...).
## 1) Préalable: configurer un serveur linux ## 1) Préalable: configurer un serveur linux
Le serveur devrait être accessible depuis Internet. Le serveur devrait être accessible depuis Internet.
### Configuration matérielle ### Configuration matérielle
@ -48,42 +50,38 @@ Le serveur devrait être accessible depuis Internet.
- mémoire: prévoir au moins 8Go de RAM, et plutôt 12 ou 16. - mémoire: prévoir au moins 8Go de RAM, et plutôt 12 ou 16.
### Informations sur les flux réseau ### Informations sur les flux réseau
Le serveur est fréquemment installé sur un réseau protégé ou sur un VPN. Le serveur est fréquemment installé sur un réseau protégé ou sur un VPN.
- le trafic entrant est sur le port 443 (le trafic http/80 est redirigé - le trafic entrant est sur le port 443 (le trafic http/80 est redirigé
vers le https). vers le https).
- le serveur doit pouvoir envoyer du mail (serveur Postfix en local, à - le serveur doit pouvoir envoyer du mail (serveur postfix en local, à
configurer pour utiliser un relais smtp ou envoyer directement, selon configurer pour utiliser un relais smtp ou envoyer directement, selon
votre politique. Au besoin, pour le reconfigurer, lancer `dpkg-reconfigure postfix`); votre politique. Au besoin, pour le reconfigurer, lancer `dpkg-reconfigure postfix`);
- Les serveurs de mise à jour de Debian doivent être accessibles (en http, - Les serveurs de mise à jour de Debian doivent être accessibles (en http,
voir `/etc/apt/sources.list`); voir `/etc/apt/sources.list`);
- Les serveurs `scodoc.org` et `scodoc.iutv.univ-paris13.fr` **doivent** - Les serveurs `scodoc.org` et `scodoc.iutv.univ-paris13.fr` doivent
être accessibles (80 et 443). être accessibles (80 et 443).
### Installation Linux Debian ### Installation Linux Debian
Nous recommandons d'effectuer une installation standard de Debian par le réseau (netinst), Nous recommandons d'effectuer une installation standard de Debian par le réseau (netinst),
et d'utiliser l'installation en mode texte, très simple et rapide. et d'utiliser l'install en mode texte, très simple et rapide.
Durant l'installation de Debian, lorsqu'il demande "logiciels à installer", tout décocher Durant l'installation de Debian, lorsqu'il demande "logiciels à installer", tout décocher
sauf "Serveur SSH" et "Utilitaires standard du système". Le script d'installation de ScoDoc sauf "Serveur SSH" et "Utilitaires standard du système". Le script d'installation de ScoDoc
se chargera ensuite d'installer tous les éléments nécessaires (serveur web, messagerie, etc.). se chargera ensuite d'installer tous les éléments nécessaires (serveur web, messagerie, etc.).
🚸 *Veiller à sélectionner une locale `UTF-8` par défaut.* *Veiller à sélectionner une locale `UTF-8` par défaut.*
![InstallDebian6-1.png](screens/InstallDebian6-1.png) ![InstallDebian6-1.png](screens/InstallDebian6-1.png)
### Points à vérifier avant d'installer ScoDoc ### Points à vérifier avant d'installer ScoDoc
Checklist minimale de votre système Linux Debian: Checklist minimale de votre système Linux Debian:
1. Connexion à Internet: le réseau doit être accessible. En effet, le script d'installation va installer des paquetages du système Debian puis télécharger la dernière mise à jour du logiciel ScoDoc (à partir du serveur Subversion). 1. Connexion à Internet: le réseau doit être accessible. En effet, le script d'installation va installer des paquetages du système Debian puis télécharger la dernière mise à jour du logiciel ScoDoc (à partir du serveur Subversion).
1. Vérifiez la connectivité, par exemple: 1. Vérifiez la connectivité, par exemple:
```
```bash
ping www.univ-paris13.fr ping www.univ-paris13.fr
(quitter avec ctrl-c) (quitter avec ctrl-c)
cd /tmp cd /tmp
@ -92,16 +90,15 @@ Checklist minimale de votre système Linux Debian:
``` ```
3. Nom DNS: le serveur doit avoir un nom ("serveur.exemple.fr") connu dans le 3. Nom DNS: le serveur doit avoir un nom ("serveur.exemple.fr") connu dans le
DNS (local ou public). Pour des tests, vous pouvez vous passer de DNS, mais DNS (local ou public). Pour des tests, vous pouvez vous passer de DNS, mais
dans ce cas le nom de votre serveur sera son adresse IP (eg `192.168.0.10`) et dans ce cas le nom de votre serveur sera son adresse IP (eg 192.168.0.10) et
il ne sera peut être pas accessible de l'extérieur. il ne sera peut être pas accessible de l'extérieur.
4. Mail: vérifiez que le serveur peut envoyer des e-mail: `mail 4. Mail: vérifiez que le serveur peut envoyer des e-mail:
votre@adresse.fr`, puis entrer un message terminé par `ctrl-d`: si vous ne `mail votre@adresse.fr`, puis entrer un message terminé par `ctrl-d`: si vous ne
recevez pas le message après quelques minutes, vérifiez votre configuration recevez pas le message après quelques minutes, vérifiez votre configuration
(et le log `/var/log/mail.log`). Un serveur ScoDoc qui n'envoie pas de mail (et le log `/var/log/mail.log`). Un serveur ScoDoc qui n'envoie pas de mail
ne peut pas vérifier ceux des utilisateurs, qui à leur tour ne pourront pas ne peut pas vérifier ceux des utilisateurs, qui à leur tour ne pourront pas
changer leurs mots de passe (bien d'autres fonctions dépendent des mails). changer leurs mots de passe (bien d'autres fonctions dépendent des mails).
Au besoin, revoir la configuration avec `dpkg-reconfigure postfix` (voir Au besoin, revoir la configuration avec `dpkg-reconfigure postfix`.
aussi [envoi des courriers électroniques](ProblemesMail.md)).
1. Vérifiez que votre serveur est accessible depuis une autre machine de votre 1. Vérifiez que votre serveur est accessible depuis une autre machine de votre
réseau (voire d'Internet): par exemple `ping serveur.exemple.fr`. réseau (voire d'Internet): par exemple `ping serveur.exemple.fr`.
@ -115,27 +112,22 @@ Checklist minimale de votre système Linux Debian:
production, mettez en place des sauvegardes sérieuses ! production, mettez en place des sauvegardes sérieuses !
#### Configuration si utilisation d'un proxy #### Configuration si utilisation d'un proxy
Si votre accès à Internet passe par un proxy, l'indiquer au moment de Si votre accès à Internet passe par un proxy, l'indiquer au moment de
l'installation Debian. l'installation Debian.
Ensuite, dans ScoDoc, indiquer votre proxy: pour cela, éditer le fichier Ensuite, dans ScoDoc, indiquer votre proxy: pour cela, éditer le fichier
```/opt/scodoc/.env``` ```/opt/scodoc/.env```
et ajouter les variables d'environnement nécessaires. Typiquement, il s'agit de : et ajouter les variables d'environnement nécessaires. Typiquement, il s'agit de :
```
```bash
HTTP_PROXY=http://proxy.univ-xxx.fr:1234 HTTP_PROXY=http://proxy.univ-xxx.fr:1234
HTTPS_PROXY=http://proxy.univ-xxx.fr:1234 HTTPS_PROXY=http://proxy.univ-xxx.fr:1234
``` ```
Vérifiez aussi que ces variables sont bien définies dans `/etc/environment`
(si l'installeur Linux Debian ne les a pas déjà indiquées là, les ajouter ou créer ce fichier).
Vérifiez aussi que ces variables sont bien définies dans `/etc/environment` (si Après modification de ce fichier (qui _doit_ être lisible par l'utilisateur `scodoc`),
l'installeur Linux Debian ne les a pas déjà indiquées là, les ajouter ou créer
ce fichier).
Après modification de ce fichier (qui *doit* être lisible par l'utilisateur `scodoc`),
redémarrer le service: redémarrer le service:
```
```bash
sudo systemctl restart scodoc sudo systemctl restart scodoc
``` ```
@ -144,6 +136,7 @@ redémarrer le service:
[ce post sur Stack Overflow]( [ce post sur Stack Overflow](
https://stackoverflow.com/questions/9445489/performing-http-requests-with-curl-using-proxy). https://stackoverflow.com/questions/9445489/performing-http-requests-with-curl-using-proxy).
#### Note sur l'install dans un container LXC #### Note sur l'install dans un container LXC
Il y a deux possibilités : Il y a deux possibilités :
@ -153,14 +146,11 @@ root et/ou sudo, attention: la config par défaut de Redis (un gestionnaire de
cache utilisé par ScoDoc) n'est pas compatible, en raison d'un problème de cache utilisé par ScoDoc) n'est pas compatible, en raison d'un problème de
système de fichier en lecture seule. Installer redis avant ScoDoc, comme suit: système de fichier en lecture seule. Installer redis avant ScoDoc, comme suit:
```bash
apt-get install redis apt-get install redis
```
Puis créer un dossier `/etc/systemd/system/redis.service.d` contenant le fichier Puis créer un dossier `/etc/systemd/system/redis.service.d` contenant le fichier
`redis.conf` avec les lignes suivantes : `redis.conf` avec les lignes suivantes :
```text
[Service] [Service]
PrivateTmp=no PrivateTmp=no
ProtectSystem=false ProtectSystem=false
@ -171,14 +161,11 @@ Puis créer un dossier `/etc/systemd/system/redis.service.d` contenant le fichie
ProtectKernelModules=no ProtectKernelModules=no
ReadWritePaths= ReadWritePaths=
ReadOnlyDirectories= ReadOnlyDirectories=
```
Ensuite Ensuite
```bash
systemctl daemon-reload systemctl daemon-reload
systemctl start redis systemctl start redis
```
... et poursuivez l'installation comme ci-dessous. ... et poursuivez l'installation comme ci-dessous.
@ -186,24 +173,20 @@ Ensuite
compte utilisateur normal, vous pouvez activer l'option « nesting » compte utilisateur normal, vous pouvez activer l'option « nesting »
(imbriqué) de LXC pour permettre à Redis de fonctionner normalement. (imbriqué) de LXC pour permettre à Redis de fonctionner normalement.
🚸 Attention ! N'activez pas le *nesting* sur un conteneur privilégié. Cela ⚠️ Attention ! N'activez pas le *nesting* sur un conteneur privilégié. Cela
provoquerait une faille de sécurité. provoquerait une faille de sécurité.
Si vous avez construit votre conteneur manuellement avec `lxc-create`, modifiez Si vous avez construit votre conteneur manuellement avec lxc-create, modifiez
le fichier `/var/lib/lxc/${nomDuConteneur}/config` et ajoutez les lignes le fichier `/var/lib/lxc/${nomDuConteneur}/config` et ajoutez les lignes
ci-dessous : ci-dessous :
```text
lxc.apparmor.allow_nesting = 1 lxc.apparmor.allow_nesting = 1
lxc.apparmor.profile = generated lxc.apparmor.profile = generated
```
Si vous utilisez un conteneur LXC sur l'hyperviseur Proxmox, modifiez le Si vous utilisez un conteneur LXC sur l'hyperviseur Proxmox, modifiez le
fichier `/etc/pve/lxc/${CTID}.conf` et ajoutez la ligne suivante : fichier `/etc/pve/lxc/${CTID}.conf` et ajoutez la ligne suivante :
```text
features: nesting=1 features: nesting=1
```
... et poursuivez l'installation comme ci-dessous. ... et poursuivez l'installation comme ci-dessous.
@ -211,9 +194,10 @@ fichier `/etc/pve/lxc/${CTID}.conf` et ajoutez la ligne suivante :
### 2.1) Charger le logiciel ### 2.1) Charger le logiciel
🚸 Les commandes ci-dessous sont à exécuter dans un terminal ouvert en tant que <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
**root** sur le serveur. Vous pouvez utiliser `su` (ou `sudo su`) pour devenir alt="/!\" /> Les commandes ci-dessous sont à exécuter dans un terminal ouvert
**root**). en tant que **root** sur le serveur. Vous pouvez utiliser `su` (ou `sudo su`)
pour devenir **root**).
Remarque: *Si ce n'est pas déjà le cas, vous avez intérêt à ouvrir une session Remarque: *Si ce n'est pas déjà le cas, vous avez intérêt à ouvrir une session
`ssh` (ou `putty`) depuis une machine normale, afin de pouvoir copier/coller `ssh` (ou `putty`) depuis une machine normale, afin de pouvoir copier/coller
@ -223,23 +207,19 @@ facilement les commandes et éditer les fichiers de configuration.*
download>scodoc.list</a> dans `/etc/apt/sources.list.d/` download>scodoc.list</a> dans `/etc/apt/sources.list.d/`
ou le créer contenant juste cette ligne: ou le créer contenant juste cette ligne:
```text
# contenu du fichier /etc/apt/sources.list.d/scodoc.list # contenu du fichier /etc/apt/sources.list.d/scodoc.list
deb http://scodoc.org/repo bullseye main deb http://scodoc.org/repo bullseye main
```
- Installer la clé: en `root` sur le serveur, lancer - Installer la clé: en `root` sur le serveur, lancer
```bash
apt-get -y install gnupg apt-get -y install gnupg
wget -O - https://scodoc.org/misc/scodoc-repo.gpg.key | apt-key add - wget -O - https://scodoc.org/misc/scodoc-repo.gpg.key | apt-key add -
```
- Installer le logiciel: - Installer le logiciel:
```bash
apt-get update apt-get update
apt-get install nginx apt-get install nginx
```
S'assurer que le logiciel `nginx`s'est bien installé. En cas de problème se S'assurer que le logiciel `nginx`s'est bien installé. En cas de problème se
référer à sa doc (par exemple, si référer à sa doc (par exemple, si
[votre serveur ne supporte pas [votre serveur ne supporte pas
@ -247,38 +227,34 @@ ou le créer contenant juste cette ligne:
Ensuite: Ensuite:
```bash
apt-get install scodoc9 apt-get install scodoc9
```
Notez que l'installation du paquet `scodoc9` va créer automatiquement un Notez que l'installation du paquet `scodoc9` va créer automatiquement un
utilisateur `scodoc` qui sera utilisé par le serveur. utilisateur `scodoc` qui sera utilisé par le serveur.
- Attribuer un mot de passe à l'utilisateur `scodoc`: - Attribuer un mot de passe à l'utilisateur `scodoc`:
```bash
passwd scodoc passwd scodoc
```
### 2.2) Configuration des logiciels et des données ### 2.2) Configuration des logiciels et des données
Lancer le script suivant en tant que `root` sur votre serveur nouvellement installé: Lancer le script suivant en tant que `root` sur votre serveur nouvellement installé:
```bash
/opt/scodoc/tools/configure-scodoc9.sh /opt/scodoc/tools/configure-scodoc9.sh
```
Vous devrez répondre à quelques questions et saisir le mot de passe que vous Vous devrez répondre à quelques questions et saisir le mot de passe que vous
attribuerez à l'utilisateur `admin`. attribuerez à l'utilisateur `admin`.
(note: pour en savoir plus sur ce script, [voir l'explication](GuideInstallDebian11Advanced.md)) (note: pour en savoir plus sur ce script, [voir l'explication](GuideInstallDebian11Advanced.md))
### 3) **Lancer ScoDoc** ### 3) **Lancer ScoDoc**:
```bash
sudo su # se connecter en root sudo su # se connecter en root
systemctl restart nginx systemctl restart nginx
systemctl restart scodoc9 systemctl restart scodoc9
```
et voila ! et voila !
Visiter `https://monscodoc.mondomaine.fr/` pour achever la configuration et Visiter `https://monscodoc.mondomaine.fr/` pour achever la configuration et
utiliser le logiciel: voir la page [GuideConfig](GuideConfig.md). utiliser le logiciel: voir la page [GuideConfig](GuideConfig.md).
@ -292,24 +268,18 @@ installation ScoDoc 7, ou même en place.
Voir [la procédure de migration](MigrationScoDoc7a9.md). Voir [la procédure de migration](MigrationScoDoc7a9.md).
## En cas de problème ## En cas de problème
Ne pas hésiter à me contacter ou à écrire sur la liste notes (voir [Listes de
diffusion](ListesDeDiffusion.md)).
Ne pas hésiter à nous contacter (voir [contacts](Contact.md)). * Problèmes d'envoi de courrier électronique (mail): voir [ProblemesMail](ProblemesMail.md)
- Problèmes d'envoi de courrier électronique (mail): voir [ProblemesMail](ProblemesMail.md)
Nota: sur certains réseaux, l'autoconfiguration IPv6 pose problème (par exemple: Nota: sur certains réseaux, l'autoconfiguration IPv6 pose problème (par exemple:
bloquage des envois de mails). Au besoin, il est possible de désactiver IPv6 bloquage des envois de mails). Au besoin, il est possible de désactiver IPv6
(voir par exemple [ici](https://wiki.debian-fr.xyz/D%C3%A9sactiver_l%27IPv6)). (voir par exemple [ici](https://wiki.debian-fr.xyz/D%C3%A9sactiver_l%27IPv6)).
## Ensuite... ## Ensuite...
- Mettez en place des [sauvegardes](SauvegardesBases.md) * Mettez en place des [sauvegardes](SauvegardesBases.md)
- Abonnez-vous au moins à la liste d'annonces: voir [contacts](Contact.md) * Abonnez-vous au moins à la liste d'annonces: voir [Listes de diffusion](ListesDeDiffusion.md)
!!! note "Voir aussi"
- [Guide configuration](GuideConfig.md)
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [FAQ](FAQ.md)
- [Contacts](Contact.md)

View File

@ -1,66 +1,46 @@
# Utilisation de ScoDoc # Utilisation de ScoDoc
ScoDoc contrôle les opérations via un mécanisme de permissions facile à mettre 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.
en œuvre et permettant de bien répartir les rôles entre les utilisateurs:
responsables, enseignants, secrétariats.
## Pour le responsable de formation ## 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.
La définition des programmes, l'inscription des étudiants et certains - [Guide pour le responsable de formation](GuideAdminFormation.md)
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) * [Modification d'un programme pédagogique et versions](VersionProgrammes.md)
* [Exemples et partages de programmes pédagogiques entre établissements](ExemplesProgrammesPedagogiques.md) * [Exemples et partages de programmes pédagogiques entre établissements](ExemplesProgrammesPedagogiques.md)
* [Importation des étudiants](ImportationEtuds.md) * [Importation des étudiants](ImportationEtuds.md)
* [Synchronisation des inscrits avec Apogée](SynchroApogee.md) * [Synchronisation des inscrits avec Apogée](SynchroApogee.md)
* [Procédure d'inscription des étudiants via Apogée](InscriptionsEtudApogee.md) * [Procédure d'inscription des étudiants via Apogée](InscriptionsEtudApogee.md)
* [Données sur l'origine des étudiants](DonneesAdmissions.md) * [Données sur l'origine des étudiants](DonneesAdmissions.md)
* [Gestion des photos des étudiants](GestionPhotos.md) * [Gestion des photos des étudiants](GestionPhotos.md)
* [Coordonnées des étudiants](GestionAdresses.md) * [Coordonnées des étudiants](GestionAdresses.md)
* [Opérations en fin de semestre (jury, ré-inscriptions, ...)](TransitionSemestre.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) * [Export des résultats et décisions de jury vers Apogée](ScoDocApogee.md)
* [Utilisation des rôles et permissions](ConfigPermissionsDept.md) * [Utilisation des rôles et permissions](ConfigPermissionsDept.md)
## Pour les enseignants et administratifs ## Pour les enseignants et administratifs:
* [Édition des bulletins de notes](BulletinsNotes.md) * [Édition des bulletins de notes](BulletinsNotes.md)
* [paramétrage des bulletins pdf](ParametrageBulletins.md) * [paramétrage des bulletins pdf](ParametrageBulletins.md)
* [Édition des PV de jury](ParametragePV.md) * [Édition des PV de jury](ParametragePV.md)
* Comment sont calculées les moyennes : [Calcul des notes](CalculNotes.md) * Comment sont calculées les moyennes : [Calcul des notes](CalculNotes.md)
## Opérations diverses ## Opérations diverses
#### Tenue des jurys et commissions
### Tenue des jurys et commissions
* [Saisie des décisions](SaisieDecisionsJury.md) * [Saisie des décisions](SaisieDecisionsJury.md)
* [Gestion des commissions et jurys, édition des PV](GestionJury.md) * [Gestion des commissions et jurys, édition des PV](GestionJury.md)
* [Capitalisation des UE](CapitalisationUE.md) * [Capitalisation des UE](CapitalisationUE.md)
### Spécificités du BUT
(documentation à venir)
### Spécificités du DUT
* [Compensation automatique des semestres](CompensationSemestre.md) * [Compensation automatique des semestres](CompensationSemestre.md)
### Suivi de l'assiduité #### Suivi de l'assiduité
* [Suivi de l'assiduité des étudiants](GestionAbsences.md) * [Suivi de l'assiduité des étudiants](GestionAbsences.md)
### Rapports, avis et tableaux de bords #### Rapports, avis et tableaux de bords
* [Rapports, suivi de cohortes, parcours](RapportsStatistiques.md) * [Rapports, suivi de cohortes, parcours](RapportsStatistiques.md)
* [Génération des avis de poursuite d'études](AvisPoursuiteEtudes.md) * [Génération des avis de poursuite d'études](AvisPoursuiteEtudes.md)
!!! note "Voir aussi" ## Questions fréquentes
Voir la [FAQ](FAQ.md)
- [Guide du responsable de formation](GuideAdminFormation.md)
- [FAQ](FAQ.md)
- [Contacts](Contact.md).

11
docs/ListesDeDiffusion.md Normal file
View File

@ -0,0 +1,11 @@
# Listes de diffusion mail pour ScoDoc
Les listes de diffusion mail sont le principal canal de communication entre les utilisateurs et entre les développeurs.
* [scodoc-annonces](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-annonces) liste à très fable trafic, en lecture seule, seules des annonces importantes sont postées (quelques messages par an), tous les utilisateurs sont encouragés à s'y abonner. Indispensable aux administrateurs du logiciel.
* [Notes](https://listes.univ-paris13.fr/mailman/listinfo/notes) discussions ou questions liées à l'utilisation du logiciel, entraide entre utilisateurs: vous pouvez y intervenir librement (les messages sont modérés pour éviter le spam).
* [scodoc-devel](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-devel) échanges entre développeurs. Abonnez-vous si vous êtes intéressés par le développement du logiciel, souhaitez participer ou poser des questions techniques.

View File

@ -1,14 +1,11 @@
# Mise à jour de ScoDoc 9
Il est nécessaire de mettre à jour très fréquemment votre installation ScoDoc. 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 À partir de ScoDoc 9, les mises à jour sont automatiques. Au besoin, on peut en
lancer une à tout moment avec la commande lancer une à tout moment avec la commande
apt update && apt-get upgrade apt update && apt-get upgrade
!!! note "Voir aussi"
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [Contacts](Contact.md)

View File

@ -1,50 +1,37 @@
# Paramétrage des bulletins de notes # Paramétrage des bulletins de notes
Ces réglages permettent de configurer la présentation des relevés de notes au format PDF.
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 bulletin est constitué de plusieurs zones:
* Le titre; * Le titre;
* le tableau des notes; * le tableau des notes;
* les absences et appréciations (immédiatement sous le tableau des notes; les * 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);
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 situation de l'étudiant (inscription, décision de jury, validations d'UE);
* la signature de gauche et celle de droite; * la signature de gauche et celle de droite;
* le pied de page. * le pied de page.
Le contenu et la présentation des zones titre, situation et signatures sont 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.
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 bulletins sont formattés pour du papier A4.
Les marges sont réglables via les valeurs dans la section "Marges additionnelles 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.
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 Variable | Valeur
---------|------- ---------|-------
titre_num | Le titre du semestre titre_num | Le titre du semestre
@ -55,8 +42,8 @@ date_debut | 01/09/2008
date_fin | 05/07/2009 date_fin | 05/07/2009
responsable | Nom du responsable du semestre (dir. des études) responsable | Nom du responsable du semestre (dir. des études)
### Informations sur l'étudiant
### Informations sur l'étudiant
Variable | Valeur (exemple) Variable | Valeur (exemple)
---------|------- ---------|-------
nom| DUPONT nom| DUPONT
@ -76,11 +63,6 @@ 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 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) 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:** | **Jurys de BUT:** |
descr_decision_annee | vide ou "Décision année: ADM" (code annuel: `ADM`, `PASD`, `DEF`...) 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" descr_decisions_rcue | vide ou nom de la compétence et code jury RCUE: "Administrer 1: ADM, Connecter 1: ADJ"
@ -102,30 +84,27 @@ groupes | indique les groupes auxquels appartient l'étudiant dans le semestre
group_0 | nom du groupe principal (1ère partition) group_0 | nom du groupe principal (1ère partition)
group_<n> | nom du group de la n-ième partition group_<n> | nom du group de la n-ième partition
### Autres informations
### Autres informations
Variable | &nbsp; Variable | &nbsp;
---------|------- ---------|-------
date_dmy | date courante, au format jj/mm/aaaa date_dmy | date courante, au format jj/mm/aaaa
date_iso | date courante, au format aaaa-mm-jj 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 ## Balises XML utilisées dans les formats
utilisateur](http://www.reportlab.com/docs/reportlab-userguide.pdf)). La balise 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 `<img>` n'est pas utilisable.
`<img>` n'est pas utilisable.
### Logos ### Logos
Une balise supplémentaire est interprétée par ScoDoc pour insérer des logos (images). 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 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 (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 documents PDF. [Plus d'information sur la gestion des logos ici](GestionLogos.md).
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; * Un logo est désigné par un identifiant (nom) et peut être défini soit globalement, soit pour un département;
@ -137,15 +116,12 @@ 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). * 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é L'enregistrement, la modification ou la suppression d'un logo peut être réalisé via la page de configuration qui est accessible aux
via la page de configuration qui est accessible aux administrateurs Scodoc administrateurs Scodoc depuis la page d'accueil.
depuis la page d'accueil.
Ce formulaire comporte une section pour les définitions globales plus une Ce formulaire comporte une section pour les définitions globales plus une section par département.
section par département.
Une section présente la liste des logos avec leurs propriétés (la dimension est Une section présente la liste des logos avec leurs propriétés (la dimension est donnée à titre indicatif quand elle est disponible).
donnée à titre indicatif quand elle est disponible).
Pour chaque logo, les actions disponibles sont : Pour chaque logo, les actions disponibles sont :
@ -155,25 +131,21 @@ Pour chaque logo, les actions disponibles sont :
* l'ajout d'un nouveau logo dans une section (global ou département) et indiquant le nom. * 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 *NB*. Quelle que soit l'opération effectuée, le nom du fichier téléversé n'a aucune importance
aucune importance (Seul le nom indiqué dans le formulaire est pris en compte et (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)
le format du fichier est déduit des données propres du fichier)
La balise `<logo name="xxx" width="44mm" height="22mm" valign="+5mm"/>`, placée La balise `<logo name="xxx" width="44mm" height="22mm" valign="+5mm"/>`, placée dans un paragraphe, insère le logo de nom `xxx` avec les dimensions indiquées.
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.
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 Notez qu'il est possible de ne préciser que l'une des deux dimensions hauteur ou largeur.
largeur. Dans ce cas, la dimension manquante est déduite du ratio (rapport Dans ce cas, la dimension manquante est déduite du ratio (rapport hauteur/largeur) de l'image originale.
hauteur/largeur) de l'image originale. Voir un exemple d'utilisation plus bas. Voir un exemple d'utilisation plus bas.
### Fond de page. ### 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. 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) 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 ### Exemple 1: Bulletins par défaut
Les bulletins édités par défaut sont obtenus avec: Les bulletins édités par défaut sont obtenus avec:

View File

@ -1,93 +1,56 @@
# Présentation rapide de ScoDoc # Présentation rapide de ScoDoc
Voir les <a href="https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7PzOD8GDW3kG1" target="_blank">Vidéos d'introduction sur YouTube <img src="/img/tube.png" alt="" style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a> Voir les <a href="https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7PzOD8GDW3kG1" target="_blank">Vidéos d'introduction sur YouTube <img src="img/tube.png" alt="" style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a>
## Page d'accueil ## Page d'accueil
![accueil](screens/accueil-scodoc7.png) ![accueil](screens/accueil-scodoc7.png)
On y trouve les éléments suivants: On y trouve les éléments suivants:
La colonne de gauche indique l'identité de l'utilisateur connecté (en rouge à La colonne de gauche indique l'identité de l'utilisateur connecté (en rouge à droite) et contient des liens facilitant la navigation sur le site (certains sont paramétrables à l'installation). On note l'accès à trois composants importants: Entreprises (fichier d'entreprises), Notes (gestion des notes), Absences (relevé des absences), et un champ de texte permettant de rechercher un étudiant par son nom.
droite) et contient des liens facilitant la navigation sur le site (certains
sont paramétrables à l'installation). On note l'accès à trois composants
importants: Entreprises (fichier d'entreprises), Notes (gestion des notes),
Absences (relevé des absences), et un champ de texte permettant de rechercher un
étudiant par son nom.
L'identité de l'utilisateur défini ses droits d'accès (rôle) et les fonctions L'identité de l'utilisateur défini ses droits d'accès (rôle) et les fonctions qu'il peut utiliser.
qu'il peut utiliser.
Le centre de la page donne les formations (sessions) en cours, groupées par Le centre de la page donne les formations (sessions) en cours, groupées par type. A côté du titre de chaque formation, on a le nom de son responsable (ou directeur des études dans le jargon IUT), ainsi que les dates de début et de fin de la session.
type. A côté du titre de chaque formation, on a le nom de son responsable (ou
directeur des études dans le jargon IUT), ainsi que les dates de début et de fin
de la session.
## Fiche étudiant ## Fiche étudiant
Pour accéder à la fiche d'un étudiant, on peut soit le rechercher par nom (voir RechercheEtudiant) soit cliquer sur un lien dans une liste ou sur une photo d'un trombinoscope. Cette fiche (exemple ci-dessous) donne accès à toutes les informations sur l'étudiant.
Pour accéder à la fiche d'un étudiant, on peut soit le rechercher par nom (voir ![fiche étudiant](screens/ficheEtud-scodoc7.png)
RechercheEtudiant) soit cliquer sur un lien dans une liste ou sur une photo d'un
trombinoscope. Cette fiche (exemple ci-dessous) donne accès à toutes les
informations sur l'étudiant. ![fiche étudiant](screens/ficheEtud-scodoc7.png)
## Suivi de l'assiduité ## Suivi de l'assiduité
ScoDoc permet d'enregistrer les absences des étudiants puis de les visualiser sur un calendrier. On peut aussi obtenir des comptes d'absences, générer des alarmes par e-mail pour prévenir un responsable, vérifier les absences qui coincident avec un examen, enregistre les justificatifs, etc.
ScoDoc permet d'enregistrer les absences des étudiants puis de les visualiser ![calendrier des absences](screens/calabs-scodoc7.png)
sur un calendrier. On peut aussi obtenir des comptes d'absences, générer des
alarmes par e-mail pour prévenir un responsable, vérifier les absences qui
coincident avec un examen, enregistre les justificatifs, etc. ![calendrier des
absences](screens/calabs-scodoc7.png)
## Gestion des notes ## Gestion des notes
La gestion des notes est la partie principale du logiciel et est conçue pour La gestion des notes est la partie principale du logiciel et est conçue pour faciliter au maximum le travail des enseignants, grâce à une grande flexibilité (définition des évaluations, import/export via Excel ou saisie sur formulaire web, vérifications, etc.).
faciliter au maximum le travail des enseignants, grâce à une grande flexibilité
(définition des évaluations, import/export via Excel ou saisie sur formulaire
web, vérifications, etc.).
### Tableau de bord du semestre, avec les modules ### Tableau de bord du semestre, avec les modules
![tableau de bord du semestre](screens/tableaubord2011.png) ![tableau de bord du semestre](screens/tableaubord2011.png)
### Tableau récapitulatif des moyennes ### Tableau récapitulatif des moyennes
![tableau de bord du semestre](screens/NotesRecap2012-crop.png) ![tableau de bord du semestre](screens/NotesRecap2012-crop.png)
### Bulletins de notes ### Bulletins de notes
Les bulletins sont affichables selon différents formats (ci-dessous le format par défaut). Ils peuvent être exportés sous forme de document PDF (pour impression papier), à d'autres formats (XML, Excel) ou directement envoyé par mail aux étudiants.
Les bulletins sont affichables selon différents formats (ci-dessous le format ![bulletin de note web](screens/BulletinInter2012-crop.png)
par défaut). Ils peuvent être exportés sous forme de document PDF (pour
impression papier), à d'autres formats (XML, Excel) ou directement envoyé par
mail aux étudiants. ![bulletin de note web](screens/BulletinInter2012-crop.png)
## Gestion des jurys et commissions ## Gestion des jurys et commissions
Une interface permet la saisie des décisions de jury. Le parcours de l'étudiant (redoublements, validations antérieures, compensations entre semestres, capitalisations d'UE) est automatiquement pris en compte, permettant aux enseignant de se concentrer sur les aspects pédagogiques sans perdre de temps avec la gestion administrative (parfois assez complexe).
Une interface permet la saisie des décisions de jury. Le parcours de l'étudiant ScoDoc intègre la gestion des jurys des DUT (2005) et bientôt du Bachelor Universitaire de technologie (BUT) et s'assure que les décisions prises respectent les règles.
(redoublements, validations antérieures, compensations entre semestres,
capitalisations d'UE) est automatiquement pris en compte, permettant aux
enseignant de se concentrer sur les aspects pédagogiques sans perdre de temps
avec la gestion administrative (parfois assez complexe).
ScoDoc intègre la gestion des jurys des DUT (2005) et bientôt du Bachelor
Universitaire de technologie (BUT) et s'assure que les décisions prises
respectent les règles.
## Gestion des groupes ## Gestion des groupes
ScoDoc permet de définir des partitions et groupes en nombre quelconque, et d'y ScoDoc permet de définir des partitions et groupes en nombre quelconque, et d'y répartir facilement les étudiants (glisser/déposer, fonctions de répartition automatiques).
répartir facilement les étudiants (glisser/déposer, fonctions de répartition ![affectation aux groupes](screens/GroupesDnD.png)
automatiques). ![affectation aux groupes](screens/GroupesDnD.png)
## Trombinoscopes ## Trombinoscopes
![trombinoscope](screens/Trombi-scodoc7.png) ![trombinoscope](screens/Trombi-scodoc7.png)
*(en réalité vous aurez les photos de vos étudiants !)* *(en réalité vous aurez les photos de vos étudiants !)*
## Autres fonctionnalités ## Autres fonctionnalités
### Imports / Exports ### Imports / Exports
Les données conservées dans le logiciel peuvent être exportées dans une grande variété de formats (pages web, PDF, Excel, XML...) ce qui facilite tant son usage par des non informaticiens que son intégration dans d'autres logiciels (portails d'établissements, systèmes d'informations comme Apogée).
Les données conservées dans le logiciel peuvent être exportées dans une grande
variété de formats (pages web, PDF, Excel, XML...) ce qui facilite tant son
usage par des non informaticiens que son intégration dans d'autres logiciels
(portails d'établissements, systèmes d'informations comme Apogée).

View File

@ -1,15 +1,12 @@
# Problèmes d'envoi de courriers électroniques # Problèmes d'envoi de courriers électroniques
ScoDoc envoie des mails en plusieurs occasions (bulletins de notes, importation
ScoDoc envoie des mails (emails, ou e-mails, ou courriels) en plusieurs d'utilisateurs, alertes sur absences, exceptions dans le code).
occasions (bulletins de notes, importation d'utilisateurs, alertes sur absences,
exceptions dans le code).
Cette page explique ce qu'il faut vérifier si l'envoi des messages ne fonctionne Cette page explique ce qu'il faut vérifier si l'envoi des messages ne fonctionne
pas. pas.
## Configuration du serveur ## Configuration du serveur
ScoDoc suppose que la machine serveur sur laquelle il s'exécute est dotée d'un ScoDoc suppose que la machine serveur sur laquelle il s'exécute est dotée d'un
serveur de mail capable d'envoyer des messages (soit directement, soit via un serveur de mail capable d'envoyer des messages (soit directement, soit via un
relais). L'installeur propose d'installer le logiciel serveur Postfix. relais). L'installeur propose d'installer le logiciel serveur Postfix.
@ -17,33 +14,27 @@ relais). L'installeur propose d'installer le logiciel serveur Postfix.
1. Vérifier que votre serveur de messagerie est bien configuré: dans un 1. Vérifier que votre serveur de messagerie est bien configuré: dans un
terminal, envoyez un message terminal, envoyez un message
```
```bash
mail mon_adresse@universite.fr mail mon_adresse@universite.fr
... entrer votre texte, terminez par ctrl-d ... ... entrer votre texte, terminez par ctrl-d ...
``` ```
Si vous ne recevez pas le message que vous vous envoyiez, revoir la Si vous ne recevez pas le message que vous vous envoyiez, revoir la
configuration de votre serveur, par exemple avec la commande configuration de votre serveur, par exemple avec la commande
```
```bash
dpkg-reconfigure postfix dpkg-reconfigure postfix
``` ```
2. Vérifiez que le serveur SMTP écoute bien en local sur le port 25: dans un terminal taper 2. Vérifiez que le serveur SMTP écoute bien en local sur le port 25: dans un terminal taper
```
```text
telnet localhost 25 telnet localhost 25
``` ```
Vous devez observer: Vous devez observer:
```
```text
Trying 127.0.0.1... Trying 127.0.0.1...
Connected to localhost. Connected to localhost.
Escape character is '^]'. Escape character is '^]'.
220 nom_du_serveur ESMTP Postfix (Debian/GNU) 220 nom_du_serveur ESMTP Postfix (Debian/GNU)
``` ```
(quitter avec ctrl-] puis `quit`) (quitter avec ctrl-] puis `quit`)
## Tests avec ScoDoc ## Tests avec ScoDoc
@ -84,9 +75,3 @@ notification ou de bulletins sans déranger les étudiants ou les collègues).
Pour cela, aller sur la page *Paramétrage*, tout en bas, et indiquer une Pour cela, aller sur la page *Paramétrage*, tout en bas, et indiquer une
*Adresse de test*. Ne pas oublier de l'enlever une fois les essais effectués ! *Adresse de test*. Ne pas oublier de l'enlever une fois les essais effectués !
!!! note "Voir aussi"
- Pour la configuration des messages envoyés par ScoDoc, la page [Configuration des envois d'emails](ConfigEmail.md)
- [Guide administrateur ScoDoc](GuideAdminSys.md)
- [Contacts](Contact.md)

View File

@ -57,10 +57,9 @@ configuré sur une autre base).
## En cas de problème: restaurer la base à partir d'une sauvegarde ## En cas de problème: restaurer la base à partir d'une sauvegarde
🚸 Attention, certaines informations sont stockées dans des fichiers (sous 🚸 Attention, certaines informations sont stockées dans des fichiers et non dans
`/opt/scodoc-data`) et non dans la base de données: configuration du logiciel, la base de données: configuration du logiciel, photos des étudiants. Ce
photos des étudiants, archives des PV, fichiers Apogée, etc. Ce paragraphe ne paragraphe ne traite que de la restauration de la base de données.
traite que de la restauration de la base de données.
Rappel: en ScoDoc 9, il n'y a qu'une seule base de donnée SQL, nommée par défaut Rappel: en ScoDoc 9, il n'y a qu'une seule base de donnée SQL, nommée par défaut
`SCODOC`. Cette base contient les données des départements et la définition des `SCODOC`. Cette base contient les données des départements et la définition des

View File

@ -68,24 +68,13 @@ Si vous êtes intéressé par le développement, voir
* [la section sur les tests unitaires de l'API](TestsScoDoc.md#tests-de-lapi-scodoc9); * [la section sur les tests unitaires de l'API](TestsScoDoc.md#tests-de-lapi-scodoc9);
* [la documentation interne](Internals.md#vues-de-lapi-et-permissions). * [la documentation interne](Internals.md#vues-de-lapi-et-permissions).
!!! note "Voir aussi"
- Si vous utilisez le CAS, pensez à laisser les comptes utilisateurs API se
connecter via ScoDoc sans CAS. Pour cela, cocher l'option
*Autorise connexion via CAS si CAS est activé*
dans leur formulaire de configuration.
- Si l'utilisateur est associé à un département (cas des comptes créés via l'interface Web),
il ne pourra accéder à l'API que via une *route départementale*, c'est à dire une route comprenant
l'acronyme de son département, de la forme `https://...//ScoDoc/DEPARTEMENT/api/...`.
## Essais avec HTTPie ## Essais avec HTTPie
[HTTPie](https://httpie.io/) est un client universel livre et gratuit très commode, disponible [HTTPie](https://httpie.io/) est un client universel livre et gratuit très commode, disponible
pour Windows, Linux, en ligne de commande ou interface graphique. pour Windows, Linux, en ligne de commande ou interface graphique.
Exemple d'utilisation en ligne de commande et interroger votre ScoDoc pour Exemple d'utilisation en ligne de commande et interroger votre ScoDoc pour obtenir la
obtenir la liste des départements: liste des départements:
```bash ```bash
http -a USER:PASSWORD POST 'http://localhost:5000/ScoDoc/api/tokens' http -a USER:PASSWORD POST 'http://localhost:5000/ScoDoc/api/tokens'
@ -139,12 +128,10 @@ version de ScoDoc 9.3.25.
### Accès à l'API REST ### Accès à l'API REST
L'API est accessible à l'adresse: L'API est accessible à l'adresse: `https://scodoc.monsite.tld/ScoDoc/api/<fonction>`,
`https://scodoc.monsite.tld/ScoDoc/api/<fonction>`, et aussi via les *routes et aussi `https://scodoc.monsite.tld/ScoDoc/<dept_acronyme>/api/<fonction>` pour un
départementales* de la forme accès avec des droits restreints au département indiqué.
`https://scodoc.monsite.tld/ScoDoc/<dept_acronyme>/api/<fonction>` pour un accès (<fonction> à choisir dans [Référence](#reference).)
avec des droits restreints au département indiqué. La liste des `<fonction>` est
donnée dans [Référence](#reference).
#### Authentification #### Authentification

View File

@ -12,8 +12,6 @@ ici:
[SCODOC_import_notes_dans_apogee.pdf](papers/SCODOC_import_notes_dans_apogee.pdf), [SCODOC_import_notes_dans_apogee.pdf](papers/SCODOC_import_notes_dans_apogee.pdf),
merci à Bérangère Lhoumeau, du service Scolarité de l'IUT de Tarbes. merci à Bérangère Lhoumeau, du service Scolarité de l'IUT de Tarbes.
Voir aussi [cette page pour les aspects spécifiques au BUT](BUTApogee.md).
## Remplissage des fichiers maquette Apogée (CSV) ## Remplissage des fichiers maquette Apogée (CSV)
Solution intégrée à ScoDoc en juillet 2016. Solution intégrée à ScoDoc en juillet 2016.

View File

@ -58,6 +58,7 @@ A ce stade, le semestre est terminé. Il est recommandé de le **verrouiller** a
6. (optionnel) Répartir les étudiants dans des groupes de TD (*Inscriptions / Modifier les groupes*). 6. (optionnel) Répartir les étudiants dans des groupes de TD (*Inscriptions / Modifier les groupes*).
C'est prêt. Les enseignants autorisés peuvent créer des évaluations et saisir des notes. C'est prêt. Les enseignants autorisés peuvent créer des évaluations et saisir des notes.
## Problèmes couramment rencontrés ## Problèmes couramment rencontrés
@ -68,4 +69,4 @@ C'est prêt. Les enseignants autorisés peuvent créer des évaluations et saisi
- **Aucun étudiant à inscrire**: cela peut arriver si les dates de semestres sont incorrectes (chevauchement): en particulier, vérifier que la date de début du nouveau semestre est bien postérieure à la date de fin des semestres d'où proviennent les étudiants à inscrire. - **Aucun étudiant à inscrire**: cela peut arriver si les dates de semestres sont incorrectes (chevauchement): en particulier, vérifier que la date de début du nouveau semestre est bien postérieure à la date de fin des semestres d'où proviennent les étudiants à inscrire.
Pour toutes questions, n'hésitez pas à nous contacter (voir la [contacts](Contact.md)). Pour toutes questions, n'hésitez pas à contacter la liste de diffusion Notes (voir la [page d'information sur les listes](ListesDeDiffusion.md)).

View File

@ -1,9 +1,6 @@
# Établissements utilisant ScoDoc # É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 à <emmanuel.viennet@gmail.com>.
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 à <emmanuel.viennet@gmail.com>.
## Établissements membres de l'association (2020-2021) [liste non à jour] ## Établissements membres de l'association (2020-2021) [liste non à jour]
@ -50,13 +47,11 @@ utilisez le logiciel, merci d'envoyer un mail à <emmanuel.viennet@gmail.com>.
* département Informatique de l'[IUT de Montpellier-Sète](https://iut-montpellier-sete.edu.umontpellier.fr/dut-informatique/) * département Informatique de l'[IUT de Montpellier-Sète](https://iut-montpellier-sete.edu.umontpellier.fr/dut-informatique/)
### Autres membres ### Autres membres
* [IUT de La Rochelle](http://www.iut-larochelle.fr/). * [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 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 utilisateurs ou adhérents ## IUT utilisateurs
* [IUT d'Aix en Provence (GEII)](http://iut.univ-amu.fr/diplomes/dut-genie-electrique-informatique-industrielle-dut-geii), * [IUT d'Aix en Provence (GEII)](http://iut.univ-amu.fr/diplomes/dut-genie-electrique-informatique-industrielle-dut-geii),
(site de Salon); (site de Salon);
@ -174,7 +169,6 @@ utilisez le logiciel, merci d'envoyer un mail à <emmanuel.viennet@gmail.com>.
* [IUT de Villeurbanne (Lyon 1)](http://iut.univ-lyon1.fr/), département GEII, environ 220 inscrits/an. * [IUT de Villeurbanne (Lyon 1)](http://iut.univ-lyon1.fr/), département GEII, environ 220 inscrits/an.
## Autres établissements utilisateurs (hors IUT) ## Autres établissements utilisateurs (hors IUT)
* Licence de sciences (SPI) à L'Université de Bretagne Occidentale (UBO); * Licence de sciences (SPI) à L'Université de Bretagne Occidentale (UBO);
* Masters de sciences, Institut Galilée, Université Sorbonne Paris Nord; * Masters de sciences, Institut Galilée, Université Sorbonne Paris Nord;
@ -190,8 +184,3 @@ utilisez le logiciel, merci d'envoyer un mail à <emmanuel.viennet@gmail.com>.
* [École Supérieure des Sciences et Technologies de l'Ingénieur de Nancy](http://www.esstin.univ-lorraine.fr) (jusqu'en 2013); * [É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)

View File

@ -1,112 +1,57 @@
# Modification d'un programme pédagogique et versions ## Modification d'un programme pédagogique et versions
Un programme pédagogique définit notamment les coefficients des modules qui le
composent. Les semestres qui se réfèrent à ce programme utilisent ces
coefficients pour calculer leurs notes. De même, les noms de UE et modules qui
apparaissent sur les bulletins viennent du programme. Il faut être
particulièrement vigilant lors des modifications du programme pédagogique.
Dans la configuration par défaut, seul le chef de département (rôle Admin) peut Un programme pédagogique définit notamment les coefficients des modules qui le composent. Les semestres qui se réfèrent à ce programme utilisent ces coefficients pour calculer leurs notes. De même, les noms de UE et modules qui apparaissent sur les bulletins viennent du programme. Il faut être particulièrement vigilant lors des modifications du programme pédagogique
modifier les programmes pédagogiques.
(voir aussi des exemples de programmes en bas de la page Dans la configuration par défaut, seul le chef de département (rôle Admin) peut modifier les programmes pédagogiques.
[GuideAdminFormation](GuideAdminFormation.md)).
## Points importants (voir aussi des exemples de programmes en bas de la page [GuideAdminFormation](GuideAdminFormation.md)).
### Unités d'Enseignement (UE)
Les UE sont destinées à être *capitalisées* (voir ### Points importants
[CapitalisationUE](CapitalisationUE.md)). Par conséquent, une formation en
plusieurs semestres devrait normalement avoir un jeu d'UE différent dans chaque
semestre.
* Il est parfois désirable de capitaliser au sein d'un parcours des UE
appartenant à deux programmes ScoDoc différents (par exemple, on peut avoir
changé de version du programme entre deux semestres, comme expliqué plus
loin). Dans ce cas, il faut attribuer aux programmes le même code de formation
(via le lien "modifier" sur la page d'accueil des programmes), et aussi
attribuer les mêmes codes aux UE (via le lien "modifier l'UE" sur la page
"programme détaillé et semestres").
* Les UE peuvent être de type "normal" ou "Sport&Culture". Ces dernières ne sont
utilisées que pour les notes optionnelles (activités culturelles et sportives)
utilisée dans certains établissements. Elles se voient attribuer une règle de
calcul spécifique qui dépend généralement de l'établissement (il n'y à pas de
règle nationale pour la prise en compte des notes de sport et culture).
Typiquement, la note des UE de ce type spécial agit directement sur la moyenne
générale de l'étudiant.
### Modules #### Unités d'Enseignement (UE)
* Le *code* du module va apparaitre sur les bulletins et certains tableaux Les UE sont destinées à être *capitalisées* (voir [CapitalisationUE](CapitalisationUE.md)). Par conséquent, une formation en plusieurs semestres devrait normalement avoir un jeu d'UE différent dans chaque semestre.
récapitulatifs. Il comporte habituellement quelques caractères (comme "MATH",
ou "SPO"). Si la version officielle de votre programme pédagogique n'utilise
pas de codes de ce genre, inventez des codes à la fois courts (pas plus de 4
ou 5 caractères) et évocateurs du nom du module.
* Le *titre* du module apparaitra sur le tableau de bord du semestre et sur les * Il est parfois désirable de capitaliser au sein d'un parcours des UE appartenant à deux programmes ScoDoc différents (par exemple, on peut avoir changé de version du programme entre deux semestres, comme expliqué plus loin). Dans ce cas, il faut attribuer aux programmes le même code de formation (via le lien "modifier" sur la page d'accueil des programmes), et aussi attribuer les mêmes codes aux UE (via le lien "modifier l'UE" sur la page "programme détaillé et semestres").
bulletins.
* L' *abréviation* est une version courte du titre. Si le titre n'est pas trop * Les UE peuvent être de type "normal" ou "Sport&Culture". Ces dernières ne sont utilisées que pour les notes optionnelles (activités culturelles et sportives) utilisée dans certains établissements. Elles se voient attribuer une règle de calcul spécifique qui dépend généralement de l'établissement (il n'y à pas de règle nationale pour la prise en compte de snotes de sport et culture). Typiquement, la note des UE de ce type spécial agit directement sur la moyenne générale de l'étudiant.
long (3 ou 4 mots), copier le. Sinon, inventer une abréviation en quelques
mots qui soit lisible.
* Les volumes horaires ne sont présents que pour information et ne sont
actuellement pas du tout utilisés par ScoDoc: il est donc facultatif de les
indiquer.
* Le coefficient est utilisé pour le calcul de la moyenne d'UE et de la moyenne #### Modules
générale. Il s'agit d'un nombre réel positif ou nul.
* Le *code* du module va apparaitre sur les bulletins et certains tableaux récapitulatifs. Il comporte habituellement quelques caractères (comme "MATH", ou "SPO"). Si la version officielle de votre programme pédagogique n'utilise pas de codes de ce genre, inventez des codes à la fois courts (pas plus de 4 ou 5 caractères) et évocateurs du nom du module.
* Le *titre* du module apparaitra sur le tableau de bord du semestre et sur les bulletins.
* L' *abréviation* est une version courte du titre. Si le titre n'est pas trop long (3 ou 4 mots), copier le. Sinon, inventer une abréviation en quelques mots qui soit lisible.
* Les volumes horaires ne sont présents que pour information et ne sont actuellement pas du tout utilisés par ScoDoc: il est donc facultatif de les indiquer.
* Le coefficient est utilisé pour le calcul de la moyenne d'UE et de la moyenne générale. Il s'agit d'un nombre réel positif ou nul.
* Choisir dans le menu la *matière* à laquelle appartient le module. * Choisir dans le menu la *matière* à laquelle appartient le module.
* Le semestre est un nombre indiquant dans quel semestre de la formation se * Le semestre est un nombre indiquant dans quel semestre de la formation se place habituellement ce module. Il arrive que l'on décline la même formation selon différentes modalités (formation initiale, continue) avec des placements différents: dans ce cas, indiquer le semestre dans la modalité "habituelle"; lors de la mise en place d'un semestre, on peut choisir manuellement des modules de tous les semestres.
place habituellement ce module. Il arrive que l'on décline la même formation
selon différentes modalités (formation initiale, continue) avec des placements
différents: dans ce cas, indiquer le semestre dans la modalité "habituelle";
lors de la mise en place d'un semestre, on peut choisir manuellement des
modules de tous les semestres.
### Ordre d'affichage des UE, matières et modules
Chaque élément (UE, matières et modules) possède un attribut *numéro* qui est un
nombre entier utilisé pour le classement des éléments de même niveau dans la
hiérarchie dans les tableaux et bulletins.
Il est conseillé d'attribuer les numéros de 10 en 10 afin de pouvoir plus
facilement insérer un nouvel élément entre deux éléments existants. Par exemple,
si l'on a dans une matière trois modules MA, MB, MC, on va leur attribuer les
numéros 10, 20 et 30.
## Verrouillage et versions
Lorsque au moins l'un des semestres qui se réfèrent à ce programme est
*verrouillé*, il devient impossible de modifier le programme (la page de
présentation du programme ne comporte alors aucun lien). Deux cas peuvent se
présenter:
* il s'agit d'une modification mineure (intitulé d'un module, ...) ne risquant
pas affecter les notes existantes, et il y a peu de semestres verrouillés:
dans ce cas, il est possible d'aller déverrouiller un à un les semestres
concernés, puis d'effectuer la modification du programme avant de
re-verrouiller les semestres.
* il s'agit d'une modification conséquente, on ne ne veut pas affecter les
semestres existants: on crée alors une nouvelle *version* du programme. La
version crée est une copie à l'identique du programme existant, que l'on peut
modifier à sa guise.
!!! note "Voir aussi" #### Ordre d'affichage des UE, matières et modules
- [Guide du responsable de formation](GuideAdminFormation.md)
- [Guide utilisateur](GuideUtilisateur.md) Chaque élément (UE, matières et modules) possède un attribut *numéro* qui est un nombre entier utilisé pour le classement des éléments de même niveau dans la hiérarchie dans les tableaux et bulletins.
- [Tutoriels vidéo](https://www.youtube.com/channel/UCb0JYCBRi0CsE4XFp4ByhXg)
- [Gestion des UE Bonus](https://www.youtube.com/watch?v=SVbjuDpq-lI) Il est conseillé d'attribuer les numéros de 10 en 10 afin de pouvoir plus facilement insérer un nouvel élément entre deux éléments existants. Par exemple, si l'on a dans une matière trois modules MA, MB, MC, on va leur attribuer les numéros 10, 20 et 30.
- [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) ### Verrouillage et versions
- [FAQ](FAQ.md)
- [Contacts](Contact.md) Lorsque au moins l'un des semestres qui se réfèrent à ce programme est *verrouillé*, il devient impossible de modifier le programme (la page de présentation du programme ne comporte alors aucun lien). Deux cas peuvent se présenter:
* il s'agit d'une modification mineure (intitulé d'un module, ...) ne risquant pas affecter les notes existantes, et il y a peu de semestres verrouillés: dans ce cas, il est possible d'aller déverrouiller un à un les semestres concernés, puis d'effectuer la modification du programme avant de reverrouiller les semestres.
* il s'agit d'une modification conséquente, on ne ne veut pas affecter les semestres existants: on crée alors une nouvelle *version* du programme. La version crée est une copie à l'identique du programme existant, que l'on peut modifier à sa guise.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 138 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 256 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 219 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 35 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 130 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 451 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 86 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 130 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 80 KiB

View File

@ -12,10 +12,11 @@ certificatives
- aide à la décision pour les jurys; - aide à la décision pour les jurys;
- listes des étudiants (groupes, trombinoscopes, bordereaux divers); - listes des étudiants (groupes, trombinoscopes, bordereaux divers);
- suivi de l'assiduité (saisie et visualisation des absences); - suivi de l'assiduité (saisie et visualisation des absences);
- tableaux de bord, rapports statistiques sur la formation (suivis de - tableaux de bords, rapports statistiques sur la formation (suivis de
cohortes, ...) utiles pour l'évaluation et le suivi des formations; cohortes, ...) utiles pour l'évaluation et le suivi des formations;
- édition des procès-verbaux, bulletins et autres documents liés à la scolarité. - édition des procès-verbaux, bulletins et autres documents liés à la scolarité.
ScoDoc est un *logiciel libre*: vous pouvez [participer à son développement](Contribuer.md). ScoDoc est un *logiciel libre*: vous pouvez [participer à son développement](Contribuer.md).
ScoDoc s'utilise sur un navigateur web standard: les utilisateurs n'ont rien à ScoDoc s'utilise sur un navigateur web standard: les utilisateurs n'ont rien à
@ -36,27 +37,24 @@ retourner à `Emmanuel.Viennet at gmail.com`.
- [Présentation générale du logiciel avec copies d'écran](PresentationGenerale.md) - [Présentation générale du logiciel avec copies d'écran](PresentationGenerale.md)
- Quelques <a href="https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7PzOD8GDW3kG1" target="_blank">vidéos d'introduction sur YouTube <img src="/img/tube.png" alt="" style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a> - Quelques <a href="https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7PzOD8GDW3kG1" target="_blank">vidéos d'introduction sur YouTube <img src="img/tube.png" alt="" style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a>
- Ancienne présentation au colloque du [CRI-IUT](https://www.criiut.fr/) en 2013: [diapos en pdf](papers/presScoDocCRIIUT2013.pdf)
- Un très ancien [article sur ScoDoc](papers/scodoc-reunion2007.pdf)
- très ancienne présentation au colloque du [CRI-IUT](https://www.criiut.fr/) en 2013: [diapos en pdf](papers/presScoDocCRIIUT2013.pdf)
- Un très très ancien [article sur ScoDoc](papers/scodoc-reunion2007.pdf)
## Communauté d'utilisateurs ## Communauté d'utilisateurs
- Le Discord des utilisateurs: assistance chat ou audio [rejoindre le salon](https://discord.gg/ybw6ugtFsZ) - Le Discord des utilisateurs: assistance chat ou audio [rejoindre le salon](https://discord.gg/ybw6ugtFsZ)
- [contacts: Discord, listes, site](Contact.md) - [Listes de diffusion e-mail](ListesDeDiffusion.md)
- Vous pouvez signaler ici des bugs ou déposer des suggestions d'amélioration via les "tickets":
* [Liste des tickets en cours](https://scodoc.org/git/viennet/ScoDoc/issues)
* Déclarer un nouveau ticket: demander un compte sur la liste `scodoc-devel` (lien ci-dessus).
- [Contribuer à ScoDoc](Contribuer.md) - [Contribuer à ScoDoc](Contribuer.md)
## Actualités ## Actualités
### ScoDoc 9.4.x
Série en développement, centrés sur la gestion du *Bachelor Universitaire de
technologie* (BUT) mais aussi sur la modernisation du logiciel et sa meilleure
intégration dans les systèmes d'informations universitaires (API, CAS).
### Parution de ScoDoc 9 en 2021-2022 ### Parution de ScoDoc 9 en 2021-2022
Version majeure, avec une architecture logicielle complètement remaniée. Cette Version majeure, avec une architecture logicielle complètement remaniée. Cette
version modernise l'infrastructure logicielle (maintenant basée sur Python version modernise l'infrastructure logicielle (maintenant basée sur Python
3/Flask/postgresql) et propose de nombreuses améliorations, notamment pour la 3/Flask/postgresql) et propose de nombreuses améliorations, notamment pour la
@ -82,12 +80,10 @@ Orléans, LP IUT Villetaneuse):
l'association. l'association.
### Nouveaux développeurs ### Nouveaux développeurs
Plusieurs développeurs volontaires, la plupart enseignants en IUT, ont rejoint Plusieurs développeurs volontaires, la plupart enseignants en IUT, ont rejoint
l'équipe depuis 2020. l'équipe depuis 2020.
### Bachelor Universitaire de Technologie (BUT) et ScoDoc ### Bachelor Universitaire de Technologie (BUT) et ScoDoc
ScoDoc évolue pour intégrer la gestion du BUT, en approche par compétences, avec ScoDoc évolue pour intégrer la gestion du BUT, en approche par compétences, avec
des situations d'apprentissage et d'évaluation (SAÉs) et des ressources des situations d'apprentissage et d'évaluation (SAÉs) et des ressources
pédagogiques. ScoDoc n'a pas vocation à devenir un portfolio APC, mais pédagogiques. ScoDoc n'a pas vocation à devenir un portfolio APC, mais
@ -98,7 +94,6 @@ Des formats de bulletins de notes adaptés sont proposés pour faciliter la
compréhension des résultats par les étudiants et enseignants. compréhension des résultats par les étudiants et enseignants.
### ScoDoc et Pégase/PC-SCOL ### ScoDoc et Pégase/PC-SCOL
Nous sommes en contact avec l'équipe du projet Pégase/PC-SCOL, qui succédera Nous sommes en contact avec l'équipe du projet Pégase/PC-SCOL, qui succédera
dans certaines universités à Apogée. A court et moyen terme, ce nouvel outil ne dans certaines universités à Apogée. A court et moyen terme, ce nouvel outil ne
rendra pas les mêmes services que ScoDoc. Nous étudions dès maintenant rendra pas les mêmes services que ScoDoc. Nous étudions dès maintenant
@ -107,14 +102,12 @@ l'interfaçage des outils (via des API), qui a priori sera plus fluide et facile
entente. entente.
### Feuille de route (roadmap) ### Feuille de route (roadmap)
Les prochaines versions de ScoDoc : Les prochaines versions de ScoDoc :
- ScoDoc 9.5 : printemps 2023 - ScoDoc 9.5 : début 2023
- Nouveau système de suivi de l'assiduité (absences, présences) - Nouveau système de suivi de l'assiduité (absences, présences)
- ScoDoc 9.4 : décembre 2022 - ScoDoc 9.4 : prévue à l'automne 2022
- cas complexes posés par les BUT (parcours, tenue des jury) - cas complexes posés par les BUT (parcours, tenue des jury)
- nouveaux documents - nouveaux documents
@ -124,6 +117,7 @@ Les prochaines versions de ScoDoc :
- nouvelle API - nouvelle API
- module "relations entreprises" - module "relations entreprises"
- ScoDoc 9.2 : publiée en avril 2022 nouvelles fonctionnalités liées au BUT - ScoDoc 9.2 : publiée en avril 2022 nouvelles fonctionnalités liées au BUT
- référentiels de compétences Orébut - référentiels de compétences Orébut
- capitalisation des UE dans le BUT - capitalisation des UE dans le BUT
@ -144,13 +138,9 @@ Les prochaines versions de ScoDoc :
- ScoDoc 9.0 : publiée le 19 sept. 2021, version complètement remaniée en - ScoDoc 9.0 : publiée le 19 sept. 2021, version complètement remaniée en
Python 3/Flask. Python 3/Flask.
<br> <br>
---
!!! note "Voir aussi"
- [Guide utilisateur](GuideUtilisateur.md) - [Guide utilisateur](GuideUtilisateur.md)
- <a href="https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7PzOD8GDW3kG1" target="_blank">Tutoriels sur YouTube <img src="/img/tube.png" alt="" style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a>
- [Contacts](Contact.md).
- Page web de l'auteur: <http://www-l2ti.univ-paris13.fr/~viennet> - Page web de l'auteur: <http://www-l2ti.univ-paris13.fr/~viennet>

View File

@ -8,7 +8,6 @@ theme:
- navigation.tabs - navigation.tabs
- toc.follow - toc.follow
- navigation.top - navigation.top
- navigation.tracking
palette: palette:
primary: light blue primary: light blue
language: fr language: fr
@ -48,7 +47,7 @@ nav:
- "Guide Développeurs": GuideDeveloppeurs.md - "Guide Développeurs": GuideDeveloppeurs.md
- "API (interfaçages autres logiciels)": ScoDoc9API.md - "API (interfaçages autres logiciels)": ScoDoc9API.md
- "Contacts": Contact.md - FAQ: FAQ.md
# theme: readthedocs # theme: readthedocs