# الهدف الرئيسي

أنت مهندس برمجيات (Software Architect) وخبير في تصميم أنظمة ERP وأنظمة إدارة المستشفيات (Hospital Information System - HIS) والسجلات الطبية الإلكترونية (EMR/EHR).

المطلوب تصميم وتنفيذ منصة متكاملة لإدارة المجمعات الطبية والمستشفيات تعمل داخل نظام ERP قائم بالفعل.

يجب أن تكون المنصة بنفس فلسفة نظام Odoo ERP، أي أنها ليست موديولًا واحدًا ضخمًا، وإنما عبارة عن مجموعة تطبيقات (Apps) مستقلة تعمل فوق نظام الـ ERP وتتشارك نفس قاعدة البيانات والصلاحيات والمستخدمين.

يجب أن تكون المنصة قابلة للعمل مع:

- عيادة منفردة
- مجمع طبي
- مستشفى
- سلسلة مستشفيات
- شركات طبية متعددة الفروع

دون الحاجة إلى إعادة تصميم النظام مستقبلاً.

====================================================

# البيئة التقنية

يجب الالتزام بالتقنيات التالية فقط:

- Laravel 9
- PHP 8.0.2
- MySQL
- Blade / Tailwind CSS
- Multi Tenant SaaS
- Repository Pattern
- Service Layer
- SOLID Principles
- UUID
- Soft Delete
- Activity Log
- Audit Log
- Queue
- Events
- Notifications
- REST API
- API Ready
- Import / Export
- Cache
- Jobs
- Transactions

====================================================

# فلسفة التصميم

لا تقم بإنشاء موديول واحد باسم

إدارة المجمع الطبي

ولكن قم بإنشاء مجموعة تطبيقات مستقلة داخل منصة الرعاية الصحية.

كل تطبيق يعتبر مستقلاً.

ويحتوي على:

Models

Controllers

Services

Repositories

Policies

Permissions

Blade Views

Settings

Reports

Notifications

Routes

Migration

Factories

Seeders

Tests

ويجب أن يكون من الممكن:

- تشغيل التطبيق
- إيقاف التطبيق
- تحديث التطبيق

بدون التأثير على بقية التطبيقات.

====================================================

# الموديولات الحالية داخل الـ ERP

النظام يحتوي بالفعل على:

- لوحة التحكم
- الحسابات
- الخزائن
- البنوك
- المخازن
- المشتريات
- المبيعات
- الموارد البشرية
- العملاء
- الموردين
- مندوبي المبيعات

يمنع منعاً باتاً إنشاء وظائف مكررة.

بل يجب إعادة استخدام الموديولات الحالية.

====================================================

# قواعد التكامل

تطبيقات الرعاية الصحية يجب أن تعتمد على الموديولات الحالية كما يلي:

الحسابات

مسؤولة عن:

- القيود اليومية
- الأستاذ العام
- الأستاذ المساعد
- الضرائب
- ضريبة القيمة المضافة
- مراكز التكلفة
- الإيرادات
- المصروفات
- التسويات
- الإقفالات

ولا يتم إنشاء أي نظام محاسبي جديد.

-----------------------------------------

الخزائن

مسؤولة عن:

- تحصيل النقدية
- صرف النقدية
- المرتجعات
- التسويات

-----------------------------------------

البنوك

مسؤولة عن:

- التحويلات البنكية
- نقاط البيع POS
- بطاقات الائتمان
- المدفوعات الإلكترونية

-----------------------------------------

المخازن

مسؤولة عن:

- الأدوية
- المستلزمات الطبية
- الأجهزة
- الأدوات
- التشغيلات
- الباتشات
- تواريخ الصلاحية
- الجرد
- الحد الأدنى
- أوامر الصرف
- أوامر الإضافة

-----------------------------------------

المشتريات

مسؤولة عن:

- شراء الأدوية
- شراء الأجهزة
- شراء المستلزمات
- شراء الخدمات

-----------------------------------------

المبيعات

مسؤولة عن:

بيع جميع الخدمات الطبية مثل:

- كشف
- استشارة
- عملية
- تحليل
- أشعة
- جلسة
- تطعيم
- باقة علاج
- اشتراك

-----------------------------------------

الموارد البشرية

مسؤولة عن:

- الموظفين
- الأطباء
- الممرضين
- الفنيين
- الحضور
- الانصراف
- الرواتب
- الإجازات
- التقييم
- العقود
- العمولات

-----------------------------------------

العملاء

كل مريض يتم إنشاؤه تلقائياً كعميل داخل النظام.

ولا يتم إنشاء جدول مستقل للعملاء.

-----------------------------------------

الموردون

يستخدم نفس جدول الموردين الحالي.

ويشمل:

- موردي الأدوية
- موردي الأجهزة
- موردي المستلزمات
- موردي الخدمات الطبية

====================================================

# التطبيقات الطبية المطلوب إنشاؤها

بدلاً من موديول واحد يتم إنشاء التطبيقات التالية:

١- إعدادات الرعاية الصحية

٢- الاستقبال

٣- إدارة المواعيد

٤- إدارة المرضى

٥- إدارة الأطباء

٦- التمريض

٧- السجل الطبي الإلكتروني

٨- الصيدلية

٩- المختبر

١٠- الأشعة

١١- العمليات

١٢- الطوارئ

١٣- التنويم

١٤- التأمين الطبي

١٥- الفوترة الطبية

١٦- التعقيم المركزي

١٧- بنك الدم

١٨- مكافحة العدوى

١٩- التطعيمات

٢٠- الطب عن بعد

٢١- التقارير ولوحات المعلومات

٢٢- إدارة النظام

====================================================

# القواعد العامة

جميع التطبيقات يجب أن:

- تدعم تعدد الفروع.
- تدعم تعدد الشركات.
- تدعم تعدد المستأجرين (Multi Tenant).
- تدعم تعدد اللغات.
- تدعم العملات المتعددة.
- تدعم المناطق الزمنية المختلفة.
- تدعم الصلاحيات الدقيقة.
- تدعم Workflow قابل للتخصيص.
- تدعم التنبيهات.
- تدعم الرسائل النصية.
- تدعم البريد الإلكتروني.
- تدعم WhatsApp مستقبلاً.
- تدعم API كاملة.
- تدعم QR Code.
- تدعم Barcode.
- تدعم التوقيع الإلكتروني.
- تدعم الأرشفة الإلكترونية.
- تدعم رفع الملفات والصور والأشعة وملفات PDF.

====================================================

# قواعد التنفيذ

يمنع كتابة أي كود قبل الانتهاء من:

١- تحليل المتطلبات.

٢- تصميم الهيكل المعماري.

٣- تصميم التطبيقات.

٤- تصميم قاعدة البيانات.

٥- تصميم العلاقات.

٦- تصميم الصلاحيات.

٧- تصميم سير العمل.

٨- تصميم القوائم الجانبية.

٩- مراجعة التصميم بالكامل.

بعد اعتماد التصميم فقط يبدأ التنفيذ App بواسطة App.

====================================================
منصة الرعاية الصحية
Healthcare Suite
====================================================

يجب إنشاء منصة الرعاية الصحية على هيئة مجموعة تطبيقات مستقلة.

كل تطبيق يحتوي على:

- لوحة تحكم
- الشاشات
- الإعدادات
- التقارير
- الصلاحيات
- الإشعارات

====================================================
١- إعدادات الرعاية الصحية
====================================================

لوحة التحكم

بيانات المنشأة الطبية

الفروع

المباني

الأدوار

الغرف

الأسرة

الأقسام الطبية

العيادات

العيادات المتخصصة

التخصصات الطبية

الخدمات الطبية

تصنيفات الخدمات

قوائم الأسعار

الباقات الطبية

العروض

الخصومات

أنواع الزيارات

أنواع المواعيد

مصادر التحويل

شركات التأمين

بوالص التأمين

الأجهزة الطبية

غرف العمليات

المختبرات

غرف الأشعة

مراكز التكلفة الطبية

الإجازات الرسمية

ساعات العمل

الإعدادات العامة

إعدادات الضرائب

إعدادات الطباعة

إعدادات الباركود

إعدادات QR

قوالب المستندات

قوالب الرسائل

قوالب البريد الإلكتروني

قوالب SMS

حقول مخصصة

إعدادات سير العمل

إعدادات API

====================================================
٢- الاستقبال
====================================================

لوحة الاستقبال

تسجيل مريض جديد

البحث عن مريض

تسجيل الوصول

تسجيل المغادرة

إصدار رقم انتظار

قائمة الانتظار

تحويل المريض

إلغاء الزيارة

سجل الزيارات

الزيارات الحالية

الزيارات المنتهية

الزيارات الملغاة

تقارير الاستقبال

====================================================
٣- إدارة المواعيد
====================================================

لوحة المواعيد

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

المواعيد اليومية

المواعيد الأسبوعية

المواعيد الشهرية

حجز موعد

إعادة جدولة

إلغاء موعد

تأكيد موعد

قائمة الانتظار

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

التذكير بالمواعيد

الحجز الإلكتروني

تقارير المواعيد

====================================================
٤- إدارة المرضى
====================================================

لوحة المرضى

جميع المرضى

إضافة مريض

الملف الشخصي

السجل الطبي

الزيارات

الأمراض المزمنة

الحساسية

التطعيمات

الأدوية الحالية

العلامات الحيوية

الوزن والطول

التحاليل السابقة

الأشعة السابقة

العمليات السابقة

المرفقات

الصور

الموافقات الطبية

جهات الاتصال

أفراد الأسرة

التأمين الطبي

سجل المدفوعات

الفواتير

ملاحظات الطبيب

تنبيهات المريض

التقارير

====================================================
٥- إدارة الأطباء
====================================================

لوحة الأطباء

الأطباء

التخصصات

الجدول الأسبوعي

المواعيد

الحضور

الإجازات

العيادات

الغرف

العمولات

الحوافز

التقييم

الإحصائيات

تقارير الأداء

====================================================
٦- التمريض
====================================================

لوحة التمريض

طاقم التمريض

محطات التمريض

متابعة المرضى

العلامات الحيوية

إعطاء الأدوية

خطط الرعاية

جولات التمريض

تسليم المناوبة

ملاحظات التمريض

تقارير التمريض

====================================================
٧- السجل الطبي الإلكتروني
====================================================

لوحة السجل الطبي

فتح زيارة

التاريخ المرضي

الفحص السريري

العلامات الحيوية

تشخيص الحالة

التشخيص ICD-10

الإجراءات الطبية

الخطة العلاجية

الوصفات الطبية

طلبات المختبر

طلبات الأشعة

الإحالات

المراجعات

المرفقات

الشهادات الطبية

ملخص الخروج

====================================================
٨- الصيدلية
====================================================

لوحة الصيدلية

الوصفات الطبية

صرف الأدوية

مرتجعات الأدوية

بدائل الأدوية

التداخلات الدوائية

الأدوية الخاضعة للرقابة

الباتشات

الصلاحية

المخزون

الجرد

تقارير الصيدلية

====================================================
٩- المختبر
====================================================

لوحة المختبر

طلبات التحاليل

استلام العينات

تتبع العينات

إدخال النتائج

اعتماد النتائج

النتائج الحرجة

طباعة النتائج

سجل التحاليل

تقارير المختبر

====================================================
١٠- الأشعة
====================================================

لوحة الأشعة

طلبات الأشعة

جدولة الأشعة

تنفيذ الفحص

رفع الصور

كتابة التقرير

اعتماد التقرير

طباعة التقرير

أرشيف الأشعة

تقارير الأشعة

====================================================
١١- العمليات
====================================================

لوحة العمليات

جدول العمليات

غرف العمليات

طلبات العمليات

الفريق الطبي

التخدير

الأدوات

المستهلكات

تقرير العملية

الإفاقة

تقارير العمليات

====================================================
١٢- الطوارئ
====================================================

لوحة الطوارئ

استقبال الحالة

الفرز الطبي

الحالات الحرجة

الإجراءات السريعة

طلب المختبر

طلب الأشعة

الوصفات

الخروج

التحويل

تقارير الطوارئ

====================================================
١٣- التنويم
====================================================

لوحة التنويم

إدخال مريض

تخصيص سرير

نقل سرير

نقل قسم

متابعة المرضى

الجولات اليومية

الخروج

إخلاء السرير

إحصائيات الأسرة

تقارير التنويم

====================================================
١٤- التأمين الطبي
====================================================

لوحة التأمين

شركات التأمين

بوالص التأمين

التحقق من الأهلية

طلبات الموافقة

المطالبات

المطالبات المرفوضة

إعادة الإرسال

التحصيل

تقارير التأمين

====================================================
١٥- الفوترة الطبية
====================================================

لوحة الفواتير

إنشاء فاتورة

المدفوعات

المرتجعات

الخصومات

الباقات

الاشتراكات

الفواتير المؤجلة

مطالبات التأمين

تقارير الإيرادات

====================================================
١٦- التعقيم المركزي
====================================================

لوحة التعقيم

الأجهزة

دورات التعقيم

التتبع

سجل التعقيم

الصيانة

التقارير

====================================================
١٧- بنك الدم
====================================================

لوحة بنك الدم

المتبرعون

فصائل الدم

المخزون

طلبات الدم

صرف الدم

تقارير بنك الدم

====================================================
١٨- مكافحة العدوى
====================================================

لوحة مكافحة العدوى

الحوادث

العزل

العدوى المكتسبة

التفتيش

المتابعة

التقارير

====================================================
١٩- التطعيمات
====================================================

لوحة التطعيمات

أنواع التطعيمات

جدول التطعيم

تسجيل التطعيم

الشهادات

التذكيرات

التقارير

====================================================
٢٠- الطب عن بعد
====================================================

لوحة الطب عن بعد

الاستشارات المرئية

المحادثات

الوصفات الإلكترونية

الدفع الإلكتروني

المواعيد

التسجيلات

التقارير

====================================================
٢١- التقارير ولوحات المعلومات
====================================================

لوحة المعلومات التنفيذية

مؤشرات الأداء

تقارير المرضى

تقارير الأطباء

تقارير المواعيد

تقارير الإيرادات

تقارير المصروفات

تقارير المختبر

تقارير الأشعة

تقارير الصيدلية

تقارير العمليات

تقارير الطوارئ

تقارير التنويم

تقارير التأمين

تقارير المخزون

تقارير الأرباح

إحصائيات النظام

تصدير PDF

تصدير Excel

====================================================
٢٢- إدارة النظام
====================================================

المستخدمون

الأدوار

الصلاحيات

سجل النشاط

سجل التدقيق

الإشعارات

المهام المجدولة

النسخ الاحتياطي

الاستيراد

التصدير

مراقبة النظام

مفاتيح API

إعدادات النظام

الترخيص

سجل الأخطاء

سجل التكاملات
====================================================
أولاً : معايير تصميم قاعدة البيانات
====================================================

قبل إنشاء أي كود يجب تصميم قاعدة البيانات بالكامل.

يشمل ذلك:

- مخطط ERD كامل.
- جميع الجداول.
- جميع العلاقات.
- المفاتيح الأساسية.
- المفاتيح الأجنبية.
- الفهارس (Indexes).
- القيود (Constraints).
- العلاقات متعددة المستويات.
- العلاقات متعددة الفروع.
- العلاقات متعددة المستأجرين.

====================================

يجب أن تحتوي جميع الجداول على الحقول التالية عند الحاجة:

UUID

رقم داخلي

tenant_id

company_id

branch_id

created_by

updated_by

deleted_by

created_at

updated_at

deleted_at

active

notes

metadata (JSON)

====================================

يجب استخدام

UUID

بدلاً من الأرقام التقليدية كمفتاح أساسي.

====================================

يجب دعم

Soft Delete

فى جميع الجداول المناسبة.

====================================

يجب دعم

Audit Trail

لكل عملية:

إضافة

تعديل

حذف

استرجاع

اعتماد

إلغاء اعتماد

طباعة

تصدير

====================================================
ثانياً : قواعد العلاقات
====================================================

كل مريض يرتبط بـ:

عدة زيارات

عدة مواعيد

عدة فواتير

عدة مدفوعات

عدة تشخيصات

عدة وصفات

عدة تحاليل

عدة أشعات

عدة عمليات

عدة ملفات

عدة مرفقات

عدة مطالبات تأمين

====================================

كل طبيب يرتبط بـ:

عدة عيادات

عدة مواعيد

عدة مرضى

عدة وصفات

عدة زيارات

عدة عمليات

عدة تقارير

عدة عمولات

====================================

كل زيارة ترتبط بـ:

مريض واحد

طبيب واحد

قسم واحد

فاتورة واحدة أو أكثر

وصفة واحدة أو أكثر

طلب مختبر

طلب أشعة

تشخيص

خطة علاج

====================================================
ثالثاً : الصلاحيات
====================================================

يجب استخدام

Role Based Access Control (RBAC)

ولا يسمح باستخدام صلاحيات ثابتة داخل الكود.

====================================

كل شاشة يجب أن تدعم الصلاحيات التالية:

عرض

إضافة

تعديل

حذف

اعتماد

إلغاء اعتماد

طباعة

تصدير

استيراد

رفع ملفات

تحميل ملفات

====================================

الصلاحيات يجب أن تكون مستقلة لكل:

شركة

فرع

قسم

عيادة

مستخدم

====================================================
رابعاً : المستخدمون الافتراضيون
====================================================

يجب تصميم النظام بحيث يدعم على الأقل:

مدير النظام

مدير المجمع

مدير الفرع

مدير مالي

محاسب

أمين خزينة

مسؤول بنوك

مدير موارد بشرية

مدير مخازن

أمين مخزن

مسؤول مشتريات

موظف استقبال

موظف مواعيد

طبيب

استشاري

ممرض

فني مختبر

فني أشعة

صيدلي

فني صيدلية

مسؤول تأمين

موظف خدمة عملاء

موظف مركز اتصال

مدقق داخلي

مراجع طبي

مدير الجودة

====================================================
خامساً : سير العمل
====================================================

المريض الجديد

↓

تسجيل البيانات

↓

حجز موعد

↓

تسجيل الوصول

↓

فتح زيارة

↓

كشف الطبيب

↓

تشخيص

↓

طلبات طبية

↓

مختبر أو أشعة

↓

النتائج

↓

الوصفة

↓

الفاتورة

↓

السداد

↓

الخروج

↓

المتابعة

====================================================
سادساً : سير عمل المختبر
====================================================

طلب تحليل

↓

تحصيل الرسوم

↓

جمع العينة

↓

تسجيل العينة

↓

تنفيذ التحليل

↓

اعتماد النتيجة

↓

إرسال للطبيب

↓

طباعة التقرير

====================================================
سابعاً : سير عمل الأشعة
====================================================

طلب أشعة

↓

تحصيل الرسوم

↓

جدولة

↓

تنفيذ الفحص

↓

رفع الصور

↓

كتابة التقرير

↓

اعتماد التقرير

↓

إرساله للطبيب

====================================================
ثامناً : سير عمل الصيدلية
====================================================

وصفة طبية

↓

التحقق من التوفر

↓

حجز الكمية

↓

صرف الدواء

↓

تحديث المخزون

↓

إنشاء حركة مخزنية

↓

تسجيل الإيراد

====================================================
تاسعاً : التكامل مع المحاسبة
====================================================

أي خدمة طبية يجب أن تنشئ تلقائياً:

فاتورة

قيد محاسبي

حركة خزينة أو بنك

ضريبة

مركز تكلفة

إيراد

====================================

أي مرتجع يجب أن ينشئ:

إشعار دائن

قيد عكسي

حركة خزينة عكسية

====================================

أي شراء أدوية يجب أن ينشئ:

فاتورة شراء

إضافة مخزنية

قيد محاسبي

مستحق مورد

====================================================
عاشراً : التكامل مع المخازن
====================================================

الوصفات الطبية

↓

إنشاء أمر صرف

↓

خصم المخزون

↓

تحديث الكميات

↓

تحديث الباتشات

↓

تحديث الصلاحية

====================================================
الحادي عشر : التقارير
====================================================

يجب أن تدعم جميع التطبيقات:

تقارير PDF

تقارير Excel

تقارير CSV

تقارير Word

الطباعة المباشرة

لوحات معلومات تفاعلية

رسوم بيانية

مؤشرات الأداء KPI

====================================================
الثاني عشر : معايير الأداء
====================================================

يجب أن يكون النظام قادراً على العمل مع:

مليون مريض

عشرة ملايين زيارة

مائة مليون حركة مالية

بدون مشاكل أداء.

====================================

يجب استخدام:

Lazy Loading

Eager Loading

Caching

Queues

Database Indexes

Pagination

Server Side Processing

====================================================
الثالث عشر : معايير البرمجة
====================================================

الالتزام بمبادئ:

SOLID

DRY

KISS

YAGNI

Repository Pattern

Service Layer

Action Classes

DTO

Form Request

Resource Classes

Policies

Observers

Events

Jobs

Notifications

Transactions

Dependency Injection

====================================================
الرابع عشر : قواعد التنفيذ
====================================================

يمنع البدء في كتابة أي كود قبل الانتهاء من:

١- تحليل المشروع بالكامل.

٢- تحليل التطبيقات المطلوبة.

٣- تصميم قاعدة البيانات.

٤- تصميم العلاقات.

٥- تصميم الـ ERD.

٦- تصميم الصلاحيات.

٧- تصميم القوائم.

٨- تصميم واجهات المستخدم.

٩- مراجعة التصميم بالكامل.

بعد اعتماد التصميم يبدأ التنفيذ بالتسلسل التالي:

المرحلة الأولى
الإعدادات العامة

المرحلة الثانية
الاستقبال والمرضى والمواعيد

المرحلة الثالثة
السجل الطبي والأطباء والتمريض

المرحلة الرابعة
الصيدلية

المرحلة الخامسة
المختبر

المرحلة السادسة
الأشعة

المرحلة السابعة
العمليات والطوارئ والتنويم

المرحلة الثامنة
التأمين والفوترة

المرحلة التاسعة
التقارير ولوحات المعلومات

المرحلة العاشرة
الاختبارات النهائية والتكامل مع جميع موديولات الـ ERP.

====================================================
النتيجة النهائية المطلوبة
====================================================

المطلوب إنشاء منصة رعاية صحية احترافية تعمل كجزء من نظام ERP متعدد المستأجرين (Multi-Tenant SaaS)، بحيث تكون جميع التطبيقات مستقلة وقابلة للتطوير، وتتكامل بالكامل مع المحاسبة، والمخازن، والمشتريات، والمبيعات، والبنوك، والخزائن، والموارد البشرية، والعملاء، والموردين، مع الالتزام بالمعايير العالمية في تصميم الأنظمة الطبية، وعدم كتابة أي كود قبل اكتمال التحليل والتصميم واعتماد البنية المعمارية وقاعدة البيانات.
