دليل التثبيت والتشغيل

هذا الدليل موجّه لفرق تقنية المعلومات التي تثبّت Amanova على خوادمها الخاصة، أو في حسابها السحابي الخاص، أو على شبكة معزولة (air-gapped). أما الخدمة المستضافة التي تديرها SMH Global Services فلا تحتاج إلى أي من ذلك.

1. ما الذي يُثبَّت

المكوّن	وظيفته
التطبيق	تطبيق Amanova على الويب، ومساحة عمل الموظفين، وبوابة العملاء، وواجهات API
خادم الويب	يقدّم التطبيق والملفات الثابتة داخل التثبيت
عمليات المعالجة في الخلفية والمجدول	تحققات المستندات، وتحليل كشوف الحسابات، ودرجات الإنذار المبكر، والتقارير، والتذكيرات
خدمة الوقت الفعلي	تحديثات مباشرة في المتصفح
MariaDB 11.8	قاعدة البيانات، على شبكة داخلية لا يوجد إليها مسار من الخارج
Redis	ذاكرة التخزين المؤقت وطوابير المهام
Caddy	HTTPS أمام كل شيء، بشهادات تلقائية أو بشهاداتكم الخاصة
`amanova.sh`	سكربت التشغيل: التثبيت، والنسخ الاحتياطي، والاستعادة، والترقية، والاشتراك، وتقرير الاستخدام

يعمل كل شيء داخل حاويات تحت Docker Compose. تُحفظ البيانات في وحدات تخزين Docker (volumes)، وتُكتب النسخ الاحتياطية في /opt/amanova/backups.

2. المتطلبات

	التجربة	الإنتاج
المعالج (CPU)	4 vCPU	8 vCPU
الذاكرة	8 GB	16 GB
القرص	60 GB SSD	200 GB SSD، إضافة إلى مساحة تخزين للنسخ الاحتياطية
نظام التشغيل	Ubuntu 22.04 أو 24.04، أو RHEL 9 أو ما يتوافق معه	نفسه
البرمجيات	Docker Engine 24 أو أحدث مع إضافة Compose	نفسه

تحتاجون أيضاً إلى:

اسم مضيف يكتبه المستخدمون، مثل lending.bank.local، يشير إلى الخادم؛
المنفذان 80 و443 مفتوحان لمستخدميكم (المنفذ 80 يعيد التوجيه إلى 443 فقط)؛
للحصول على شهادات تلقائية عبر الإنترنت، يجب أن يكون اسم المضيف عاماً؛ أما على شبكة داخلية، فاستخدموا شهادتكم الخاصة (القسم 6).

3. التثبيت القياسي (الخادم متصل بالإنترنت)

sudo tar -xzf amanova-2.1.0-onprem.tar.gz -C /opt
sudo mv /opt/amanova-2.1.0-onprem /opt/amanova
cd /opt/amanova
sudo ./amanova.sh install

يطلب السكربت:

العنوان الذي سيكتبه المستخدمون (اسم المضيف)؛
اسم جهة الإقراض؛
الدولة الرئيسية (PK أو BD أو SA أو AE أو NG أو KE أو EG أو GH أو SN أو MZ)؛
عنوان البريد الإلكتروني لمدير النظام الأول.

ثم يبني صورة التطبيق أو يحمّلها، ويشغّل الخدمات، وينشئ الموقع بكلمات مرور عشوائية لقاعدة البيانات ولمدير النظام (محفوظة في /opt/amanova/.env، ولا يقرؤها إلا المستخدم root)، ويطبع العنوان وكلمة المرور الأولى لمدير النظام. يستغرق البناء الأول من 15 إلى 25 دقيقة.

4. التثبيت دون اتصال (في بيئة معزولة)

اطلبوا من SMH Global أرشيف الصور الخاص بإصداركم، amanova-2.1.0-images.tar.gz. انسخوا الملفين إلى الخادم، ثم:

sudo tar -xzf amanova-2.1.0-onprem.tar.gz -C /opt
sudo mv /opt/amanova-2.1.0-onprem /opt/amanova
cd /opt/amanova
sudo ./amanova.sh load-images /path/to/amanova-2.1.0-images.tar.gz
sudo ./amanova.sh install --offline

لا يُنزَّل أي شيء. يعمل محرك الذكاء الاصطناعي المدمج دون اتصال؛ ولاستخدام نماذج الذكاء الاصطناعي، شغّلوا خادم نماذج في مقركم (القسم 10).

سجّلوا الدخول عبر https://<your host>/login بصفتكم مدير النظام، وغيّروا كلمة المرور.
إعدادات Amanova: اسم جهة الإقراض، والعلامة التجارية، والدولة الرئيسية، واللغات، وهاتف الدعم وبريده الإلكتروني.
حزمة الدولة: أكّدوا قواعد الهوية والجوال ومكتب الائتمان والإقراض مع فريق الامتثال لديكم.
منتج التمويل: أنشئوا منتجاتكم وحدودها وأسعارها والمستندات المطلوبة؛ وحدّدوا خيار العرض على البوابة للمنتجات المتاحة عبر الإنترنت.
المستخدمون: أضيفوا الموظفين بالأدوار Loan Officer أو Loan Underwriter أو Loan Manager أو Compliance Officer أو Auditor.
إعدادات الامتثال في Amanova: فعّلوا تسجيل الدخول ثنائي العامل للموظفين، واضبطوا بوابات الفحص وKYC والاعتماد.
ثبّتوا ملف الاشتراك (القسم 9).

6. شهادة TLS

اسم مضيف عام: يحصل Caddy على الشهادة ويجددها تلقائياً.
اسم مضيف داخلي: ضعوا شهادتكم ومفتاحها في /opt/amanova/certs/ باسم site.crt وsite.key، ثم شغّلوا sudo ./amanova.sh cert. استخدموا السلسلة الكاملة في site.crt.

7. النسخ الاحتياطي والاستعادة

sudo ./amanova.sh backup              # database and files, with a SHA-256 checksum
sudo ./amanova.sh backups             # list backups
sudo ./amanova.sh restore <folder>    # verifies the checksum, then restores

يُجرى نسخ احتياطي كل ليلة الساعة 02:00، ويُحتفظ بآخر 14 نسخة (BACKUP_KEEP في .env). انسخوا /opt/amanova/backups إلى وحدة تخزين منفصلة؛ ومفتاح تشفير قاعدة البيانات موجود في .env ويجب نسخه احتياطياً بشكل منفصل وحفظه في مكان آمن.

8. الترقيات

sudo tar -xzf amanova-2.2.0-onprem.tar.gz -C /tmp
sudo /tmp/amanova-2.2.0-onprem/amanova.sh upgrade /opt/amanova

تأخذ الترقية نسخة احتياطية أولاً، ثم تستبدل ملفات التطبيق (مع الاحتفاظ بملف .env والشهادات والاشتراك والنسخ الاحتياطية)، وتعيد بناء الصورة الجديدة أو تحمّلها، وترحّل قاعدة البيانات، وتعيد التشغيل. وتحمّل المواقع المعزولة أرشيف الصور الجديد أولاً. ويمكن للتثبيتات المستنسخة من مستودع SMH Global تشغيل sudo ./amanova.sh update لجلب أحدث إصدار وتطبيقه.

9. ملف الاشتراك وتقرير الاستخدام

توقّع SMH Global ملف الاشتراك، ويُتحقق منه دون اتصال بالمفتاح العام المرفق بالمنتج؛ ولا شيء يتصل بخوادمنا. ويسجّل الملف المرخَّص له، والمستخدمين من الموظفين، وشريحة المحفظة، والوحدات، والدول، والمدة، وتاريخ انتهاء الدعم.

sudo ./amanova.sh subscription /path/to/subscription.json   # install or replace
sudo ./amanova.sh subscription                              # show status
sudo ./amanova.sh usage-report                              # writes usage-report-<date>.json with a checksum

ويرى مديرو النظام أيضاً الاشتراك والاستخدام وتاريخ الانتهاء ضمن اشتراك Amanova في التطبيق. وعند انتهاء فترة الاشتراك أو الدعم، أو تجاوز الاستخدام للكمية المشترك فيها، يظهر إشعار لمديري النظام؛ ويستمر عمل الإقراض وخدمة التمويل والتحصيل. أرسلوا إلى SMH Global تقرير استخدام كل ربع سنة، أو عند الطلب.

10. خيارات الذكاء الاصطناعي

ضمن إعدادات Amanova ← السوق والذكاء الاصطناعي:

المزوّد	وجهة البيانات
المدمج	لا تخرج إلى أي جهة: قواعد وإحصاءات داخل التثبيت لديكم
في مقركم	خادم النماذج الخاص بكم مع API متوافقة مع OpenAI (مثل vLLM أو Ollama)، يُضبط بعنوان URL الخاص به
Anthropic Claude أو سحابة متوافقة مع OpenAI	المزوّد الذي تعتمدونه، بمفتاح API الخاص بكم، مخزّناً بشكل مشفّر

تُسجَّل كل نتيجة من الذكاء الاصطناعي مع مدخلاتها والشخص الذي قبلها أو رفضها. ولا يُتخذ أي قرار بالذكاء الاصطناعي وحده.

11. ملاحظات أمنية لمراجعة أمن المعلومات

تشغّل الحاويات التطبيق بمستخدم غير جذري (non-root)؛ ولا توجد منافذ منشورة لقاعدة البيانات وRedis.
HTTPS فقط، مع TLS 1.2 و1.3؛ ويُعاد توجيه HTTP إلى HTTPS.
كلمات المرور مُجزّأة (hashed)؛ والبيانات السرية مثل مفاتيح API مشفّرة بمفتاح الموقع الموجود في .env.
تسجيل الدخول ثنائي العامل للموظفين، وسياسة كلمات المرور، وقفل الحساب بعد المحاولات الفاشلة، وانتهاء صلاحية الجلسات كلها قابلة للضبط.
مستندات العملاء ملفات خاصة، لا تُعرض إلا للمستخدمين المسجّل دخولهم والمصرّح لهم برؤيتها.
يحتفظ كل مستند بسجل إصداراته؛ وتُسجَّل نتائج الذكاء الاصطناعي مع مراجعها.

12. التثبيت دون حاويات

حيث لا يُسمح بالحاويات، تُثبَّت Amanova وفق الإعداد الإنتاجي القياسي للمنصة (Python وNode.js وMariaDB وRedis وNGINX وSupervisor) باستخدام bench. اطلبوا من SMH Global دليل systemd/bench الخاص بنظام التشغيل لديكم.

13. استكشاف الأخطاء وإصلاحها

العَرَض	ما يجب التحقق منه
الموقع لا يفتح	`sudo ./amanova.sh status` و`sudo ./amanova.sh logs web`
أخطاء الشهادات	اسم المضيف يشير إلى الخادم؛ والمنفذان 80 و443 مفتوحان؛ أو ثبّتوا شهادتكم الخاصة
بطء التحققات في الخلفية	`sudo ./amanova.sh logs worker`؛ أضيفوا ذاكرة أو معالجات
رفض الاستعادة	مجموع التحقق للنسخة الاحتياطية غير مطابق؛ انسخوا النسخة الاحتياطية مجدداً

14. مرجع الأوامر

الأمر	وظيفته
`install [--offline]`	التثبيت الأول
`status`	الخدمات والإصدار والاشتراك واستخدام القرص
`start`، `stop`، `restart`	التحكم في جميع الخدمات
`logs [service]`	متابعة السجلات (`app`، `web`، `worker`، `scheduler`، `db`، `proxy`)
`backup`، `backups`، `restore <folder>`	نسخ احتياطية مع مجاميع تحقق
`upgrade <folder>` / `update`	الترقية من حزمة جديدة، أو جلب أحدث إصدار من المستودع
`load-images <archive>`	تحميل الصور لتثبيت أو ترقية دون اتصال
`cert`	استخدام شهادتكم الخاصة من `certs/`
`subscription [file]`	تثبيت الاشتراك أو عرضه
`usage-report`	كتابة تقرير استخدام لـ SMH Global
`admin-password`	تعيين كلمة مرور جديدة لمدير النظام
`version`	عرض الإصدار المثبّت

الدعم: support@amanova.app · SMH Global Services، دبي · كراتشي · الرياض

دليل التثبيت والتشغيل.