موديول KPI - مؤشرات الأداء

الفكرة العامة

الموديول مبني على 4 مراحل متتابعة:

1) تعريف المؤشر (Create KPI)

⟸

2) عرض المؤشرات (KPI log)

⟸

3) قياس المؤشر (Measure KPI)

⟸

4) التاريخ والرسوم (History + Charts)

1) إنشاء مؤشر جديد (Create KPI)

الحقل	الشرح
Name	اسم المؤشر
Definition	تعريف المؤشر — ده بيقيس إيه بالظبط
Process Category	قائمة — اختيار واحد فقط من فئات العمليات الموجودة (مثل: Lab Examination، Equipment Management...)
Interpretation	نص يوضح إزاي نفسر النتيجة (ارتفاع الرقم كويس ولا وحش)
Aggregation	طريقة تجميع البيانات: % (نسبة) / Rate (معدل) / Count (عدد) / Sum (إجمالي) / Average (متوسط)
Target	الهدف المطلوب الوصول له
Measurement frequency	كل قد إيه يتم القياس (يومي/أسبوعي/شهري/ربع سنوي/نصف سنوي/سنوي)
Type of sample	هل القياس على كل المجتمع (full population) أو على عينة (subset)
Data Source	نص — من فين بييجي مصدر البيانات
Branch	أكتر من فرع — المؤشر ده يتقاس في أنهي فروع

المعادلة (Equation) — حسب نوع الـ Aggregation

النوع	المعادلة
Percentage %	`KPI% = (Denominator ÷ Numerator) × 100`
Rate	`Rate = (Population ÷ Events) × k` حيث k = 10 أو 100 أو 1000
Count	عدّ بسيط
Sum	إجمالي
Average	متوسط

2) سجل المؤشرات (KPI log)

شاشة عرض لكل المؤشرات المُنشأة:

NameProcess CategoryBranchTargetFrequency

3) قياس المؤشر (Measure KPI for each branch)

يتم لكل فرع على حدة كل ما تيجي فترة القياس حسب الـ Frequency:

Fill the space in the equation: المستخدم بيدخل الأرقام الفعلية حسب نوع المعادلة:
- Percentage → Numerator + Denominator
- Rate → Population + Events
- Count / Sum / Average → القيمة المباشرة
النظام يحسب Result تلقائيًا من المعادلة
Performance Status: مقارنة النتيجة بالـ Target → "Met Target" (أخضر) أو "Not Met" (أحمر)

لو النتيجة "Not Met" يظهر للمستخدم اختياران:

Add improvement project → ربط القياس بمشروع تحسين (موديول Improvement Project)
Add occurrence → ربط القياس بواقعة/حادثة (جدول occurrences الموجود فعلاً في النظام)

4) عرض تاريخ كل مؤشر (View History)

BranchDateResultTargetPerformance StatusNext date

يوضح كل القياسات السابقة لمؤشر معين عبر الزمن، ومتى القياس القادم.

5) الرسوم البيانية (Charts for presentation)

عرض النتائج بشكل Charts للعرض على الإدارة — Dashboard مبني على بيانات kpi_measurements.

جداول قاعدة البيانات (5 جداول)

الجدول	وظيفته
`kpis`	تعريف المؤشر بالكامل (الاسم، المعادلة، الهدف، التكرار...)
`kpi_branches`	ربط المؤشر بالفروع المستهدفة (كثير لكثير)
`kpi_measurements`	كل عملية قياس فعلية: التاريخ، أرقام المعادلة، النتيجة، الهدف وقت القياس، حالة الأداء
`kpi_measurement_occurrences`	ربط القياس (لو Not Met) بواقعة في جدول `occurrences`
`kpi_measurement_improvement_projects`	ربط القياس (لو Not Met) بمشروع تحسين في جدول `improvement_projects`

kpis ──< kpi_branches >── branches
  │
  └──< kpi_measurements
            │
            ├──< kpi_measurement_occurrences >── occurrences
            └──< kpi_measurement_improvement_projects >── improvement_projects

نقاط تصميم مهمة

target بتتسجل كـ "snapshot" في كل قياس — لو غيّرت الهدف بعدين، القياسات القديمة تفضل محتفظة بالهدف اللي كان موجود وقت القياس، عشان التاريخ يبقى دقيق.
أعمدة المعادلة كلها في جدول واحد (kpi_measurements) بس فاضية إلا اللي يخص نوع الـ Aggregation المحدد.
مفيش تكرار لبيانات الـ Improvement Project — جدول الربط بسيط (مجرد ID للقياس + ID للمشروع) لأن كل التفاصيل موجودة في موديول Improvement Project المستقل.