feat(doc): complete validation and sensitivity documentation (#3317)

docs/admin-manual.rst

@@ -521,7 +521,7 @@ Pour chaque taxon (cd_ref) disposant de données dans la vue ``gn_profiles.v_syn
 
 Ces profils sont déclinés sur :
 
-- Le module de validation permet d'attirer l'attention des validateurs sur les données qui sortent du "cadre" déjà connu pour le taxon considéré, et d'apporter des éléments de contexte en complément de la donnée en cours de validation
+- Le module Validation permet d'attirer l'attention des validateurs sur les données qui sortent du "cadre" déjà connu pour le taxon considéré, et d'apporter des éléments de contexte en complément de la donnée en cours de validation
 - Le module Synthèse (fiche d'information, onglet validation) permet d'apporter des éléments de contexte en complément des données brutes consultées
 - Le module Occtax permet d'alerter les utilisateurs lors de la saisie de données qui sortent du "cadre" déjà connu pour un taxon considéré
 - Le processus de validation automatique permet de valider automatiquement les observations respectant le profil de taxons (non activé par défaut).
@@ -2318,11 +2318,11 @@ D'autres élements sont paramètrables dans le module Synthese. La liste complè
 Module VALIDATION
 -----------------
 
-Le module VALIDATION, integré depuis la version 2.1.0 dans le coeur de GeoNature permet de valider des occurrences de taxon en s'appuyant sur les données présentes dans la SYNTHESE. Le module s'appuie sur le `standard Validation <http://www.naturefrance.fr/la-reunion/protocole-de-validation>`_ du SINP et sur ses `nomenclatures officiels <http://standards-sinp.mnhn.fr/nomenclature/80-niveaux-de-validation-validation-manuelle-ou-combinee-2018-05-14/>`_.
+Le module VALIDATION, integré depuis la version 2.1.0 dans le coeur de GeoNature (mais optionnel) permet de valider des occurrences de taxon en s'appuyant sur les données présentes dans la SYNTHESE. Le module s'appuie sur le standard Validation du SINP et sur ses `nomenclatures officielles <https://inpn.mnhn.fr/programme/donnees-observations-especes/references/validation>`_.
 
-Afin de valider une occurrence, celle-ci doit impérativement avoir un UUID. En effet, la validation est stockée en BDD dans la table transversale ``gn_commons.t_validations``  (`voir doc <admin-manual.html#tables-transversales>`_ ) qui impose la présence de cet UUID.
+Afin de valider une occurrence de taxons, celle-ci doit impérativement avoir un UUID. En effet, la validation est stockée en BDD dans la table transversale ``gn_commons.t_validations``  (`voir doc <admin-manual.html#tables-transversales>`_ ) qui impose la présence de cet UUID.
 
-La table ``gn_commons.t_validations`` contient l'ensemble de l'historique de validation des occurrences. Pour une même occurrence (identifiée par un UUID unique) on peut donc retrouver plusieurs lignes dans la table correspondant au différents statuts de validation attribués à cet occurrence dans le temps.
+La table ``gn_commons.t_validations`` contient l'ensemble de l'historique de validation des occurrences de taxons. Pour une même occurrence (identifiée par un UUID unique) on peut donc retrouver plusieurs lignes dans la table correspondant aux différents statuts de validation attribués à cette occurrence dans le temps.
 
 La vue ``gn_commons.v_latest_validation`` permet de récupérer le dernier statut de validation d'une occurrence.
 
@@ -2353,10 +2353,10 @@ Gestion de l'affichage des colonnes de la liste via le paramètre ``COLUMN_LIST`
 E-mail
 ``````
 
-Il est possible de personnaliser le message du mail envoyé aux observateurs.
+Il est possible de personnaliser le message de l'email envoyé aux observateurs d'une observation quand on clique sur le bouton dédié à cela depuis la fiche détail d'une observation.
 Pour ce faire il faut modifier les  paramètres ``MAIL_BODY`` et ``MAIL_SUBJECT``
 
-Pour afficher dans le mail des données relatives à l'observation ou au taxon il faut respecter la syntaxe suivante:
+Pour afficher dans l'email des données relatives à l'observation ou au taxon il faut respecter la syntaxe suivante :
 ``${ d.NOM_PROPRIETE }``
 
 Liste des propriétés disponibles :
@@ -2367,6 +2367,8 @@ Liste des propriétés disponibles :
 - tous les champs de la synthèse (acquisition_framework, altitude_max, altitude_min, bio_status, blurring, cd_hab, cd_nom, comment_context, comment_description, date_min, depth_max, depth_min, determiner, diffusion_level, digital_proof, entity_source_pk_value, exist_proof, grp_method, grp_typ, last_action, life_stage, meta_create_date, meta_update_date, meta_v_taxref, meta_validation_date, nat_obj_geo, naturalness, nom_cite, non_digital_proof, obj_count, obs_technique, observation_status, observers, occ_behaviour, occ_stat_biogeo, place_name, precision, sample_number_proof, sensitivity, sex, source, type_count, unique_id_sinp, unique_id_sinp_grp, valid_status, validation_comment)
 - tous les champs du taxon (cd_nom, cd_ref, cd_sup, cd_taxsup, regne, ordre, classe, famille, group1_inpn, group2_inpn, id_rang, nom_complet, nom_habitat, nom_rang, nom_statut, nom_valide, nom_vern)
 
+Il est aussi possible de modifier la structure du message de notification envoyé automatiquement à un observateur quand une de ses observations voit son statut de validation modifié, dans la table `gn_notifications.bib_notifications_templates`.
+
 Validation automatique
 """"""""""""""""""""""
 

docs/sensitivity.rst

@@ -73,8 +73,10 @@ que l’un des critères ou l’une des zones correspond à l’observation.
 Si des règles de sensibilité sont définies avec des conditions de critères 
 sur une nomenclature (Statut biologique ou Comportement), 
 alors ces règles sont appliquées aussi si la nomenclature n'est pas renseignée 
-(par principe de précaution), en dupliquant les règles pour les valeurs de 
-nomenclature "Non renseigné", "Ne sait pas", "Indéterminé",... (https://github.com/PnX-SI/GeoNature/blob/30c27266495b4affc635f79748c9984feb81a6d7/backend/geonature/core/sensitivity/utils.py#L37-L54).
+(par principe de précaution), en associant aussi des critères à ces règles 
+(dans la table `gn_sensitivity.cor_sensitivity_criteria`) pour les valeurs 
+de nomenclature "Non renseigné", "Ne sait pas", "Indéterminé",... 
+(https://github.com/PnX-SI/GeoNature/blob/30c27266495b4affc635f79748c9984feb81a6d7/backend/geonature/core/sensitivity/utils.py#L37-L54).
 
 Certaines règles sont définies non pas pour une espèce donnée mais pour un
 rang supérieur. Ces règles sont artificiellement dupliquées pour chaques espèces