forked from ScoDoc/ScoDoc
fixed doc markdown
This commit is contained in:
parent
b0a77fba66
commit
c0f5292db8
46
README.md
46
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:
|
**Work in Progress (WIP)**: développement en cours, certaines pages fonctionnent, d'autres pas:
|
||||||
merci de signaler les erreurs.
|
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).
|
- 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 d'import/export excel.
|
||||||
|
|
||||||
- pas de pages gestion utilisateurs.
|
|
||||||
|
|
||||||
**En cours:**
|
**En cours:**
|
||||||
|
|
||||||
- tests, formulaires utilisateurs, logging.
|
- nettoyage du code, finalisation tests et intégration.
|
||||||
|
|
||||||
|
|
||||||
## Installation (sur Debian 10 / python3.7)
|
## 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
|
1. S'assurer que l'installation ScoDoc 7 est à jour
|
||||||
|
|
||||||
sudo su
|
sudo su
|
||||||
cd /opt/scodoc/Products/ScoDoc/config
|
cd /opt/scodoc/Products/ScoDoc/config
|
||||||
./upgrade.sh
|
./upgrade.sh
|
||||||
|
|
||||||
2. Arrêter le service ScoDoc 7
|
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.
|
S'assurer qu'il est bien stoppé (`ps auxw`, ...), sans qui la migration va échouer.
|
||||||
|
|
||||||
3. Renommer le répertoire de ScoDoc 7:
|
3. Renommer le répertoire de ScoDoc 7:
|
||||||
|
|
||||||
sudo su
|
sudo su
|
||||||
mv /opt/scodoc /opt/scodoc7
|
mv /opt/scodoc /opt/scodoc7
|
||||||
|
|
||||||
Les données pourront être migrées après installation la nouvelle evrsion, voir plus loin.
|
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:
|
- Déplacer ou copier le fichier `ScoDoc-x.y.z.tgz` dans `/opt` et le décomprimer:
|
||||||
|
|
||||||
sudo su
|
sudo su
|
||||||
cd /opt; tar xf - ScoDoc-x.y.z.tgz # remplacer x.y.z par votre version
|
cd /opt; tar xf - ScoDoc-x.y.z.tgz # remplacer x.y.z par votre version
|
||||||
|
|
||||||
- Lancer le script d'installation:
|
- Lancer le script d'installation:
|
||||||
|
|
||||||
cd /opt/scodoc/tools
|
cd /opt/scodoc/tools
|
||||||
./install_debian10.sh
|
./install_debian10.sh
|
||||||
|
|
||||||
ce script crée un compte utilisateur "scodoc".
|
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`:
|
En tant qu'utilisateur `scodoc`:
|
||||||
|
|
||||||
su scodoc # si besoin
|
su scodoc # si besoin
|
||||||
|
cd /opt/scodoc
|
||||||
|
source bin/env/activate
|
||||||
flask db init
|
flask db init
|
||||||
flask db migrate -m "users and roles tables"
|
flask db migrate -m "users and roles tables"
|
||||||
flask db upgrade
|
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
|
1. Lancer le script de migration
|
||||||
ScoDoc 8 doit avoir été installé comme expliqué plus haut.
|
ScoDoc 8 doit avoir été installé comme expliqué plus haut.
|
||||||
|
|
||||||
sudo su
|
sudo su
|
||||||
cd /opt/scodoc/tools
|
cd /opt/scodoc/tools
|
||||||
./migrate_from_scodoc7.sh
|
./migrate_from_scodoc7.sh
|
||||||
|
|
||||||
## Création d'un département
|
## Création d'un département
|
||||||
|
|
||||||
@ -196,9 +197,18 @@ Principaux contenus:
|
|||||||
|
|
||||||
## Tests unitaires
|
## 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
|
pytest tests/unit
|
||||||
|
|
||||||
# TODO
|
|
||||||
|
## TODO
|
||||||
|
|
||||||
- import/export Excel
|
- import/export Excel
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user