ScoDoc, un logiciel pour le suivi de la scolarité
Go to file
2024-03-29 16:38:14 +01:00
app Assiduité : signal_assiduites_diff : fix visibilité tableau 2024-03-29 16:15:19 +01:00
flask_cas CAS logout handling when misconfigured 2023-12-17 12:45:32 +01:00
logos Upload from subversion 1932 2020-09-26 16:19:37 +02:00
migrations Ajout des nvo fichiers du master 2024-02-27 16:20:23 +01:00
misc Version 9.6.73 + copyright 2024 2023-12-31 23:04:06 +01:00
ressources/referentiels Fix: nom ref. comp. BUT Info-Comm. 2023-11-28 17:16:40 +01:00
tests Assiduité : docs : erratum samples 2024-03-29 16:38:14 +01:00
tools Assiduité : ajout tests unitaire cache + cas justificatifs 2024-03-01 12:56:00 +01:00
.env-exemple mail on localhost by default 2021-08-27 10:49:36 +02:00
.flake8 flake8 config. Code cosmetic. 2023-08-23 01:42:03 +02:00
.gitignore WIP: tableau de bord utilisateur 2023-12-29 13:58:18 +01:00
.mypy.ini Qq corrections cosmétiques du HTML + config mypy 2023-12-07 15:35:09 +01:00
.pylintrc API doc: ameliore script sample + sample evaluation 2023-08-28 12:15:53 +02:00
bench.py Un peu de nettoyage de d'optimisation (gain ~ 30-40% sur calcul NT). 2021-10-15 14:00:51 +02:00
config.py Merge PE v4 2024-02-27 21:23:45 +01:00
LICENSE Initialization. 2020-09-25 23:03:44 +02:00
pytest.ini API: enrichit création/édition GroupDescr 2023-11-22 17:54:16 +01:00
README.md ajout_justificatif_etud: upload fichiers + corrige permissions 2023-12-16 22:53:02 +01:00
requirements-3.11.txt Upgrade Python packages - Flask 3.0.0 - Migrate to scrypt password hash 2023-12-06 03:34:24 +01:00
sco_version.py Fix: jury BUT cas particulier sans ue 2024-03-27 09:22:34 +01:00
scodoc.py Fix unit tests 2024-02-22 18:32:51 +01:00

ScoDoc - Gestion de la scolarité - Version ScoDoc 9

(c) Emmanuel Viennet 1999 - 2024 (voir LICENCE.txt).

Installation: voir instructions à jour sur https://scodoc.org/GuideInstallDebian11

Documentation utilisateur: https://scodoc.org

Version ScoDoc 9

La version ScoDoc 9 est parue en septembre 2021. Elle représente une évolution majeure du projet, maintenant basé sur Flask (au lieu de Zope) et sur python 3.9+.

La version 9.0 s'efforce de reproduire presque à l'identique le fonctionnement de ScoDoc7, avec des composants logiciels différents (Debian 11, Python 3, Flask, SQLAlchemy, au lien de Python2/Zope dans les versions précédentes).

État actuel (dec 22)

  • 9.4.x est en production
  • le prochain jalon est 9.5. Voir branches sur gitea.

Lignes de commandes

Voir [https://scodoc.org/GuideConfig](le guide de configuration).

Organisation des fichiers

L'installation comporte les fichiers de l'application, sous /opt/scodoc/, et les fichiers locaux (archives, photos, configurations, logs) sous /opt/scodoc-data. Par ailleurs, il y a évidemment les bases de données postgresql et la configuration du système Linux.

Fichiers locaux

Sous /opt/scodoc-data, fichiers et répertoires appartenant à l'utilisateur scodoc. Ils ne doivent pas être modifiés à la main, sauf certains fichiers de configuration sous /opt/scodoc-data/config.

Le répertoire /opt/scodoc-data doit être régulièrement sauvegardé.

Principaux contenus:

/opt/scodoc-data
/opt/scodoc-data/log             # Fichiers de log ScoDoc
/opt/scodoc-data/config          # Fichiers de configuration
             .../config/logos    # Logos de l'établissement
             .../config/depts    # un fichier par département
/opt/scodoc-data/photos          # Photos des étudiants
/opt/scodoc-data/archives        # Archives: PV de jury, maquettes Apogée, fichiers étudiants

Pour les développeurs

Installation du code

Installer ScoDoc 9 normalement (voir la doc).

Puis remplacer /opt/scodoc par un clone du git.

sudo su
mv /opt/scodoc /opt/off-scodoc # ou ce que vous voulez
apt-get install git # si besoin
cd /opt
git clone https://scodoc.org/git/viennet/ScoDoc.git
# (ou bien utiliser votre clone gitea si vous l'avez déjà créé !)

# Renommer le répertoire:
mv ScoDoc scodoc

# Et donner ce répertoire à l'utilisateur scodoc:
chown -R scodoc.scodoc /opt/scodoc

Il faut ensuite installer l'environnement et le fichier de configuration:

# Le plus simple est de piquer le virtualenv configuré par l'installeur:
mv /opt/off-scodoc/venv /opt/scodoc

Et la config:

ln -s /opt/scodoc-data/.env /opt/scodoc

Cette dernière commande utilise le .env crée lors de l'install, ce qui n'est pas toujours le plus judicieux: vous pouvez modifier son contenu, par exemple pour travailler en mode "développement" avec FLASK_ENV=development.

Tests unitaires

Les tests unitaires utilisent normalement la base postgresql SCODOC_TEST. Avant le premier lancement, créer cette base ainsi:

./tools/create_database.sh SCODOC_TEST
export FLASK_ENV=test
flask db upgrade

Cette commande n'est nécessaire que la première fois (le contenu de la base est effacé au début de chaque test, mais son schéma reste) et aussi si des migrations (changements de schéma) ont eu lieu dans le code.

Certains tests ont besoin d'un département déjà créé, qui n'est pas créé par les scripts de tests: Lancer au préalable:

flask delete-dept -fy TEST00 && flask create-dept TEST00

Puis dérouler les tests unitaires:

pytest tests/unit

Ou avec couverture (pip install pytest-cov)

pytest --cov=app --cov-report=term-missing --cov-branch tests/unit/*

Utilisation des tests unitaires pour initialiser la base de dev

On peut aussi utiliser les tests unitaires pour mettre la base de données de développement dans un état connu, par exemple pour éviter de recréer à la main étudiants et semestres quand on développe.

Il suffit de positionner une variable d'environnement indiquant la BD utilisée par les tests:

export SCODOC_TEST_DATABASE_URI=postgresql:///SCODOC_DEV

(si elle n'existe pas, voir plus loin pour la créer) puis de les lancer normalement, par exemple:

pytest tests/unit/test_sco_basic.py

Il est en général nécessaire d'affecter ensuite un mot de passe à (au moins) un utilisateur:

flask user-password admin

Attention: les tests unitaires effacent complètement le contenu de la base de données (tous les départements, et les utilisateurs) avant de commencer !

Modification du schéma de la base

On utilise SQLAlchemy avec Alembic et Flask-Migrate.

flask db migrate -m "message explicatif....."
flask db upgrade

Ne pas oublier de d'ajouter le script de migration à git (git add migrations/...).

Mémo: séquence re-création d'une base (vérifiez votre .env ou variables d'environnement pour interroger la bonne base !).

dropdb SCODOC_DEV
tools/create_database.sh SCODOC_DEV # créé base SQL
flask db upgrade # créé les tables à partir des migrations
flask sco-db-init # ajoute au besoin les constantes (fait en migration 0)

# puis imports:
flask import-scodoc7-users
flask import-scodoc7-dept STID SCOSTID

Si la base utilisée pour les dev n'est plus en phase avec les scripts de migration, utiliser les commandes flask db historyet flask db stamppour se positionner à la bonne étape.

Profiling

Sur une machine de DEV, lancer

flask profile --host 0.0.0.0 --length 32 --profile-dir /opt/scodoc-data

le fichier .prof sera alors écrit dans /opt/scodoc-data (on peut aussi utiliser /tmp).

Pour la visualisation, snakeviz est bien:

pip install snakeviz

puis

snakeviz -s --hostname 0.0.0.0 -p 5555 /opt/scodoc-data/GET.ScoDoc......prof 

Paquet Debian 12

Les scripts associés au paquet Debian (.deb) sont dans tools/debian. Le plus important est postinstqui se charge de configurer le système (install ou upgrade de scodoc9).

La préparation d'une release se fait à l'aide du script tools/build_release.sh.