@geoalgeria/poste 2.1.0 → 2.1.2

package/LICENSE

@@ -1,3 +1,5 @@
+## Code
+
 MIT License
 
 Copyright (c) 2025-2026 Yasser's Studio (https://yasser.studio)
@@ -19,3 +21,9 @@ 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.
+
+## Data
+
+Data © Algérie Poste; redistributed for reference
+
+The underlying data is © Algérie Poste, redistributed for reference and to power GeoAlgeria (https://geoalgeria.com).

package/README.ar.md

@@ -8,7 +8,7 @@
 
 [![npm](https://img.shields.io/npm/v/@geoalgeria/poste)](https://www.npmjs.com/package/@geoalgeria/poste)
 [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/poste)](https://www.npmjs.com/package/@geoalgeria/poste)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Code: MIT](https://img.shields.io/badge/Code-MIT-green.svg)](LICENSE)
 
 </div>
 
@@ -77,9 +77,8 @@ data/
 
 > GeoJSON يتضمن فقط السجلات التي تحتوي على إحداثيات – 16 مكتبًا و5 أجهزة صراف
 > آلي لا تُبلّغ عن `lat`/`lng` وتُحذف منه (لكنها تبقى في JSON/CSV، مع
-> `geo_precision`/`geo_method` بقيمة `null`). سجلات أجهزة الصراف الآلي تحمل
-> `commune_code` بقيمة `null` (واجهة API المصدر لا تحلّ كود بلدية لأجهزة
-> الصراف الآلي).
+> `geo_precision`/`geo_method` بقيمة `null`). يملأ GeoAlgeria حقل
+> `commune_code` لـ90 جهازًا فقط عند تطابق اسم البلدية والولاية الأم وموقع النقطة.
 
 ## أشكال السجلات
 
@@ -115,8 +114,8 @@ GeoAlgeria. عندما ينشر بريد الجزائر قيمة أصلية مخ
 
 **جهاز صراف آلي** – نفس الشكل، مُعرّف بـ `id`/`name`/`wilaya_code`/`postal_code`
 مع `lat`/`lng`، بالإضافة إلى حقل `status` (‏`"OPEN"`، ‏`"CLOSED (OFFLINE)"`، أو
-قيمة المصدر غير الموثقة `"1"`)؛ `commune_code` و`address` تكون دائمًا `null`
-(المصدر لا يحلّهما لأجهزة الصراف الآلي).
+قيمة المصدر غير الموثقة `"1"`)؛ يُملأ `commune_code` في 90 سجلًا مؤكّدًا ويبقى
+`null` في غيرها، بينما يبقى `address` دائمًا `null`.
 
 ## هل تحتاج التقسيمات الإدارية أيضًا؟
 
@@ -132,8 +131,10 @@ GeoAlgeria. عندما ينشر بريد الجزائر قيمة أصلية مخ
 (<https://baridimap.poste.dz>). نفّذ `npm run fetch` لإعادة توليد جميع
 المخرجات من واجهة API المباشرة؛ نفس العملية تعكس البيانات في حزمة `geoalgeria`
 حتى لا يحدث اختلاف بينهما أبدًا (هذه الحزمة هي المصدر المرجعي). أعد التشغيل
-دوريًا – BaridiMap لا يزال يصنف المكاتب وفق نظام 58 ولاية، لذا الولايات
-الجديدة 59–69 تظهر حاليًا تحت ولاياتها الأم.
+دوريًا. لا يزال BaridiMap يصنف بعض السجلات وفق نظام 58 ولاية. يربط GeoAlgeria
+المكاتب عبر `commune_code` المرجعي، ويربط 90 جهاز صراف عندما يتطابق اسم البلدية
+الفرنسي أو العربي الدقيق وعلاقة الولاية الأم والمضلع الوحيد الذي يحتوي النقطة. يحتفظ
+`source_wilaya_code` بقيمة المصدر عند اختلافها.
 
 ## الترخيص والإسناد
 

package/README.fr.md

@@ -8,7 +8,7 @@
 
 [![npm](https://img.shields.io/npm/v/@geoalgeria/poste)](https://www.npmjs.com/package/@geoalgeria/poste)
 [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/poste)](https://www.npmjs.com/package/@geoalgeria/poste)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Code: MIT](https://img.shields.io/badge/Code-MIT-green.svg)](LICENSE)
 
 </div>
 
@@ -77,9 +77,9 @@ data/
 
 > Le GeoJSON n'inclut que les enregistrements ayant des coordonnées – 16
 > bureaux et 5 DAB ne rapportent pas de `lat`/`lng` et en sont absents (mais
-> restent dans JSON/CSV, avec `geo_precision`/`geo_method` à `null`). Les
-> enregistrements de DAB portent `commune_code` à `null` (l'API source ne
-> résout pas de code commune pour les DAB).
+> restent dans JSON/CSV, avec `geo_precision`/`geo_method` à `null`). Pour 90
+> DAB, GeoAlgeria renseigne `commune_code` uniquement lorsque le nom de commune,
+> la wilaya mère et le point concordent.
 
 ## Structure des enregistrements
 
@@ -114,8 +114,8 @@ le bureau n'est pas géocodé) ; `geo_method` indique comment le point a été o
 
 **DAB** – même structure, identifié par `id`/`name`/`wilaya_code`/`postal_code`
 avec `lat`/`lng`, plus un champ `status` (`"OPEN"`, `"CLOSED (OFFLINE)"`, ou la
-valeur source non documentée `"1"`) ; `commune_code` et `address` sont toujours
-`null` (la source ne les résout pas pour les DAB).
+valeur source non documentée `"1"`) ; `commune_code` est renseigné pour 90
+enregistrements corroborés et vaut sinon `null` ; `address` vaut toujours `null`.
 
 ## Besoin des divisions administratives ?
 
@@ -131,9 +131,11 @@ Les données proviennent d'**Algérie Poste** via l'API publique BaridiMap
 (<https://baridimap.poste.dz>). Exécutez `npm run fetch` pour régénérer toutes
 les sorties à partir de l'API en direct ; la même exécution reflète les données
 dans le paquet `geoalgeria` pour que les deux ne divergent jamais (ce paquet est
-la source canonique). Relancez périodiquement – BaridiMap classe toujours les
-bureaux selon le schéma à 58 wilayas, donc les nouvelles wilayas 59–69
-apparaissent actuellement sous leur wilaya mère.
+la source canonique). Relancez périodiquement. BaridiMap classe encore certains
+enregistrements selon le schéma à 58 wilayas. GeoAlgeria rattache les bureaux via
+leur `commune_code` canonique et 90 DAB lorsque le nom français ou arabe exact de la
+commune, la relation avec la wilaya mère et l'unique polygone contenant le point
+concordent. `source_wilaya_code` conserve la valeur fournisseur différente.
 
 ## Licence et attribution
 

package/README.md

@@ -8,7 +8,7 @@
 
 [![npm](https://img.shields.io/npm/v/@geoalgeria/poste)](https://www.npmjs.com/package/@geoalgeria/poste)
 [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/poste)](https://www.npmjs.com/package/@geoalgeria/poste)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Code: MIT](https://img.shields.io/badge/Code-MIT-green.svg)](LICENSE)
 
 </div>
 
@@ -77,8 +77,8 @@ data/
 
 > GeoJSON includes only records that have coordinates, 16 offices and 5 ATMs
 > report no `lat`/`lng` and are omitted there (but remain in JSON/CSV, with
-> `geo_precision`/`geo_method` both `null`). ATM records carry `commune_code`
-> as `null` (the source API doesn't resolve ATMs to a commune code).
+> `geo_precision`/`geo_method` both `null`). For 90 ATMs, GeoAlgeria supplies a
+> `commune_code` only where the commune name, mother wilaya, and point agree.
 
 ## Record shapes
 
@@ -114,8 +114,8 @@ isn't geocoded); `geo_method` names how the point was obtained.
 
 **ATM** – same shape, keyed by `id`/`name`/`wilaya_code`/`postal_code` with
 `lat`/`lng`, plus a `status` field (`"OPEN"`, `"CLOSED (OFFLINE)"`, or the
-undocumented source value `"1"`); `commune_code` and `address` are always
-`null` (the source doesn't resolve them for ATMs).
+undocumented source value `"1"`). `commune_code` is populated for 90
+corroborated records and is otherwise `null`; `address` is always `null`.
 
 ## Need the administrative divisions too?
 
@@ -130,8 +130,11 @@ Data comes from **Algérie Poste** via the public BaridiMap API
 (<https://baridimap.poste.dz>). Run `npm run fetch` to regenerate every output
 from the live API; the same run mirrors the data into the `geoalgeria` package so
 the two never drift (this package is the canonical source). Re-fetch periodically.
-BaridiMap still files offices under the 58-wilaya scheme, so new wilayas 59–69
-currently appear under their mother wilaya.
+BaridiMap still files some records under the 58-wilaya scheme. GeoAlgeria
+reconciles each office through its canonical `commune_code`. It also reconciles
+90 ATMs where the exact French or Arabic commune name, mother-wilaya relationship, and
+sole polygon containment agree. `source_wilaya_code` preserves a differing
+provider value.
 
 ## License & attribution