{"name":"Atlas API - أطلس جدة","tagline":"الواجهة البرمجية لمنصة استكشاف أحياء ومعالم ومؤشرات مدينة جدة","description":"الواجهة البرمجية (Backend) المعتمدة لمنصة أطلس؛ توفر خدمات البيانات الجغرافية، إدارة الأحياء، تصنيف المعالم والأنشطة، المؤشرات الإحصائية والمشاريع التنموية، مع دعم كامل للوحة التحكم الإدارية وخرائط MapLibre التفاعلية.","version":"1.0.0","status":"active","environment":"production","serverTime":"2026-10-18T12:48:09.307Z","uptimeSeconds":5086,"baseUrl":"https://apis-atlas.tadbeer.sa","stack":[{"name":"Node.js","role":"Runtime Environment","icon":"🟢"},{"name":"Express.js","role":"RESTful Web Framework","icon":"⚡"},{"name":"MongoDB & Mongoose","role":"Database & ODM","icon":"🍃"},{"name":"JWT & Bcrypt","role":"Authentication & Security","icon":"🔐"},{"name":"Multer","role":"Media & File Storage","icon":"📁"},{"name":"Memory Caching","role":"High-Performance Read Cache","icon":"🚀"}],"features":[{"title":"استعراض بيانات الأحياء","desc":"قراءة وإدارة حدود وبيانات أحياء جدة السكنية والتجارية ومؤشراتها."},{"title":"المعالم والخرائط التفاعلية","desc":"دعم نقاط الخريطة (MapLibre GL) وتصنيف الأماكن مع إحداثيات دقيقة."},{"title":"المؤشرات الإحصائية التنموية","desc":"بيانات حيوية تشمل السكان، الفعاليات، السياحة، والقوة الشرائية."},{"title":"المشاريع الحكومية الكبرى","desc":"متابعة وعرض المشاريع التنموية والتحول الحضري في جدة."},{"title":"لوحة تحكم إدارية مؤمنة","desc":"إمكانية إضافة وتحديث وحذف العناصر مع مصادقة JWT للمشرفين."},{"title":"طبقة كاش فائقة السرعة","desc":"تخزين مؤقت لعمليات القراءة مع إفراغ تلقائي عند أي تحديث."}],"endpointsList":[{"method":"GET","path":"/","scope":"public","tag":"عام","desc":"المسار التعريفي ومعلومات النظام المباشرة"},{"method":"GET","path":"/health","scope":"public","tag":"عام","desc":"فحص جاهزية الخادم وحالته ومعدل الـ Uptime"},{"method":"GET","path":"/api/info","scope":"public","tag":"عام","desc":"بيانات الـ API الكاملة بصيغة JSON"},{"method":"POST","path":"/api/auth/login","scope":"public","tag":"المصادقة","desc":"تسجيل دخول المشرف واستلام رمز JWT"},{"method":"GET","path":"/api/auth/me","scope":"admin","tag":"المصادقة","desc":"التحقق من جلسة المشرف الحالي وصلاحياته"},{"method":"GET","path":"/api/districts","scope":"public","tag":"الأحياء","desc":"قائمة أحياء جدة بكامل التفاصيل والمؤشرات"},{"method":"GET","path":"/api/districts/:id","scope":"public","tag":"الأحياء","desc":"تفاصيل حي محدد بواسطة المعرف"},{"method":"POST","path":"/api/districts","scope":"admin","tag":"الأحياء","desc":"إضافة حي جديد إلى النظام (أدمن)"},{"method":"PUT","path":"/api/districts/:id","scope":"admin","tag":"الأحياء","desc":"تحديث بيانات حي موجود (أدمن)"},{"method":"DELETE","path":"/api/districts/:id","scope":"admin","tag":"الأحياء","desc":"حذف حي من النظام (أدمن)"},{"method":"GET","path":"/api/categories","scope":"public","tag":"الفئات","desc":"استعراض تصنيفات المعالم (مطاعم، فنادق، تسوق...)"},{"method":"GET","path":"/api/categories/:key","scope":"public","tag":"الفئات","desc":"استرجاع بيانات فئة محددة عبر المفتاح"},{"method":"POST","path":"/api/categories","scope":"admin","tag":"الفئات","desc":"إنشاء تصنيف جديد (أدمن)"},{"method":"PUT","path":"/api/categories/:id","scope":"admin","tag":"الفئات","desc":"تعديل تصنيف موجود (أدمن)"},{"method":"DELETE","path":"/api/categories/:id","scope":"admin","tag":"الفئات","desc":"حذف تصنيف (أدمن)"},{"method":"GET","path":"/api/items","scope":"public","tag":"المعالم","desc":"استعراض المعالم والخدمات مع دعم الفلاتر والبحث"},{"method":"GET","path":"/api/items/:id","scope":"public","tag":"المعالم","desc":"استرجاع تفاصيل معلم أو نشاط محدد"},{"method":"POST","path":"/api/items","scope":"admin","tag":"المعالم","desc":"إضافة معلم أو نشاط جديد (أدمن)"},{"method":"PUT","path":"/api/items/:id","scope":"admin","tag":"المعالم","desc":"تحديث بيانات معلم (أدمن)"},{"method":"DELETE","path":"/api/items/:id","scope":"admin","tag":"المعالم","desc":"حذف معلم (أدمن)"},{"method":"GET","path":"/api/markers","scope":"public","tag":"الخريطة","desc":"نقاط الخريطة الجغرافية التفاعلية مع الإحداثيات"},{"method":"GET","path":"/api/atlas","scope":"public","tag":"أطلس","desc":"كل الإحصائيات والمشاريع التنموية في رد موحد"},{"method":"GET","path":"/api/atlas/projects","scope":"public","tag":"أطلس","desc":"قائمة المشاريع الحكومية الكبرى"},{"method":"GET","path":"/api/atlas/statistics","scope":"public","tag":"أطلس","desc":"المؤشرات الإحصائية الرسمية"},{"method":"GET","path":"/api/atlas/population","scope":"public","tag":"أطلس","desc":"إحصاءات الكثافة والتركيبة السكانية"},{"method":"GET","path":"/api/atlas/events","scope":"public","tag":"أطلس","desc":"مؤشرات الفعاليات والمواسم"},{"method":"GET","path":"/api/atlas/tourism","scope":"public","tag":"أطلس","desc":"مؤشرات وحركة السياحة"},{"method":"GET","path":"/api/atlas/purchasing-power","scope":"public","tag":"أطلس","desc":"مؤشرات القوة الشرائية والإنفاق"},{"method":"GET","path":"/api/atlas/economic","scope":"public","tag":"أطلس","desc":"المؤشرات والبيانات الاقتصادية"},{"method":"GET","path":"/api/overview/stats","scope":"public","tag":"الإحصائيات","desc":"كروت الأرقام والإحصائيات التلخيصية للرئيسية"},{"method":"GET","path":"/uploads/:filename","scope":"public","tag":"الوسائط","desc":"خدمة ملفات الوسائط والصور المرفوعة"}]}