Merge branch 'develop'

CHANGES.rst

@@ -2,20 +2,36 @@
 CHANGELOG
 =========
 
+1.2.1 (2022-12-21)
+------------------
+
+Compatible avec GeoNature 2.10, 2.11 et plus.
+
+**🐛 Corrections**
+
+* Suppression d’un import inutile supprimé dans GeoNature 2.11
+* Correction et mise à jour de la documentation du module
+* Ajout d’indexes potentiellement manquants sur les vieilles installations du module
+
 1.2.0 (2022-11-02)
 ------------------
 
 Nécessite la version 2.10.0 (ou plus) de GeoNature.
 
-**Evolutions**
+**🚀 Nouveautés**
+
+* Compatibilité avec Angular version 12, mis à jour dans la version 2.10.0 de GeoNature (#38)
+* Packaging du module
+
+**🐛 Corrections**
+
+* Correction de la commande de mise à jour des vues matérialisées du module (#46)
 
-- Compatibilité avec Angular version 12, mis à jour dans la version 2.10.0 de GeoNature (#38)
-- Packaging du module
+**Notes de version**
 
-**Note de version**
+* Suivez la procédure classique de mise à jour du module
+* Exécuter la commande suivante afin d’indiquer à Alembic l'état de votre base de données :
 
-- Suivez la procédure classique de mise à jour du module
-- Exécuter la commande suivante afin d’indiquer à Alembic l'état de votre base de données :
   ::
 
     cd
@@ -24,7 +40,7 @@ Nécessite la version 2.10.0 (ou plus) de GeoNature.
     geonature db autoupgrade
 
 1.1.0 (2022-01-03)
------------------
+------------------
 
 Non compatible avec les versions 2.10 et supérieures de GeoNature.
 
@@ -59,7 +75,7 @@ Nécessite la version 2.8.0 (ou plus) de GeoNature
 * Correction année du slider en dur (#20)
 * Utilisation de la librairie utils-sqla (#30)
 
-**Note de version**
+**⚠️ Notes de version**
 
 Si vous faites une mise à jour du module :
 

README.md

@@ -41,30 +41,25 @@ Installation
     `mv gn_module_dashboard-X.Y.Z gn_module_dashboard`
 -   Placez-vous dans le répertoire `backend` de GeoNature et lancez les
     commandes `source venv/bin/activate` puis
-    `geonature install-packaged-gn-module <chemin_vers_le_module> <module_code>`
-    pour installer le module (exemple
-    `geonature install-packaged-gn-module ~/gn_module_dashboard DASHBOARD`)
--   Complétez la configuration du module dans le fichier
-    `config/conf_gn_module.toml` à partir des paramètres présents dans
-    `config/conf_gn_module.toml.example`, dont vous pouvez surcoucher
-    les valeurs par défaut. Relancez la mise à jour de la configuration
-    depuis le répertoire `geonature/backend` avec les commandes
-    `source venv/bin/activate` puis
-    `geonature update_module_configuration DASHBOARD`
--   Vous pouvez sortir du venv en lançant la commande `deactivate`
--   Relancez GeoNature et rebuilder le front
-    - `sudo systemctl restart geonature`
-    - `cd geonature/frontend`
-    - `nvm use`
-    - `npm run build`
+    `geonature install-gn-module ~/gn_module_dashboard DASHBOARD`
+-   Vous pouvez sortir du venv en exécutant la commande `deactivate`
+-   Relancez GeoNature (`sudo systemctl restart geonature`)
 
 Configuration
 -------------
 
-Un certain nombre de paramètres permettent de customiser le module en
-modifiant le fichier `conf/conf_gn_module.toml` (vous pouvez vous
-inspirer du fichier `conf_gn_module.toml.example` qui liste l'ensemble
-des paramètres disponibles et leurs valeurs par défaut) :
+Vous pouvez compléter la configuration du module dans le fichier
+`config/conf_gn_module.toml` à partir des paramètres présents dans
+`config/conf_gn_module.toml.example`, dont vous pouvez surcoucher
+les valeurs par défaut. 
+
+Pour appliquer ces changements, rechargez GeoNature (`sudo systemctl reload geonature`)
+puis la mise à jour de la configuration
+depuis le répertoire `geonature/backend` avec les commandes
+`source venv/bin/activate` puis
+`geonature update-configuration`
+
+Détail des paramètres modifiables :
 
 -   Paramétrage du niveau de simplification des zonages sur la carte
     "Synthèse par entité géographique" : `SIMPLIFY_LEVEL`. Passer un
@@ -84,25 +79,25 @@ des paramètres disponibles et leurs valeurs par défaut) :
     en question et 'false' pour le masquer.
 -   Paramétrage par défaut du graphique "Synthèse par entité
     géographique" du dashboard :
-    `DISPLAY_NBOBS_LEGEND_BY_DEFAULT_IN_GEO_GRAPH` Renseigner 'true'
-    si vous souhaitez afficher par défault les observations, 'false'
-    si vous souhaitez les taxons
+    `DISPLAY_NBOBS_LEGEND_BY_DEFAULT_IN_GEO_GRAPH`. Renseigner 'true'
+    si vous souhaitez afficher par défaut les observations, 'false'
+    si vous souhaitez les taxons.
 
 Vues matérialisées
 ------------------
 
-Dans un souci de performance, des vues matérialisées ont été mises en
+Dans un soucis de performance, des vues matérialisées ont été mises en
 place. Elles sont renseignées lors de l'installation du module. Il est
 nécessaire de rafraichir régulièrement ces vues matérialisées. Pour cela
 vous pouvez mettre en place un CRON pour l'automatisation de cette
 tâche.
 
-Ouvrez le fichier ``/etc/cron/geonature`` s’il est existant, sinon créez le. Renseignez le commande `geonature dashboard refresh-vm`.
+Ouvrez le fichier `/etc/cron/geonature` s’il est existant, sinon créez le. Renseignez le commande `geonature dashboard refresh-vm`.
 
 ```
-0 0 * * 0 <UTLIATEUR LINUX GEONATURE> <CHEMIN_VERS_GEONATURE>/backend/venv/bin/geonature dashboard geonature dashboard refresh-vm chiro
+0 0 * * 0 <UTLISATEUR LINUX GEONATURE> <CHEMIN_VERS_GEONATURE>/backend/venv/bin/geonature dashboard geonature dashboard refresh-vm
 Exemple (exécuté tous les dimanches à 00h00):
-0 0 * * 0 geonatadmin /home/geonatadmin/backend/venv/bin/geonature geonature dashboard refresh-vm chiro
+0 0 * * 0 geonatadmin /home/geonatadmin/backend/venv/bin/geonature geonature dashboard refresh-vm
 ```
 
 Cette commande peut être effectuée à tout moment depuis l’environnement
@@ -136,19 +131,12 @@ Mise à jour du module
 
         cp /home/`whoami`/gn_module_dashboard_old/config/conf_gn_module.toml /home/`whoami`/gn_module_dashboard/config/conf_gn_module.toml
 
--   Réinstaller les librairies et relancer la compilation en mettant à
-    jour la configuration
+-   Lancez la mise à jour du module
 
-        cd /home/`whoami`/geonature/frontend
-        npm install /home/`whoami`/gn_module_dashboard/frontend
-        cd /home/`whoami`/geonature/backend
-        source venv/bin/activate
-        pip install -e ~/gn_module_dashboard/
-        geonature update_module_configuration DASHBOARD
+        cd /home/`whoami`/
+        source geonature/backend/venv/bin/activate
+        geonature install-gn-module ~/gn_module_dashboard DASHBOARD
         sudo systemctl restart geonature
-        cd ~/geonature/frontend
-        nvm use
-        npm run build
 
 Licence
 -------

VERSION

@@ -1 +1 @@
-1.2.0
+1.2.1

backend/gn_module_dashboard/blueprint.py

@@ -12,7 +12,6 @@
 from .models import VSynthese, VTaxonomie, VFrameworks
 from geonature.core.gn_synthese.models import Synthese, CorAreaSynthese
 from ref_geo.models import BibAreasTypes
-from geonature.core.taxonomie.models import Taxref
 
 # # import des fonctions utiles depuis le sous-module d'authentification
 # from geonature.core.gn_permissions import decorators as permissions

backend/gn_module_dashboard/migrations/3bd3234cab96_add_missing_index.py

@@ -0,0 +1,31 @@
+"""add missing index
+
+Revision ID: 3bd3234cab96
+Revises: 2628978e1016
+Create Date: 2022-12-21 09:03:51.048633
+
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision = "3bd3234cab96"
+down_revision = "2628978e1016"
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.execute(
+        """
+        CREATE unique index IF NOT EXISTS vm_synthese_id_synthese_idx on gn_dashboard.vm_synthese (id_synthese);
+        CREATE index IF NOT EXISTS vm_synthese_cd_ref_idx on gn_dashboard.vm_synthese (cd_ref);
+        CREATE unique index IF NOT EXISTS vm_synthese_frameworks_acquisition_framework_name_year_idx on gn_dashboard.vm_synthese_frameworks (acquisition_framework_name,year);
+        CREATE unique index IF NOT EXISTS vm_taxonomie_name_taxon_level_idx on gn_dashboard.vm_taxonomie (name_taxon,level);
+        """
+    )
+
+
+def downgrade():
+    pass

backend/gn_module_dashboard/migrations/data/dashboard.sql

@@ -34,8 +34,8 @@ WITH DATA;
 COMMENT ON MATERIALIZED VIEW gn_dashboard.vm_synthese
     IS 'Vue matérialisée remettant à plat la taxonomie de toutes les observations présentes dans la synthèse';
 
-CREATE unique index on gn_dashboard.vm_synthese (id_synthese);
-CREATE index on gn_dashboard.vm_synthese (cd_ref);
+CREATE UNIQUE INDEX vm_synthese_id_synthese_idx ON gn_dashboard.vm_synthese (id_synthese);
+CREATE INDEX vm_synthese_cd_ref_idx ON gn_dashboard.vm_synthese (cd_ref);
 
 
 -- Vue matérialisée calculant le nombre d'observations par cadre d'acquisition par année
@@ -52,7 +52,7 @@ WITH DATA;
 COMMENT ON MATERIALIZED VIEW gn_dashboard.vm_synthese_frameworks
     IS 'Vue matérialisée calculant le nombre d''observations par cadre d''acquisition par année';
 
-CREATE unique index on gn_dashboard.vm_synthese_frameworks (acquisition_framework_name,year);
+CREATE UNIQUE INDEX vm_synthese_frameworks_acquisition_framework_name_year_idx ON gn_dashboard.vm_synthese_frameworks (acquisition_framework_name,year);
 
 
 -- Vue matérialisée listant tous les taxons pour lesquels des données ont été observées, ainsi que leur rang taxonomique
@@ -95,7 +95,7 @@ WITH DATA;
 COMMENT ON MATERIALIZED VIEW gn_dashboard.vm_synthese
     IS 'Vue matérialisée listant tous les taxons pour lesquels des données ont été observées, ainsi que leur rang taxonomique';
 
-CREATE unique index on gn_dashboard.vm_taxonomie (name_taxon,level);
+CREATE UNIQUE INDEX vm_taxonomie_name_taxon_level_idx ON gn_dashboard.vm_taxonomie (name_taxon,level);
 
 
 -- Fonction rafraichissant en parallèle toutes les vues matérialisées utilisées par le module Dashboard