قاعدة البيانات

جداول النظام الرئيسية.

المخطط الكامل في backend/prisma/schema.prisma. هنا ملخّص الجداول الأهم وعلاقاتها.

جداول الأعمال (Domain)

الجدولالغرض
Userحسابات المستخدمين (JWT auth)
AgentProfile52 وكيل: اسم، نموذج، system prompt، أدوات
PmClientالعملاء
PmProjectالمشاريع (FK → PmClient)
PmTaskمهام Kanban (FK → PmProject)
WhatsAppConversationمحادثات + AI mode + assigned agent
WhatsAppMessageكل رسالة (in/out)
WaPendingReplyقائمة موافقة HYBRID mode
Workflowworkflows الأتمتة
WorkflowRunتنفيذ workflow (حالة + logs + result)
WorkflowSchedulecron schedules مرتبطة بـ workflows
HermesTaskمهمة في خطة تنفيذ راشد
معلومة
كل جدول لو فيه FK لجدول آخر، نستخدم onDelete: Cascade غالباً — يحمي من أيتام البيانات.

الفهارس (Indexes)

كل جدول له فهارس على الحقول المُستعلَم عنها بكثرة. أمثلة:

  • WhatsAppConversation.phone — unique للبحث بالرقم.
  • WorkflowRun.workflowId + status + startedAt — لقوائم الـ runs.
  • PmTask.projectId, status, position — composite لـ Kanban.

Migrations

نستخدم npx prisma db push في التطوير. للإنتاج: prisma migrate deploy. كل تغيير على schema لازم يمرّ عبر prisma generate لتحديث TypeScript types.