Intégration de TaxHub à GeoNature

[camillemonchicourt]

TaxHub a récemment été refondu en version 2.0.0.

• Détail : https://github.com/PnX-SI/TaxHub/releases/tag/2.0.0
• Précisions : TaxHub v2 - Angular JS VS Angular ? TaxHub#297

Cette refonte a consisté à refondre l'interface de TaxHub pour la simplifier ainsi que sa maintenance en passant sur l'outil Flask-admin (aussi utilisé pour le module "Admin" de GeoNature).
Cela a aussi été l'occasion de supprimer la table taxonomie.bib_noms pour simplifier le modèle de données, la gestion des taxons et surtout la mise à jour de Taxref.

Suite à cette refonte, TaxHub peut continuer à être installé comme un outil indépendant ou autonome, mais quand on utilise aussi GeoNature alors TaxHub est désormais intégré au module "Admin" de GeoNature.
Répercussions sur GeoNature réalisées dans #3150.

Cela simplifie son accès, son utilisation mais aussi son administration.
On n'a donc plus à installer et mettre à jour TaxHub en parallèle de GeoNature.

Ainsi TaxHub est désormais mis à jour automatiquement quand on met à jour GeoNature à partir de sa version 2.15.

Cela implique :

• Que l'installation à part de TaxHub est plus utile ni utilisée à partir de GeoNature 2.15
• Lors du passage à GeoNature 2.15, le service TaxHub est supprimé, ainsi que sa configuration Apache
• Le dossier spécifique de TaxHub (à priori dans /homer/monuser/taxhub/ n'est plus utile ni utilisé
• L'URL de l'API de TaxHub évolue et est derrière l'URL de l'API de GeoNature (si vous les utilisez, à répercuter dans la config de GeoNature-atlas, d'Occtax-mobile et de GeoNature-citizen, quand vous passez à GeoNature 2.15 ou plus, ou alors mettre en place des redirections au niveau de la configuration Apache de TaxHub)
  Exemple d'API de TaxHub une fois intégré à GeoNature : https://demo.geonature.fr/geonature/api/taxhub/api/taxref/
• L'URL des médias de TaxHub évolue aussi et est désormais avec les autres médias de GeoNature (si vous l'utilisez, à répercuter dans la config de GeoNature-atlas, ou mettre en place une redirection au niveau de la conf Apache de TaxHub)
• TaxHub est désormais un module de GeoNature, avec une entrée dans la table t_modules et dispose de permissions comme les autres modules
• Les commandes de TaxHub sont maintenant accessibles depuis la commande geonature, par exemple :

  geonature taxref info # avant flask taxref info
  geonature taxref enable-bdc-statut-text # avant flask taxref enable-bdc-statut-text
  geonature taxref migrate-to-v17 # flask taxref migrate-to-v17

• Les médias ont été déplacés automatiquement du dossier /static/medias/ de TaxHub vers le dossier /backend/media/taxhub/ de GeoNature. En conséquence, les URL des médias ont changé. Vous devez donc modifier les paramètres de vos éventuelles applications qui les utilisent (REMOTE_MEDIAS_URL et REMOTE_MEDIAS_PATH de la configuration de GeoNature-atlas par exemple).
  Vous pouvez aussi définir des règles de redirection pour les médias dans un fichier de configuration Apache de TaxHub :

  # Cas où TaxHub et GeoNature sont sur le même sous-domaine
  RewriteEngine on
  RewriteRule   "^/taxhub/static/medias/(.+)" "/geonature/api/medias/taxhub/$1"  [R,L]
  # Cas où TaxHub et GeoNature ont chacun un sous-domaine
  RewriteEngine on
  RewriteRule   "^/static/medias/(.+)" "https://geonature.<MON_DOMAINE.EXT>/api/medias/taxhub/$1"  [R,L]
  

• Exemple de configuration de GeoNature-atlas après passage à GeoNature 2.15 :

  # URL d'accès aux photos et autres médias (URL racine). Par exemple l'url d'accès à Taxhub
  # Cette url sera cachée aux utilisateurs de l'atlas
  REMOTE_MEDIAS_URL = "https://demo.geonature.fr/geonature/"
  # Racine du chemin des fichiers médias stockés dans le champ "chemin" de "atlas.vm_medias"
  # Seule cette partie de l'url sera visible pour les utilisateurs de l'atlas
  REMOTE_MEDIAS_PATH = "api/medias/taxhub/"
  
  # URL de TaxHub (pour génération à la volée des vignettes des images).
  # Si le service Taxhub n'est pas utilisé, commenter la variable
  REDIMENSIONNEMENT_IMAGE = True
  # si redimmentionnement image = True, indiquer l'URL de taxhub
  TAXHUB_URL = "https://demo.geonature.fr/geonature/api/taxhub"
  

[camillemonchicourt]

Fait dans la 2.15.0, intégré automatiquement lors de la mise à jour vers la version 2.15 ou plus :