add the main file structure requirements
هذا الالتزام موجود في:
89
common-mortakaz/integration-1.md
Normal file
89
common-mortakaz/integration-1.md
Normal file
@@ -0,0 +1,89 @@
|
||||
# اقتراح التكامل الأول: تايلور سي في (Taylor CV)
|
||||
## Integration Proposal: Taylor CV + Ghaymah Cloud
|
||||
|
||||
---
|
||||
|
||||
## وصف المنتج
|
||||
|
||||
منصة ذكاء اصطناعي تنشئ سيرة ذاتية ورسالة تحفيزية مخصصة لكل وظيفة، وتحضر للمقابلات، وتقدم خطط تعلم يومية، وتدعم لغات متعددة.
|
||||
|
||||
**الرابط:** [Taylor CV على مرتكز](https://www.mortakaz.com/projects/6a60ad7e3d576288c1011ff2)
|
||||
|
||||
---
|
||||
|
||||
## كيف يتكامل مع ghaymah.systems
|
||||
|
||||
| جانب التكامل | التفاصيل |
|
||||
|--------------|----------|
|
||||
| **الاستضافة** | استضافة التطبيق على Ghaymah Cloud باستخدام Container Services |
|
||||
| **قاعدة البيانات** | استخدام PostgreSQL المُدار من غيمة لتخزين بيانات المستخدمين والسير الذاتية |
|
||||
| **التخزين** | Block Storage لحفظ ملفات PDF المُولّدة والقوالب |
|
||||
| **الأمان** | تفعيل SSL التلقائي وMFA لحماية بيانات المستخدمين الحساسة |
|
||||
|
||||
---
|
||||
|
||||
## التكامل التقني
|
||||
|
||||
```yaml
|
||||
# docker-compose.yml for Taylor CV on Ghaymah
|
||||
version: '3.8'
|
||||
services:
|
||||
taylor-cv-app:
|
||||
image: taylor-cv:latest
|
||||
environment:
|
||||
- DATABASE_URL=postgresql://user:pass@ghaymah-postgres:5432/taylorcv
|
||||
- STORAGE_ENDPOINT=https://storage.ghaymah.systems
|
||||
- AI_API_KEY=${OPENAI_KEY}
|
||||
deploy:
|
||||
replicas: 2
|
||||
|
||||
ghaymah-postgres:
|
||||
image: postgres:15
|
||||
volumes:
|
||||
- ghaymah-block-storage:/var/lib/postgresql/data
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## القيمة المضافة للمستخدم النهائي
|
||||
|
||||
| الفائدة | الوصف |
|
||||
|---------|-------|
|
||||
| **سرعة الأداء** | خوادم غيمة في السعودية = زمن استجابة أقل للمستخدمين العرب |
|
||||
| **أمان البيانات** | البيانات تبقى في المنطقة العربية (Data Sovereignty) |
|
||||
| **تكلفة أقل** | أسعار غيمة التنافسية تقلل تكلفة التشغيل |
|
||||
| **دعم عربي** | دعم فني باللغة العربية |
|
||||
|
||||
---
|
||||
|
||||
## رسم بسيط للتكامل (Architecture Sketch)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ Ghaymah Cloud │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ Users │───▶│ Taylor CV │───▶│ PostgreSQL │ │
|
||||
│ │ (العرب) │ │ Container │ │ (Managed) │ │
|
||||
│ └──────────────┘ └──────┬───────┘ └──────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌──────────────┐ │
|
||||
│ │ Block Storage│ │
|
||||
│ │ (PDF Files) │ │
|
||||
│ └──────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## التحديات التقنية والتجارية المحتملة
|
||||
|
||||
| التحدي | الحل المقترح |
|
||||
|--------|--------------|
|
||||
| **تكامل AI APIs** | استخدام API Gateway من غيمة لإدارة الاتصال مع OpenAI |
|
||||
| **حجم التخزين** | خطة تسعير مرنة حسب الاستخدام من غيمة |
|
||||
| **التوسع** | Auto-scaling مع Container Services |
|
||||
| **الامتثال** | غيمة متوافقة مع متطلبات حماية البيانات السعودية |
|
||||
161
common-mortakaz/integration-2.md
Normal file
161
common-mortakaz/integration-2.md
Normal file
@@ -0,0 +1,161 @@
|
||||
# اقتراح التكامل الثاني: جرين (Green PHP Framework)
|
||||
## Integration Proposal: Green Framework + Ghaymah Cloud + mithal.space
|
||||
|
||||
---
|
||||
|
||||
## وصف المنتج
|
||||
|
||||
إطار عمل PHP حديث وخفيف، يسهل بناء تطبيقات الويب وواجهات برمجة التطبيقات بوضوح وتنظيم وقابلية للتوسع.
|
||||
|
||||
**الرابط:** [Green على مرتكز](https://www.mortakaz.com/projects/6a66386b64ffff87848cfc37)
|
||||
|
||||
---
|
||||
|
||||
## كيف يتكامل مع ghaymah.systems
|
||||
|
||||
| جانب التكامل | التفاصيل |
|
||||
|--------------|----------|
|
||||
| **Template جاهز** | إنشاء قالب Green جاهز للنشر بنقرة واحدة على غيمة |
|
||||
| **CI/CD** | تكامل مع GitHub Actions للنشر التلقائي |
|
||||
| **قاعدة البيانات** | دعم مباشر لـ PostgreSQL من غيمة في إعدادات Framework |
|
||||
| **التوثيق** | توثيق خاص بالنشر على غيمة |
|
||||
|
||||
---
|
||||
|
||||
## التكامل التقني مع غيمة
|
||||
|
||||
```php
|
||||
<?php
|
||||
// config/database.php - Green Framework + Ghaymah
|
||||
|
||||
return [
|
||||
'default' => 'ghaymah_postgres',
|
||||
|
||||
'connections' => [
|
||||
'ghaymah_postgres' => [
|
||||
'driver' => 'pgsql',
|
||||
'host' => env('GHAYMAH_DB_HOST', 'db.ghaymah.systems'),
|
||||
'port' => env('GHAYMAH_DB_PORT', '5432'),
|
||||
'database' => env('GHAYMAH_DB_NAME', 'myapp'),
|
||||
'username' => env('GHAYMAH_DB_USER'),
|
||||
'password' => env('GHAYMAH_DB_PASS'),
|
||||
'ssl_mode' => 'require',
|
||||
],
|
||||
],
|
||||
];
|
||||
```
|
||||
|
||||
```bash
|
||||
# نشر تطبيق Green على غيمة
|
||||
ghaymah app create my-green-app \
|
||||
--template green-php \
|
||||
--database postgres \
|
||||
--region me-riyadh-1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## كيف يتكامل مع mithal.space
|
||||
|
||||
| جانب التكامل | التفاصيل |
|
||||
|--------------|----------|
|
||||
| **Search API** | إضافة package للبحث عبر mithal.space API |
|
||||
| **الخصوصية** | بديل لـ Google Search في التطبيقات التي تحترم الخصوصية |
|
||||
| **دعم العربية** | نتائج بحث محسّنة للمحتوى العربي |
|
||||
|
||||
```php
|
||||
<?php
|
||||
// packages/mithal-search/src/MithalSearch.php
|
||||
|
||||
namespace Green\MithalSearch;
|
||||
|
||||
class MithalSearch
|
||||
{
|
||||
private string $baseUrl = 'https://mithal.space/api/search';
|
||||
|
||||
public function search(string $query, array $options = []): array
|
||||
{
|
||||
// بحث يحترم الخصوصية - لا تتبع
|
||||
return $this->request([
|
||||
'q' => $query,
|
||||
'lang' => $options['lang'] ?? 'ar',
|
||||
'safe' => $options['safe'] ?? true,
|
||||
]);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## القيمة المضافة للمستخدم النهائي
|
||||
|
||||
| الفائدة | الوصف |
|
||||
|---------|-------|
|
||||
| **سهولة النشر** | من الكود إلى Production في دقائق |
|
||||
| **بحث عربي** | نتائج بحث أفضل للمحتوى العربي عبر mithal |
|
||||
| **خصوصية** | لا تتبع للمستخدمين |
|
||||
| **تكلفة** | استضافة بأسعار تنافسية |
|
||||
|
||||
---
|
||||
|
||||
## رسم بسيط للتكامل (Architecture Sketch)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ Green Framework App │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ Green │────────▶│ Ghaymah │ │
|
||||
│ │ PHP App │ │ Cloud │ │
|
||||
│ └──────┬───────┘ └──────────────┘ │
|
||||
│ │ │
|
||||
│ │ Search API │
|
||||
│ ▼ │
|
||||
│ ┌──────────────┐ │
|
||||
│ │ mithal.space│ │
|
||||
│ │ (بحث عربي) │ │
|
||||
│ └──────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## التحديات التقنية والتجارية المحتملة
|
||||
|
||||
| التحدي | الحل المقترح |
|
||||
|--------|--------------|
|
||||
| **توافق PHP** | دعم PHP 8.1+ المتوفر على غيمة |
|
||||
| **Cache** | استخدام Redis من غيمة للتخزين المؤقت |
|
||||
| **Rate Limiting** | تنسيق مع mithal.space لحدود API |
|
||||
| **التوثيق** | إنشاء توثيق مشترك بالعربية |
|
||||
|
||||
---
|
||||
|
||||
## لماذا هذا المنتج الأكثر قابلية للتطبيق؟ ✅
|
||||
|
||||
| السبب | التفسير |
|
||||
|-------|---------|
|
||||
| **1. البنية التحتية** | إطار العمل يحتاج استضافة، وغيمة توفرها مباشرة |
|
||||
| **2. المطورين العرب** | Green موجه للمطورين العرب، وغيمة كذلك = تكامل طبيعي |
|
||||
| **3. سهولة التنفيذ** | إنشاء template جاهز أسهل من تكامل AI معقد |
|
||||
| **4. القيمة المتبادلة** | Green يحصل على استضافة، غيمة تحصل على مستخدمين |
|
||||
| **5. التوسع** | كل تطبيق يُبنى بـ Green يمكن استضافته على غيمة |
|
||||
| **6. التكامل مع mithal** | إضافة بحث عربي يحترم الخصوصية = ميزة تنافسية |
|
||||
|
||||
---
|
||||
|
||||
## خطة التنفيذ المقترحة
|
||||
|
||||
| المرحلة | المدة | المهام |
|
||||
|---------|-------|--------|
|
||||
| **المرحلة 1** | أسبوع 1-2 | إنشاء Ghaymah Template لـ Green + توثيق خطوات النشر |
|
||||
| **المرحلة 2** | أسبوع 3-4 | تطوير mithal-search package + اختبار التكامل |
|
||||
| **المرحلة 3** | أسبوع 5-6 | إطلاق رسمي + حملة تسويقية مشتركة |
|
||||
|
||||
---
|
||||
|
||||
## الخلاصة
|
||||
|
||||
التكامل بين **Green Framework** و **Ghaymah Cloud** و **mithal.space** يخلق منظومة متكاملة للمطورين العرب تدعم **السيادة الرقمية العربية** وتوفر بديلاً محلياً للحلول الأجنبية.
|
||||
المرجع في مشكلة جديدة
حظر مستخدم