feat: sync source-backed OSM facility entrances

docs/geocoding_api.md

@@ -21,8 +21,8 @@
 4. **الاستعلامات النسبية (Relative Queries):**
    فهم طبيعة الوصف في الشارع الأردني والعربي. عندما يبحث المستخدم عن `"قرب مستشفى التخصصي"`, يقوم النظام بفلترة كلمة "قرب"، ويبحث عن المستشفى، ويعيد إحداثياته الدقيقة تحت اسم "قرب مستشفى التخصصي".
 
-5. **بوابات المجمعات (POI Gates Clustering):**
-   لا توجيه إلى مراكز المباني بعد اليوم! الأماكن الكبرى مثل المولات تعود بقائمة من البوابات الفعلية (مثال: البوابة الرئيسية، بوابة كارفور) لتوجيه السائق بدقة متناهية.
+5. **مداخل المنشآت (POI Gates):**
+   قد تعود نتيجة المنشأة بمداخل موثقة من عقد OpenStreetMap الفعلية. لا ينشئ النظام بوابات افتراضية؛ وتكون `is_main_gate=true` فقط عندما يوسم المصدر المدخل صراحةً بـ `entrance=main`. راجع [توثيق التغطية والمصدر](PLACE_GATES_COVERAGE_AR.md).
 
 6. **هل تقصد؟ (Safety Net & Spell Checker):**
    محرك تعويض الأخطاء (Fallback). إذا أدخل المستخدم مصطلحاً مستحيلاً وأسفر عن 0 نتائج، يتدخل استعلام `KNN` لاقتراح أقرب مصطلح منطقي أو تصحيحه تلقائياً.
@@ -60,22 +60,22 @@
       "distance_km": "3.50",
       "full_address": "شارع الملك عبدالله، عمان",
       "totalScore": 0.95,
-      "gates": [
-        {
-          "name_ar": "البوابة الرئيسية",
-          "name_en": "Main Gate",
-          "latitude": 31.9806,
-          "longitude": 35.8380,
-          "is_main_gate": true
-        }
-      ]
+      "gates": []
     }
   ],
   "did_you_mean": null
 }
 ```
 
-### 2. الإكمال التلقائي (Autocomplete)
+قد تحتوي النتيجة على `gates` إذا وجدت نقاط أبواب/مداخل موثقة ومطابقة للمنشأة؛ وقد تكون المصفوفة فارغة. لا يدل غيابها على عدم وجود مدخل في الواقع، بل على عدم توفر نقطة مصدر مطابقة.
+
+### 2. مداخل منشأة محددة
+
+**الرابط:** `GET /api/geocoding/places/{placeId}/gates`
+
+يتطلب مفتاح API. يعيد المداخل المسجلة للمعلم، مع الإحداثيات ونوع المدخل ووسوم المصدر ومعرّف عقدة OSM ورابطها وإسناد `© OpenStreetMap contributors`.
+
+### 3. الإكمال التلقائي (Autocomplete)
 مخصص لتقديم اقتراحات سريعة جداً أثناء طباعة المستخدم في مربع البحث.
 
 **الرابط:** `GET /api/geocoding/autocomplete`
@@ -107,8 +107,8 @@
   عبارة عن `Materialized View` في PostgreSQL يجمع بيانات (الأردن، سوريا، مصر، و OpenStreetMap) في جدول واحد سريع جداً.
 - **pg_trgm:**
   تقنية في قاعدة البيانات تستخدم (Trigrams) لتحطيم الكلمات إلى مقاطع من 3 أحرف ومقارنتها بدقة رهيبة للتغلب على الأخطاء الإملائية.
-- **تحديثات شعبية الأماكن (Future Sero Trips Sync):**
-  المحرك مجهز لاستقبال بيانات رحلات السائقين وتحديث نقاط `popularity_score` واستنتاج بوابات المجمعات تلقائياً. 
+- **مداخل المنشآت:**
+  تُحدّث من نقاط OSM الفعلية عند تشغيل مزامنة الخريطة كل عشرة أيام. تحفظ معرّفات المصدر والوسوم الأصلية، ولا تستنتج إحداثيات أو تصنيفات غير موجودة في المصدر. انظر [توثيق التغطية والتشغيل](PLACE_GATES_COVERAGE_AR.md).
 
 ---
-**المستند محدث بتاريخ:** يوليو 2026
+**المستند محدث بتاريخ:** سبتمبر 2026