ScoDoc, un logiciel pour le suivi de la scolarité

Go to file

Emmanuel Viennet 787f0038d9 Tests unitaires avec pytest au lieu de unittest		2021-07-20 09:01:56 +03:00
app	fix link	2021-07-20 07:53:05 +03:00
config	fixed some string ops	2021-07-12 00:25:23 +02:00
logos	Upload from subversion 1932	2020-09-26 16:19:37 +02:00
misc	nouvelle implementation des caches	2021-07-19 20:53:01 +03:00
scotests	nouvelle implementation des caches	2021-07-19 20:53:01 +03:00
tests	Tests unitaires avec pytest au lieu de unittest	2021-07-20 09:01:56 +03: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	WIP deplacé /static. Accueil fonctionnel.	2021-06-16 16:59:31 +02:00
LICENSE	Initialization.	2020-09-25 23:03:44 +02:00
README.md	added required Debian packages	2021-07-15 09:05:25 +02:00
refactor.py	WIP suite de la migration	2021-06-21 10:17:16 +02:00
requirements-2.7.txt	completed elimination of jaxml	2021-07-11 13:03:13 +02:00
requirements-3.7.txt	nouvelle implementation des caches	2021-07-19 20:53:01 +03:00
scodoc_manager.py	nouvelle implementation des caches	2021-07-19 20:53:01 +03:00
scodoc.py	creation super admin en ligne de commande	2021-07-05 21:56:28 +02:00

README.md

ScoDoc - Gestion de la scolarité - Version ScoDoc 8

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

Documentation utilisateur: https://scodoc.org

Branche ScoDoc 8 expérimentale

N'utiliser que pour les développements et tests, dans le cadre de la migration de Zope vers Flask.

La version ScoDoc8 est basée sur Flask (au lieu de Zope) et sur python 3.7+. Elle ne sera pas mise en production, c'est une version de développement pour le passage à Python 3.

De très nombreux changements sont susceptibles d'affecter l'API, mais on s'efforce à ce que rien ne soit visible des utilisateurs.

Work in Progress (WIP)

Développement en cours, certaines pages fonctionnent, d'autres pas.

État actuel (13 juillet 21)

passage à l'unicode en cours (certaines E/S encore à revoir).
pas d'import/export excel.

En cours:

tests

Setup (sur Debian 10 / python3.7)

Pour les dev, le plus simple est de partir d'une install fonctionnelle de ScoDoc7 sous git, et de changer de branche

git checkout ScoDoc8

Debian 10 est livré avec Python 3.7.

apt-get install python3-dev
apt-get install python3-venv
apt-get install libpq-dev
apt-get install libcrack2-dev

Création d'un environnement:

python3 -m venv venv

Puis installation de Flask:

source venv/bin/activate
pip install flask
pip install wheel

Installer les dépendances:

pip install -r requirements-3.7.txt

Bases de données

ScoDoc8 utilise les bases de département de ScoDoc7, mais une nouvelle base utilisateurs nommée SCO8USERS (au lieu de SCOUSERS), qui est manipulée via sqlalchemy.

Configuration de la base utilisateurs

On va créer une base nommée SCO8USERS, appartenant à l'utilisateur (aka role) postgres scodoc. Cet utilisateur sera créé ainsi sur le serveur linux::

su - postgres
createuser --no-createdb  --no-createrole --pwprompt scodoc

Puis création de la base (en tant qu'utilisateur postgres):

createdb -O scodoc SCO8USERS

Initialisation base par flask

En tant qu'utilisateur www-data (compat. avec ScoDoc7):

flask db init
flask db migrate -m "users and roles tables"
flask db upgrade

Puis initialisation de l'appli:

flask user-db-init

Et saisie du mot de passe admin:

flask user-password admin

On peut ensuite créer des utilisateurs tests avec:

flask user-create toto Ens RT
flask user-create tata Ens Info

ou mieux, importer les utilisateurs de ScoDoc7 avec:

flask user-db-import-scodoc7

(la base SCOUSERS de ScoDoc7 n'est pas affectée, ScoDoc8 utilise une base séparée, nommée SCO8USERS).

Pour créer un utilisateur "super admin", c'est à dire admin dans tous les départements:

flask user-create admin1 SuperAdmin @all

Lancement serveur (développement, sur VM Linux)

export FLASK_APP=scodoc.py
export FLASK_ENV=development
flask run --host=0.0.0.0

Tests

python -m unittest tests.test_users

TODO

page d'erreur ScoValueError
redirection pour authentification
import/export Excel