@geoalgeria/sante 1.0.0 → 2.0.0

package/dataset-metadata.json

@@ -0,0 +1,52 @@
+{
+  "@context": "https://schema.org",
+  "@type": "Dataset",
+  "name": "Algeria public health establishments",
+  "alternateName": "Établissements de santé publique d'Algérie",
+  "identifier": "@geoalgeria/sante",
+  "description": "Public health establishments (EPH/EPSP/EHS/CHU) from the Ministry of Health registry. Coordinates layered on via OSM/Wikidata; where no point was found the commune centroid is used (approximate) and 95 remain ungeocoded.",
+  "conditionsOfAccess": "Official registry (Ministry of Health); geocoding ODbL/CC0",
+  "isAccessibleForFree": true,
+  "creator": {
+    "@type": "Organization",
+    "name": "Yasser's Studio",
+    "url": "https://yasser.studio"
+  },
+  "spatialCoverage": {
+    "@type": "Place",
+    "name": "Algeria",
+    "geo": {
+      "@type": "GeoShape",
+      "box": "19.573539 -8.140085 37.0072 9.635"
+    }
+  },
+  "variableMeasured": "695 records, 58 wilayas",
+  "distribution": [
+    {
+      "@type": "DataDownload",
+      "name": "sante (JSON)",
+      "encodingFormat": "application/json",
+      "contentUrl": "https://cdn.jsdelivr.net/npm/@geoalgeria/sante/data/sante.json"
+    },
+    {
+      "@type": "DataDownload",
+      "name": "sante (CSV)",
+      "encodingFormat": "text/csv",
+      "contentUrl": "https://cdn.jsdelivr.net/npm/@geoalgeria/sante/data/csv/sante.csv"
+    },
+    {
+      "@type": "DataDownload",
+      "name": "sante (GeoJSON)",
+      "encodingFormat": "application/geo+json",
+      "contentUrl": "https://cdn.jsdelivr.net/npm/@geoalgeria/sante/data/geojson/sante.geojson"
+    }
+  ],
+  "dateModified": "2026-06-27",
+  "url": "https://geoalgeria.com",
+  "sameAs": "https://github.com/yasserstudio/geoalgeria",
+  "citation": [
+    "Ministry of Health (sante.gov.dz) — health-establishment registry — Official public registry (Ministry of Health)",
+    "OpenStreetMap — geocoding — ODbL 1.0 (© OpenStreetMap contributors)",
+    "Wikidata — geocoding — CC0-1.0"
+  ]
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@geoalgeria/sante",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "type": "module",
-  "description": "Public health establishments of Algeria — hospitals (EPH), proximity health (EPSP), specialized hospitals (EHS) and university hospitals (CHU) from the Ministère de la Santé, bilingual FR/AR, geocoded via OpenStreetMap & Wikidata, with commune/wilaya linkage. JSON, CSV, GeoJSON, TypeScript.",
+  "description": "Public health establishments of Algeria — hospitals (EPH), proximity health (EPSP), specialized hospitals (EHS) and university hospitals (CHU) from the Ministry of Health, bilingual FR/AR, geocoded via OpenStreetMap & Wikidata, with commune/wilaya linkage. JSON, CSV, GeoJSON, TypeScript.",
   "main": "index.js",
   "types": "types/index.d.ts",
   "exports": {
@@ -13,6 +13,7 @@
     "./data/*": "./data/*"
   },
   "files": [
+    "dataset-metadata.json",
     "data/**/*.json",
     "data/**/*.csv",
     "data/**/*.geojson",

package/types/index.d.ts

@@ -1,89 +1,117 @@
-// Type definitions for @geoalgeria/sante
-// Public health establishments of Algeria — the Ministère de la Santé (MSP)
+// Type definitions for @geoalgeria/sante (schema v2).
+// Public health establishments of Algeria — the Ministry of Health (MoH)
 // registry, geocoded via OpenStreetMap (ODbL) and Wikidata (CC0).
+// Records follow the canonical GeoRecord contract from @geoalgeria/schema
+// (zero-padded string wilaya_code, string ONS commune_code, geo_precision/
+// geo_method/source/refs) plus the health-specific fields below.
 
 /** Establishment category. */
 export type HealthType = "eph" | "epsp" | "ehs" | "chu" | "clinique" | "hopital";
 
-/** Ownership sector. The MSP registry is public; private clinics carry "private". */
+/** Ownership sector. The MoH registry is public; private clinics carry "private". */
 export type HealthSector = "public" | "private";
 
-/** Where the record's identity came from, plus which geo sources contributed a precise point. */
-export type HealthSource =
-  | "msp"
-  | "msp+osm"
-  | "msp+wikidata"
-  | "msp+osm+wikidata";
+/** Coordinate provenance, coarse-grained. Detail lives in `geo_method`.
+ *  `null` when the establishment has no coordinate at all. */
+export type GeoPrecision = "exact" | "approximate" | null;
 
-/** How the coordinates were obtained. */
-export type GeoPrecision =
-  | "osm_point"
-  | "wikidata_point"
-  | "commune_centroid"
-  | "none";
+/** How the coordinate was obtained. `null` on an ungeocoded record — no method
+ *  produced a point, so none can be named. */
+export type GeoMethod = "osm_point" | "wikidata_point" | "commune_centroid" | null;
+
+/** External identifiers keyed by source system. */
+export interface Refs {
+  /** MoH post id on sante.gov.dz. */
+  msp: string;
+  /** OSM element id (e.g. "way/432370657") when an OSM facility matched. */
+  osm?: string;
+  /** Wikidata QID when a Wikidata facility matched. */
+  wikidata?: string;
+}
 
 /** A public health establishment. */
 export interface HealthEstablishment {
-  /** Stable id, `{wilaya_code}-{type}-{seq}` (e.g. "22-eph-01"). */
+  /** Stable id, `{wilaya_code}-{type}-{seq}` (e.g. "22-eph-01"). Unique within this dataset. */
   id: string;
   /** Best available display name (French preferred, else Arabic). */
   name: string;
-  /** Arabic name, or null. */
-  name_ar: string | null;
   /** French name, or null. */
   name_fr: string | null;
-  /** Establishment category. */
-  type: HealthType;
-  /** Canonical French label for the type. */
-  type_label_fr: string;
-  /** Canonical Arabic label for the type. */
-  type_label_ar: string;
-  /** Ownership sector ("public" for the MSP registry). */
-  sector: HealthSector;
-  /** Wilaya name (French). */
-  wilaya: string;
-  /** Wilaya name (Arabic). */
-  wilaya_ar: string;
-  /** Wilaya code as a zero-padded string ("01".."69"). */
+  /** Arabic name, or null. */
+  name_ar: string | null;
+  /** Wilaya code, zero-padded 2-digit string ("01".."69"). */
   wilaya_code: string;
+  /** Commune (ONS) code as a 4-digit string, best-effort. Null when unresolved. */
+  commune_code: string | null;
   /** Commune name (French), best-effort from the establishment locality. Null when unresolved. */
   commune: string | null;
-  /** Commune code (geoalgeria code_commune), best-effort. Null when unresolved. */
-  commune_code: number | null;
   /** Latitude, or null when the establishment could not be geocoded. */
   lat: number | null;
-  /** Longitude, or null when the establishment could not be geocoded. */
+  /** Longitude, or null. Both coordinates are set, or both are null. */
   lng: number | null;
-  /** Provenance: MSP registry, plus OSM/Wikidata where a precise point matched. */
-  source: HealthSource;
-  /** How `lat`/`lng` were obtained. */
+  /** "exact" for an OSM/Wikidata point, "approximate" for a commune centroid,
+   *  `null` when `lat`/`lng` are null — a record with no point asserts no precision. */
   geo_precision: GeoPrecision;
-  /** Wikidata QID when a Wikidata facility matched, else null. */
-  wikidata: string | null;
-  /** OSM element id (e.g. "node/123") when an OSM facility matched, else null. */
-  osm_id: string | null;
-  /** Source post id on sante.gov.dz (French post preferred). */
-  msp_id: number;
+  /** How `lat`/`lng` were obtained; null when there are none. */
+  geo_method: GeoMethod;
+  /** Provenance key into `metadata.sources[]` — always "msp" (the MoH registry).
+   *  The geocoding sources are named per record in {@link HealthEstablishment.refs}. */
+  source: "msp";
+  /** External identifiers: always the MoH post id, plus OSM/Wikidata where matched. */
+  refs: Refs;
+  /** Establishment category. */
+  type: HealthType;
+  /** Canonical French label for the type. */
+  type_label_fr: string;
+  /** Canonical Arabic label for the type. */
+  type_label_ar: string;
+  /** Ownership sector ("public" for the MoH registry). */
+  sector: HealthSector;
   /** URL slug of the source post (French post preferred). */
   slug: string;
 }
 
-/** Dataset metadata (data/metadata.json). */
-export interface Metadata {
-  source: string;
-  origin: string;
+/** One provenance entry in `metadata.sources[]`. */
+export interface SourceRef {
+  key: string;
+  name: string;
+  url?: string;
   license: string;
-  sante: number;
-  by_type: Record<HealthType, number>;
-  by_sector: Record<HealthSector, number>;
-  by_geo_precision: Record<GeoPrecision, number>;
+  retrieved?: string;
+  evidence_type?: "official" | "crowdsourced" | "derived";
+}
+
+/** Dataset metadata (data/metadata.json) — canonical fields plus health stats. */
+export interface Metadata {
+  package: "@geoalgeria/sante";
+  schema_version: string;
+  title_fr: string;
+  title_ar: string;
+  title_en: string;
+  record_count: number;
+  /** Records with coordinates. */
+  geocoded_count: number;
+  geocoded_pct: number;
+  /** Count by `geo_precision` among geocoded records; ungeocoded records carry none. */
+  precision: { exact: number; approximate: number };
+  estimated_universe: number | null;
+  coverage_pct: number | null;
+  coverage_note: string;
   wilayas_covered: number;
-  geocoded: number;
+  /** `[minLng, minLat, maxLng, maxLat]`, or null when nothing is geocoded. */
+  bbox: [number, number, number, number] | null;
+  sources: SourceRef[];
+  license: string;
+  /** ISO date (YYYY-MM-DD) the dataset was regenerated. */
+  updated: string;
+  /** Count by type; categories with no records are absent. */
+  by_type: Partial<Record<HealthType, number>>;
+  /** Count by sector; the MoH registry is public-only today. */
+  by_sector: Partial<Record<HealthSector, number>>;
+  /** Count by `geo_method`; ungeocoded records are absent (they have no method). */
+  by_geo_method: Partial<Record<Exclude<GeoMethod, null>, number>>;
   bilingual: number;
   linkage_note: string;
-  coverage_note: string;
-  /** ISO date (YYYY-MM-DD) the snapshot was generated. */
-  generated_at: string;
 }
 
 /** All public health establishments. */