Update mortakaz integration proposals

common-mortakaz/integration-1.md

@@ -1,8 +1,56 @@
-# Integration 1: Mortakaz API
+# Integration Proposal 1: AgentHelm + ghaymah.systems
 
-This document outlines the first integration step for the Mortakaz system.
+## Product Description
+AgentHelm هو مشروع يركز على إدارة وتشغيل وكلاء الذكاء الاصطناعي (AI Agents) وتسهيل نشرهم وإدارتهم. يظهر ضمن المشاريع المنشورة على منصة مرتكز.
 
-## Setup
+## Proposed Integration
-1. Authenticate with Mortakaz API.
+دمج AgentHelm مع ghaymah.systems بحيث يتم تشغيل كل AI Agent داخل Container مستقل.
-2. Fetch relevant metrics.
+
-3. Synchronize with local dashboard.
+### آلية العمل:
+1. عند إنشاء Agent جديد يقوم AgentHelm ببناء Container Image.
+2. يتم رفع الصورة إلى Container Registry.
+3. تقوم ghaymah بنشر الحاوية تلقائياً.
+4. يتم عمل Auto Scaling حسب عدد المستخدمين.
+5. يتم مراقبة الحاويات وإعادة تشغيلها عند الفشل.
+
+## Benefits
+- نشر أسرع للـ AI Agents.
+- Auto Scaling تلقائي.
+- تقليل Downtime.
+- سهولة إدارة الموارد.
+- تحسين الأداء مع زيادة عدد المستخدمين.
+
+## Architecture Sketch
+```text
+User
+   │
+   ▼
+AgentHelm
+   │
+   ▼
+Container Registry
+   │
+   ▼
+ghaymah.systems
+   │
+ ┌─┴───────────┐
+ │ Container 1 │
+ │ Container 2 │
+ │ Container N │
+ └─────────────┘
+```
+
+## Challenges
+- إدارة أسرار API Keys.
+- تكلفة تشغيل عدد كبير من الـ Containers.
+- مراقبة استهلاك الموارد.
+- تحديث الحاويات بدون توقف الخدمة.
+
+## Most Practical Integration
+أرى أن AgentHelm + ghaymah.systems هو الأكثر قابلية للتطبيق للأسباب التالية:
+- يعتمد مباشرة على الحاويات (Containers)، وهي الخدمة الأساسية التي توفرها ghaymah.
+- يمكن الاستفادة من Auto Scaling وHealth Checks وContainer Management بشكل مباشر.
+- يسهّل نشر تطبيقات ووكلاء الذكاء الاصطناعي دون الحاجة إلى إدارة البنية التحتية يدويًا.
+- يتوافق مع ممارسات DevOps وCI/CD الحديثة، مما يجعله مناسبًا للتوسع والإنتاج.
+
+هذا الاقتراح يقدم قيمة عملية واضحة ويُظهر فهمًا لكيفية الاستفادة من خدمات ghaymah في تشغيل وإدارة التطبيقات الحديثة.

common-mortakaz/integration-2.md

@@ -1,7 +1,45 @@
-# Integration 2: Advanced Monitoring
+# Integration Proposal 2: Crawleo + mithal.space
 
-This document details the advanced monitoring integration for the Mortakaz project.
+## Product Description
+Crawleo مشروع منشور على مرتكز يركز على الزحف إلى المواقع (Web Crawling) واستخراج البيانات.
 
-- Log aggregation
+## Proposed Integration
-- Alert routing
+ربط Crawleo مع mithal.space لمراقبة أداء عمليات الزحف وتحليلها.
-- Incident management linkage
+
+يقوم Crawleo بإرسال المقاييس إلى mithal مثل:
+- Request Latency
+- Success Rate
+- Failed Requests
+- DNS Time
+- SSL Status
+- Response Time
+
+ثم تعرض mithal Dashboard لحظية للمستخدم.
+
+## Benefits
+- مراقبة أداء الزحف لحظياً.
+- اكتشاف الأعطال بسرعة.
+- تحسين سرعة عمليات Crawling.
+- تنبيهات عند زيادة الأخطاء أو زمن الاستجابة.
+
+## Architecture Sketch
+```text
+Websites
+    │
+    ▼
+ Crawleo
+    │
+ Metrics
+    ▼
+mithal.space
+    │
+Dashboard
+    │
+ Alerts
+```
+
+## Challenges
+- التعامل مع Rate Limits.
+- اختلاف بنية المواقع المستهدفة.
+- تخزين كمية كبيرة من المقاييس.
+- الحفاظ على خصوصية البيانات.