From af2e02e77a82a784c5bd877cc5a5680528897adb Mon Sep 17 00:00:00 2001 From: Camille Monchicourt Date: Sat, 14 Sep 2024 00:02:58 +0200 Subject: [PATCH] 0.8.0 - Changelog + doc review (#366) Co-authored-by: Amandine --- README.md | 195 +++++++++++++++++++++------------------------- docs/changelog.md | 98 +++++++++++++---------- docs/commandes.md | 4 +- 3 files changed, 149 insertions(+), 148 deletions(-) diff --git a/README.md b/README.md index 3ba5a6521..7d2573569 100644 --- a/README.md +++ b/README.md @@ -1,109 +1,92 @@ -# Module monitoring +# Module Monitoring ## Sommaire -* [Concepts du module](#concepts) -* [Installation du module](#installation) -* [Installation d'un sous module](#installation-dun-sous-module) -* [Configuration des champs spécifiques d'un sous-module](docs/sous_module.md) -* [Gestion des sites et groupes de site](docs/gestion_sites_groupes_de_site.md) +* [Présentation du module](#présentation) +* [Installation du module](#installation-du-module) +* [Installation d'un sous-module](#installation-dun-sous-module) +* [Champs spécifiques d'un sous-module]([#configuration-des-champs-sp%C3%A9cifiques-dun-sous-module) +* [Gestion des sites et groupes de site](#gestion-des-sites) * [Permissions](#permissions) * [Base de données](#base-de-données) * [Gestion de la synthèse](docs/synthese.md) * [Documentation technique](docs/documentation_technique.md) * [Liste des commandes](docs/commandes.md) -## Concepts +## Présentation -Ce module permet de générer de façon générique des interfaces de saisies correspondant à des protocoles de suivi. -Par "suivi", on entend un protocole dont le point d'entrée est un site géographique, sur lequel on va revenir régulièrement effectuer des relevés. Il s'oppose par sa structure au module "Occtax" dont l'objecif est de faire de la saisie de données opportunistes (sans revenir régulièrement sur le même site de suivi). +Ce module permet de générer de façon générique des interfaces de saisie correspondant à des protocoles de suivi. +Par "suivi", on entend un protocole dont le point d'entrée est un site géographique, sur lequel on va revenir régulièrement effectuer des visites. Il se distingue par sa structure du module "Occtax" dont l'objectif est de faire de la saisie de données opportunistes ou d'inventaire (sans revenir régulièrement sur le même site de suivi). -Le module est articulé autour des trois concepts : +Le module est articulé autour de 3 concepts : -- les sites : l'objet géographique de suivi (qui peuvent être regroupés en groupe de sites) -- les visites : une visite est effectué sur un site (date, observateurs) -- le observations : observations faites durant la visite (espèces) +- les sites : l'objet géographique de suivi (qui peuvent être regroupés par groupes de sites) +- les visites : une visite est effectuée sur un site (date, observateurs) +- les observations : observations faites durant la visite (espèces) -Les 3 niveaux que sont le site, les visites et les observations sont fourni avec un tronc commun (les champs génériques) qui peuvent être complétés par des champs spécifiques à chaque protocole. Ces champs spécifiques sont défini par des fichiers de configurations JSON. -Pour chaque sous-module, correspondant à un protocole spécifique de suivi, il est ainsi possible d'ajouter dynamiquement des champs de différents types (liste, nomenclature, booléen, date, radio, observateurs, texte, taxonomie...). Ceux-ci peuvent être obligatoires ou non, affichés ou non et avoir des valeurs par défaut (voir doc détaillé : [Création d'un sous-module](docs/sous_module.md) -) +Les 3 niveaux que sont les sites, les visites et les observations sont fournis avec un tronc commun (les champs génériques) qui peuvent être complétés par des champs spécifiques à chaque protocole. Ces champs spécifiques sont définis par des fichiers de configuration JSON. +Pour chaque sous-module, correspondant à un protocole spécifique de suivi, il est ainsi possible d'ajouter dynamiquement des champs de différents types (liste, nomenclature, booléen, date, radio, observateurs, texte, taxonomie...). Ceux-ci peuvent être obligatoires ou non, affichés ou non et avoir des valeurs par défaut (voir doc détaillée : [Création d'un sous-module](docs/sous_module.md)). ![Liste des sites du protocole de test](docs/images/apercu.png) +## Installation du module -## Installation +- Téléchargez le module dans ``/home//``, en remplacant ``X.Y.Z`` par la version souhaitée -### Pré-requis - -* Avoir GeoNature installé dans une version compatible avec celle de la version du module. - -### Récupération du dépôt - -Pour récupérer le code source du module, vous pouvez le télécharger ou le cloner. - -#### Téléchargement - -```sh +```bash +cd wget https://github.com/PnX-SI/gn_module_monitoring/archive/X.Y.Z.zip unzip X.Y.Z.zip rm X.Y.Z.zip -mv gn_module_monitoring-X.Y.Z gn_module_monitoring ``` -Avec `X`, `Y`, `Z` correspondant à la version souhaitée. -#### Clonage du dépôt +- Renommez le répertoire du module -```sh -git clone https://github.com/PnX-SI/gn_module_monitoring.git +```bash +mv ~/gn_module_monitoring-X.Y.Z ~/gn_module_monitoring ``` -### Installation du module +- Lancez l'installation du module -```sh +```bash source ~/geonature/backend/venv/bin/activate geonature install-gn-module ~/gn_module_monitoring MONITORINGS sudo systemctl restart geonature deactivate ``` -Créer le dossier suivant dans le dossier `media` de GeoNature - -```sh -mkdir ~/geonature/backend/media/monitorings -``` - -Il vous faut désormais attribuer des permissions aux groupes ou utilisateurs que vous souhaitez, pour qu'ils puissent accéder et utiliser le module (voir ). Si besoin une commande permet d'attribuer automatiquement toutes les permissions dans tous les modules à un groupe ou utilisateur administrateur. +Il vous faut désormais attribuer des permissions aux groupes ou utilisateurs que vous souhaitez, pour qu'ils puissent accéder et utiliser le module (voir https://docs.geonature.fr/admin-manual.html#gestion-des-droits). Si besoin une commande permet d'attribuer automatiquement toutes les permissions dans tous les modules à un groupe ou utilisateur administrateur. -### Mise à jour +### Mise à jour du module -Pour mettre à jour le modue monitoring, suivre la documentation de [mise à jour d'un module GeoNature](https://docs.geonature.fr/installation.html#mise-a-jour-du-module) +Pour mettre à jour le modue Monitoring, suivre la documentation de [mise à jour d'un module GeoNature](https://docs.geonature.fr/installation.html#mise-a-jour-du-module) -### Configuration générale du module monitoring +### Configuration générale du module -Un fichier de config `monitorings_config.toml.example` peut être modifié puis copié à la racine du dossier de config de GeoNature : `~/geonature/config`. +Le fichier de configuration `monitorings_config.toml.example` peut être modifié puis copié à la racine du dossier de config de GeoNature : `~/geonature/config`. -Trois champs sont paramétrable : +3 éléments sont paramétrables : -- `TITLE_MODULE` : Titre présent sur la page d'accueil du module monitoring -- `DESCRIPTION_MODULE` : Description du module monitoring également présente sur la page d'accueil -- `CODE_OBSERVERS_LIST` : Code de la liste d'observateur qui est utilisé par défaut +- `TITLE_MODULE` : Titre présent sur la page d'accueil du module Monitoring +- `DESCRIPTION_MODULE` : Description du module Monitoring également présent sur la page d'accueil +- `CODE_OBSERVERS_LIST` : Code de la liste d'observateurs qui est utilisée par défaut -### Installation d'un sous-module +## Installation d'un sous-module -#### Récupérer le répertoire de configuration d'un sous-module de suivi +### Récupérer le répertoire de configuration d'un sous-module de suivi -Par exemple le sous-module `test` présent dans le repertoire `contrib/test` du module de suivi. +Par exemple le sous-module `test` présent dans le repertoire `contrib/test` du module Monitoring. -#### Activer le venv de GeoNature +### Activer le venv de GeoNature ```sh source ~/geonature/backend/venv/bin/activate ``` -#### Copie du dossier de configuration +### Copie du dossier de configuration -Créer un dossier pour référencer les configurations des sous-modules dans GeoNature (`geonature/backend/media/monitorings`) : +Si il n'existe pas déjà, créer un dossier pour stocker les configurations des sous-modules dans GeoNature (`geonature/backend/media/monitorings`) : ```sh mkdir geonature/backend/media/monitorings @@ -121,7 +104,7 @@ Exemple pour le module "test" : ln -s ~/gn_module_monitoring/contrib/test ~/geonature/backend/media/monitorings/test ``` -#### Lancer la commande d'installation du sous-module +### Lancer la commande d'installation du sous-module ```sh geonature monitorings install @@ -151,7 +134,7 @@ Modules installés : Il vous faut désormais attribuer des permissions aux groupes ou utilisateurs que vous souhaitez, pour qu'ils puissent accéder et utiliser le sous-module (voir ). Si besoin une commande permet d'attribuer automatiquement toutes les permissions dans tous les modules à un groupe ou utilisateur administrateur. -### Configurer le sous-module +### Configurer un sous-module #### Dans le menu de droite de GeoNature, cliquer sur le module "Monitorings" @@ -163,107 +146,109 @@ Vous êtes désormais sur la page du sous-module. Un message apparaît pour vous #### Cliquez sur le bouton `Éditer` -Le formulaire d'édition du sous-module s'affiche et vous pouvez choisir les variables suivantes : +Le formulaire d'édition du sous-module s'affiche et vous pouvez renseigner les variables suivantes : * Jeux de données *(obligatoire)* : - * Un module peut concerner plusieurs jeux de données, le choix sera ensuite proposé au niveau de chaque visite. + * Un sous-module peut concerner un ou plusieurs jeux de données, le choix sera ensuite proposé au niveau de chaque visite. * Liste des observateurs *(obligatoire)* : - * La liste d'observateurs définit l'ensemble des observateurs possibles pour le module (et de descripteurs de site). - * Cette liste peut être définie dans l'application `UsersHub`. + * La liste d'observateurs définit l'ensemble des observateurs possibles pour le sous-module (et de descripteurs de site). + * Cette liste peut être gérée dans l'application `UsersHub`. * Liste des taxons *(obligatoire selon le module)* : - * Cette liste définit l'ensemble des taxons concernés par ce module. Elle est gérée dans l'application `TaxHub`. -* Activer la synthèse *(non obligatoire, désactivée par défaut)* ? - * Si on décide d'intégrer les données du sous-module dans la synthèse de GeoNature. + * Cette liste définit l'ensemble des taxons concernés par ce sous-module. Elle est gérée dans l'application `TaxHub`. +* Activer la synchro synthèse *(non obligatoire, désactivée par défaut)* ? + * Si on décide d'intégrer automatiquement les données du sous-module dans la synthèse de GeoNature. * Affichage des taxons *(obligatoire)* ? * Définit comment sont affichés les taxons dans le module : * `lb_nom` : Nom latin, * `nom_vern,lb_nom` : Nom vernaculaire par defaut s'il existe, sinon nom latin. -* Afficher dans le menu ? *(non obligatoire, non affiché par défaut)* : - * On peut décider que le sous-module soit accessible directement depuis le menu de gauche de GeoNature. +* Afficher dans le menu latéral ? *(non obligatoire, non affiché par défaut)* : + * On peut décider que le sous-module soit accessible directement depuis le menu latéral de GeoNature. * `active_frontend` -* Type de site : - * Permet d'associer des sites créé dans le gestionnaire de site à un module. Tous les sites dont le type est défini ici remonteront dans le module ( [voir documentation sur le gestionnaire de sites (#gestionnaire-de-sites) ) +* Types de sites : + * Permet d'associer des sites (créés dans le gestionnaire de sites) à un sous-module. Tous les sites dont le type est défini ici remonteront dans le module ([voir documentation sur le gestionnaire de sites (#gestionnaire-de-sites)) * Options spécifiques du sous-module : * Un sous-module peut présenter des options qui lui sont propres et définies dans les paramètres spécifiques du sous-module. - -### Configuration des champs spécifiques du sous-module +## Configuration des champs spécifiques d'un sous-module -Maintenant que le sous-module est installé, vous pouvez ajouter des champs spécifiques pour le faire correspondre à votre protocole de suivi. -Le documentation détaillé de la configuration des champs additionnels est ici : [Configuration des champs d'un sous module](docs/sous_module.md) +Maintenant que le sous-module est installé, vous pouvez configurer ses champs spécifiques pour le faire correspondre à votre protocole de suivi. +La documentation détaillée de la configuration des champs additionnels est ici : [Configuration des champs d'un sous module](docs/sous_module.md) -Des exemples de sous-modules sont disponibles sur le dépôt - : +Des exemples de sous-modules sont disponibles sur le dépôt : -* Protocole de suivi des oedicnèmes, +* Protocole de suivi des oedicnèmes * Protocole de suivi des mâles chanteurs de l'espèce chevêche - d'Athena; + d'Athena * Protocole Suivi Temporel des Oiseaux de Montagne (STOM) * Autres... -## Gestionnaire de sites +## Gestion des sites -Chaque module permet de créer ses propres sites et groupe de sites. Cependant certains sites peuvent faire l'objet de plusieurs protocoles de suivi, c'est pouquoi le module monitoring offre la possibilité de créer des sites et des groupes de site dans le **gestionnaire de site** et de les mobiliser dans plusieurs sous-modules. +Chaque sous-module permet de créer ses propres sites et groupes de sites. Cependant certains sites peuvent faire l'objet de plusieurs protocoles de suivi, c'est pouquoi le module Monitoring offre la possibilité de créer des sites et des groupes de sites globalement dans le **gestionnaire de site** et de les utiliser dans plusieurs sous-modules. ![Page d'accueil accès aux sites](docs/images/page_accueil_monitoring_acces_sites.png) -Dans le gestionnaire de site il est possible de créer, éditer, supprimer, modifier des sites et des groupes de site de manière indépendante à la gestion de sous modules. Il est également possible de saisir directement des visites et des observations en rattachant les visites au sous-module que l'on souhaite. +Dans le gestionnaire de sites, il est possible de créer, éditer, supprimer des sites et des groupes de sites de manière indépendante à la gestion de sous-modules. Il est également possible de saisir directement des visites et des observations en rattachant les visites au sous-module que l'on souhaite. > [!IMPORTANT] -> **Associer un site à un module** +> **Associer un site à un sous-module** > -> Plutôt que d'associer un à un les sites à des modules, l'association entre un site et un module se fait via la notion de **type de site**. Une type de site est un concept permettant de regrouper des sites qui font l'objet de multiples protocoles et qui partage potentiellement une série de descripteurs communs. +> Plutôt que d'associer un à un les sites à des sous-modules, l'association entre un site et un sous-module se fait via la notion de **types de sites**. Une type de sites est un concept permettant de regrouper des sites qui font l'objet de plusieurs protocoles et qui partagent potentiellement une série de descripteurs communs. > -> Un "point d'écoute" qui va par exemple faire l'objet de plusieurs protocoles ornithologiques (STOC, oiseaux migrateurs etc...) peut être définit comme un type de site. +> Un "point d'écoute" qui va par exemple faire l'objet de plusieurs protocoles ornithologiques (STOC, oiseaux migrateurs etc...) peut être définit comme un type de sites. > -> Lors de la configuration d'un module (en interface), on doit associer le module à un ou des types de site. Tous les sites créés via le gestionnaire de site dont le type correspond à celui définit au niveau du module, remonteront dans la liste des sites du module. +> Lors de la configuration d'un sous-module (depuis l'interface), on doit l'associer à un ou des types de site. Tous les sites créés via le gestionnaire de sites dont le type correspond à celui défini au niveau du sous-module, remonteront dans la liste des sites du sous-module. > -> **Associer un groupe de sites à un module** +> **Associer un groupe de sites à un sous-module** > -> L'association entre un groupe de site et un module se fait elle directement. Lorsque l'on crée un groupe de site dans le gestionnaire de site, on l'associe directement à un ou plusieurs groupes de site +> L'association entre un groupe de sites et un sous-module se fait individuellement. Lorsque l'on crée un groupe de site dans le gestionnaire de sites, on l'associe directement à un ou plusieurs sous-modules. **Définir des champs spécifique à un type de site** -Il est possible de définir des champs spécifiques communs à des type de sites. -Contrairement aux configurations des modules, celle-ci ne se fait pas dans un fichier JSON, mais dans le backoffice de GeoNature (rubrique monitoring / type de sites). +Il est possible de définir des champs spécifiques communs à chaque type de sites. +Contrairement aux configurations des sous-modules, celle-ci ne se fait pas dans un fichier JSON, mais dans le module Admin de GeoNature (rubrique Monitoring / Types de sites). ![admin type de sites](docs/images/admin_type_site.png) -La syntaxe est la même que pour la création de champs d'un sous-module (voir [Création d'un sous-module](docs/sous_module.md) -). La clé `specific` permettant de configurer les champs et la clé `display_properties` d'afficher les champs sur les fiches info des sites. +La syntaxe est la même que pour la création de champs d'un sous-module (voir [Création d'un sous-module](docs/sous_module.md)). La clé `specific` permettant de configurer les champs et la clé `display_properties` de définir les champs à afficher sur les fiches info des sites. ## Permissions -Les permissions peuvent désormais être définies avec une notion de portée ('mes données', 'les données de mon organisme', 'toutes les données' si on ne précise pas de portée mais qu'on accorde une permission). Ces permissions peuvent être définies sur chaque objet défini ci dessous. - -La gestion des permissions pour les rôles (utilisateur ou groupe) se réalise au niveau de l'interface d'administration des permissions de GeoNature. +- Une permission définit si l'on peut accéder au module Monitoring (R sur Monitoring) +- Des permissions définissent si on peut accéder au gestionnaire de sites et y créer, modifier, supprimer des sites et groupes de sites +- Des permissions définissent si on peut gérer les types de sites dans le module Admin -Les permissions sont définis par sous-modules pour chaque type d'objet (modules, groupes de sites, sites, visites, observations et types de site) : +Les permissions des sous-modules sont définies au niveau de chaque sous-module pour chaque type d'objet (sous-module, groupes de sites, sites, visites, observations) : -- `MONITORINGS_MODULES` - R : permet a l'utilisateur d'accéder au module, de le voir dans la liste des modules -- `MONITORINGS_MODULES` - U : action administrateur qui permet de configurer le module et de synchroniser la synthèse -- `MONITORINGS_MODULES` - E : action qui permet aux utilisateurs d'exporter les données (si défini par le module) -- `MONITORINGS_GRP_SITES` - CRUD : action de lire, créer, modifier, supprimer un groupe de site +- `MONITORINGS_MODULES` - R : permet à l'utilisateur d'accéder au sous-module, de le voir dans la liste des sous-modules +- `MONITORINGS_MODULES` - U : action administrateur qui permet de configurer le sous-module et de synchroniser la synthèse +- `MONITORINGS_MODULES` - E : action qui permet aux utilisateurs d'exporter les données (si configuré au niveau du sous-module) +- `MONITORINGS_GRP_SITES` - CRUD : action de lire, créer, modifier, supprimer un groupe de sites - `MONITORINGS_SITES` - CRUD : action de lire, créer, modifier, supprimer un site - `MONITORINGS_VISITES` - CRUD : action de lire, créer, modifier, supprimer les visites, observations, observations détails -- `TYPES_SITES`- CRUD : action de lire, créer, modifier, supprimer les types de sites via l'interface administrateur (uniquement pour le module monitorings et non les sous modules) -Par défaut, dès qu'un utilisateur a un droit supérieur à 0 pour une action (c-a-d aucune portée) il peut réaliser cette action. +Les permissions des sous-modules peuvent être limitées avec une notion de portée : 'Mes données' ou 'Les données de mon organisme' : -Il est possible de mettre à jour les permissions disponibles pour un module en utilisant la commande `update_module_available_permissions` +- Pour les groupes de sites, la portée s'appuie sur son id_digitizer (et son organisme si la portée est de niveau 2) +- Site : id_digitizer ou id_inventor du site +- Visite : id_digitiser ou observers de la visite +- Observation : id_digitizer de l'observation +Si vous modifiez la configuration d'un sous-module en y ajoutant des objets (ajout du niveau groupe de sites par exemple), il est possible de mettre à jour les permissions disponibles pour ce sous-module en utilisant la commande `update_module_available_permissions`. ## Base de données Le module permet de générer des sous-modules (stockés dans la table `gn_commons.t_modules`) pour chaque protocole de suivi. Ils s'appuient sur les champs fixes des 3 tables `gn_monitoring.t_base_sites`, `gn_monitoring.t_base_visits` et `gn_monitoring.t_observations` qui peuvent chacunes être étendues avec des champs spécifiques et dynamiques stockés dans des champs de type `JSONB`. - Des fonctions SQL ainsi qu'une vue définie pour chaque protocole permettent d'alimenter automatiquement la synthèse de GeoNature à partir des données saisies dans chaque sous-module. - - -Les sites et groupes de sites multi modules. +Les sites et groupes de sites peuvent être associés à plusieurs protocoles (sous-modules). ![MCD du schema gn_monitoring](docs/images/2023-10-MCD_schema_monitoring.png) +## Autres + +* [Gestion de la synthèse](docs/synthese.md) +* [Documentation technique](docs/documentation_technique.md) +* [Liste des commandes](docs/commandes.md) diff --git a/docs/changelog.md b/docs/changelog.md index e9e4e8349..9775601ad 100644 --- a/docs/changelog.md +++ b/docs/changelog.md @@ -1,23 +1,49 @@ # CHANGELOG -## 0.8.0 (unrelease) +## 0.8.0 (unreleased) -- Création du gestionnaire de site : les sites et les groupes de site peuvent être utilisés dans plusieurs sous-module. Le gestionnaire de site permet de créer / modifier / supprimer des sites et des groupes de site hors d'un sous-module. -- Possibilité de créer des champs additionnels par type de site via le backoffice GeoNature +Nécessite GeoNature 2.15.0 (ou plus) -- Suppression des commandes `process_csv` et `process_all` qui sont remplacés par la commande `process_sql` -- [process_sql] Ajout d'un controle de conformité des fichiers qui ne peuvent pas contenir les commandes sql suivantes : INSERT, DELETE, UPDATE, EXECUTE, TRUNCATE, ALTER, GRANT, COPY, PERFORM, CASCADE +**🚀 Nouveautés** + +- Les sites (et groupes de sites) peuvent désormais être utilisés dans plusieurs protocoles (sous-modules) (#117) + - Un gestionnaire de sites permet de gérer les sites (et groupes de sites) globalement et non plus uniquement à l'intérieur de chaque sous-module + - Chaque site est associé à un ou plusieurs types de sites + - Un gestionnaire des types de sites est disponible dans le module Admin de GeoNature + - Des champs additionnels peuvent être définis pour chaque type de site pour pouvoir décrire des sites globalement, et pas uniquement par protocole + - Chaque sous-module est associé à un ou plusieurs type de site pour définir les sites qui seront proposés dans le sous-module + - Le modèle de données a évolué pour pouvoir associer un site à plusieurs types et un sous-module à plusieurs types de sites (suppression du champs id_nomenclature_type_site + - Le modèle de données a évolué pour pouvoir associer un groupe de sites à plusieurs sous-modules +- Ajout de la prise en compte des portées au niveau des permissions (#92) +- Ajout d'un champ `observers_txt` au niveau de la table des visites (#106) +- Possibilité de définir plusieurs types de géométrie pour les sites d'un sous-module (#136) +- Ajout de triggers de répercussion dans la Synthèse des données supprimées dans un sous-module de Monitoring (#286) +- Ajout de tests unitaires +- Suppression des commandes `process_csv` et `process_all` qui sont remplacées par la commande `process_sql` (#244) +- [process_sql] Ajout d'un controle de conformité des fichiers qui ne peuvent pas contenir les commandes SQL suivantes : INSERT, DELETE, UPDATE, EXECUTE, TRUNCATE, ALTER, GRANT, COPY, PERFORM, CASCADE +- Bascule de la table `t_observations` dans le coeur de GeoNature (#271) + +**🐛 Corrections** + +- Correction d'une erreur silencieuse lors de la synchronisation avec la synthèse (liée à l'absence de la vue de synchro ou d'un champs obligatoire) (#286) +- Mise à jour de SQLAlchemy version 1.3 à 1.4 **⚠️ Notes de version** -- Si vous installé le module sans être passé par la version 0.7.0 : - Après mise à jour du module, utiliser la commande pour générer les permissions disponibles pour les sous-modules déjà installés +- Si vous installé le module sans être passés par la version 0.7.0, éxecuter le script `data\upgrade_modules_permissions.sql` pour transférer les permissions et supprimer les permissions disponibles (après avoir exécuté la commande `geonature monitorings update_module_available_permissions`). +- Si vous avez des modules installés, les vues synthèses et exports ne seront pas compatibles et bloqueront la migration. Il faut les supprimer en amont et les recréer après mise à jour en tenant compte des évolutions du modèle de données. +- Si vous aviez défini la propriété `id_nomenclature_type_site` dans la configuration de vos sous-modules, celle-ci n'existe plus et peut être remplacée par `types_sites`. Exemple : ``` - geonature monitorings update_module_available_permissions + "types_site": + "default": [ + { + "id_nomenclature_type_site": 686 + } + ], + "hidden": true + } ``` -- mise à jour des fichiers de config comprenant `id_nomenclature_type_site` ?? - -Puis vous pouvez utiliser le script `data\upgrade_modules_permissions.sql` pour transférer les permissions et supprimer les permissions disponibles +- Si vous le souhaitez, vous pouvez attribuer des permissions à vos utilisateurs au nouveau gestionnaire de sites et limiter les portées des permissions par objets et par sous-modules (https://github.com/PnX-SI/gn_module_monitoring?tab=readme-ov-file#permissions) ## 0.7.3 (03/05/23) @@ -25,9 +51,7 @@ Puis vous pouvez utiliser le script `data\upgrade_modules_permissions.sql` pour - Correction du selecteur des groupes de sites - 0.7.2 (27-02-23) - ---- +## 0.7.2 (27-02-23) **🚀 Nouveautés** @@ -39,9 +63,7 @@ Puis vous pouvez utiliser le script `data\upgrade_modules_permissions.sql` pour - Erreur lors de l'installation du module (#284) - Corrections des permissions (export PDF, groupes de sites) - 0.7.1 (05-12-23) - ---- +## 0.7.1 (05-12-2023) **🚀 Nouveautés** @@ -52,9 +74,7 @@ Puis vous pouvez utiliser le script `data\upgrade_modules_permissions.sql` pour - Export avec un filtre par jeux de données (#241) - 0.7.0 (2023-08-23) - ---- +## 0.7.0 (2023-08-23) Nécessite la version 2.13.0 (ou plus) de GeoNature @@ -73,9 +93,7 @@ Nécessite la version 2.13.0 (ou plus) de GeoNature geonature monitorings update_module_available_permissions ``` - 0.6.0 (2023-05-23) - ---- +## 0.6.0 (2023-05-23) Nécessite GeoNature version 2.12.0 (ou plus) @@ -111,9 +129,7 @@ Nécessite GeoNature version 2.12.0 (ou plus) geonature monitorings install ``` - 0.5.0 (2023-03-29) - ---- +## 0.5.0 (2023-03-29) Nécessite GeoNature version 2.12.0 (ou plus) @@ -145,7 +161,7 @@ Nécessite GeoNature version 2.12.0 (ou plus) }, ``` -# 0.4.1 (2023-02-05) +## 0.4.1 (2023-02-05) **🚀 Nouveautés** @@ -172,7 +188,7 @@ concernés (dans leur fichier `module.json`). Exemple : ], ``` -# 0.4.0 (2022-12-21) +## 0.4.0 (2022-12-21) Nécessite la version 2.11.0 (ou plus) de GeoNature. @@ -223,7 +239,7 @@ geonature db stamp 362cf9d504ec # monitorings 0.3.0 geonature db upgrade monitorings@head ``` -# 0.3.0 (2022-11-02) +## 0.3.0 (2022-11-02) Nécessite la version 2.10.0 (ou plus) de GeoNature. @@ -264,7 +280,7 @@ Nécessite la version 2.10.0 (ou plus) de GeoNature. (#170) - Suppression de l'alias `@librairies` (#178) - # 0.2.10 (2022-03-02) +## 0.2.10 (2022-03-02) Compatible avec GeoNature version 2.9.2 maximum. @@ -275,7 +291,7 @@ Compatible avec GeoNature version 2.9.2 maximum. - Prise en compte du changement de l'api pour les jdd pour le choix des jdd de l'export - # 0.2.9 (2022-01-13) +## 0.2.9 (2022-01-13) Compatibilité avec GeoNature version 2.9.0 et plus. @@ -286,7 +302,7 @@ Compatibilité avec GeoNature version 2.9.0 et plus. - Reprise du composant de la liste déroulante de sélection des jeux de données, suite au passage à `ng-select2` dans GeoNature 2.9.0 - # 0.2.8 (2021-12-10) +## 0.2.8 (2021-12-10) **🐛 Corrections** @@ -300,7 +316,7 @@ Compatibilité avec GeoNature version 2.9.0 et plus. - Les modules POPAmphibien et POPReptile ont été déplacés dans le dépot - # 0.2.7 (2021-10-26) +## 0.2.7 (2021-10-26) **⚠️ Notes de version** @@ -357,7 +373,7 @@ cd path_to_geonature/frontend npm install external_modules/monitorings/frontend --no-save ``` -# 0.2.6 (2021-07-23) +## 0.2.6 (2021-07-23) Compatible avec GeoNature à partir de sa version 2.6.2 (dont GeoNature 2.8). @@ -401,13 +417,13 @@ export FLASK_APP=geonature geonature monitorings process_img ``` -# 0.2.5 (2021-07-12) +## 0.2.5 (2021-07-12) **🐛 Corrections** Problème de route frontend (#100) -# 0.2.4 (2021-06-15) +## 0.2.4 (2021-06-15) **🐛 Corrections** @@ -416,7 +432,7 @@ Problème de route frontend (#100) Version minimale de GeoNature nécessaire : 2.6.2 -# 0.2.3 (2021-04-01) +## 0.2.3 (2021-04-01) Version minimale de GeoNature nécessaire : 2.5.5 @@ -431,7 +447,7 @@ Si vous mettez à jour le module : - Suivez la procédure classique de mise à jour du module (`docs/MAJ.rst`) - # 0.2.2 (2021-03-22) +## 0.2.2 (2021-03-22) - Version minimale de GeoNature nécessaire : 2.5.5 @@ -461,7 +477,7 @@ npm uninstall test npm ci /home/`whoami`/gn_module_monitoring/frontend/ --no-save ``` -# 0.2.1 (2021-01-14) +## 0.2.1 (2021-01-14) - Version minimale de GeoNature nécessaire : 2.5.5 @@ -511,7 +527,7 @@ Si vous mettez à jour le module : ces données sont désormais gérées automatiquement depuis la configuration. - # 0.2.0 (2020-10-23) +## 0.2.0 (2020-10-23) Nécessite la version 2.5.2 de GeoNature minimum. @@ -589,7 +605,7 @@ Si vous mettez à jour le module depuis la version 0.1.0 : - Suivez la procédure classique de mise à jour du module (`docs/MAJ.rst`) - # 0.1.0 (2020-06-30) +## 0.1.0 (2020-06-30) Première version fonctionelle du module Monitoring de GeoNature. Nécessite la version 2.4.1 de GeoNature minimum. diff --git a/docs/commandes.md b/docs/commandes.md index e2c216de4..15215260c 100644 --- a/docs/commandes.md +++ b/docs/commandes.md @@ -5,7 +5,7 @@ geonature monitorings install ``` -# Mettre à jour la nommenclature +# Mettre à jour les nomenclatures Ajoute ou met à jour des nomenclatures en base de données à partir du fichier `nomenclature.json` de la config du module (voir le fichier @@ -35,7 +35,7 @@ données associées. geonature monitorings remove ``` -# Mettre à jour la synthese +# Mettre à jour la synthèse Cette commande lit la vue de synchronisation liée au module et synchronise les données dans la synthèse (insertion et mise à jour