Module pour la gestion des Poursuites d'Etudes BUT dans ScoDoc 9 (édition des jury PE, avis PE, suivi des PE).

Go to file

Emmanuel Viennet ee0961d247 Debian desinstall (purge) script		2021-09-06 21:32:56 +02:00
app	doc dans script migration sur config bonus	2021-09-05 13:41:26 +02:00
logos	Upload from subversion 1932	2020-09-26 16:19:37 +02:00
migrations	Ajout configuration gloable via formualaire: bonus_sport. Modif migration fichier config. A suivre	2021-09-05 12:30:11 +02:00
misc	refactoring: élimination de 'context' (très frais, tests en cours).	2021-08-21 00:24:51 +02:00
tests	reorganized logging.	2021-08-29 19:58:15 +02:00
tools	Debian desinstall (purge) script	2021-09-06 21:32:56 +02:00
.env-exemple	mail on localhost by default	2021-08-27 10:49:36 +02:00
.gitignore	Application Flask pour ScoDoc 8	2021-05-29 18:22:51 +02:00
.pylintrc	tweaks for install on Mac + fix test users models	2021-07-11 23:49:38 +02:00
config.py	reorganized logging.	2021-08-29 19:58:15 +02:00
LICENSE	Initialization.	2020-09-25 23:03:44 +02:00
README.md	Sépare les tags (modules et itemsuivi) par département	2021-08-29 21:22:03 +02:00
requirements-3.9.txt	Améliore formulaires gestion utilisateurs	2021-08-28 16:01:41 +02:00
sco_version.py	version bump	2021-09-06 08:25:06 +02:00
scodoc.py	Migration ScoDOc 7 à 9: gestion des clés manquantes et tronque certains champs	2021-09-04 11:37:46 +02:00

README.md

ScoDoc - Gestion de la scolarité - Version ScoDoc 9

VERSION EXPERIMENTALE - NE PAS DEPLOYER - TESTS EN COURS

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

Documentation utilisateur: https://scodoc.org

Version ScoDoc 9

N'utiliser que pour les développements et tests.

La version ScoDoc 9 est basée 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 (27 août 21)

Tests en cours, notamment système d'installation et de migration.

Fonctionnalités non intégrées:

feuille "placement" (en cours)
ancien module "Entreprises" (obsolete)

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 appartienant à 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éé !)
mv ScoDoc scodoc # important !

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

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 sco-delete-dept TEST00 && flask sco-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 étudianst 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

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 "ScoDoc 9.0.x: ..." # ajuster le message !
flask db upgrade

Ne pas oublier de commiter les migrations (git add migrations ...).

Mémo pour développeurs: séquence re-création d'une 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

Paquet debian 11

Les scripts associés au paquet Debian (.deb) sont dans tools/debian.

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