دليل المطوّر — سكينة
منصة Laravel 11 + PostgreSQL + Claude API. مبنية للسوق السعودي مع تكاملات mock تعمل كاملة في dev.
المعمارية بسطر
Laravel 11 backend · PostgreSQL + pgvector · Anthropic Claude · 12+ migrations · 80+ routes · 102 tests passing.
التشغيل المحلي
# كل شي يعمل عبر Docker Compose
docker compose up -d
# Migrate + seed roles + sync knowledge base
docker compose exec app php artisan migrate
docker compose exec app php artisan db:seed --class=SakeenahRolesSeeder
docker compose exec app php artisan sakeenah:sync-knowledge-base
# افتح المتصفح
open http://localhost:8088
الـ Entry Points
| المسار | الدور | الوصف |
|---|---|---|
/ | عام | الصفحة الرئيسية + التكاملات |
/login | عام | تسجيل دخول |
/register | عام | تسجيل حساب جديد |
/patient | patient | لوحة المريض |
/therapist | therapist | لوحة المعالج |
/admin | org_admin | لوحة المؤسسة |
/admin/integrations | org_admin | حالة كل التكاملات |
/admin/instruments | super_admin | اعتماد أدوات القياس سريرياً — البوّابة بين المسوّدة والاستخدام الحقيقي |
/dev/role-switcher | dev only | القفز بين الأدوار للاختبار |
التقنيات الأساسية
| التقنية | الإصدار | الاستخدام |
|---|---|---|
| Laravel | 11.x | Backend framework |
| PostgreSQL | 16 (pgvector) | قاعدة البيانات + vector search |
| Anthropic Claude | Sonnet 4.6 | الـ AI للجلسات + formulation |
| OpenAI | text-embedding-3-small | embeddings للـ RAG |
| Spatie Permission | 6.x | Roles + permissions (7 roles, 31 perms) |
| Pest | 2.x | Testing framework |
| Filament | 3.x | Admin panel (مُثبَّت لـ future use) |
الـ Roadmap
- Phase 1 (الآن - 3 أشهر): Nafath + Mada + Unifonic + NPHIES
- Phase 2 (3-6 أشهر): SCFHS therapists + Najat + Wasfaty + Sehhaty
- Phase 3 (6-12 شهر): Children + couples + family protocols
- Phase 4 (سنة+): MOH integration + universities + insurance partners
الخطوات التالية
ملاحظة الإنتاج
كل integration حالياً في وضع
mock — يعمل end-to-end في dev بدون credentials.
لرفع integration إلى production، انظر دليل التكاملات.