.. _dhis2_vatovavy_geospatial_update:

================================
Mise à jour de la carte Vatovavy
================================
Région Vatovavy
===============

Objet
-----
Procédure complète de mise à jour des limites des communes et de la région Vatovavy dans DHIS2 via QGIS et import GML.

Périmètre
---------
- Région : Vatovavy
- Districts : Mananjary, Ifanadiana, Nosy Varika

Environnement technique
-----------------------
- QGIS
- DHIS2 (Import/Export App)
- GDAL (ogr2ogr)
- Shapefile source : EPSG:4326
- Version DHIS2 : 2.38+

Vue d’ensemble du processus
===========================
QGIS → Dissolve → Conversion GML → Édition GML → Import DHIS2

----

1. Introduction et contexte
===========================

Dans DHIS2, les analyses géospatiales reposent sur les unités organisationnelles.

La région Vatovovy (créée en 2021) comprend :
Mananjary, Ifanadiana et Nosy Varika.

Cette mise à jour nécessite une correction des géométries dans DHIS2.

----

2. Phase 1 — Préparation des données dans QGIS
==============================================

2.1 Extraction des données
--------------------------
- Extraire le shapefile
- Vérifier : ``MDG_adm4.shp``

----

2.2 Import dans QGIS
--------------------
- Ajouter couche vecteur
- Charger ``MDG_adm4.shp``

----

2.3 Sélection des communes Vatovavy
-----------------------------------
Expression :

::

   "NAME_1" = 'Vatovavy Fitovinany'

----

2.4 Export sélection
--------------------
- Format : Shapefile
- Nom : Vatovavy_Commune

----

2.5 Vérification
----------------
- Affichage couche filtrée
- Contrôle cartographique

----

2.6 Nettoyage des entités
-------------------------
À supprimer :
- Vohipeno
- Manakara Atsimo
- Ikongo

Point critique :
- Vérifier suppression de Namorona

----

2.7 Contrôle final
------------------
Conservés :
- Mananjary
- Ifanadiana
- Nosy Varika

Supprimés :
- Vohipeno
- Manakara Atsimo
- Ikongo

----

2.8 Dissolve district
---------------------
- Champ : NAME_3
- Output : Région_Vatovavy_2026

----

2.9 Dissolve région
-------------------
- Champ : NAME_2
- Output : Vatovavy_Region_2026

----

2.10 Export final
-----------------
- Communes : Vatovavy_Commune_final.shp
- Districts : Vatovavy_Districts_2026.shp
- Région : Vatovavy_Region_2026.shp

Projection obligatoire :
::

   EPSG:4326

----

3. Phase 2 — Conversion Shapefile → GML
=======================================

Commande GDAL :

::

   ogr2ogr -f GML output.gml input.shp

Fichiers :
- Communes
- Districts
- Région

----

4. Phase 3 — Structuration GML
==============================

Identifiants DHIS2
-------------------

.. list-table:: Identifiants GML DHIS2
   :header-rows: 1
   :widths: 20 20 20 40

   * - Champ
     - Balise
     - Fiabilité
     - Description
   * - name
     - ogr:Name
     - Moyenne
     - Nom unité DHIS2
   * - code
     - ogr:Code
     - Haute
     - Code unique
   * - uid
     - ogr:Uid
     - Maximale
     - Identifiant DHIS2 recommandé

Exemple UID :

::

   O0yrAFTjghG

----

5. Phase 4 — Import DHIS2
=========================

5.1 Procédure
-------------
- DHIS2 → Import/Export
- Org Unit geometry import
- Format GML
- Exécuter Dry Run

Validation :
- 0 création
- N mises à jour

----

5.2 Ordre d’import

.. list-table:: Ordre d’import GML
   :header-rows: 1
   :widths: 10 40 20 30

   * - #
     - Fichier
     - Niveau
     - Résultat
   * - 1
     - Communes.gml
     - Niveau 4
     - Mise à jour
   * - 2
     - Districts.gml
     - Niveau 3
     - Mise à jour
   * - 3
     - Region.gml
     - Niveau 2
     - Mise à jour

----

5.3 Vérification Maps
---------------------
- Application Maps
- Boundary Layer
- Filtrer Vatovavy
- Actualiser

----

6. Checklist
============

.. list-table:: Checklist opérationnelle
   :header-rows: 1
   :widths: 60 40

   * - Élément
     - Statut
   * - Shapefile OK
     - OK
   * - Filtrage Vatovavy
     - OK
   * - Suppression Fitovinany
     - OK
   * - Dissolve district
     - OK
   * - Dissolve région
     - OK
   * - EPSG:4326
     - OK
   * - Conversion GML
     - OK
   * - UID injecté
     - OK
   * - Dry run validé
     - OK
   * - Import DHIS2 OK
     - OK

----

7. Problèmes courants
=====================

.. list-table:: Résolution des problèmes
   :header-rows: 1
   :widths: 50 50

   * - Problème
     - Solution
   * - Pas de mise à jour DHIS2
     - Vérifier UID/code
   * - Coordonnées incorrectes
     - EPSG:4326 obligatoire
   * - Fitovinany encore présent
     - Refaire suppression QGIS
   * - Géométrie invalide
     - Repair geometry QGIS
   * - Région absente
     - Vérifier API DHIS2