corrige chemin scodoc.log

docs/ApiGenerationBulletinsPdf.md

@@ -428,9 +428,13 @@ Le champ `notes` dans une évaluation est un dictionnaire dont les clés sont le
  | filigranne | texte en surimpression | 'Provisoire' 
 
 
-
 ##  Note: la fonction log 
-Pour la mise au point, il peut être utile de recourir à la bonne vieille fonction log, qui envoie du texte dans le fichier de log courant, normalement `/opt/scodoc/instance/log/notes.log`. La date et le saut de ligne final sont automatiquement ajoutés.
+
+Pour la mise au point, il peut être utile de recourir à la bonne vieille
+fonction log, qui envoie du texte dans le fichier de log courant, normalement
+`/opt/scodoc-data/log/scodoc.log`. La date et le saut de ligne final sont
+automatiquement ajoutés.
+
 ```
 log("toto")
 ```

docs/GuideInstallDebian11Advanced.md

@@ -50,6 +50,7 @@ Il est utile de vérifier que le serveur Web a bien démarré, avec
     systemctl status nginx
 
 ## Création des bases de données
+
 ScoDoc 9 utilise une base de données unique, regroupant tous les 
 départements et les utilisateurs. Elle est nommée `SCODOC` (et `SCODOC_DEV`
 en mode développement, ou `SCODOC_TEST`pour les tests unitaires).
@@ -63,11 +64,11 @@ Pour créer la base de données, lancer le script:
     ./tools/create_database.sh SCODOC_DEV # pour la base "developement"
     ./tools/create_database.sh SCODOC_TEST # pour les tests unitaires
 
-
 Les bases créées appartiennent à l'utilisateur (rôle) postgres `scodoc`
 (qui a été créé par le script d'installation précédent). 
 
 ## Variables d'environnement
+
 Le serveur utilise des variables d'environnement donnant la 
 configuration de base.
 Le plus simple est de les grouper dans un fichier `.env` (dans

docs/ProblemesMail.md

@@ -45,7 +45,7 @@ semestre, et lui envoyer son bulletin par mail. (sur la page web de son
 bulletin, petit menu "Autres opérations").
 
 À ce moment, regarder le log
-`/opt/scodoc/instance/log/notes.log`
+`/opt/scodoc-data/log/scodoc.log`
 
 On devrait voir quelque chose ressemblant à:
 ```
@@ -54,6 +54,7 @@ On devrait voir quelque chose ressemblant à:
 ```
 
 Et d'autre part dans le log de postfix (`/var/log/mail.log`)
+
 ```
 Sep  7 11:37:42 xxxxxxxx postfix/smtp[31240]: ED1F62BAB22:
 to=<emmanuel.viennet@xxxx.fr>, relay=gmail-smtp-in.l.google.com[209.85.135.27]:25, delay=1.5,
@@ -62,7 +63,7 @@ delays=0.03/0/0.41/1, dsn=2.0.0, status=sent (250 2.0.0 OK 1220942550 y2si226470
 
 Cela devrait permettre de savoir:
 
- 1. si ScoDoc tente d'envoyer un mail (`notes.log`);
+ 1. si ScoDoc tente d'envoyer un mail (`/opt/scodoc-data/log/scodoc.log`);
  
  2. si le serveur SMTP arrive à traiter ce mail.
 
@@ -74,5 +75,3 @@ notification ou de bulletins sans déranger les étudiants ou les collègues).
 
 Pour cela, aller sur la page *Paramétrage*, tout en bas, et indiquer une
 *Adresse de test*. Ne pas oublier de l'enlever une fois les essais effectués !
-
-

docs/TestsScoDoc.md

@@ -3,7 +3,7 @@
 
 ScoDoc est basé sur Flask, se référer à la doc de Flask pour aller plus loin.
 
-On travaille toujours en tant qu'utilisateur `scodoc`, dans le virtualenv:
+On travaille toujours en tant qu'utilisateur `scodoc`, dans le *virtualenv*:
 
     su scodoc # si nécessaire
     cd /opt/scodoc
@@ -26,9 +26,17 @@ On utilise `pytest`. Ainsi, la commande
 
 lance l'ensemble des tests unitaires.
 
+### Création de la base de données pour les tests unitaires
+
+```bash
+./tools/create_database.sh SCODOC_TEST
+export FLASK_ENV=test
+flask db upgrade
+```
+
 ## Tests Selenium (web)
 
-TODO (Aurélien, JMP) *ce projet est abandonné pour l'instant*.
+*Ce projet est abandonné pour l'instant* (Aurélien, JMP).
 
 ## Portail pour tests
 
@@ -52,45 +60,44 @@ serveur doit avoir été configuré avec des données de test.
 
 ### Configuration du serveur pour tester l'API
 
- 1. modifier /opt/scodoc/.env pour indiquer 
+ 1. modifier `/opt/scodoc/.env` pour indiquer
-```
+```bash
     FLASK_ENV=test_api
     FLASK_DEBUG=1
 ```
- 2. En tant qu'utilisateur scodoc, lancer:
+ 1. En tant qu'utilisateur scodoc, lancer:
-```
+```bash
     tools/create_database.sh --drop SCODOC_TEST_API
     flask db upgrade
     flask sco-db-init --erase
     flask init-test-database
 ```
-
 Ces commandes vont effacer la base `SCODOC_TEST_API` si elle existe, la
 recréer, mettre à jour le schéma pour la dernière version de ScoDoc installée,
 l'initialiser et la peupler de données fictives pour les tests.
-
  3. Relancer ScoDoc:
-```
+```bash
     flask run --host 0.0.0.0
 ```
 
 ### Configuration du client de test API
+
  1. Copier le fichier `scodoc/tests/api/dotenv_exemple` dans
     `scodoc/tests/api/.env`, et éditer ce fichier `.env`pour y configurer votre
     *client* de test (ne pas confondre avec `scodoc/.env` qui est la config de
     votre serveur).
     Normalement, il est suffisant d'indiquer l'URL de votre serveur. Si le
     client de test est sur la même machine que le serveur ScoDoc, c'est simplement:
-    ```
+    ```bash
-    SCODOC_URL = "http://localhost:5000/"
+    SCODOC_URL="http://localhost:5000/"
     ```
 
 ### Lancement des tests de l'API
 
-Le serveur scodoc étant lancé comme expliqué ci-dessus, on utilise `pytest`sur
+Le serveur scodoc étant lancé comme expliqué ci-dessus, on utilise `pytest` sur
 le client (qui peut être un autre shell de la même machine, bien sûr).
 
-```
+```bash
 cd /opt/scodoc/
 pytest tests/api/test_api_xxx.py # remplacer xxx par votre test
 ```
@@ -98,14 +105,7 @@ pytest tests/api/test_api_xxx.py # remplacer xxx par votre test
 Rappelons quelques options utiles de `pytest`: `-x` permet de s'arrêter sur la
 première erreur, et `--pdb` lance directement le débuggueur sur l'erreur.
 Ainsi,
-```
+```bash
 pytest --pdb -x tests/api/test_api_departements.py 
 ```
 lancera un test en mode "interactif", utile pour les mises au point.
-
-
-
-
-
-
-