دليل التكاملات السعودية

منصة Sakeenah تستخدم design pattern واحد لكل تكامل: Contract + Adapter. كل تكامل له interface واضحة + mock adapter يعمل في dev بدون credentials.

المبدأ المعماري

// 1. Contract — interface واضحة لكل integration
interface IdentityProvider {
    public function requestAuth(string $nationalId): array;
    public function status(string $requestId): array;
}

// 2. Mock — يعمل في dev (لا credentials لازمة)
class MockNafath implements IdentityProvider { ... }

// 3. Production — يُبنى عند الجاهزية
class NafathAdapter implements IdentityProvider { ... }

// 4. Binding يتم تلقائياً في AppServiceProvider
// حسب config('sakeenah.integrations.identity.driver')

كيف ترفع تكاملاً من mock إلى production

1. ابنِ كلاس جديد في app/Integrations/Production/ يطبّق الـ contract
2. أضف اسم الكلاس إلى Registry::all() في حقل production_class
3. ضع credentials الموزود في .env (مثلاً NAFATH_API_KEY=...)
4. غيّر driver=production في .env (مثلاً NAFATH_DRIVER=production)
5. أعد تشغيل الخدمة — الـ container binding يتغير تلقائياً

التكاملات المتاحة (8)

مثال: استخدام تكامل في أي service

// In your controller or service
use App\Integrations\Contracts\IdentityProvider;

class SignupController {
    public function __construct(
        private readonly IdentityProvider $identity,
    ) {}

    public function verifyWithNafath(Request $req) {
        $result = $this->identity->requestAuth($req->national_id);
        return $result; // {request_id, deep_link, qr_url, expires_at}
    }
}

قواعد التكامل السعودي

• الدفع: Mada · STC Pay · Tap · HyperPay (وليس Stripe المباشر)
• الهوية: Nafath عبر ELM (وليس Google/Facebook)
• SMS للأرقام السعودية: Unifonic (CITC requirement — لا Twilio)
• التأمين الصحي: NPHIES (الإلزامي عبر CCHI)
• الوصفات: Wasfaty (MOH)
• الفيديو الطبي: Sehhaty أو Cura أو Altibbi (data residency في السعودية)
• الـ Hosting: AWS me-central-1 (Bahrain) أو STC Cloud
• AI Models: Claude/OpenAI مسموح (لا بديل محلي) — مع DPA + لا تخزين PHI خام في prompts