مفتوح المصدر · ترخيص MIT · استضافة ذاتية عبر Docker

برنامج خرائط داخلية مفتوح المصدر تستضيفه على خوادمك

يتوفر Spatial Map أيضًا بوصفه برنامج خرائط داخلية مفتوح المصدر. المحرّر نفسه والعارض ثلاثي الأبعاد نفسه اللذان يعملان على app.spatialmap.io منشوران على GitHub بترخيص MIT: انسخ المستودع، وأضف رمز Mapbox مجانيًا، وشغّله على خادمك عبر Docker Compose. حوّل مخططات PDF وDWG إلى خرائط داخلية متعددة الطوابق، واربطها ببياناتك، وابنِ التقارير — من دون خطط ولا حدود.

نجوم GitHub لمستودع Siraj-zaki/spatial-map

آخر تحديث:

دون بطاقة ائتمان. يعمل في المتصفح. خطة Pro بسعر 60 دولارًا شهريًا لما يصل إلى 4 منشآت. احجز عرضًا توضيحيًا

Crestline Fulfillment Center (مركز تنفيذ طلبات) في عارض Spatial Map ثلاثي الأبعاد مع مؤشرات الأجهزة الحيّة
Crestline Fulfillment Center
مركز Crestline Fulfillment من العرض التوضيحي السحابي. الإصدار مفتوح المصدر هو المحرّر والعارض نفسيهما، على خوادمك أنت.
الترخيص — استخدام وتعديل وإعادة توزيع
MIT
docker compose up -d
أمر واحد
لغات للواجهة، منها العربية من اليمين إلى اليسار
6
تقريرًا جاهزًا في مساحة العمل التجريبية المرفقة
84

ما هو الإصدار مفتوح المصدر

إنه تطبيق Spatial Map نفسه وليس نموذجًا مصغّرًا: تطبيق React وTypeScript على Mapbox GL، وواجهة برمجية بلغة Go، وPostgreSQL مع PostGIS، وMinIO للملفات، وRedis — في مشروع Docker Compose واحد. عند الاستضافة الذاتية تكون كل الميزات مفعّلة: لا خطط ولا حدود لعدد المنشآت ولا فوترة.

تختاره الفرق عندما يجب أن تبقى البيانات داخل شبكتها، أو عندما تريد تعديل الشيفرة، أو تقييم حل خرائط داخلية بعمق قبل الشراء. وإن لم تكن ترغب في تشغيل الخوادم، فإن الإصدار السحابي هو المنتج نفسه وندير تشغيله نيابةً عنك.

  • محرّر المنشآت — استيراد مخططات PDF وDWG والصور، ورسم المساحات والجدران والأبواب والسلالم والمصاعد والرفوف والعلامات والنماذج ثلاثية الأبعاد.
  • عارض ثلاثي الأبعاد حي — كل طابق ورف ومساحة على خريطة حقيقية، ملوّنة وفق قواعدك، مع روابط مشاركة للقراءة فقط.
  • الجداول وروابط البيانات — جداول مدمجة مع استيراد CSV/XLSX وواجهة REST لكل جدول، وروابط بيانات تربط كل صف بشكل على الخريطة بالاسم أو الرمز أو الإحداثيات.
  • التقارير ولوحات المتابعة — منشئ تقارير بمؤشرات ورسوم بيانية وجداول ومرشّحات، وتخطيط خريطة كاملة يتحدّث تلقائيًا.
  • مساحات العمل والأدوار — مالك ومسؤول ومحرّر ومشاهد؛ ست لغات وسمة فاتحة وداكنة.

ما الذي تتولاه عند الاستضافة الذاتية

بعض المهام يتولاها الإصدار السحابي عنك. لا شيء منها غير مألوف في تطبيقات Docker:

  • رمز وصول Mapbox (لدى Mapbox فئة مجانية) للخريطة الأساسية والعرض ثلاثي الأبعاد.
  • خادم SMTP لرموز التسجيل وإعادة تعيين كلمة المرور — وإلى حين ضبطه تظهر الرموز في سجل الواجهة البرمجية.
  • وكيل عكسي مع TLS (Caddy أو nginx أو Traefik) أمام المنفذ 3000، وأسرار حقيقية: مع SPATIAL_MAP_MODE=production يرفض التطبيق العمل بقيم افتراضية.
  • النسخ الاحتياطي والتحديثات لقاعدة البيانات وتخزين الملفات؛ تصدر الإصدارات الجديدة على GitHub.

الترخيص والتوثيق والمساهمة

الشيفرة مرخّصة بترخيص MIT: يمكنك استخدامها تجاريًا وتعديلها وإعادة توزيعها مع الإبقاء على نص الترخيص. النماذج ثلاثية الأبعاد المرفقة مرخّصة بـ CC BY 4.0 وتتطلب نسبتها إلى أصحابها؛ بيانات الخرائط © Mapbox و© مساهمو OpenStreetMap.

أدلة الاستخدام على spatialmap.io/docs (بالإنجليزية) تصف الإصدار السحابي وتنطبق كذلك على الإصدار المستضاف ذاتيًا. البلاغات وطلبات الدمج مرحّب بها على GitHub.

الإصدار مفتوح المصدر مقابل الإصدار السحابي

المحرّر والعارض وروابط البيانات والتقارير نفسها. الفرق هو من يتولى التشغيل.

مفتوح المصدر (استضافة ذاتية)سحابي (spatialmap.io)
الترخيص والسعرMIT، مجانيتجربة مجانية 7 أيام، ثم Pro بسعر 60 دولارًا شهريًا أو 600 دولار سنويًا
الحدودلا حدود — كل الميزات مفعّلةتغطي خطة Pro حتى 4 منشآت لكل مساحة عمل
التشغيلخوادمك أو حسابك السحابي، عبر Docker Composeمُدار على app.spatialmap.io
Mapbox والبريدرمز Mapbox وخادم SMTP خاصّان بكمشمولان
التحديثات والنسخ الاحتياطيتتولاها أنت؛ الإصدارات على GitHubنتولاها نحن
أداة المخططات بالذكاء الاصطناعيعامل اختياري (docker compose --profile ai) يقترح الغرف والجدران للمراجعةقريبًا
المساعدةبلاغات وطلبات دمج على GitHubدعم بالبريد وخدمات مخصّصة

بدء سريع عبر Docker

تحتاج إلى Docker مع Compose بالإصدار 2.20 أو أحدث، ورمز وصول Mapbox مجاني.

bash·Terminal
git clone https://github.com/Siraj-zaki/spatial-map.git
cd spatial-map
cp .env.example .env          # set VITE_MAPBOX_ACCESS_TOKEN=pk....
docker compose up -d          # first run builds the images (a few minutes)

# open http://localhost:3000 and sign up; without SMTP the code is in the API log:
docker compose logs api | grep -i "verification code"

شغّل docker compose pull قبل up لاستخدام الصور المنشورة بدلًا من البناء محليًا. كل الخيارات موثّقة في .env.example.

كيف يعمل Spatial Map

من نسخ المستودع إلى خريطة داخلية حيّة في أربع خطوات

  1. 01

    احصل على رمز Mapbox

    أنشئ رمزًا عامًا مجانيًا في حساب Mapbox وضعه في ملف .env.

  2. 02

    شغّل الحزمة

    نفّذ docker compose up -d؛ يستغرق البناء الأول بضع دقائق. افتح المنفذ 3000 وأنشئ حسابًا.

  3. 03

    ارسم المبنى

    افتح مساحة العمل التجريبية، أو أنشئ منشأة واستورد مخطط PDF أو DWG وارسمه ثلاثي الأبعاد.

  4. 04

    أرسل بياناتك

    أرسل الصفوف إلى واجهة REST الخاصة بالجدول برمز Bearer، واربط الجدول بالأشكال لتتحدّث الخريطة.

ما تبنيه الفرق به

تعمل حالات الاستخدام التالية بالطريقة نفسها في الإصدارين؛ العروض التوضيحية من المعرض السحابي.

خرائط مخزون المستودعات

رفوف ومواقع تخزين ملوّنة حسب المخزون من نظام إدارة المستودعات، داخل شبكتك.

تتبّع الأصول في المباني

معدات موسومة بتقنية RFID أو BLE، غرفة بغرفة عبر عدة طوابق.

مراقبة سلسلة التبريد

حساسات الحرارة والرطوبة على الغرف التي تقيسها، مع السجل والتقارير.

شاهده على منشآت تجريبية حقيقية

أسماء خيالية، ومخططات طوابق حقيقية، وحساسات وقارئات RFID ووسوم BLE وبوابات حيّة — افتح أيًّا منها في المتصفح.

جميع المنشآت التجريبية الـ 13

الخرائط الداخلية مفتوحة المصدر — الأسئلة الشائعة

نعم. الشيفرة مرخّصة بترخيص MIT، فيمكنك تشغيلها وتعديلها واستخدامها تجاريًا دون مقابل. تدفع فقط تكلفة خوادمك، وتكلفة Mapbox إن تجاوزت فئتها المجانية.

إنه التطبيق نفسه. مع الاستضافة الذاتية لا خطط ولا حدود، وتتولى أنت التشغيل والبريد والتحديثات والنسخ الاحتياطي. أما الإصدار السحابي فيكلّف 60 دولارًا شهريًا لما يصل إلى 4 منشآت بعد تجربة مجانية مدتها 7 أيام.

Docker مع Compose بالإصدار 2.20 أو أحدث، ورمز Mapbox مجانيًا. يشغّل مشروع Compose قاعدة PostgreSQL مع PostGIS وMinIO وRedis والواجهة البرمجية بلغة Go وتطبيق الويب.

افتح بلاغًا أو طلب دمج في المستودع على GitHub. أبلغ عن الثغرات الأمنية بشكل خاص كما هو موضّح في SECURITY.md.

شغّله بنفسك، أو دعنا نشغّله لك.

انسخ المستودع وشغّله عبر Docker في دقائق — أو ابدأ تجربة مجانية للإصدار السحابي واستغنِ عن الخوادم.