#            ScoDoc - Gestion de la scolarité - Version ScoDoc 8

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


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 2.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)

En général, les commits indiqués "WIP" ne tournent pas.

### État actuel (21 juin 21)

 - l'ensemble des pages est raccordé, sauf "entreprises" et la gestion des utilisateurs (de ce fait, de nombreuses pages plantent).

 - pas d'excel (voir si on réinstalle `pyExcelerator` ou si on migre immédiatement ?), pdf non testé (mais devrait marcher ?).

**En cours:**
 
 - recodage pages gestion utilisateurs avec SQLAlchemy.
 
 - migration bases `SCUUSERS`vers `SCO8USERS`
 
 - raccorder page "entreprises".


## Setup (sur Debian 10 / python2.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

Puis d'installer Flask comme suit:

    virtualenv envsco8

    source envsco8/bin/activate

Installation:

    pip install flask
    # et pas mal d'autres paquets

donc utiliser:

    pip install -r requirements.txt

pour régénerer ce fichier:

    pip freeze > requirements.txt

### Bidouilles temporaires

Installer le bon vieux `pyExcelerator` dans l'environnement:

    (cd /tmp; tar xfz /opt/scodoc/Products/ScoDoc/config/softs/pyExcelerator-0.6.3a.patched.tgz )
    (cd /tmp/pyExcelerator-0.6.3a.patched/; python setup.py install)

## 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