@geoalgeria/sante 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Yasser's Studio (https://yasser.studio)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ar.md

@@ -0,0 +1,187 @@
+[English](README.md) | [Français](README.fr.md) | **العربية**
+
+<div align="center">
+
+# @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)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+</div>
+
+**695 مؤسسة صحية عمومية** عبر **58 ولاية** لها مديرية للصحة — المؤسسات العمومية
+الاستشفائية (EPH)، ومؤسسات الصحة الجوارية (EPSP)، والمؤسسات الاستشفائية المتخصصة
+(EHS)، والمراكز الاستشفائية الجامعية (CHU) من **وزارة الصحة (MSP)**، ثنائية اللغة
+عربي/فرنسي، **600 منها بإحداثيات** عبر OpenStreetMap وWikidata مع ربطٍ
+بالبلدية والولاية. متوفر بصيغ JSON وCSV وGeoJSON وTypeScript. جزء من
+[GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
+
+```bash
+npm install @geoalgeria/sante
+```
+
+```js
+import sante from "@geoalgeria/sante";
+
+const all = sante.sante();              // 695 مؤسسة
+
+// المستشفيات العمومية في ولاية (ربط بـ wilaya_code في GeoAlgeria)
+const ephAlger = all.filter((e) => e.wilaya_code === "16" && e.type === "eph");
+
+// فقط ما له إحداثيات، جاهز للخريطة
+const mappable = all.filter((e) => e.lat != null);
+```
+
+## ما يمكنك بناؤه
+
+- **أدلّة ومحدّدات مواقع المستشفيات والعيادات** — إحداثيات على 600 من أصل 695
+  سجلًّا، جاهزة للخريطة أو للبحث عن الأقرب.
+- **أدلّة صحية ثنائية اللغة** — أسماء عربية وفرنسية، والنوع الرسمي والولاية لكل
+  مؤسسة.
+- **تحليل التغطية والتخطيط** — حساب المؤسسات حسب النوع لكل بلدية/ولاية عبر البلاد.
+
+## المحتوى
+
+| مجموعة البيانات | العدد | الإحداثيات | ملاحظات |
+| --- | --- | --- | --- |
+| المؤسسات الصحية | **695** | 600 بإحداثيات | 58 ولاية، 563 ثنائية اللغة |
+
+**حسب النوع**
+
+| النوع | العدد | المعنى |
+| --- | --- | --- |
+| `eph` | 270 | المؤسسة العمومية الاستشفائية |
+| `epsp` | 292 | المؤسسة العمومية للصحة الجوارية |
+| `ehs` | 108 | المؤسسة الاستشفائية المتخصصة |
+| `chu` | 20 | المركز الاستشفائي الجامعي |
+| `hopital` | 5 | مستشفى عمومي آخر |
+
+**حسب دقّة الإحداثيات** (`geo_precision`)
+
+| القيمة | العدد | المعنى |
+| --- | --- | --- |
+| `osm_point` | 121 | نقطة دقيقة من مرفق في OpenStreetMap ضمن البلدية |
+| `wikidata_point` | 3 | نقطة دقيقة من مرفق في Wikidata ضمن البلدية |
+| `commune_centroid` | 476 | مركز ثقل بلدية المؤسسة (تقريبي) |
+| `none` | 95 | لم تُربط البلدية — بلا إحداثيات |
+
+> **السجل رسمي؛ أما الإحداثيات فأفضل ما أمكن.** الأسماء والنوع والولاية من وزارة
+> الصحة. لا تنشر الوزارة إحداثيات، فيستنتجها GeoAlgeria (انظر *المصدر والمنهجية*).
+> تتغيّر الأعداد مع تحديثات الوزارة وOpenStreetMap وWikidata.
+
+## الصيغ
+
+تتضمّن حزمة npm ملف **JSON** (قابل للاستيراد مباشرة):
+
+```js
+import sante from "@geoalgeria/sante/data/sante.json" with { type: "json" };
+// أو عبر CDN، دون تثبيت:
+// https://cdn.jsdelivr.net/npm/@geoalgeria/sante/data/sante.json
+```
+
+المُحمِّلات وبنية السجلات **مُوثَّقة الأنواع** بالكامل — تعريفات TypeScript مرفقة في الحزمة:
+
+```ts
+import sante, { type HealthEstablishment } from "@geoalgeria/sante";
+const all: HealthEstablishment[] = sante.sante();
+```
+
+ملفّا **CSV وGeoJSON** موجودان في المستودع ضمن [`data/`](data) ومُرفقان في كل
+[إصدار على GitHub](https://github.com/yasserstudio/geoalgeria/releases):
+
+```
+data/
+  sante.json              # 695 مؤسسة (مصفوفة)
+  metadata.json           # المصادر، الأعداد، التغطية، generated_at
+  csv/sante.csv           # المستودع + الإصدار (ليس في حزمة npm)
+  geojson/sante.geojson   # معالم نقطية (السجلات ذات الإحداثيات)
+```
+
+## بنية السجل
+
+```json
+{
+  "id": "01-ehs-02",
+  "name": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
+  "name_ar": "المؤسسة الاستشفائية المتخصصة في الأمراض العقلية أدرار",
+  "name_fr": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
+  "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
+}
+```
+
+`id` مفتاح ثابت `{wilaya_code}-{type}-{seq}` يولّده GeoAlgeria (لا تنشر الوزارة
+رمزًا). `name` هو الاسم الفرنسي إن وُجد، وإلا العربي. يُشتقّ `type` من العنوان،
+و`wilaya` من وسم الوزارة. `sector` يساوي `"public"` لكامل سجل الوزارة (العيادات
+الخاصة، عند إضافتها، ستحمل `"private"`). يبيّن `source` السجلات المساهِمة، و
+`geo_precision` مصدر الإحداثية. تكون `lat`/`lng` بقيمة `null` للسجلات الـ95 التي
+تعذّر ربط بلديتها.
+
+> **الإحداثيات والبلدية مُستنتَجة وليست من الوزارة.** تَسرد وزارة الصحة الأسماء
+> والنوع والولاية فقط. يربط GeoAlgeria موقع كل مؤسسة ببلدية من مجموعة
+> [`geoalgeria`](https://www.npmjs.com/package/geoalgeria) ضمن ولايتها
+> (`commune` و`commune_code` ومركز ثقل)، ثم يرفع الإحداثية إلى نقطة دقيقة عندما
+> يوجد مستشفى أو عيادة في OpenStreetMap أو Wikidata ضمن البلدية نفسها. الولاية
+> دقيقة؛ أما البلدية والإحداثيات فتقريبية.
+
+## تحتاج التقسيمات الإدارية أيضًا؟
+
+للولايات والدوائر والبلديات، استخدم الحزمة الرئيسية
+**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** — بها تحوّل
+`commune_code` لمؤسسةٍ ما إلى مضلّع أو مركز ثقل. استخدم `@geoalgeria/sante` عندما
+تحتاج المؤسسات الصحية *فقط*.
+
+## المصدر والمنهجية
+
+شغّل `npm run fetch` لإعادة توليد المخرجات. يقوم السكربت بـ:
+
+1. سحب سجل مؤسسات **وزارة الصحة** من واجهة WordPress REST في `sante.gov.dz`
+   (`healthinstitution`)، بالفرنسية والعربية، كلٌّ موسوم بولايته؛
+2. اشتقاق **النوع** من كل عنوان و**مزاوجة** البطاقتين الفرنسية والعربية في سجلٍ
+   ثنائي اللغة؛
+3. ربط **الموقع ببلدية** من مجموعة `geoalgeria` ضمن ولايته (`commune` و
+   `commune_code` ومركز ثقل)؛
+4. استعلام **Wikidata** (SPARQL، المستشفيات) و**OpenStreetMap** (Overpass،
+   `amenity=hospital`/`clinic`، `healthcare=*`) و**رفع** الإحداثية إلى نقطة دقيقة
+   عند وجود واحدة ضمن البلدية.
+
+تُحفظ عمليات السحب الخام ضمن
+[`research/sante/`](https://github.com/yasserstudio/geoalgeria/tree/main/research/sante).
+
+## الترخيص والإسناد
+
+**شيفرة** الحزمة بترخيص [MIT](LICENSE). أما **البيانات** فهي تجميع:
+
+- سجل **وزارة الصحة** (الأسماء والنوع والولاية) قائمة واقعية للقطاع العام.
+- **الإحداثيات** مُستنتَجة من **Wikidata** (**CC0**، ملك عام) ومن
+  **OpenStreetMap** (**© مساهمو OpenStreetMap**، بترخيص
+  **[ODbL 1.0](https://www.openstreetmap.org/copyright)**). عند استخدامك أو إعادة
+  نشرك لهذه البيانات يجب **إسناد الفضل لمساهمي OpenStreetMap** وإبقاء القواعد
+  المُشتقّة تحت ترخيصٍ متوافق.
+
+تحقّق من المصادر الرسمية للمعلومات الموثوقة. تُقدَّم هذه البيانات للمرجعية ولتشغيل
+[GeoAlgeria](https://geoalgeria.com).
+
+[توثيق API والحقول →](https://geoalgeria.com/data/docs/sante) · [تصفّح كل الحزم →](https://geoalgeria.com/data)
+
+---
+
+من إنجاز [Yasser's Studio](https://yasser.studio) · [LinkedIn](https://www.linkedin.com/in/yasserberrehail/) · [X](https://x.com/yassersstudio) · [hello@yasser.studio](mailto:hello@yasser.studio)

package/README.fr.md

@@ -0,0 +1,198 @@
+[English](README.md) | **Français** | [العربية](README.ar.md)
+
+<div align="center">
+
+# @geoalgeria/sante
+
+**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)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+</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
+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.
+Livré en JSON, CSV, GeoJSON et TypeScript. Fait partie de
+[GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
+
+```bash
+npm install @geoalgeria/sante
+```
+
+```js
+import sante from "@geoalgeria/sante";
+
+const all = sante.sante();              // 695 établissements
+
+// Hôpitaux publics d'une wilaya (jointure sur le wilaya_code de GeoAlgeria)
+const ephAlger = all.filter((e) => e.wilaya_code === "16" && e.type === "eph");
+
+// Uniquement les géolocalisés, prêts pour une carte
+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
+  enregistrements, prêtes pour une carte ou une recherche de proximité.
+- **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
+  par commune/wilaya sur tout le pays.
+
+## Contenu
+
+| Jeu de données | Nombre | Coordonnées | Notes |
+| --- | --- | --- | --- |
+| Établissements de santé | **695** | 600 géolocalisés | 58 wilayas, 563 bilingues |
+
+**Par type**
+
+| Type | Nombre | Signification |
+| --- | --- | --- |
+| `eph` | 270 | Établissement Public Hospitalier |
+| `epsp` | 292 | Établissement Public de Santé de Proximité |
+| `ehs` | 108 | Établissement Hospitalier Spécialisé |
+| `chu` | 20 | Centre Hospitalo-Universitaire |
+| `hopital` | 5 | autre hôpital public |
+
+**Par précision des coordonnées** (`geo_precision`)
+
+| 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 |
+
+> **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
+> coordonnées : GeoAlgeria les dérive (voir *Source & méthode*). Les totaux
+> évoluent au gré des mises à jour du MSP, d'OpenStreetMap et de Wikidata.
+
+## Formats
+
+Le paquet npm fournit le **JSON** (importable directement) :
+
+```js
+import sante from "@geoalgeria/sante/data/sante.json" with { type: "json" };
+// ou via CDN, sans installation :
+// 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 :
+
+```ts
+import sante, { type HealthEstablishment } from "@geoalgeria/sante";
+const all: HealthEstablishment[] = sante.sante();
+```
+
+Les **CSV et GeoJSON** sont dans le dépôt sous [`data/`](data) et inclus dans
+chaque [GitHub Release](https://github.com/yasserstudio/geoalgeria/releases) :
+
+```
+data/
+  sante.json              # 695 établissements (tableau)
+  metadata.json           # sources, totaux, couverture, generated_at
+  csv/sante.csv           # dépôt + Release (pas dans le tarball npm)
+  geojson/sante.geojson   # entités Point (enregistrements géolocalisés)
+```
+
+## Structure d'un enregistrement
+
+```json
+{
+  "id": "01-ehs-02",
+  "name": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
+  "name_ar": "المؤسسة الاستشفائية المتخصصة في الأمراض العقلية أدرار",
+  "name_fr": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
+  "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
+}
+```
+
+`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.
+
+> **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
+> localité de chaque établissement à une commune du jeu
+> [`geoalgeria`](https://www.npmjs.com/package/geoalgeria) dans sa wilaya
+> (`commune`, `commune_code` et un centroïde), puis remplace la coordonnée par un
+> point précis lorsqu'un hôpital ou une clinique d'OpenStreetMap ou de Wikidata
+> se trouve dans la même commune. La wilaya est exacte ; la commune et les
+> coordonnées sont approximatives.
+
+## 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
+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é.
+
+## Source & méthode
+
+Lancez `npm run fetch` pour régénérer les sorties. Le script :
+
+1. récupère le registre des établissements du **Ministère de la Santé** depuis
+   l'API REST WordPress de `sante.gov.dz` (`healthinstitution`), en français et
+   en arabe, chacun étiqueté par sa wilaya ;
+2. déduit le **type** de chaque titre et **apparie** les fiches française et
+   arabe en un enregistrement bilingue ;
+3. rattache la **localité à une commune** du jeu `geoalgeria` dans sa wilaya
+   (`commune`, `commune_code` et un centroïde) ;
+4. interroge **Wikidata** (SPARQL, hôpitaux) et **OpenStreetMap** (Overpass,
+   `amenity=hospital`/`clinic`, `healthcare=*`) et **remplace** la coordonnée par
+   un point précis lorsqu'il s'en trouve un dans la commune.
+
+Les extractions brutes sont mises en cache sous
+[`research/sante/`](https://github.com/yasserstudio/geoalgeria/tree/main/research/sante).
+
+## Licence & attribution
+
+Le **code** du paquet est sous [MIT](LICENSE). Les **données** sont un composite :
+
+- Le registre du **Ministère de la Santé** (noms, type, wilaya) est une liste
+  factuelle du secteur public.
+- Les **coordonnées** sont dérivées de **Wikidata** (**CC0**, domaine public) et
+  d'**OpenStreetMap** (**© les contributeurs d'OpenStreetMap**, sous licence
+  **[ODbL 1.0](https://www.openstreetmap.org/copyright)**). Si vous utilisez ou
+  redistribuez ce jeu de données, vous devez **attribuer aux contributeurs
+  d'OpenStreetMap** et conserver les bases dérivées sous une licence compatible.
+
+Vérifiez auprès des sources officielles pour toute information faisant foi. Ce jeu
+de données est fourni à titre de référence et pour alimenter
+[GeoAlgeria](https://geoalgeria.com).
+
+[Docs API & champs →](https://geoalgeria.com/data/docs/sante) · [Tous les paquets →](https://geoalgeria.com/data)
+
+---
+
+Réalisé par [Yasser's Studio](https://yasser.studio) · [LinkedIn](https://www.linkedin.com/in/yasserberrehail/) · [X](https://x.com/yassersstudio) · [hello@yasser.studio](mailto:hello@yasser.studio)

package/README.md

@@ -0,0 +1,194 @@
+**English** | [Français](README.fr.md) | [العربية](README.ar.md)
+
+<div align="center">
+
+# @geoalgeria/sante
+
+**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)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+</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
+TypeScript. Part of [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
+
+```bash
+npm install @geoalgeria/sante
+```
+
+```js
+import sante from "@geoalgeria/sante";
+
+const all = sante.sante();              // 695 establishments
+
+// Public hospitals in a wilaya (joins GeoAlgeria's wilaya_code)
+const ephAlger = all.filter((e) => e.wilaya_code === "16" && e.type === "eph");
+
+// Only the geocoded ones, ready to map
+const mappable = all.filter((e) => e.lat != null);
+```
+
+## What you can build
+
+- **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
+  wilaya for every establishment.
+- **Coverage & planning analysis** — count establishments by type per
+  commune/wilaya across the whole country.
+
+## What's inside
+
+| Dataset | Count | Coordinates | Notes |
+| --- | --- | --- | --- |
+| Health establishments | **695** | 600 geocoded | 58 wilayas, 563 bilingual |
+
+**By type**
+
+| 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 |
+| `hopital` | 5 | other public hospital |
+
+**By coordinate precision** (`geo_precision`)
+
+| 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 |
+
+> **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
+> state.
+
+## Formats
+
+The npm package ships the **JSON** (importable directly):
+
+```js
+import sante from "@geoalgeria/sante/data/sante.json" with { type: "json" };
+// or via CDN, no install:
+// https://cdn.jsdelivr.net/npm/@geoalgeria/sante/data/sante.json
+```
+
+The loaders and record shapes are fully **typed** — TypeScript definitions ship in the package:
+
+```ts
+import sante, { type HealthEstablishment } from "@geoalgeria/sante";
+const all: HealthEstablishment[] = sante.sante();
+```
+
+**CSV and GeoJSON** are in the repo under [`data/`](data) and bundled in every
+[GitHub Release](https://github.com/yasserstudio/geoalgeria/releases):
+
+```
+data/
+  sante.json              # 695 establishments (array)
+  metadata.json           # sources, counts, coverage, generated_at
+  csv/sante.csv           # repo + Release bundle (not in npm tarball)
+  geojson/sante.geojson   # Point features (geocoded records only)
+```
+
+## Record shape
+
+```json
+{
+  "id": "01-ehs-02",
+  "name": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
+  "name_ar": "المؤسسة الاستشفائية المتخصصة في الأمراض العقلية أدرار",
+  "name_fr": "Etablissement Hospitalier Spécialisé Psychiatrie Adrar",
+  "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
+}
+```
+
+`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
+> 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
+> or clinic in OpenStreetMap or Wikidata sits in that same commune. Wilaya is
+> exact; commune and coordinates are best-effort.
+
+## Need the administrative divisions too?
+
+For wilayas, dairas, and communes, use the main
+**[`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.
+
+## Source & method
+
+Run `npm run fetch` to regenerate every output. It:
+
+1. pulls the **Ministère de la Santé** 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
+   into one bilingual record;
+3. matches each establishment's **locality to a commune** in the `geoalgeria`
+   set within its wilaya, attaching `commune`, `commune_code` and a centroid;
+4. queries **Wikidata** (SPARQL, hospitals) and **OpenStreetMap** (Overpass,
+   `amenity=hospital`/`clinic`, `healthcare=*`) and **upgrades** the coordinate
+   to a precise point where one sits in the establishment's commune.
+
+Raw source pulls are cached under
+[`research/sante/`](https://github.com/yasserstudio/geoalgeria/tree/main/research/sante).
+
+## License & attribution
+
+Package **code** is [MIT](LICENSE). The **data** is a composite:
+
+- The **Ministère de la Santé** 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
+  **[ODbL 1.0](https://www.openstreetmap.org/copyright)**). If you use or
+  redistribute this dataset, you must **attribute OpenStreetMap contributors**
+  and keep derived databases under a compatible license.
+
+Verify against official sources for authoritative information. This dataset is
+provided for reference and to power [GeoAlgeria](https://geoalgeria.com).
+
+[API docs & field reference →](https://geoalgeria.com/data/docs/sante) · [Browse all packages →](https://geoalgeria.com/data)
+
+---
+
+Made by [Yasser's Studio](https://yasser.studio) · [LinkedIn](https://www.linkedin.com/in/yasserberrehail/) · [X](https://x.com/yassersstudio) · [hello@yasser.studio](mailto:hello@yasser.studio)