Skip to content

mmitsa/adaaa-paltform

Repository files navigation

نظام قياس الأداء الوظيفي للجهات الحكومية السعودية

نظام شامل لإدارة وتقييم أداء الموظفين في القطاع الحكومي وفقاً للوائح وزارة الموارد البشرية والتنمية الاجتماعية السعودية.

🎯 نظرة عامة

هذا النظام هو نسخة MVP (الحد الأدنى من المنتج القابل للتطبيق) يوفر منصة إلكترونية متكاملة لإدارة دورة الأداء السنوية، بدءاً من تحديد الأهداف الذكية (SMART)، مروراً بعملية التقييم، وصولاً إلى إدارة الاعتراضات وإصدار التقارير.

✨ الميزات الرئيسية الم��نفذة

1. إدارة المستخدمين والأدوار

  • نظام مصادقة آمن باستخدام Supabase Auth
  • أربعة أدوار رئيسية:
    • موظف (Employee)
    • مدير مباشر (Direct Manager)
    • إدارة الموارد البشرية (HR Admin)
    • مسؤول النظام (System Admin)
  • صلاحيات متدرجة حسب الدور
  • نظام Row Level Security (RLS) متكامل لحماية البيانات

2. قاعدة البيانات الشاملة

تم إنشاء 18 جدول رئيسي يغطي جميع جوانب النظام:

  • organizations - معلومات الجهات الحكومية
  • departments - الإدارات والهيكل التنظيمي
  • users - بيانات المستخدمين وملفاتهم الشخصية
  • performance_cycles - دورات الأداء السنوية
  • smart_goals - الأهداف الذكية للموظفين
  • competency_frameworks - أطر الكفاءات القابلة للتخصيص
  • competencies - الكفاءات الفردية
  • competency_levels - مستويات التقييم (1-5)
  • performance_evaluations - التقييمات الرئيسية
  • evaluation_goals_detail - تفاصيل تحقيق الأهداف
  • evaluation_behaviors_detail - تفاصيل تقييم السلوكيات
  • evaluation_initiatives - المبادرات والمساهمات
  • objections - اعتراضات الموظفين
  • objection_timeline - سجل الاعتراضات
  • notifications - الإشعارات
  • audit_logs - سجل التدقيق
  • system_settings - إعدادات النظام

3. نظام الحسابات الآلي

  • دالة calculate_evaluation_score() - حساب الدرجة النهائية الموزونة
  • دالة auto_classify_rating() - التصنيف التلقائي للأداء
  • محفزات (Triggers) لتحديث الدرجات تلقائياً
  • تطبيق المعادلة الرسمية: (60% أهداف + 30% سلوكيات + 10% مبادرات)

4. التصنيفات الخمسة للأداء

  • ممتاز (Excellent) - 90% فأعلى
  • فوق المتوقع (Above Expected) - 80-89%
  • مرضي (Satisfactory) - 60-79%
  • أقل من المتوقع (Below Expected) - 40-59%
  • ضعيف (Weak) - أقل من 40%

5. نظام التقويم المزدوج

  • دعم التقويم الهجري والميلادي معاً
  • عرض التواريخ بالصيغتين بشكل متزامن
  • إمكانية اختيار التفضيل الشخصي للموظف
  • مكون DualDatePicker لاختيار التواريخ

6. واجهة مستخدم احترافية

  • تصميم RTL (من اليمين لليسار) كامل
  • خطوط عربية احترافية (Cairo & Tajawal)
  • تصميم متجاوب لجميع الأجهزة (Desktop, Tablet, Mobile)
  • ألوان مناسبة للجهات الحكومية (أزرق، أخضر، أزرق فاتح - بدون بنفسجي)
  • قائمة جانبية قابلة للطي
  • نظام إشعارات في الوقت الفعلي
  • لوحة تحكم تفاعلية

7. الأمان والامتثال

  • تشفير البيانات الحساسة
  • Row Level Security (RLS) على جميع الجداول
  • سجل تدقيق شامل (Audit Logs) لمدة 12 شهر كحد أدنى
  • صلاحيات محددة بدقة لكل دور
  • حماية من العمليات المدمرة للبيانات

🏗️ البنية التقنية

Frontend

  • React 18 مع TypeScript
  • React Router DOM للتوجيه
  • Tailwind CSS للتصميم
  • Zustand لإدارة الحالة
  • React Hook Form + Zod للنماذج والتحقق
  • Recharts للرسوم البيانية
  • Lucide React للأيقونات
  • date-fns لإدارة التواريخ

Backend & Database

  • Supabase (PostgreSQL + Auth + Storage)
  • Row Level Security (RLS) لأمان البيانات
  • Database Functions للحسابات المعقدة
  • Triggers للتحديثات التلقائية

📋 المتطلبات

  • Node.js 18+ و npm
  • حساب Supabase نشط
  • متصفح حديث يدعم ES6+

🚀 التثبيت والتشغيل

1. تثبيت المتطلبات

npm install

2. إعداد المتغيرات البيئية

ملف .env موجود بالفعل ويحتوي على:

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

3. تشغيل النظام

npm run dev

4. بناء للإنتاج

npm run build

5. إنشاء حسابات المستخدمين

⚠️ مطلوب: إعداد يدوي للحسابات التجريبية

لا يمكن إنشاء المستخدمين تلقائياً عبر SQL. يجب إنشاؤهم عبر Supabase Dashboard:

📖 اتبع الدليل الكامل في: CREATE_USERS_GUIDE.md

الحسابات المطلوبة:

خطوات سريعة:

  1. افتح Supabase Dashboard → Authentication → Users
  2. أضف كل مستخدم بالبريد الإلكتروني وكلمة المرور
  3. فعّل "Auto Confirm User" لكل مستخدم
  4. انسخ User IDs واستخدمها في SQL لربط الحسابات بجدول public.users

📖 للتفاصيل الكاملة: راجع CREATE_USERS_GUIDE.md, ADMIN_SETUP.md, و QUICK_START.md

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

✅ تم إنجازه

  • البنية التحتية للقاعدة البيانات (18 جدول)
  • نظام المصادقة والصلاحيات
  • الواجهة الأساسية مع دعم RTL
  • نظام التقويم المزدوج (هجري/ميلادي)
  • لوحة التحكم الرئيسية
  • نظام الإشعارات
  • الحسابات التلقائية للتقييمات
  • سجل التدقيق
  • واجهة إدارة أطر الكفاءات (قابلة للتخصيص)
  • واجهة إدارة دورات الأداء السنوية
  • نظام إضافة وتعديل الكفاءات السلوكية
  • نظام إدارة الأهداف الذكية SMART
    • إنشاء وتعيين الأهداف من قبل المديرين
    • اعتماد أو رفض الأهداف من قبل الموظفين
    • نظام الأوزان النسبية مع التحقق (100%)
    • تتبع حالة الأهداف (مسودة/معلق/معتمد/مرفوض)
  • لوحة المدير لإدارة الفريق
    • عرض جميع أعضاء الفريق
    • إحصائيات الفريق (الأهداف والتقييمات)
    • الوصول السريع لأهداف وتقييمات الأعضاء
  • واجهة التقييمات
    • عرض التقييمات للموظفين والمديرين
    • نظام التصنيف الخماسي التلقائي
    • عرض الدرجات المفصلة (أهداف + سلوكيات + مبادرات)
    • حساب الدرجة النهائية الموزونة
  • نظام الاعتراضات الكامل
    • تقديم اعتراضات من قبل الموظفين
    • سير عمل الاعتراضات (مرسل → قيد المراجعة → اللجنة → تم البت)
    • إدارة القرارات (مقبول/مقبول جزئياً/مرفوض)
    • تتبع حالة الاعتراضات والتواريخ

🔄 قيد التطوير

  • واجهة التقييم التفصيلية (إدخال الدرجات)
  • لوحة الموارد البشرية الشاملة
  • التقارير والتحليلات المتقدمة
  • تصدير PDF للتقارير
  • التكامل مع منصة "مسار"
  • إدارة المستخدمين والصلاحيات

🎨 التصميم

النظام مصمم بعناية ليكون:

  • احترافي - ألوان وتصميم مناسب للقطاع الحكومي
  • سهل الاستخدام - واجهة بديهية باللغة العربية
  • متجاوب - يعمل على جميع الأجهزة والشاشات
  • سريع - تحميل سريع وأداء ممتاز
  • آمن - أمان متعدد الطبقات

🔐 الأمان

  • Authentication: Supabase Auth مع دعم email/password
  • Authorization: RLS policies على مستوى قاعدة البيانات
  • Audit Trail: تسجيل جميع العمليات الحساسة
  • Data Encryption: تشفير البيانات الحساسة
  • Session Management: إدارة الجلسات الآمنة

📱 التوافق

  • ✅ Chrome (آخر إصدارين)
  • ✅ Safari (آخر إصدارين)
  • ✅ Firefox (آخر إصدارين)
  • ✅ Edge (آخر إصدارين)
  • ✅ أجهزة iOS (Safari)
  • ✅ أجهزة Android (Chrome)

📞 الدعم الفني

للمزيد من المعلومات أو الدعم الفني، يرجى التواصل مع: مسارات المستكشف للاتصالات وتقنية المعلومات


© 2025 مسارات المستكشف للاتصالات وتقنية المعلومات - جميع الحقوق محفوظة

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published