autosco/README.md

# AutoSco

Composant satellite de ScoDoc pour l'auto-inscription des étudiants

## Installation

### Paquets Debian

```bash
apt-get install cracklib-runtime libcrack2-dev nginx postgresql libpq-dev python3.11-venv
```

### Installation de AutoSco

```bash
cd /opt/autosco # recommandé
/bin/rm -rf venv
python3 -m venv venv
source venv/bin/activate
pip install wheel
pip install -r requirements.txt
```

Puis saisir la config dans `.env`.

## Base de données

La base de données est légère: elle ne contient que les comptes utilisateurs.

## Configuration de l'accès à ScoDoc

Côté ScoDoc, créer un rôle et un utilisateur dédiés:

```bash
flask create-role AutoSco
flask edit-role AutoSco -a ScoView
flask user-create autosco AutoSco @all
flask user-edit autosco --allow-scodoc-login
flask user-password autosco

```

Configurer les paramètres d'accès dans AutoSco: éditer le fichier
`/opt/autosco/.env` et indiquer

```bash
SCODOC_URL="http://localhost:5000" # l'URL racine de votre ScoDoc
SCODOC_LOGIN="autosco"
SCODOC_PASSWORD="xxx" # le mot de passe saisi ci-dessus
```

## Pour les développeuses

### Lancement manuel de l'application

En mode debug (*ne pas utiliser sur un serveur public !**):

```bash
flask run -p 5001 --host 0.0.0.0 --debug
```

Sous gunicorn:

```bash
/opt/autosco/venv/bin/gunicorn -b localhost:8001 -w 4 --timeout 600 autosco:app
```

### Génération du fichier de dépendances python

```bash
pip freeze > requirements.txt
```