نظام قياس الأداء الوظيفي | Government Performance Management System

📊 نظرة عامة

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

الأهداف الرئيسية

• ✅ التحول الرقمي: الانتقال من التقييم اليدوي إلى نظام إلكتروني شامل
• ✅ العدالة والشفافية: معايير موحدة وواضحة لقياس الأداء
• ✅ الكفاءة: أتمتة العمليات وتقليل الجهد الإداري
• ✅ التكامل: ربط الأداء بالترقيات، التدريب، والتطوير الوظيفي
• ✅ دعم القرار: تقارير تحليلية متقدمة للإدارة العليا
• ✅ الامتثال: التوافق مع معايير NCA و SDAIA

📊 حالة المشروع

✅ ما تم إنجازه (Completed)

المرحلة 1: التوثيق والتخطيط

• ✅ خطة التنفيذ الكاملة (8 أسابيع)
• ✅ مخطط قاعدة البيانات (19 جدول)
• ✅ توثيق API (200+ نقطة نهاية)
• ✅ دليل البناء والنشر

المرحلة 2: Backend Infrastructure

• ✅ هيكل المشروع (Clean Architecture)
• ✅ 13 Entity Models مع العلاقات
• ✅ EF Core DbContext مع الإعدادات الكاملة
• ✅ Data Seeding (5 أدوار، 16 صلاحية، بيانات تجريبية)
• ✅ Application Layer (DTOs, Services)
• ✅ API Controllers (Auth, Goals, Evaluations)
• ✅ JWT Authentication
• ✅ معادلة التقييم التلقائية
• ✅ إنشاء PIP تلقائي عند النتيجة < 2.5

الملفات المهمة:

• backend/SETUP.md - دليل الإعداد الشامل
• backend/src/PerformanceSystem.API/Program.cs - إعدادات API
• backend/src/PerformanceSystem.Infrastructure/Data/PerformanceDbContext.cs - سياق قاعدة البيانات

حسابات تجريبية:

اسم المستخدم	كلمة المرور	الدور
admin	Admin@123	مسؤول النظام
hr.manager	Hr@123	موارد بشرية
it.manager	Manager@123	مدير
john.doe	Employee@123	موظف

🚧 قيد التنفيذ (In Progress)

المرحلة 3: Frontend Development (الأسابيع 1-8)

• ⬜ Week 1: Infrastructure Setup (Redux, Theme, i18n, Auth)
• ⬜ Week 2: Common Components Library (15+ components)
• ⬜ Week 3: Employee Dashboard & Goals Management
• ⬜ Week 4: Manager Dashboard & Evaluations
• ⬜ Week 5: HR Dashboard & Reports
• ⬜ Week 6: Admin Dashboard & System Management
• ⬜ Week 7: Executive Dashboard & Notifications
• ⬜ Week 8: Testing, QA & Production Deployment

خطة Frontend مفصلة:

• 📄 docs/FRONTEND_PLAN.md - خطة شاملة (60+ صفحة)
• 📄 frontend/QUICKSTART.md - دليل البدء السريع

📅 المراحل القادمة (Upcoming)

المرحلة 4: التكامل والاختبار (الأسبوع 9-10)

• ⬜ اختبارات التكامل الكاملة
• ⬜ اختبارات الأداء
• ⬜ اختبارات الأمان
• ⬜ إصلاح الأخطاء

المرحلة 5: التكامل الخارجي (الأسبوع 11-12)

• ⬜ التكامل مع منصة مسار
• ⬜ التكامل مع نفاذ الوطني
• ⬜ التكامل مع HRMS
• ⬜ واجهات API خارجية

المرحلة 6: التدريب والنشر (الأسبوع 13-14)

• ⬜ تدريب المستخدمين
• ⬜ إنشاء أدلة المستخدم
• ⬜ النشر التجريبي
• ⬜ النشر النهائي

---

📸 Screenshots & Live Demo

صفحة تسجيل الدخول | Login Page

للحصول على لقطات الشاشة: اتبع الدليل في SCREENSHOTS_GUIDE.md

قريباً: لقطة شاشة لصفحة تسجيل الدخول

الميزات:

• تصميم حديث بألوان العلم السعودي
• دعم RTL كامل للعربية
• حقول username & password
• عرض الحسابات التجريبية

---

لوحة تحكم الموظف | Employee Dashboard

قريباً: لقطة شاشة للوحة التحكم

الميزات:

• بطاقات إحصائيات ملونة
• قائمة الأهداف مع نسب الإنجاز
• قائمة التقييمات مع الدرجات
• قائمة جانبية تفاعلية

---

إدارة الأهداف | Goals Management

قريباً: لقطة شاشة لإدارة الأهداف

الميزات:

• عرض جميع الأهداف
• Progress bars لكل هدف
• Status chips ملونة
• أوزان الأهداف (يجب أن يكون المجموع 100%)

---

التقييمات | Evaluations

قريباً: لقطة شاشة للتقييمات

الميزات:

• عرض الفترة ونوع التقييم
• الدرجة النهائية (0-5)
• التصنيف (ممتاز، فوق المتوقع، إلخ)
• Chips ملونة للحالات

---

🎬 Live Demos

Demo 1: تسجيل الدخول | Login Flow (5-10s)

قريباً: GIF لعملية تسجيل الدخول

Demo 2: جولة في لوحة التحكم | Dashboard Tour (15-20s)

قريباً: GIF لجولة في لوحة التحكم

Demo 3: رحلة المستخدم الكاملة | Complete Workflow (30-45s)

قريباً: GIF للرحلة الكاملة

---

🚀 How to Add Screenshots

Follow these steps to add screenshots and GIFs:

Quick Start (30 Minutes)

# 1. Run preparation script
bash scripts/prepare-screenshots.sh
# Or on Windows: scripts\prepare-screenshots.bat

# 2. Start backend
cd backend/src/PerformanceSystem.API
dotnet run

# 3. Start frontend
cd frontend
npm run dev

# 4. Follow screenshot guide
# Open: SCREENSHOTS_GUIDE.md
# Capture 8 screenshots + 3 GIFs

# 5. Add files to repo
cp ~/Desktop/*.png docs/screenshots/
cp ~/Desktop/*.gif docs/demos/

# 6. Update README (uncomment image links above)

# 7. Commit
git add docs/screenshots docs/demos README.md
git commit -m "docs: add platform screenshots and demos"
git push

Tools Needed

• Screenshots: Browser built-in tools (F12 or Windows+Shift+S)
• GIFs (Windows): ScreenToGif (Free)
• GIFs (Mac): LICEcap (Free)
• GIFs (Linux): Peek (sudo apt install peek)

Test Accounts

Use these accounts to explore the platform:

Username	Password	Role	Arabic
admin	Admin@123	Admin	مسؤول النظام
hr.manager	Hr@123	HR	موارد بشرية
it.manager	Manager@123	Manager	مدير
john.doe	Employee@123	Employee	موظف

---

🎯 الميزات الرئيسية

إدارة الأهداف الذكية (SMART Goals)

• تحديد واعتماد الأهداف بين الموظف والمدير
• ربط الأهداف الفردية بالأهداف الاستراتيجية للجهة
• متابعة نسب الإنجاز بشكل دوري

نظام التقييم المتكامل

• 60% تحقيق الأهداف
• 30% الكفاءات السلوكية
• 10% المبادرات والمساهمات
• ±0.15 / -0.20 أثر التدريب على الأداء

التصنيف التلقائي

• ⭐⭐⭐⭐⭐ ممتاز (4.5 - 5.0)
• ⭐⭐⭐⭐ فوق المتوقع (3.5 - 4.49)
• ⭐⭐⭐ مرضي (2.5 - 3.49)
• ⭐⭐ أقل من المتوقع (1.5 - 2.49)
• ⭐ ضعيف (0.0 - 1.49)

إدارة الاعتراضات

• تقديم اعتراض إلكتروني خلال 5 أيام
• آلية واضحة لمراجعة واعتماد الاعتراضات
• متابعة حالة الاعتراض (Open/Accepted/Rejected/Adjusted)

خطة تحسين الأداء (PIP)

• فتح تلقائي عند الحصول على تقييم < 2.5
• خطة تطويرية مخصصة لكل موظف
• متابعة التقدم والنتائج

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

• ربط نتائج الدورات التدريبية بالأداء
• توصيات تدريبية ذكية حسب الفجوات
• قياس أثر التدريب على تحسين الأداء

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

• 📊 لوحة الموظف: أهدافي، تقييمي، خطة تطويري
• 📈 لوحة المدير: أداء الفريق، الاعتراضات، خطط التحسين
• 📉 لوحة HR: نسب التقييم، المرشحون للترقية، الامتثال
• 🎯 لوحة الإدارة العليا: الأداء المؤسسي، المخاطر، التوصيات

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

• تقرير الأداء الفردي (PDF/Excel)
• تقرير أداء الفريق
• تقرير المرشحين للترقية
• تقرير أثر التدريب
• تقرير الاعتراضات
• تقرير الامتثال

التكامل مع الأنظمة الخارجية

• 🔗 منصة مسار: رفع النتائج النهائية تلقائياً
• 🔗 HRMS: مزامنة بيانات الموظفين والإدارات
• 🔗 نظام التدريب: استقبال نتائج الدورات
• 🔗 SSO/نفاذ: الدخول الموحد الآمن

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

Frontend

• Framework: React 18+ with TypeScript
• UI Library: Material-UI (RTL Support)
• State Management: Redux Toolkit
• Charts: Chart.js / Recharts
• Forms: React Hook Form

Backend

• Framework: ASP.NET Core 8.0 (C#)
• ORM: Entity Framework Core
• API: RESTful with Swagger/OpenAPI
• Authentication: OAuth2 / SAML 2.0

Database

• Primary: SQL Server 2019+
• Alternative: PostgreSQL 15+
• Migrations: EF Core Migrations

Security

• Encryption: AES-256 (at rest), TLS 1.3 (in transit)
• Authentication: SSO, نفاذ الوطني, MFA
• Authorization: RBAC (Role-Based Access Control)
• Compliance: NCA ECC/DCC Standards

DevOps

• CI/CD: GitHub Actions / Azure DevOps
• Containerization: Docker
• Hosting: On-Premise / Azure Gov Cloud
• Monitoring: Application Insights

📁 هيكل المشروع

KPI-Measuring/
├── frontend/              # React Frontend Application
├── backend/               # ASP.NET Core Backend
├── database/              # Database Scripts & Migrations
├── docs/                  # Documentation
├── infrastructure/        # IaC & Docker
└── README.md

🚀 البدء السريع

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

• Node.js 18+ و npm/yarn
• .NET 8.0 SDK
• SQL Server 2019+ أو PostgreSQL 15+
• Git
• Docker (اختياري)

تشغيل Frontend

cd frontend
npm install
npm start

الواجهة ستعمل على: http://localhost:3000

تشغيل Backend

cd backend/src/PerformanceSystem.API
dotnet restore
dotnet ef database update
dotnet run

API ستعمل على: https://localhost:5001

تشغيل Database

# SQL Server
sqlcmd -S localhost -U sa -P YourPassword -i database/setup.sql

# PostgreSQL
psql -U postgres -d performance_db -f database/setup.sql

📖 التوثيق

التخطيط والتصميم

• 📋 خطة المشروع الكاملة - نظرة شاملة على المشروع
• 📝 المهام التفصيلية - 159 مهمة موزعة على 9 مراحل
• 🔄 مخططات سير العمل - 13 workflow مفصل
• 📅 المعالم الزمنية - الجدول الزمني والتقدم
• 📋 خطة التنفيذ الكاملة - خطة 8 أسابيع للمشروع
• 🎨 خطة تطوير Frontend - خطة شاملة لتطوير الواجهة (60+ صفحة)
• ⚡ دليل البدء السريع - Frontend - ابدأ التطوير بسرعة
• 📊 خريطة الطريق 2025-2027

البنية التقنية والمعمارية

• 🗄️ مخطط قاعدة البيانات - 19 جدول مع SQL
• 📊 ERD تفاعلي - مخططات Mermaid تفاعلية
• 🔌 توثيق API - 200+ نقطة نهاية
• 📡 Postman Collection - مجموعة API جاهزة
• 💡 أمثلة API - أمثلة شاملة لاستخدام API
• ⚙️ دليل إعداد Backend - إعداد شامل لـ .NET
• 🏗️ دليل البناء - Docker + Local Development
• 🏛️ قرارات معمارية (ADRs) - 4 ADRs موثقة
• 👨‍💻 دليل المطورين - معايير البرمجة والتطوير

النشر والعمليات

• 🚀 دليل النشر - خطوات النشر الكاملة
• ✅ قائمة التحقق للإنتاج - 100+ عنصر للتحقق
• 🔄 خطة التراجع - إجراءات الطوارئ
• 📊 إعداد المراقبة - Prometheus, Grafana, ELK
• 🐳 Docker Compose - بيئة كاملة بأمر واحد

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

• 🔒 قائمة التحقق الأمني - 200+ عنصر أمني
• 🛡️ حماية البيانات - NCA و PDPL compliance
• 🚨 الاستجابة للحوادث - خطة الطوارئ الأمنية

الاختبار

• 🎯 استراتيجية الاختبار - Unit, Integration, E2E
• 📋 حالات الاختبار - اختبارات تفصيلية
• 🔄 سيناريوهات E2E - اختبارات شاملة

CI/CD والأتمتة

• ⚙️ Backend CI/CD - اختبار وبناء Backend
• 🎨 Frontend CI/CD - اختبار وبناء Frontend
• 🔒 فحص أمني - CodeQL, Trivy, SAST
• 🚀 النشر التلقائي - نشر متعدد البيئات

عمليات الصيانة

• 🔧 حل المشاكل - مشاكل شائعة وحلولها
• ⚡ تحسين الأداء - Backend, Frontend, DB

الأدلة الإضافية

• 👤 دليل المستخدم
• 🤝 دليل المساهمة
• ❓ الأسئلة الشائعة
• 🛠️ سكريبت الإعداد - إعداد بيئة التطوير تلقائياً
• 📝 ملف البيئة النموذجي - Environment variables

🧪 الاختبار

Backend Tests

cd backend
dotnet test

Frontend Tests

cd frontend
npm test
npm run test:e2e

Performance Tests

k6 run tests/performance/load-test.js

🔒 الأمن والامتثال

• ✅ التوافق مع ضوابط NCA (الهيئة الوطنية للأمن السيبراني)
• ✅ تشفير شامل للبيانات الحساسة (AES-256)
• ✅ TLS 1.3 لجميع الاتصالات
• ✅ Audit Logs لجميع العمليات الحساسة
• ✅ RBAC مع Least Privilege Principle
• ✅ MFA للمستخدمين ذوي الصلاحيات العالية
• ✅ النسخ الاحتياطي المشفر
• ✅ خطة الاستجابة للحوادث

📊 مؤشرات النجاح

المؤشر	الهدف
نسبة الاستخدام	≥ 90%
رضا المستخدمين	≥ 85%
دقة احتساب التقييم	≥ 99.9%
زمن تحميل الصفحة	≤ 3 ثوانٍ
زمن استجابة API	≤ 1 ثانية
التوفر	≥ 99.5%
معالجة الاعتراضات	≤ 5 أيام
دقة الربط مع مسار	≥ 99%

🗓️ الجدول الزمني

• MVP (النسخة الأولى): 8 أسابيع
• التشغيل التجريبي: 2 أسابيع
• الإطلاق الكامل: 10-11 أسبوع

👥 الأدوار والصلاحيات

الموظف (Employee)

• عرض الأهداف والتقييمات
• تقديم الاعتراضات
• الاطلاع على خطة التطوير

المدير المباشر (Manager)

• تحديد الأهداف
• إدخال التقييمات
• مراجعة الاعتراضات
• متابعة خطط التحسين

الموارد البشرية (HR)

• إدارة دورة الأداء
• متابعة الاعتراضات
• إصدار التقارير
• إدارة خطط التحسين والتطوير

الإدارة العليا (Executive)

• لوحة المؤشرات المؤسسية
• التقارير الاستراتيجية
• اتخاذ القرارات

مسؤول النظام (System Admin)

• إدارة الصلاحيات
• مراقبة النظام والتكامل
• الأمان والنسخ الاحتياطي

🌟 التحسينات المستقبلية

• 🤖 الذكاء الاصطناعي التنبؤي لتوقع انخفاض الأداء
• 🎁 نظام المكافآت المرتبط بالأداء
• ✍️ التوقيع الإلكتروني المعتمد
• 📱 تطبيق الجوال (iOS/Android)
• 🗄️ التكامل مع الأرشفة الحكومية
• 📈 لوحة مؤشرات المخاطر الوظيفية

📞 الدعم والمساعدة

• البريد الإلكتروني:admin@mmit.sa
• الهاتف: 0504875663
• ساعات العمل: الأحد - الخميس، 8 صباحاً - 4 مساءً

📄 الترخيص

هذا المشروع ملك للجهة الحكومية المستفيدة ومخصص للاستخدام الحكومي فقط.

🙏 شكر وتقدير

تم تطوير هذا النظام بالتعاون مع:

• وزارة الموارد البشرية والتنمية الاجتماعية
• الهيئة الوطنية للأمن السيبراني (NCA)
• الهيئة السعودية للبيانات والذكاء الاصطناعي (SDAIA)

---

آخر تحديث: نوفمبر 2025 الإصدار: 1.0 الحالة: 🚧 قيد التطوير