.
├── Dockerfile
├── requirements.txt
├── .dockerignore
├── .ghaymah.json
├── app/
│   └── main.py            # تطبيق Flask + /health + /metrics
├── demo/
├── health-check.sh        # سكربت مراقبة بلغة bash (فحص كل 30 ثانية)
├── health-check.py
└── dashboard.html         # لوحة مراقبة (HTML/CSS/JS) تعمل من المتصفح مباشرة

1) بناء واختبار الصورة محليًا

docker build -t sample-api:latest .
docker run --rm -p 8080:8080 sample-api:latest

# في نافذة أخرى
curl http://localhost:8080/health
curl http://localhost:8080/metrics

2) تشغيل سكربت المراقبة

بعد النشر، شغّل سكربت المراقبة موجّهًا إلى الرابط العام للتطبيق:

# Python (الخيار الموصى به)
python health-check.py --url https://sample-api-xxxx.ghaymah.systems --interval 30

# أو bash
chmod +x health-check.sh
./health-check.sh https://sample-api-xxxx.ghaymah.systems 30

السكربت يقوم بـ:

فحص /health كل 30 ثانية.
تسجيل الحالة وزمن الاستجابة في monitor.log.
كتابة آخر نتيجة في status.json.
إطلاق تنبيه (ALERT) في السجل بعد 3 فحوصات فاشلة متتالية.

يمكن تشغيله كخدمة نظام دائمة (systemd) أو كحاوية منفصلة (sidecar) بجانب التطبيق نفسه.

3) لوحة المراقبة (Dashboard)

افتح dashboard.html مباشرة في المتصفح (لا يحتاج خادمًا، ملف ثابت واحد):

أدخل الرابط العام للتطبيق في حقل الاتصال، مثل: https://sample-api-xxxx.ghaymah.systems
اضغط اتصال.

تعرض اللوحة:

الحالة: مؤشر أخضر (يعمل) / أحمر (متوقف)، مع نبض حي عند التشغيل السليم.
زمن الاستجابة: آخر قيمة + رسم بياني لآخر 30 قراءة.
عدد الطلبات: القيمة الإجمالية القادمة من /metrics.
مدة التشغيل وسجل مباشر لكل عملية فحص.

اللوحة تستدعي /metrics كل 5 ثوانٍ عبر fetch() مباشرة من المتصفح؛ التطبيق (main.py) يضيف ترويسة Access-Control-Allow-Origin: * لذلك لا حاجة لخادم وسيط.

4) ملاحظات إنتاجية (Production Notes)

التطبيق يعمل بمستخدم غير جذري (non-root user) داخل الحاوية.
يُستخدم gunicorn كخادم WSGI إنتاجي بدلاً من خادم التطوير المدمج في Flask.
HEALTHCHECK مضمّن في الـ Dockerfile نفسه، بالإضافة إلى فحص خارجي (health-check.py) — طبقتا مراقبة مستقلتان.
للتوسع: يمكن رفع عدد النسخ (replicas) من إعدادات الخدمة في Ghaymah دون تعديل الكود.