IntroObjetsScoDoc et nouveaux screenshots

docs/Assiduites.md

@@ -1,9 +1,11 @@
-# Module "Assiduités"
+# Suivi de l'assiduité
 
 Ce module de ScoDoc remplace l'ancien module de suivi des absences de Scodoc.
-En plus de moderniser l'ancien module, le module assiduités met à disposition une API complète.
+Il propose des fonctions plus étendues: absences, retards, justificatifs (et
+gestion des documents associés) avec une granularité fine, des outils de
+*reporting* et une API complète permettant d'interfacer des modules tiers.
 
-Ce projet a été développé en 2022-2023, par Matthias Hartmann, apprenti de l'IUT de
+Ce projet a été développé de 2022 à 2024, par Matthias Hartmann, apprenti de l'IUT de
 Lannion financé par l'Association ScoDoc.
 
 **Ce module est disponible à partir de ScoDoc version 9.6**.
@@ -22,7 +24,7 @@ Le module fournit:
 
 ## Guide d'utilisation
 
-- [Module "Assiduités"](#module-assiduités)
+- [Suivi de l'assiduité](#suivi-de-lassiduité)
   - [Fonctionnalités](#fonctionnalités)
   - [Guide d'utilisation](#guide-dutilisation)
     - [Migration de l'ancien module](#migration-de-lancien-module)
@@ -182,7 +184,7 @@ Explication de l'interface
         sélectionnée rentre en conflit avec les assiduités de l'étudiant.
         Cliquer sur un bouton d'assiduité ne modifiera pas l'état de l'étudiant
         mais ouvrira un menu de résolution de conflit.
-        
+
         ![Résolution de conflit](#)
 
 Les assiduités de la page sont enregistrées en temps réel. Lorsque la saisie est

docs/IntroObjetsScoDoc.md

@@ -0,0 +1,152 @@
+# Les principaux objets de ScoDoc
+
+Nous introduisons ici les principaux objets manipulés par ScoDoc.
+
+## Départements
+
+Un serveur ScoDoc peut gérer un nombre quelconque de départements. Les
+départements sont entièrement séparés, à l'exception des comptes utilisateurs
+(un secrétaire ou une enseignante peuvent intervenir dans plusieurs
+départements). Les étudiants et les formations sont rattachés à un et un seul
+département.
+
+Lorsqu'un utilisateur se connecte, il voit en bleu les liens vers les
+départements dans lesquels il a le droit d'aller.
+
+![sco-accueil-0223.png](screens/sco-accueil-0223.png)
+
+## Semestre
+
+Un *semestre* représente une session d'un dispositif de formation. La plupart des
+formations LMD sont structurées en années scolaires de deux semestres. Dans
+ScoDoc, un "semestre" peut avoir une durée quelconque, il peut aussi bien s'agir
+une action de formation continue d'une semaine que d'une formation sur un an.
+
+Saisie des dates de début et fin d'un semestre:
+![sco-dates-semestre.png](screens/sco-dates-semestre.png)
+
+Les semestre a un ou plusieurs (co)responsables, utilisateurs ayant des droits
+particuliers, dont ceux de modifier la liste des modules d'enseignement à
+suivre, de nommer les enseignants, etc. Les responsables de semestres sont
+souvent appelés *directeurs ou directrices des études*.
+
+Un semestre a un ensemble d'étudiants inscrits.
+
+Le tableau de bord du semestre indique notamment la liste des modules qui y sont
+proposés:
+![sco-formsemestre-status.png](screens/sco-formsemestre-status.png)
+
+
+## Formations (programmes pédagogiques)
+
+Un semestre utilise une *formation* (programme pédagogique) qui définit les
+unités d'enseignement (UE), modules, coefficients, crédits académiques, etc.
+Pour en savoir plus, voir [programmes pédagogiques et versions](Formations.md).
+
+Exemple: une formation de *Bachelor Universitaire de Technologie* (BUT):
+![sco-formation-but.png](screens/sco-formation-but.png)
+
+## Modules
+
+Un *module* représente un dispositif pédagogique, typiquement un ensemble de
+cours, travaux dirigés, travaux pratiques, mais il peut aussi s'agir d'un
+projet, d'un stage, ou de tout ensemble d'activités.
+
+Un module a un enseignant responsable (typiquement le chargé de cours) et des
+des enseignants associés (typiquement les chargés de TD).
+
+Un sous-ensemble des étudiants inscrits au semestre peut être inscrit au module.
+
+En BUT, les modules représentent les *ressources* et les SAÉs.
+
+Le tableau de bord d'un module permet d'y inscrire les étudiants, modifier les
+enseignants, créer des évaluations et y saisir des notes.
+Exemple: une ressource de BUT
+![sco-modimpl-status.png](screens/sco-modimpl-status.png)
+
+## Évaluations
+
+Une *évaluation* est un dispositif pédagogique produisant une note par étudiant.
+Les notes sont numériques, mais dans les formations en approche par compétences
+(APC), les évaluations peuvent être associées à des *apprentissages critiques*.
+
+Pour en savoir plus:
+
+- [Calcul des notes](CalculNotes.md)
+- [Bachelor Universitaire de Technologie (BUT)](BUT.md)
+
+Exemple: modification d'une évaluation
+![sco-evaluation-edit.png](screens/sco-evaluation-edit.png)
+
+## Étudiants
+
+Un étudiant peut être créé individuellement par formulaire, ou bien importé via
+une feuille de calcul (par exemple Excel), ou, via un connecteur API, importé
+depuis un autre système (Apogée, Pégase, annuaire...).
+
+Les étudiants sont rattachés à un et un seul département (en cas de transfert,
+le créer dans l'autre département). Chaque étudiant peut être inscrit à un
+nombre quelconque de semestres (en général, à un instant $t$, l'étudiant a un
+seul semestre en cours, mais il arrive que les semestres suivis se chevauchent).
+
+La fiche de l'étudiant rassemble de nombreuses informations: données d'état
+civil, coordonnées, photographie, semestres suivis et leurs résultats résumés,
+annotations, etc. Ces informations peuvent être modifiées dans ScoDoc. Les accès
+et les droits de modification sont contrôlés par des autorisations spécifiques,
+tous les utilisateurs n'ont pas accès aux mêmes vues.
+
+Exemple: extrait de la fiche d'un étudiant
+![sco-fiche-etud.png](screens/sco-fiche-etud.png)
+
+## Groupes et partitions
+
+Les étudiants d'un semestre peuvent être répartis dans des groupes.
+
+Chaque *partition* d'un semestre défini un ensemble de groupes: par exemple, les
+la partition des groupes de TD, ou la partition des projets tuteurés.
+
+On peut à tout moment créer une partition, y créer des groupes, y placer ou
+déplacer des étudiants.
+
+Exemple: l'éditeur de partitions
+![sco-partition-edit.png](screens/sco-partition-edit.png)
+
+
+
+## Utilisateurs
+
+ScoDoc gère des comptes utilisateur, et associe à chacun des rôles spécifiques,
+eux-mêmes associés à des permissions (droits d'accès). ce système permet de
+hiérarchiser l'accès aux informations et opérations sensibles (modification de
+résultats, inscriptions, éditions de procès-verbaux, etc.).
+
+- [Rôles et permissions dans ScoDoc](ConfigPermissionsDept.md)
+- [Gestion des utilisateurs dans ScoDoc](AdminUsers.md)
+
+### Administrateur de département
+
+L'administrateur d'un département (typiquement le responsable de formation ou
+chef de département, ou bien une personne de confiance) possède des droits
+étendus sur son département (rassemblés dans le rôle `AdminDept`). Il peut
+notamment modifier les formations, mettre en place des semestres, créer des
+comptes utilisateurs.
+
+### Super-administrateur
+
+Le super-administrateur est un utilisateur ayant des droits d'accès complet au
+logiciel. Ce compte ne doit pas être utilisé pour autre chose que le paramétrage
+global. Il est le seul à avoir accès aux pages de configuration, accessibles via
+la page d'accueil:
+
+![sco-config-generale.png](screens/sco-config-generale.png)
+
+## Assiduité et justificatifs
+
+Voir [Suivi de l'assiduité](Assiduites.md).
+
+
+!!! note "Voir aussi"
+
+    - [Guide utilisateur](GuideUtilisateur.md)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)

docs/PresentationGenerale.md

@@ -4,7 +4,7 @@ Voir les <a href="https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7Pz
 
 ## Page d'accueil
 
-![accueil](screens/accueil-scodoc7.png)
+![accueil](screens/sco-accueil-dept.png)
 
 On y trouve les éléments suivants:
 
@@ -13,7 +13,7 @@ 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.  
+étudiant par son nom.
 
 L'identité de l'utilisateur défini ses droits d'accès (rôle) et les fonctions
 qu'il peut utiliser.
@@ -22,7 +22,7 @@ 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.
- 
+
 ## Fiche étudiant
 
 Pour accéder à la fiche d'un étudiant, on peut soit le rechercher par nom (voir
@@ -35,8 +35,8 @@ informations sur l'étudiant. ![fiche étudiant](screens/ficheEtud-scodoc7.png)
 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. ![calendrier des
+coïncident avec un examen, enregistre les justificatifs, etc. ![calendrier des
-absences](screens/calabs-scodoc7.png)
+absences](screens/sco-assi-cal.png)
 
 ## Gestion des notes
 
@@ -47,10 +47,11 @@ web, vérifications, etc.).
 
 ### Tableau de bord du semestre, avec les modules
 
-![tableau de bord du semestre](screens/tableaubord2011.png)
+![tableau de bord du semestre](screens/sco-formsemestre-status.png)
 
 ### Tableau récapitulatif des moyennes
-![tableau de bord du semestre](screens/NotesRecap2012-crop.png) 
+
+![tableau de bord du semestre](screens/sco-table-recap-but.png)
 
 ### Bulletins de notes
 
@@ -74,8 +75,9 @@ respectent les règles.
 ## Gestion des groupes
 
 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
+répartir facilement les étudiants:
-automatiques). ![affectation aux groupes](screens/GroupesDnD.png)
+
+![sco-partition-edit.png](screens/sco-partition-edit.png)
 
 ## Trombinoscopes
 
@@ -89,5 +91,12 @@ automatiques). ![affectation aux groupes](screens/GroupesDnD.png)
 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). 
+(portails d'établissements,  systèmes d'informations comme Apogée).
 
+
+!!! note "Voir aussi"
+
+    - [Les principaux objets de ScoDoc](IntroObjetsScoDoc.md)
+    - [Guide utilisateur](GuideUtilisateur.md)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)

docs/ScoDoc9API.md

@@ -616,8 +616,11 @@ Sur l'application, elles sont affichées et modifiables sur la fiche de l'étudi
 * **Méthode: POST**
 * **Permission: `ScoEtudInscrit`**
 * **Paramètres:** ``
-* **Data:** exactement comme `etudiant/create`, seuls les données passées sont modifiées.
+* **Data:** exactement comme `etudiant/create`, seules les données passées sont modifiées.
-* **Routes:** `/etudiant/edit.
+* **Routes:**
+  * `/etudiant/etudid/<int:etudid>/edit`
+  * `/etudiant/nip/<string:nip>/edit`
+  * `/etudiant/ine/<string:ine>/edit`
 * **Résultat:** Modifie les données de l'étudiant.
 
 #### **`etudiant-annotation`**

docs/index.md

@@ -34,11 +34,11 @@ retourner à `Emmanuel.Viennet at gmail.com`.
 ## Présentation générale
 
 - [Présentation générale du logiciel avec copies d'écran](PresentationGenerale.md)
-
+- [Les principaux objets de ScoDoc](IntroObjetsScoDoc.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>
 
 - 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)
+- Un *très* très ancien [article sur ScoDoc](papers/scodoc-reunion2007.pdf)
 
 ## Communauté d'utilisateurs
 
@@ -48,6 +48,12 @@ retourner à `Emmanuel.Viennet at gmail.com`.
 
 ## Actualités
 
+### Mars 2024
+
+La série **9.6.x** continue son développement, avec une gestion de l'assiduité
+toujours plus facile à utiliser, un nouveau module de génération des résultats
+pour les poursuites d'études, et de nombreuses améliorations.
+
 ### Septembre 2023: parution de ScoDoc 9.6.x pour Debian 12
 
 **9.6.x** est la version en production de ScoDoc. Y sont régulièrement intégrées
@@ -133,7 +139,7 @@ d'emplois du temps des universités, notamment pour faciliter le suivi de
 l'assiduité (lien emplois du temps / module ScoDoc).
 
 Les anciennes versions de ScoDoc :
- 
+
 - ScoDoc 9.5 : printemps 2023 (*fin de vie octobre 2023*)
 
     - Nouveau système de suivi de l'assiduité (absences, présences)
@@ -168,11 +174,11 @@ Les anciennes versions de ScoDoc :
 - ScoDoc 9.0 : publiée le 19 sept. 2021, version complètement remaniée en
  Python 3/Flask.
 
-<br> 
+<br>
 
 
 !!! note "Voir aussi"
-    
+
     - [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).