@geoalgeria/sante 1.0.0 → 2.0.0

package/README.ar.md

@@ -15,8 +15,9 @@
 **695 مؤسسة صحية عمومية** عبر **58 ولاية** لها مديرية للصحة — المؤسسات العمومية
 الاستشفائية (EPH)، ومؤسسات الصحة الجوارية (EPSP)، والمؤسسات الاستشفائية المتخصصة
 (EHS)، والمراكز الاستشفائية الجامعية (CHU) من **وزارة الصحة (MSP)**، ثنائية اللغة
-عربي/فرنسي، **600 منها بإحداثيات** عبر OpenStreetMap وWikidata مع ربطٍ
-بالبلدية والولاية. متوفر بصيغ JSON وCSV وGeoJSON وTypeScript. جزء من
+عربي/فرنسي، **600 منها بإحداثيات** (124 بنقطة دقيقة من OpenStreetMap/Wikidata،
+و476 بمركز ثقل البلدية) مع ربطٍ بالبلدية والولاية. متوفر بصيغ JSON وCSV
+وGeoJSON وTypeScript. جزء من
 [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
 
 ```bash
@@ -61,12 +62,20 @@ const mappable = all.filter((e) => e.lat != null);
 
 **حسب دقّة الإحداثيات** (`geo_precision`)
 
+| القيمة | العدد | المعنى |
+| --- | --- | --- |
+| `exact` | 124 | نقطة دقيقة من مرفق في OSM أو Wikidata ضمن البلدية |
+| `approximate` | 476 | مركز ثقل بلدية المؤسسة |
+| `null` | 95 | لم تُربط البلدية — بلا إحداثيات (`lat`/`lng` أيضًا `null`) |
+
+**حسب طريقة الحصول على الإحداثية** (`geo_method`)
+
 | القيمة | العدد | المعنى |
 | --- | --- | --- |
 | `osm_point` | 121 | نقطة دقيقة من مرفق في OpenStreetMap ضمن البلدية |
 | `wikidata_point` | 3 | نقطة دقيقة من مرفق في Wikidata ضمن البلدية |
 | `commune_centroid` | 476 | مركز ثقل بلدية المؤسسة (تقريبي) |
-| `none` | 95 | لم تُربط البلدية — بلا إحداثيات |
+| `null` | 95 | لا توجد طريقة — السجل بلا إحداثيات |
 
 > **السجل رسمي؛ أما الإحداثيات فأفضل ما أمكن.** الأسماء والنوع والولاية من وزارة
 > الصحة. لا تنشر الوزارة إحداثيات، فيستنتجها GeoAlgeria (انظر *المصدر والمنهجية*).
@@ -95,7 +104,7 @@ const all: HealthEstablishment[] = sante.sante();
 ```
 data/
   sante.json              # 695 مؤسسة (مصفوفة)
-  metadata.json           # المصادر، الأعداد، التغطية، generated_at
+  metadata.json           # المصادر، الأعداد، التغطية، updated
   csv/sante.csv           # المستودع + الإصدار (ليس في حزمة npm)
   geojson/sante.geojson   # معالم نقطية (السجلات ذات الإحداثيات)
 ```
@@ -106,33 +115,38 @@ data/
 {
   "id": "01-ehs-02",
   "name": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
-  "name_ar": "المؤسسة الاستشفائية المتخصصة في الأمراض العقلية أدرار",
   "name_fr": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
+  "name_ar": "المؤسسة الاستشفائية المتخصصة في الأمراض العقلية أدرار",
+  "wilaya_code": "01",
+  "commune_code": "0101",
+  "commune": "Adrar",
+  "lat": 27.875834,
+  "lng": -0.307533,
+  "geo_precision": "exact",
+  "geo_method": "osm_point",
+  "source": "msp",
+  "refs": {
+    "osm": "way/432370657",
+    "msp": "3588"
+  },
   "type": "ehs",
   "type_label_fr": "Établissement Hospitalier Spécialisé",
   "type_label_ar": "المؤسسة الاستشفائية المتخصصة",
   "sector": "public",
-  "wilaya": "Adrar",
-  "wilaya_ar": "أدرار",
-  "wilaya_code": "01",
-  "commune": "Adrar",
-  "commune_code": 101,
-  "source": "msp+osm",
-  "geo_precision": "osm_point",
-  "wikidata": null,
-  "osm_id": "way/432370657",
-  "msp_id": 3588,
-  "slug": "etablissement-hospitalier-specialise-psychiatrie-adrar",
-  "lat": 27.875834,
-  "lng": -0.307533
+  "slug": "etablissement-hospitalier-specialise-psychiatrie-adrar"
 }
 ```
 
 `id` مفتاح ثابت `{wilaya_code}-{type}-{seq}` يولّده GeoAlgeria (لا تنشر الوزارة
-رمزًا). `name` هو الاسم الفرنسي إن وُجد، وإلا العربي. يُشتقّ `type` من العنوان،
-و`wilaya` من وسم الوزارة. `sector` يساوي `"public"` لكامل سجل الوزارة (العيادات
-الخاصة، عند إضافتها، ستحمل `"private"`). يبيّن `source` السجلات المساهِمة، و
-`geo_precision` مصدر الإحداثية. تكون `lat`/`lng` بقيمة `null` للسجلات الـ95 التي
+رمزًا) — قيمة مبهمة، فريدة ضمن `sante.json`. `name` هو الاسم الفرنسي إن وُجد،
+وإلا العربي. يُشتقّ `type` من العنوان، و`wilaya_code` من وسم الوزارة. `sector`
+يساوي `"public"` لكامل سجل الوزارة (العيادات الخاصة، عند إضافتها، ستحمل
+`"private"`). يساوي `source` دائمًا `"msp"` (سجل وزارة الصحة)؛ يحمل `refs`
+معرّفات المصادر المساهِمة — دائمًا `msp`، إضافة إلى `osm` أو `wikidata` عند
+رفع الإحداثية إلى نقطة دقيقة. تكون `geo_precision` إما `"exact"` أو
+`"approximate"` أو `null`؛ ويبيّن `geo_method` كيفية الحصول على الإحداثية
+(`osm_point`، أو `wikidata_point`، أو `commune_centroid`، أو `null`). تكون
+`lat`/`lng`/`geo_precision`/`geo_method` كلّها `null` معًا للسجلات الـ95 التي
 تعذّر ربط بلديتها.
 
 > **الإحداثيات والبلدية مُستنتَجة وليست من الوزارة.** تَسرد وزارة الصحة الأسماء

package/README.fr.md

@@ -16,7 +16,8 @@
 direction de la santé — établissements publics hospitaliers (EPH), de santé de
 proximité (EPSP), hospitaliers spécialisés (EHS) et centres hospitalo-universitaires
 (CHU) du **Ministère de la Santé (MSP)**, bilingues français/arabe, **600
-géolocalisés** via OpenStreetMap et Wikidata avec rattachement commune/wilaya.
+géolocalisés** (124 sur un point précis OpenStreetMap/Wikidata, 476 sur un
+centroïde de commune) avec rattachement commune/wilaya.
 Livré en JSON, CSV, GeoJSON et TypeScript. Fait partie de
 [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
 
@@ -63,12 +64,20 @@ const mappable = all.filter((e) => e.lat != null);
 
 **Par précision des coordonnées** (`geo_precision`)
 
+| Valeur | Nombre | Signification |
+| --- | --- | --- |
+| `exact` | 124 | point précis d'un établissement OSM ou Wikidata dans la commune |
+| `approximate` | 476 | centroïde de la commune de l'établissement |
+| `null` | 95 | localité non rattachée à une commune — pas de coordonnées (`lat`/`lng` aussi `null`) |
+
+**Par méthode d'obtention** (`geo_method`)
+
 | Valeur | Nombre | Signification |
 | --- | --- | --- |
 | `osm_point` | 121 | point précis d'un établissement OpenStreetMap dans la commune |
 | `wikidata_point` | 3 | point précis d'un établissement Wikidata dans la commune |
 | `commune_centroid` | 476 | centroïde de la commune de l'établissement (approximatif) |
-| `none` | 95 | localité non rattachée à une commune — pas de coordonnées |
+| `null` | 95 | aucune méthode — l'enregistrement n'a pas de coordonnées |
 
 > **Le registre est officiel ; les coordonnées sont au mieux.** Les noms, le type
 > et la wilaya proviennent du Ministère de la Santé. Le MSP ne publie pas de
@@ -98,7 +107,7 @@ chaque [GitHub Release](https://github.com/yasserstudio/geoalgeria/releases) :
 ```
 data/
   sante.json              # 695 établissements (tableau)
-  metadata.json           # sources, totaux, couverture, generated_at
+  metadata.json           # sources, totaux, couverture, updated
   csv/sante.csv           # dépôt + Release (pas dans le tarball npm)
   geojson/sante.geojson   # entités Point (enregistrements géolocalisés)
 ```
@@ -109,36 +118,41 @@ data/
 {
   "id": "01-ehs-02",
   "name": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
-  "name_ar": "المؤسسة الاستشفائية المتخصصة في الأمراض العقلية أدرار",
   "name_fr": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
+  "name_ar": "المؤسسة الاستشفائية المتخصصة في الأمراض العقلية أدرار",
+  "wilaya_code": "01",
+  "commune_code": "0101",
+  "commune": "Adrar",
+  "lat": 27.875834,
+  "lng": -0.307533,
+  "geo_precision": "exact",
+  "geo_method": "osm_point",
+  "source": "msp",
+  "refs": {
+    "osm": "way/432370657",
+    "msp": "3588"
+  },
   "type": "ehs",
   "type_label_fr": "Établissement Hospitalier Spécialisé",
   "type_label_ar": "المؤسسة الاستشفائية المتخصصة",
   "sector": "public",
-  "wilaya": "Adrar",
-  "wilaya_ar": "أدرار",
-  "wilaya_code": "01",
-  "commune": "Adrar",
-  "commune_code": 101,
-  "source": "msp+osm",
-  "geo_precision": "osm_point",
-  "wikidata": null,
-  "osm_id": "way/432370657",
-  "msp_id": 3588,
-  "slug": "etablissement-hospitalier-specialise-psychiatrie-adrar",
-  "lat": 27.875834,
-  "lng": -0.307533
+  "slug": "etablissement-hospitalier-specialise-psychiatrie-adrar"
 }
 ```
 
 `id` est une clé stable `{wilaya_code}-{type}-{seq}` synthétisée par GeoAlgeria
-(le MSP ne publie pas de code). `name` est le nom français s'il existe, sinon
-l'arabe. `type` est déduit du titre ; `wilaya` de l'étiquette du MSP. `sector`
-vaut `"public"` pour tout le registre MSP (les cliniques privées, une fois
-ajoutées, porteront `"private"`). `source` indique les registres ayant
-contribué ; `geo_precision` l'origine de la coordonnée. `lat`/`lng` valent
-`null` pour les 95 enregistrements dont la localité n'a pu être rattachée à une
-commune.
+(le MSP ne publie pas de code) — opaque, unique au sein de `sante.json`.
+`name` est le nom français s'il existe, sinon l'arabe. `type` est déduit du
+titre ; `wilaya_code` de l'étiquette du MSP. `sector` vaut `"public"` pour tout
+le registre MSP (les cliniques privées, une fois ajoutées, porteront
+`"private"`). `source` vaut toujours `"msp"` (le registre du Ministère de la
+Santé) ; `refs` porte les identifiants de provenance ayant contribué —
+toujours `msp`, plus `osm` ou `wikidata` quand la coordonnée a été remplacée
+par un point précis. `geo_precision` vaut `"exact"`, `"approximate"` ou
+`null` ; `geo_method` indique comment la coordonnée a été obtenue (`osm_point`,
+`wikidata_point`, `commune_centroid`, ou `null`). `lat`/`lng`/`geo_precision`/
+`geo_method` valent tous `null` ensemble pour les 95 enregistrements dont la
+localité n'a pu être rattachée à une commune.
 
 > **Les coordonnées et la commune sont dérivées, pas issues du MSP.** Le
 > Ministère de la Santé ne liste que noms, type et wilaya. GeoAlgeria rattache la

package/README.md

@@ -14,9 +14,9 @@
 
 **695 public health establishments** across all **58 wilayas** with health
 directorates — public hospitals (EPH), proximity-health establishments (EPSP),
-specialized hospitals (EHS) and university hospitals (CHU) from the **Ministère
-de la Santé (MSP)**, bilingual French/Arabic, **600 geocoded** via OpenStreetMap
-and Wikidata with commune/wilaya linkage. Shipped as JSON, CSV, GeoJSON, and
+specialized hospitals (EHS) and university hospitals (CHU) from the **Ministry of Health (MoH)**, bilingual French/Arabic, **600 geocoded** (124 to a precise
+OpenStreetMap/Wikidata point, 476 to a commune centroid) with commune/wilaya
+linkage. Shipped as JSON, CSV, GeoJSON, and
 TypeScript. Part of [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
 
 ```bash
@@ -62,17 +62,25 @@ const mappable = all.filter((e) => e.lat != null);
 
 **By coordinate precision** (`geo_precision`)
 
+| Value | Count | Meaning |
+| --- | --- | --- |
+| `exact` | 124 | precise point from an OSM or Wikidata facility in the commune |
+| `approximate` | 476 | the establishment's commune centroid |
+| `null` | 95 | locality not resolved to a commune — no coordinates (`lat`/`lng` also `null`) |
+
+**By coordinate method** (`geo_method`)
+
 | Value | Count | Meaning |
 | --- | --- | --- |
 | `osm_point` | 121 | precise point from an OpenStreetMap facility in the commune |
 | `wikidata_point` | 3 | precise point from a Wikidata facility in the commune |
 | `commune_centroid` | 476 | the establishment's commune centroid (approximate) |
-| `none` | 95 | locality not resolved to a commune — no coordinates |
+| `null` | 95 | no method — record has no coordinate |
 
 > **The registry is official; the coordinates are best-effort.** Names, type and
-> wilaya come from the Ministère de la Santé. The MSP publishes no coordinates,
+> wilaya come from the Ministry of Health. The MoH publishes no coordinates,
 > so GeoAlgeria derives them — see *Source & method* below. Counts move as the
-> MSP, OpenStreetMap and Wikidata are edited; each rebuild reflects their current
+> MoH, OpenStreetMap and Wikidata are edited; each rebuild reflects their current
 > state.
 
 ## Formats
@@ -98,7 +106,7 @@ const all: HealthEstablishment[] = sante.sante();
 ```
 data/
   sante.json              # 695 establishments (array)
-  metadata.json           # sources, counts, coverage, generated_at
+  metadata.json           # sources, counts, coverage, updated
   csv/sante.csv           # repo + Release bundle (not in npm tarball)
   geojson/sante.geojson   # Point features (geocoded records only)
 ```
@@ -109,38 +117,44 @@ data/
 {
   "id": "01-ehs-02",
   "name": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
-  "name_ar": "المؤسسة الاستشفائية المتخصصة في الأمراض العقلية أدرار",
   "name_fr": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
+  "name_ar": "المؤسسة الاستشفائية المتخصصة في الأمراض العقلية أدرار",
+  "wilaya_code": "01",
+  "commune_code": "0101",
+  "commune": "Adrar",
+  "lat": 27.875834,
+  "lng": -0.307533,
+  "geo_precision": "exact",
+  "geo_method": "osm_point",
+  "source": "msp",
+  "refs": {
+    "osm": "way/432370657",
+    "msp": "3588"
+  },
   "type": "ehs",
   "type_label_fr": "Établissement Hospitalier Spécialisé",
   "type_label_ar": "المؤسسة الاستشفائية المتخصصة",
   "sector": "public",
-  "wilaya": "Adrar",
-  "wilaya_ar": "أدرار",
-  "wilaya_code": "01",
-  "commune": "Adrar",
-  "commune_code": 101,
-  "source": "msp+osm",
-  "geo_precision": "osm_point",
-  "wikidata": null,
-  "osm_id": "way/432370657",
-  "msp_id": 3588,
-  "slug": "etablissement-hospitalier-specialise-psychiatrie-adrar",
-  "lat": 27.875834,
-  "lng": -0.307533
+  "slug": "etablissement-hospitalier-specialise-psychiatrie-adrar"
 }
 ```
 
 `id` is a stable `{wilaya_code}-{type}-{seq}` key synthesized by GeoAlgeria (the
-MSP publishes no establishment code). `name` is the French name where available,
-else Arabic. `type` is derived from the establishment's title; `wilaya` from the
-MSP's wilaya tag. `sector` is `"public"` for the whole MSP registry (private
-clinics, when added, will carry `"private"`). `source` records which registries
-contributed; `geo_precision` records where the coordinate came from. `lat`/`lng`
-are `null` for the 95 records whose locality could not be matched to a commune.
-
-> **Coordinates and commune are derived, not from the MSP.** The Ministère de la
-> Santé lists names, type and wilaya only. GeoAlgeria matches each
+MoH publishes no establishment code) — opaque, unique within `sante.json`.
+`name` is the French name where available, else Arabic. `type` is derived from
+the establishment's title; `wilaya_code` from the MoH's wilaya tag. `sector` is
+`"public"` for the whole MoH registry (private clinics, when added, will carry
+`"private"`). `source` is always `"msp"` (the Ministry of Health registry);
+`refs` carries the per-provenance ids that contributed the record — `msp`
+always, plus `osm` or `wikidata` when the coordinate was upgraded to a precise
+point. `geo_precision` is `"exact"`, `"approximate"`, or `null`; `geo_method`
+names how the coordinate was obtained (`osm_point`, `wikidata_point`,
+`commune_centroid`, or `null`). `lat`/`lng`/`geo_precision`/`geo_method` are all
+`null` together for the 95 records whose locality could not be matched to a
+commune.
+
+> **Coordinates and commune are derived, not from the MoH.** The Ministry of
+> Health lists names, type and wilaya only. GeoAlgeria matches each
 > establishment's locality to the [`geoalgeria`](https://www.npmjs.com/package/geoalgeria)
 > commune set within its wilaya (giving `commune`, `commune_code` and a centroid
 > coordinate), then upgrades the coordinate to a precise point where a hospital
@@ -158,7 +172,7 @@ you turn an establishment's `commune_code` into a polygon or centroid. Use
 
 Run `npm run fetch` to regenerate every output. It:
 
-1. pulls the **Ministère de la Santé** establishment registry from the
+1. pulls the **Ministry of Health** establishment registry from the
    `sante.gov.dz` WordPress REST API (`healthinstitution`), in French and Arabic,
    each tagged with its wilaya;
 2. derives the **type** from each title and **pairs** the French and Arabic posts
@@ -176,7 +190,7 @@ Raw source pulls are cached under
 
 Package **code** is [MIT](LICENSE). The **data** is a composite:
 
-- The **Ministère de la Santé** registry (names, type, wilaya) is a factual
+- The **Ministry of Health** registry (names, type, wilaya) is a factual
   public-sector listing.
 - **Coordinates** are derived from **Wikidata** (**CC0**, public domain) and
   **OpenStreetMap** (**© OpenStreetMap contributors**, licensed under the