@geoalgeria/sante 1.0.0 → 2.0.1

package/README.ar.md

@@ -4,7 +4,7 @@
 
 # @geoalgeria/sante
 
-**المؤسسات الصحية العمومية في الجزائر — كبيانات قابلة للتثبيت.**
+**المؤسسات الصحية العمومية في الجزائر، كبيانات قابلة للتثبيت.**
 
 [![npm](https://img.shields.io/npm/v/@geoalgeria/sante)](https://www.npmjs.com/package/@geoalgeria/sante)
 [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/sante)](https://www.npmjs.com/package/@geoalgeria/sante)
@@ -12,13 +12,22 @@
 
 </div>
 
-**695 مؤسسة صحية عمومية** عبر **58 ولاية** لها مديرية للصحة — المؤسسات العمومية
+**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).
 
+> **الطبقة المجتمعية موجودة في [`@geoalgeria/cliniques`](https://www.npmjs.com/package/@geoalgeria/cliniques)، ولا يجوز جمع الاثنين أبدًا.**
+> هذه الحزمة هي طبقة *السجل*: المؤسسات العمومية التي تسيّرها وزارة الصحة، سجل
+> رسمي ومغلق. أما `cliniques` فهي الطبقة *المجتمعية*: 1,894 عيادة متعددة
+> الخدمات وقاعة علاج ومركز صحي ومصحة توليد وعيادة، رسمها متطوعو OpenStreetMap،
+> وهي جزئية بطبيعتها. كل عنصر OSM يشير إليه سجل من هنا مستبعَد هناك بحكم
+> البناء، فلا يُنشر أي مكان مرتين تحت العنصر نفسه، لكن الاثنتين تصفان طبقتين
+> مختلفتين من منظومة الصحة، وجمع 695 مع 1,894 لا يعدّ شيئًا حقيقيًا.
+
 ```bash
 npm install @geoalgeria/sante
 ```
@@ -37,11 +46,11 @@ const mappable = all.filter((e) => e.lat != null);
 
 ## ما يمكنك بناؤه
 
-- **أدلّة ومحدّدات مواقع المستشفيات والعيادات** — إحداثيات على 600 من أصل 695
+- **أدلّة ومحدّدات مواقع المستشفيات والعيادات** – إحداثيات على 600 من أصل 695
   سجلًّا، جاهزة للخريطة أو للبحث عن الأقرب.
-- **أدلّة صحية ثنائية اللغة** — أسماء عربية وفرنسية، والنوع الرسمي والولاية لكل
+- **أدلّة صحية ثنائية اللغة** – أسماء عربية وفرنسية، والنوع الرسمي والولاية لكل
   مؤسسة.
-- **تحليل التغطية والتخطيط** — حساب المؤسسات حسب النوع لكل بلدية/ولاية عبر البلاد.
+- **تحليل التغطية والتخطيط** – حساب المؤسسات حسب النوع لكل بلدية/ولاية عبر البلاد.
 
 ## المحتوى
 
@@ -61,12 +70,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 (انظر *المصدر والمنهجية*).
@@ -82,7 +99,7 @@ import sante from "@geoalgeria/sante/data/sante.json" with { type: "json" };
 // https://cdn.jsdelivr.net/npm/@geoalgeria/sante/data/sante.json
 ```
 
-المُحمِّلات وبنية السجلات **مُوثَّقة الأنواع** بالكامل — تعريفات TypeScript مرفقة في الحزمة:
+المُحمِّلات وبنية السجلات **مُوثَّقة الأنواع** بالكامل – تعريفات TypeScript مرفقة في الحزمة:
 
 ```ts
 import sante, { type HealthEstablishment } from "@geoalgeria/sante";
@@ -95,7 +112,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 +123,40 @@ 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"` لكامل سجل الوزارة، وهو لا يضم أي مؤسسة خاصة؛ أما المرافق
+الخاصة التي يرسمها OpenStreetMap فتوجد في
+[`@geoalgeria/cliniques`](https://www.npmjs.com/package/@geoalgeria/cliniques).
+يساوي `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 التي
 تعذّر ربط بلديتها.
 
 > **الإحداثيات والبلدية مُستنتَجة وليست من الوزارة.** تَسرد وزارة الصحة الأسماء
@@ -145,7 +169,7 @@ data/
 ## تحتاج التقسيمات الإدارية أيضًا؟
 
 للولايات والدوائر والبلديات، استخدم الحزمة الرئيسية
-**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** — بها تحوّل
+**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** – بها تحوّل
 `commune_code` لمؤسسةٍ ما إلى مضلّع أو مركز ثقل. استخدم `@geoalgeria/sante` عندما
 تحتاج المؤسسات الصحية *فقط*.
 

package/README.fr.md

@@ -4,7 +4,7 @@
 
 # @geoalgeria/sante
 
-**Les établissements de santé publics d'Algérie — sous forme de données prêtes à installer.**
+**Les établissements de santé publics d'Algérie, sous forme de données prêtes à installer.**
 
 [![npm](https://img.shields.io/npm/v/@geoalgeria/sante)](https://www.npmjs.com/package/@geoalgeria/sante)
 [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/sante)](https://www.npmjs.com/package/@geoalgeria/sante)
@@ -13,13 +13,24 @@
 </div>
 
 **695 établissements de santé publics** dans les **58 wilayas** dotées d'une
-direction de la santé — établissements publics hospitaliers (EPH), de santé de
+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).
 
+> **Le volet communautaire vit dans [`@geoalgeria/cliniques`](https://www.npmjs.com/package/@geoalgeria/cliniques), et les deux ne doivent jamais être additionnés.**
+> Ce paquet est le volet *registre* : les établissements publics que gère le
+> ministère de la Santé, officiel et clos. `cliniques` est le volet
+> *communautaire* : 1 894 polycliniques, salles de soins, centres de santé,
+> maternités et cliniques cartographiés par les contributeurs OpenStreetMap,
+> partiel par nature. Tout élément OSM référencé par un enregistrement d'ici en
+> est exclu par construction, donc aucun lieu n'est publié deux fois sous le
+> même élément, mais les deux décrivent des volets différents d'un système de
+> santé : additionner 695 et 1 894 ne compte rien de réel.
+
 ```bash
 npm install @geoalgeria/sante
 ```
@@ -38,11 +49,11 @@ const mappable = all.filter((e) => e.lat != null);
 
 ## Ce que vous pouvez construire
 
-- **Localisateurs d'hôpitaux et de cliniques** — des coordonnées sur 600 des 695
+- **Localisateurs d'hôpitaux et de cliniques** – des coordonnées sur 600 des 695
   enregistrements, prêtes pour une carte ou une recherche de proximité.
-- **Annuaires de santé bilingues** — noms français et arabe, type officiel et
+- **Annuaires de santé bilingues** – noms français et arabe, type officiel et
   wilaya pour chaque établissement.
-- **Analyse de couverture & planification** — compter les établissements par type
+- **Analyse de couverture & planification** – compter les établissements par type
   par commune/wilaya sur tout le pays.
 
 ## Contenu
@@ -63,12 +74,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
@@ -85,7 +104,7 @@ import sante from "@geoalgeria/sante/data/sante.json" with { type: "json" };
 // https://cdn.jsdelivr.net/npm/@geoalgeria/sante/data/sante.json
 ```
 
-Les chargeurs et les enregistrements sont entièrement **typés** — les définitions TypeScript sont incluses :
+Les chargeurs et les enregistrements sont entièrement **typés** – les définitions TypeScript sont incluses :
 
 ```ts
 import sante, { type HealthEstablishment } from "@geoalgeria/sante";
@@ -98,7 +117,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 +128,43 @@ 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, qui ne liste aucun établissement privé ; les structures privées
+que cartographie OpenStreetMap vivent dans
+[`@geoalgeria/cliniques`](https://www.npmjs.com/package/@geoalgeria/cliniques).
+`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
@@ -152,7 +178,7 @@ commune.
 ## Besoin des divisions administratives ?
 
 Pour les wilayas, dairas et communes, utilisez le paquet principal
-**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** — c'est ce qui
+**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** – c'est ce qui
 transforme le `commune_code` d'un établissement en polygone ou centroïde.
 Utilisez `@geoalgeria/sante` quand vous n'avez besoin *que* des établissements de
 santé.

package/README.md

@@ -4,7 +4,7 @@
 
 # @geoalgeria/sante
 
-**Algeria's public health establishments — as data you can install.**
+**Algeria's public health establishments, as data you can install.**
 
 [![npm](https://img.shields.io/npm/v/@geoalgeria/sante)](https://www.npmjs.com/package/@geoalgeria/sante)
 [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/sante)](https://www.npmjs.com/package/@geoalgeria/sante)
@@ -13,12 +13,21 @@
 </div>
 
 **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
+directorates, public hospitals (EPH), proximity-health establishments (EPSP),
+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).
 
+> **The community tier lives in [`@geoalgeria/cliniques`](https://www.npmjs.com/package/@geoalgeria/cliniques), and the two must not be summed.**
+> This package is the *registry* tier: the public establishments the Ministry of
+> Health runs, official and closed. `cliniques` is the *community* tier: 1,894
+> polycliniques, salles de soins, centres de santé, maternités and clinics
+> mapped by OpenStreetMap volunteers, partial by nature. Every OSM element a
+> record here references is excluded there by construction, so no place is
+> published twice under the same element, but the two describe different tiers
+> of a health system and adding 695 to 1,894 counts nothing real.
+
 ```bash
 npm install @geoalgeria/sante
 ```
@@ -37,11 +46,11 @@ const mappable = all.filter((e) => e.lat != null);
 
 ## What you can build
 
-- **Hospital & clinic locators** — coordinates on 600 of 695 records, ready for a
+- **Hospital & clinic locators** – coordinates on 600 of 695 records, ready for a
   map or nearest-facility search.
-- **Bilingual health directories** — French and Arabic names, official type and
+- **Bilingual health directories** – French and Arabic names, official type and
   wilaya for every establishment.
-- **Coverage & planning analysis** — count establishments by type per
+- **Coverage & planning analysis** – count establishments by type per
   commune/wilaya across the whole country.
 
 ## What's inside
@@ -54,25 +63,33 @@ const mappable = all.filter((e) => e.lat != null);
 
 | Type | Count | Meaning |
 | --- | --- | --- |
-| `eph` | 270 | Établissement Public Hospitalier — public hospital |
-| `epsp` | 292 | Établissement Public de Santé de Proximité — proximity health |
-| `ehs` | 108 | Établissement Hospitalier Spécialisé — specialized hospital |
-| `chu` | 20 | Centre Hospitalo-Universitaire — university hospital |
+| `eph` | 270 | Établissement Public Hospitalier – public hospital |
+| `epsp` | 292 | Établissement Public de Santé de Proximité – proximity health |
+| `ehs` | 108 | Établissement Hospitalier Spécialisé – specialized hospital |
+| `chu` | 20 | Centre Hospitalo-Universitaire – university hospital |
 | `hopital` | 5 | other public hospital |
 
 **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,
-> so GeoAlgeria derives them — see *Source & method* below. Counts move as the
-> MSP, OpenStreetMap and Wikidata are edited; each rebuild reflects their current
+> wilaya come from the Ministry of Health. The MoH publishes no coordinates,
+> so GeoAlgeria derives them, see *Source & method* below. Counts move as the
+> MoH, OpenStreetMap and Wikidata are edited; each rebuild reflects their current
 > state.
 
 ## Formats
@@ -85,7 +102,7 @@ import sante from "@geoalgeria/sante/data/sante.json" with { type: "json" };
 // https://cdn.jsdelivr.net/npm/@geoalgeria/sante/data/sante.json
 ```
 
-The loaders and record shapes are fully **typed** — TypeScript definitions ship in the package:
+The loaders and record shapes are fully **typed**, TypeScript definitions ship in the package:
 
 ```ts
 import sante, { type HealthEstablishment } from "@geoalgeria/sante";
@@ -98,7 +115,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 +126,46 @@ 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, which lists no private establishment at
+all; the private facilities OpenStreetMap records live in
+[`@geoalgeria/cliniques`](https://www.npmjs.com/package/@geoalgeria/cliniques).
+`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
@@ -150,7 +175,7 @@ are `null` for the 95 records whose locality could not be matched to a commune.
 ## Need the administrative divisions too?
 
 For wilayas, dairas, and communes, use the main
-**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** package — it's how
+**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** package, it's how
 you turn an establishment's `commune_code` into a polygon or centroid. Use
 `@geoalgeria/sante` when you *only* need the health establishments.
 
@@ -158,7 +183,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 +201,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