init README

insert_liste_alerte/README.md

@@ -0,0 +1,49 @@
+# Intégration de liste d'Alerte `MAISON`
+Dans le cas de l'Isère il s'agit de liste d'alerte départementale
+
+## 1. Les fonctions éventuellement à modifier
+Le script incrémente de nouveaux types de statuts dans la bdd : 
+- def insert_status_alerte (l.25) : Intégration du statut `alerte départementale` dans la table `taxonomie.bdc_statut_type`
+|cd_type_statut|lb_type_statut|regroupement_type|thematique|type_value|
+|-|-|-|-|-|
+|'AL'|'Liste d''alerte départementale'|'Alerte'|'STATUTS'|'VALUE'|
+- def insert_status_values (l.42) : Intégration de libellés de statut nom présent dans la table `taxonomie.bdc_statut_values`
+|code_statut|label_statut|
+|-|-|
+|'RE'|'Disparue au niveau départemental'|
+|'AS-1'|'Quasi menacée (localisées sans signe de déclin)'|
+|'AS-2'|'Quasi menacée (répandues mais en déclin)'|
+|'AS-3'|'Quasi menacée (répandues, déclin à confirmer)'|
+
+## 2. Le code à personaliser
+La personalisation impérative est située à partir de la ligne 231 du script :
+- l.235 : Import/Définition de la connexion à la bdd GéoNature.
+	En cas de définition de la connexion, ajoutez/completez le code ci-dessous :
+``` py 
+from sqlalchemy import create_engine
+from sqlalchemy.engine import URL
+gn_user = 'XXXX'
+gn_pwd  = 'XXXX'
+gn_adr  = 'XXXX'
+gn_base = 'XXXX'
+gn_url  = URL.create("postgresql+psycopg2", username=gn_user, password=gn_pwd, host=gn_adr, database=gn_base)
+con_gn  = create_engine(gn_url)
+```
+- l.242 : Chemin vers le fichier des listes d'alertes à importer. Le fichier doit être un Excel contenant à minima les colonnes suivantes : 
+|CD_NOM|Statut|Source|Source_url|
+|-|-|-|-|
+ATTENTION : les lignes la `Source_url` est None ou NA (non remplie) seront ignorés. La colonne `Statut` recense les CODES STATUTS.
+Pour exemple, vous pouvez vous référez au fichier utilisé en Isère : `listes_alertes_isère.xlsx`
+- l.244 : Définir l'échelle administratif des listes à implémenter.
+- l.246 : Définir le nom du niveau adminsitratif concerné.
+- l.248 : Définir le code SIG du niveau adminnistratif. N'hésiter pas à vous référer à ceux déjà présent dans la table `taxonomie.bdc_statut_text`
+- l.253 : Dictionnaire des listes de statut présent dans le fichier Excel. A définir sous le format suivant
+``` json
+{
+'Source' : {
+	'id_doc': Valeur du cd_doc à implémenter dans la table taxonomie.bdc_statut_text
+	'id_values': [Liste de l'ensemble des statut concernés par la source.]
+},
+...
+}
+```