المنصة نفسها تعمل داخل شبكتك، والأمور القليلة التي تختلف هناك.
Haiyz Enclave هو منصّة Haiyz Cloud نفسها، تعمل على خادم داخل شبكتك أنت.
لا تفريع للشيفرة ولا نسخة مبتورة. فالبوابة ومركز التحكم والتوثيق وواجهة برمجة التطبيقات مع Hyz ID وعاملها ومحرّك نظم المعلومات الجغرافية هي الصور نفسها التي يشغّلها Haiyz Cloud، مأخوذة من إصدار ربع سنوي. وتصل في حزمة واحدة موقّعة تُنصَّب دون اتصال بالإنترنت.
وهذا هو مقصده: البيانات التي لا يجوز أن تغادر شبكتك لا تغادرها، ويبقى بين يديك المنتج نفسه الذي يستعمله الآخرون.
يحوّل المثبّت النسخة إلى وضع Enclave؛ فلا شيء يُضبط يدويًا.
| Haiyz Cloud | Haiyz Enclave | |
|---|---|---|
| الإصدار | مستمر | ربع سنوي (يناير وأبريل ويوليو وأكتوبر)؛ ويُدعم آخر إصدارين |
| الميزات | المستقرة، والتجريبية خلف مفتاح | المستقرة فقط — تبقى الميزة التجريبية معطّلة أيًّا كان إعدادها |
| فئة كل حساب | الأعلى بين فئة الشخص وفئات مؤسساته | الفئة التي يحدّدها الترخيص (ماكس أثناء فترة التقييم) |
| حدود الخطط | لكل فئة، تضبطها حيز | حدود الترخيص؛ وكل ما سواها بلا حدّ |
| الأسعار ودعوات الترقية والشراء | ظاهرة | مخفيّة؛ ويوزّع مشرفوك المقاعد |
| الملفات والبلاطات والتنزيلات | عبر شبكة توصيل محتوى | من واجهة برمجة التطبيقات على خادمك، برمز مؤقت |
| ما يغادر الشبكة | — | ما تهيّئه أنت فقط: خادم بريدك، واختياريًا الدخول الموحّد ومزوّد ذكاء اصطناعي |
وما سوى ذلك — عناصر البيانات والخرائط ولوحات المعلومات وحملات حيز Field وHyz Workspace ومحرّك نظم المعلومات الجغرافية ومركز التحكم — يعمل كما هو موثّق في سائر صفحات هذا الموقع.
تُبنى الحزمة لإصدار واحد ومعمارية معالج واحدة. وتختار نمطًا عند التنصيب:
| النمط | يشغّل | ويضيف |
|---|---|---|
| core | المنتج | البوابة ومركز التحكم والتوثيق وواجهة برمجة التطبيقات مع Hyz ID والعامل ومحرّك نظم المعلومات الجغرافية وقواعد بياناتها (MongoDB وRedis وPostgreSQL) |
| standard | core مع المراقبة | Prometheus وAlertmanager وLoki وGrafana وصفحة حالة |
| full | standard مع خادم WMS وWFS | WMS وWFS لأنظمة GIS المكتبية وسائر البرمجيات |
ويعمل Hyz MCP في كل نمط ما لم تعطّله. وعند الطلب تحمل الحزمة أيضًا فحص المرفوعات من الفيروسات (ClamAV، لمعالجات x86_64 فقط، مع مرآة تواقيع توفّرها أنت)؛ وإلا فالفحص معطّل: فالموقع المستضاف ذاتيًا يتولّى أمن ملفاته بنفسه. ولا تحمل الحزمة نموذج ذكاء اصطناعي — يجيب Hyz AI عبر المزوّد الذي تضبطه (انظر Hyz AI والوكلاء).
| نظام التشغيل | Ubuntu 22.04 أو 24.04 LTS؛ RHEL 9 أو Rocky 9 أو AlmaLinux 9. وWindows Server من 2019 إلى 2025 مضيفًا لـ Hyper-V يشغّل أحدها في آلة افتراضية |
| المعمارية | x86_64 أو arm64 |
| الحاويات | Docker Engine 26 فما فوق مع إضافة Compose 2.24 فما فوق |
| الحجم، core | 4 معالجات افتراضية، و8 غيغابايت ذاكرة، و40 غيغابايت شاغرة، إضافة إلى تخزين الملفات |
| الحجم، full | 8 معالجات افتراضية، و16 غيغابايت ذاكرة، و80 غيغابايت شاغرة |
| الملفات | قرص محلي أو NFS أو SMB أو تخزين متوافق مع S3 (MinIO وCeph وAWS S3) |
| البريد | أي خادم ترحيل SMTP — فرموز الدخول تُرسل بالبريد؛ ويكفي خادم داخلي دون بيانات اعتماد |
| التشفير (TLS) | شهادتك على البوابة، أو موازن أحمال أمامها يحملها |
خادم واحد لكل تنصيب. أما توزيع الأجزاء على خوادم منفصلة فخدمة احترافية، لا مسار مؤتمت.
انسخ الحزمة إلى الخادم — على وسيط قابل للإزالة إن كان الموقع معزولًا — وطابقها مع قيمة التحقق التي نشرتها حيز مع الإصدار:
cd haiyz-enterprise-<version>
grep -v ' checksums.txt' checksums.txt | sha256sum -c --quiet && echo package intact
sha256sum checksums.txt # compare with the published value
ثم املأ الإعدادات وافحص الخادم ونصّب:
cp install.conf.example install.conf && $EDITOR install.conf
scripts/preflight.sh --conf install.conf
scripts/install.sh --conf install.conf
يتحقّق المثبّت من الحزمة، ويفحص الخادم، ويُعدّ /opt/haiyz، ويكتب كل ملف إعدادات بأسرار تُولَّد
على الخادم نفسه، ويحمّل الصور من الحزمة (بلا سجلّ صور ولا إنترنت)، ويشغّل الخدمات بالترتيب، وينشئ
قاعدة بيانات Hyz ID، وينشئ المشرف الأول ومؤسستك. ثم يطبع تقريرًا ويحفظه في
/opt/haiyz/logs/release/.
يسمّي install.conf التنصيب في سطر واحد، HAIYZ_BASE_DOMAIN، وتتفرّع منه كل العناوين. فمع
haiyz.company.sa:
| العنوان | يخدم |
|---|---|
haiyz.company.sa |
البوابة، وواجهة برمجة التطبيقات تحت /api، وHyz ID، والملفات، وخدمات حيز وبلاطاتها |
admin.haiyz.company.sa |
مركز التحكم |
docs.haiyz.company.sa |
هذا التوثيق |
status.haiyz.company.sa |
صفحة الحالة (standard وfull) |
mcp.haiyz.company.sa |
Hyz MCP، للوكلاء |
ويمكن تغيير اسم أي منها أو الاستغناء عنه في install.conf. ويسمّي الملف نفسه المشرفَ الأول
(HAIYZ_ADMIN_EMAIL) ومؤسستك — اسمها بالإنجليزية والعربية، ونوعها، ومقاعدها.
الدخول الأول: افتح عنوان المنصّة وادخل ببريد المشرف؛ ويصلك الرمز عبر خادم بريدك. هذا الحساب هو مشرف المنصّة ومالك مؤسستك، فيفتح مركز التحكم على المؤسسة، ومنها يُدعى الأعضاء.
يغطّي دليل التنصيب داخل الحزمة (docs/installation.md) كل إعداد: التشفير على البوابة أو أمامها،
وتغيير أسماء العناوين، وActive Directory، ووصلات التخزين، وتجهيز خادم خالٍ بـ Ansible.
تعمل كل مخازن البيانات افتراضيًا حاوياتٍ على الخادم، ببيانات اعتماد مولَّدة، وتدخل في النسخ
الاحتياطية. ولاستعمال خادم يديره فريقك أصلًا، اضبط نمطه على external في install.conf وأعطِ
عنوانه:
| المخزن | يحفظ | الإصدار |
|---|---|---|
| MongoDB | المستخدمين والمؤسسات وعناصر البيانات وسجل التدقيق | 7 |
| Redis | الطوابير وحدود المعدّل والجلسات المخزّنة مؤقتًا | 7 |
| PostgreSQL مع امتداده المكاني | طبقات حيز والبحث، وHyz ID في قاعدة بيانات مستقلة | 16، والامتداد المكاني 3.5 |
شيفرة المنصّة واحدة في الحالتين. والإعدادات المختلطة جائزة — عنقود PostgreSQL خارجي مع MongoDB
وRedis محليين مثلًا. ويتحقّق preflight.sh من أن كل خادم خارجي يمكن الوصول إليه من الخادم.
تعمل نسخة Enclave بموجب وثيقة رخصة تصدرها حيز وتتحقّق منها مفاتيح مضمّنة في الإصدار — لا شيء
يُهيّأ ولا شيء يُجلب. وإلى أن تُفعَّل رخصة تكون النسخة في فترة تقييم مدتها 30 يومًا من أول
تشغيل، على فئة ماكس مع تفعيل كل الامتدادات. والتفعيل برمز (خادم متصل) أو بملف طلب وملف رخصة (خادم
معزول)، من مركز التحكم تحت المنصّة › الترخيص أو بالأمر haiyzctl license.
| الحالة | ما يراه الناس |
|---|---|
| التقييم | إشعار بالأيام المتبقية؛ كل شيء يعمل |
| سارية | لا شيء؛ تسري فئة الترخيص وامتداداته وحدوده ومقاعده |
| فترة السماح | تحذير بتاريخ الانتهاء وتاريخ التحوّل إلى القراءة فقط؛ كل شيء يعمل 30 يومًا أخرى |
| للقراءة فقط | تنبيه: العرض والتنزيل والتصدير تعمل؛ الإنشاء والتحرير بانتظار رخصة. ويعمل الدخول والتفعيل دائمًا |
يعدّ الترخيص الأشخاص لكل نوع مدفوع من المستخدمين — المساهمين والمنشئين والناشرين ومديري المحتوى
ومديري الأمن والمديرين (ويُحتسب مالك المؤسسة مديرًا، والدور المخصّص منشئًا)؛ أمّا المستخدم فلا
يحتاج إلى مقعد. وتتيح فترة التقييم 5 مساهمين و5 منشئين وناشرَين اثنين ومديرَي محتوى اثنين، ومديري
الأمن والمديرين بلا حدّ. وعندما لا يتبقّى مقعد من نوعٍ ما يُرفض تغيير الدور بالرمز
SEAT_LIMIT_REACHED، ومن يصل عبر الدليل يحتفظ بنوعه ويعمل كمستخدم حتى يتحرّر مقعد — وتعرض صفحة
التراخيص المقاعد لكل نوع. وإلى جانب الدعوات والدخول الموحّد، يستطيع مدير المؤسسة إنشاء حساب
مباشرةً من الأعضاء › إنشاء حساب؛ فتصل الشخصَ رسالة ترحيب ويدخل برمز يصله بالبريد الإلكتروني.
الإضافات وحدات لها سعر مستقل بجانب الفئة والمقاعد، يذكر الترخيص ما اخترتموه منها، ويُتفق على
سعرها مع فريق المبيعات. وهي اليوم اثنتان. واجهات الأدوات (tool-apis): فإن لم يذكرها الترخيص لم تُنشأ
واجهة أداة ولم تُغيَّر ولم تُستدعَ على هذا التثبيت (LICENSE_FEATURE_MISSING). ينشئها مالكو المؤسسة
ومسؤولوها، ويمنحون دور منشئ واجهات الأدوات من الأعضاء › العضو › الإضافات لمن يحق له غيرهم.
ولا ينشئ الشخص واجهة أداة خاصة به إلا بهذا الدور، أو بصفته مالكًا أو مسؤولًا، في إحدى مؤسساته. ولا تزال واجهات الأدوات ميزة تجريبية،
فتصل إلى Haiyz Enclave مع الإصدار الذي يجعلها مستقرة. وأصول حيز (assets)، وتُصدَر مع publishing —
لأن طبقة كل فئة أصول تُقدَّم خدمةً من خدمات حيز: فبدونها يبقى الموجود مقروءًا، ولا تُنشأ فئة ولا مستشعر ولا
يُعدَّلان، ولا تُستلم قراءة. وحدودها إعدادات النسخة نفسها لا الترخيص، ويُمنح مدير الأصول ومدير القواعد
بجانب منشئ واجهات الأدوات. وهي تجريبية كذلك. انظر الإيقاف والحدود.
لا يخرج شيء من الشبكة لأجل الترخيص. تقرير الاستخدام — كميات فقط: المقاعد، والحدود المستخدمة،
والامتدادات قيد الاستخدام، والإصدارات — يُصدَّر بالأمر haiyzctl usage export لطلب التجديد، ولا
يُرسل يوميًا إلا إذا فعّل مشرفٌ ذلك تحت المنصّة › الإعدادات › الترخيص.
يعمل Hyz AI (Hyz Insight وHyz Help ومشاريع الذكاء الاصطناعي والأوصاف وأنماط الخرائط ولوحات المعلومات) وHyz MCP في Haiyz Enclave كما يعملان في Haiyz Cloud. ويبقى لكم أمران:
mcp.<نطاقكم>. ويسجّل المشغّل لديكم كل منصّة
وكلاء مرة واحدة (/opt/haiyz/scripts/mcp-client.sh add)، ويوقّع Hyz ID على خادمكم رمز كل وكيل —
فلا يصل شيء إلى Haiyz Cloud. انظر Hyz MCP.haiyzctl هو الأمر الوحيد على الخادم:
| الأمر | يفعل |
|---|---|
haiyzctl health |
سطر لكل جزء، ويخرج بالرمز 1 إن تعطّل أيّها — وهو فحص مهمة المراقبة |
haiyzctl status · version |
الحاويات وحالتها؛ والإصدار والعناوين وأنماط المخازن |
haiyzctl logs <service> · restart <service> |
سجلات خدمة واحدة؛ وإعادة إنشائها بعد تعديل إعداد |
haiyzctl backup · restore |
نسخة احتياطية مؤرّخة بقيم تحقق لكل قواعد البيانات، ومنها قاعدة بيانات Hyz ID، والإعدادات، والملفات اختياريًا |
haiyzctl update · rollback |
الإصدار التالي، والعودة منه |
haiyzctl diagnostics |
حزمة للدعم لا قيمة سرّية فيها |
haiyzctl license · usage export |
الرخصة السارية، والتفعيل، وتقرير الاستخدام |
النسخ الاحتياطية: جدوِل haiyzctl backup ليلًا (يثبّت التجهيز الاختياري بـ Ansible المؤقّت)،
وانسخها خارج الخادم بنظام النسخ الاحتياطي لديك. والاستعادة تكون إلى خادم يشغّل الإصدار نفسه.
التحديث من الإصدار السابق: فكّ الحزمة الجديدة بجوار القديمة، وتحقّق منها، وشغّل
scripts/update.sh. فيأخذ نسخة احتياطية أولًا، ويحمّل الصور الجديدة، ويعيد تشغيل ما تغيّر فقط،
وينتظر سلامة الخدمات؛ ويعيد scripts/rollback.sh الإصدار السابق. وما ضبطه مشرفوك في مركز التحكم
يبقى بعد كل تحديث.