From c0f5292db8e8ad6637a1c837eda853be70508648 Mon Sep 17 00:00:00 2001
From: Emmanuel Viennet <emmanuel.viennet@gmail.com>
Date: Fri, 30 Jul 2021 17:52:48 +0300
Subject: [PATCH] fixed doc markdown
---
README.md | 46 ++++++++++++++++++++++++++++------------------
VERSION | 2 +-
2 files changed, 29 insertions(+), 19 deletions(-)
diff --git a/README.md b/README.md
index 50146fc7..d3f76bb6 100644
--- a/README.md
+++ b/README.md
@@ -21,19 +21,18 @@ ne soit visible des utilisateurs Web.
**Work in Progress (WIP)**: développement en cours, certaines pages fonctionnent, d'autres pas:
merci de signaler les erreurs.
-### État actuel (23 juillet 21)
+### État actuel (30 juillet 21)
- serveur de développement fonctionnel (pas testé en mode "production" sous gunicorn+nginx).
- - logs à revoir
+ - logs à revoir (tropverbeux), dans `/opt/scodoc-data/log`
- pas d'import/export excel.
- - pas de pages gestion utilisateurs.
**En cours:**
- - tests, formulaires utilisateurs, logging.
+ - nettoyage du code, finalisation tests et intégration.
## Installation (sur Debian 10 / python3.7)
@@ -47,20 +46,20 @@ On peut installer à partir de zéro, ou sur une machine ayant déjà un ScoDoc
1. S'assurer que l'installation ScoDoc 7 est à jour
- sudo su
- cd /opt/scodoc/Products/ScoDoc/config
- ./upgrade.sh
+ sudo su
+ cd /opt/scodoc/Products/ScoDoc/config
+ ./upgrade.sh
2. Arrêter le service ScoDoc 7
- systemctl stop scodoc
+ systemctl stop scodoc
S'assurer qu'il est bien stoppé (`ps auxw`, ...), sans qui la migration va échouer.
3. Renommer le répertoire de ScoDoc 7:
- sudo su
- mv /opt/scodoc /opt/scodoc7
+ sudo su
+ mv /opt/scodoc /opt/scodoc7
Les données pourront être migrées après installation la nouvelle evrsion, voir plus loin.
@@ -71,13 +70,13 @@ Sur un système Linux Debian 10, en tant que `root`:
- Déplacer ou copier le fichier `ScoDoc-x.y.z.tgz` dans `/opt` et le décomprimer:
- sudo su
- cd /opt; tar xf - ScoDoc-x.y.z.tgz # remplacer x.y.z par votre version
+ sudo su
+ cd /opt; tar xf - ScoDoc-x.y.z.tgz # remplacer x.y.z par votre version
- Lancer le script d'installation:
- cd /opt/scodoc/tools
- ./install_debian10.sh
+ cd /opt/scodoc/tools
+ ./install_debian10.sh
ce script crée un compte utilisateur "scodoc".
@@ -105,6 +104,8 @@ Cet utilisateur est automatiquement créé si nécessaire.
En tant qu'utilisateur `scodoc`:
su scodoc # si besoin
+ cd /opt/scodoc
+ source bin/env/activate
flask db init
flask db migrate -m "users and roles tables"
flask db upgrade
@@ -142,9 +143,9 @@ de votre installation ScoDoc 7 pour passer à ScoDoc 8 (*ne pas utiliser en prod
1. Lancer le script de migration
ScoDoc 8 doit avoir été installé comme expliqué plus haut.
- sudo su
- cd /opt/scodoc/tools
- ./migrate_from_scodoc7.sh
+ sudo su
+ cd /opt/scodoc/tools
+ ./migrate_from_scodoc7.sh
## Création d'un département
@@ -196,9 +197,18 @@ Principaux contenus:
## 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
-# TODO
+
+## TODO
- import/export Excel
diff --git a/VERSION b/VERSION
index 215aacb4..50c496d2 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-8.0.3
+8.0.4