دليل المستخدم الشامل

📚 1. مقدمة عن النظام

مرحبا بكم في نظام إدارة الأجهزة الملاحية والرادار التابع للإدارة العامة لخفر السواحل في دولة الكويت. تم تطوير هذا النظام لإدارة وتتبع أجهزة الملاحة والرادارات والاتصالات المثبتة على دوريات خفر السواحل بكفاءة عالية.

ماذا يقدم النظام؟

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

📱 2. تثبيت التطبيق

النظام يعمل كتطبيق ويب تقدمي (PWA) - يمكنك تثبيته على جهازك للوصول السريع وتجربة تشبه التطبيقات الأصلية.

تثبيت على Android

1. افتح الموقع في متصفح Chrome
2. سيظهر بانر تثبيت تلقائي أسفل الشاشة - اضغط "تثبيت"
3. إذا لم يظهر البانر: اضغط على القائمة (النقاط الثلاث ⋮) ثم اختر "إضافة إلى الشاشة الرئيسية"
4. سيظهر التطبيق كأيقونة على الشاشة الرئيسية

تثبيت على iPhone / iPad

1. افتح الموقع في متصفح Safari (إلزامي - لا يعمل من Chrome على iOS)
2. اضغط على أيقونة المشاركة (المربع مع السهم للأعلى) في أسفل الشاشة
3. مرر للأسفل واختر "إضافة للشاشة الرئيسية" (Add to Home Screen)
4. اضغط "إضافة"
5. سيظهر التطبيق كأيقونة على الشاشة الرئيسية

تثبيت على الكمبيوتر

1. افتح الموقع في Chrome أو Edge
2. ابحث عن أيقونة التثبيت في شريط العنوان (عادة على اليمين)
3. اضغط عليها واختر "تثبيت"
4. سيفتح التطبيق في نافذة مستقلة بدون شريط المتصفح

🔒 3. تسجيل الدخول

عند فتح النظام لأول مرة، ستظهر لك صفحة تسجيل الدخول. يوفر النظام طريقتين للدخول:

صورة: صفحة تسجيل الدخول - login.png

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

الطريقة الأولى: اسم المستخدم وكلمة المرور

1. أدخل اسم المستخدم في الحقل المخصص
2. أدخل كلمة المرور
3. اضغط زر "تسجيل دخول"

الطريقة الثانية: تسجيل الدخول بالبصمة (WebAuthn / Face ID)

إذا كان جهازك يدعم البصمة أو التعرف على الوجه، يمكنك تسجيل الدخول بسرعة بدون كتابة كلمة المرور:

1. عند تسجيل الدخول الأول بكلمة المرور، ستظهر رسالة تسألك عن تفعيل البصمة
2. اضغط "تفعيل" وقم بتأكيد البصمة أو الوجه على جهازك
3. في المرات التالية، اضغط فقط زر "دخول بالبصمة" على صفحة تسجيل الدخول

طلب إنشاء حساب جديد

إذا لم يكن لديك حساب، يمكنك الضغط على رابط "طلب حساب جديد" أسفل نموذج الدخول. سيتم إرسال الطلب للمشرف الرئيسي للموافقة عليه.

📊 4. لوحة التحكم الرئيسية

لوحة التحكم هي الصفحة الأولى التي تظهر بعد تسجيل الدخول. تعرض ملخصا شاملا لحالة النظام والبيانات المهمة.

صورة: لوحة التحكم الرئيسية - dashboard-alerts.png

لوحة التحكم الرئيسية مع الإحصائيات والتنبيهات

تعرض لوحة التحكم:

• إحصائيات الدوريات: عدد الدوريات الإجمالي وحالة الأجهزة
• عداد البلاغات: عدد البلاغات حسب كل حالة (جديد، متابعة، شركات، منجز)
• تنبيهات الكفالات: الكفالات القريبة من الانتهاء أو المنتهية

🔧 5. شريط الأدوات العلوي

🔧 صورة شريط الأدوات

يظهر شريط الأدوات في أعلى كل صفحة ويحتوي على أدوات سريعة مهمة.

عناصر شريط الأدوات

🔍 6. البحث الشامل

يتيح لك البحث الشامل إيجاد أي معلومة في النظام بسرعة عبر كتابة كلمة أو عبارة في حقل البحث.

صورة: البحث الشامل - global-search.png

واجهة البحث الشامل

كيفية الاستخدام

1. اضغط على حقل البحث في أعلى الصفحة أو اضغط رمز البحث
2. اكتب كلمة البحث (مثلا: رقم دورية، اسم جهاز، رقم بلاغ، اسم شركة)
3. ستظهر النتائج فورا مصنفة حسب الأقسام

فلتر الأقسام

يمكنك تضييق نطاق البحث على قسم محدد باستخدام أزرار الفلتر:

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

🚢 7. الدوريات

قسم الدوريات هو القسم الأساسي في النظام. يعرض جميع دوريات خفر السواحل مع أجهزتها ونواقصها وتاريخها الزمني.

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

صورة: قائمة الدوريات - patrols-list.png

قائمة الدوريات المصنفة

تصنيفات الدوريات

الدوريات مصنفة حسب النوع:

• تامبا (Tampa)
• ربز
• دوريات صغيرة (1-10)
• دوريات متوسطة (200)
• دوريات كبيرة (300)
• وغيرها من التصنيفات

فلاتر القائمة

• الكل: عرض جميع الدوريات
• كبيرة: الدوريات الكبيرة فقط
• صغيرة: الدوريات الصغيرة فقط
• كفالات: الدوريات التي لديها كفالات سارية
• أعطال: الدوريات التي لديها أعطال حالية

صورة: بطاقات الدوريات - patrol-cards.png

بطاقات الدوريات مع ملخص حالة الأجهزة

كل بطاقة دورية تعرض:

• رقم الدورية ونوعها
• إحصائية الأجهزة: المجموع / يعمل / لا يعمل
• ألوان سريعة تدل على الحالة

تفاصيل الدورية

صورة: تفاصيل الدورية - patrol-detail.png

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

تعرض صفحة التفاصيل: معلومات الدورية الأساسية (الرقم والنوع والتصنيف)، تبويبات التفاصيل (أجهزة / سجل زمني / صور / مستندات)، وبطاقات الأجهزة المثبتة على الدورية.

عند الضغط على بطاقة دورية، تفتح صفحة التفاصيل التي تحتوي على:

• تبويب الأجهزة: جميع الأجهزة المثبتة على الدورية
• تبويب السجل الزمني: تاريخ جميع العمليات على الدورية
• تبويب الصور: صور الأجهزة والدورية
• تبويب المستندات: ملفات مرفقة (PDF، صور، إلخ)

بطاقة الجهاز

صورة: بطاقة الجهاز - patrol-equipment.png

بطاقات الأجهزة مع حالاتها

كل جهاز يعرض:

• نوع الجهاز: رادار، GPS، بلوتر، VHF، نوكيا، موتورولا، وغيرها
• الحالة بالألوان:
  • أخضر = يعمل
  • برتقالي = يعمل بملاحظة (يوجد ملاحظة لكن الجهاز يعمل)
  • أحمر = لا يعمل (عطل)
• النواقص: قطع الغيار أو الإصلاحات المطلوبة

إضافة أو تعديل جهاز

1. افتح تفاصيل الدورية
2. اضغط زر "إضافة جهاز" أو اضغط على بطاقة جهاز موجود للتعديل
3. املأ البيانات: النوع، الموديل، الرقم التسلسلي، الحالة
4. اضغط "حفظ"

السجل الزمني (Timeline)

صورة: السجل الزمني - patrol-timeline.png

السجل الزمني للدورية

يعرض تاريخ كل عملية تمت على الدورية مرتبة زمنيا (إضافة أجهزة، تغيير حالات، ملاحظات، إلخ).

📣 8. البلاغات

نظام البلاغات يتيح تتبع الأعطال والمشكلات من لحظة اكتشافها حتى حلها بالكامل.

صورة: صفحة البلاغات - issues-page.png

صفحة البلاغات

تتضمن الصفحة فلاتر الحالة للتصفية حسب حالة البلاغ، وبطاقات البلاغات مع تفاصيلها وأزرار التحكم.

صورة: فلاتر البلاغات - issues-filters.png

أزرار تصفية البلاغات حسب الحالة

حالات البلاغ

إنشاء بلاغ جديد

1. اضغط زر "إرسال بلاغ" في أعلى صفحة البلاغات
2. اختر رقم الدورية من القائمة المنسدلة
3. اختر نوع العطل (رادار، GPS، اتصالات، إلخ)
4. اختر حالة الجهاز
5. اكتب وصف المشكلة بالتفصيل
6. يمكنك إرفاق صورة أو فيديو للعطل
7. اضغط "إرسال البلاغ"

صورة: نموذج إرسال بلاغ - new-issue-form.png

نموذج إرسال بلاغ عطل جديد

إدارة البلاغ

• تغيير الحالة: اضغط على أزرار الحالة السريعة (متابعة / شركات / منجز) لنقل البلاغ للمرحلة التالية
• إضافة ملاحظات: يمكنك إضافة ملاحظات وتحديثات على البلاغ في أي وقت
• إرفاق صور: التقاط أو رفع صور توضيحية
• أرشيف المنجز: البلاغات المنجزة تنتقل للأرشيف ويمكن مراجعتها من فلتر "منجز"

صورة: الرد على بلاغ - issue-reply.png

إدارة البلاغ: أزرار تغيير الحالة والرد

🏢 9. الشركات

قسم الشركات يدير جميع الشركات المزودة للأجهزة والخدمات، سواء المحلية أو الخارجية.

صورة: صفحة الشركات - companies-page.png

صفحة قائمة الشركات

تتضمن الصفحة تبويبات لتصنيف الشركات (محلية/خارجية) وبطاقات الشركات مع معلومات التواصل السريع.

أنواع الشركات

• شركات محلية 🇰🇼: الشركات الكويتية المسجلة محليا
• شركات خارجية 🌍: الشركات الدولية والوكلاء الخارجيون

إضافة شركة جديدة

1. اضغط زر "إضافة شركة"
2. املأ بيانات الشركة: الاسم، النوع (محلية/خارجية)، رقم الهاتف، البريد الإلكتروني
3. اضغط "حفظ"

تفاصيل الشركة

صورة: تفاصيل الشركة - company-detail.png

صفحة تفاصيل الشركة

صفحة تفاصيل الشركة تحتوي على تبويبات متعددة:

• المستندات: رفع وإدارة ملفات الشركة (عقود، مراسلات، شهادات)
• الكفالات: عقود الكفالة المرتبطة بالشركة
• عروض الأسعار: عروض الأسعار والفواتير
• الأشخاص: موظفي الشركة وبياناتهم ومستنداتهم
• المركبات: مركبات الشركة المسجلة

رفع الملفات

يدعم النظام رفع أنواع متعددة من الملفات:

• ملفات PDF
• صور (JPEG, PNG, WebP)
• ملفات Word (DOC, DOCX)

التواصل السريع

من بطاقة الشركة يمكنك:

• واتساب: فتح محادثة واتساب مباشرة مع الشركة
• اتصال: الاتصال الهاتفي المباشر
• إيميل: إرسال بريد إلكتروني

📋 10. الكفالات

نظام إدارة الكفالات يتتبع جميع عقود الكفالة والضمان المرتبطة بالأجهزة والدوريات.

صورة: الكفالات - warranties.png

الجدول الزمني المرئي للكفالات

حالات الكفالة

إضافة كفالة جديدة

1. اضغط "إضافة كفالة"
2. اختر الشركة المزودة
3. اختر الدورية أو الأجهزة المشمولة
4. حدد تاريخ البدء وتاريخ الانتهاء
5. أضف أي ملاحظات إضافية
6. اضغط "حفظ"

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

النظام يرسل تنبيهات تلقائية قبل انتهاء الكفالة بـ 30 يوما. تظهر هذه التنبيهات في:

• لوحة التحكم الرئيسية
• قسم الإشعارات
• صفحة الكفالات

📦 11. المخزن

نظام المخزن يتتبع قطع الغيار والمواد المخزنية مع حركات الإضافة والصرف والإرجاع.

صورة: المخزن - inventory.png

صفحة إدارة المخزن

قائمة الأصناف

تعرض جميع الأصناف المخزنية مع الكميات المتاحة. يمكنك البحث بالاسم أو الرمز.

إضافة صنف جديد

1. اضغط "إضافة صنف"
2. أدخل: اسم الصنف، الوحدة، الكمية الأولية
3. اضغط "حفظ"

حركات المخزن

تسجيل حركة مخزنية

1. اختر الصنف من القائمة
2. اضغط على نوع الحركة (إضافة / صرف / إرجاع)
3. أدخل الكمية والملاحظات
4. اضغط "تنفيذ"

📖 12. دفتر الأحوال

دفتر الأحوال الإلكتروني يسجل جميع أحداث المناوبة بشكل متتابع زمنيا.

صورة: دفتر الأحوال - duty-log.png

دفتر الأحوال

طريقة العرض

دفتر الأحوال يعرض الأحداث بشكل متتابع زمنيا (من الأحدث للأقدم) مقسمة حسب نظام الإلزام:

• الإلزام الأول: المناوبة الصباحية
• الإلزام الثاني: المناوبة المسائية

إضافة حدث جديد

1. اضغط "إضافة حدث"
2. اختر الإلزام (الأول أو الثاني)
3. اكتب وصف الحدث
4. سيتم تسجيل الوقت والتاريخ تلقائيا
5. اضغط "حفظ"

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

يمكنك تصدير دفتر الأحوال للطباعة أو كملف رقمي بالضغط على زر "تصدير".

🤖 13. المساعد الذكي (AI)

المساعد الذكي مدعوم بتقنية Claude AI ويقدم مساعدة فورية في استخدام النظام وتحليل البيانات.

صورة: المساعد الذكي - ai-assistant.png

واجهة المساعد الذكي

واجهة المساعد الذكي تتضمن أزرار سريعة باقتراحات جاهزة للأسئلة الشائعة، منطقة المحادثة للأسئلة والأجوبة، وحقل إدخال لكتابة السؤال أو إرفاق صورة.

ما يمكن للمساعد الذكي فعله

• أسئلة عن بيانات النظام: "كم بلاغا جديدا اليوم؟"، "ما نواقص الدورية 830؟"، "إحصائيات الشهر"
• دعم فني: "كيف أضيف جهاز جديد؟"، "لماذا لا تعمل المزامنة؟"، "شرح إعدادات الرادار"
• تحليل صور: أرفق صورة لجهاز أو شاشة خطأ وسيحللها المساعد ويقدم اقتراحات
• بحث الإنترنت: البحث عن معلومات تقنية عن الأجهزة والقطع
• إدخال صوتي: اضغط زر المايكروفون وتحدث بدلا من الكتابة

الأزرار السريعة

تظهر أزرار سريعة تقترح أسئلة شائعة مثل:

• "ملخص البلاغات"
• "إحصائيات الأجهزة"
• "الكفالات المنتهية"
• "نواقص الدوريات"

🎤 14. الأوامر الصوتية

يدعم النظام الأوامر الصوتية للتنقل السريع بين الأقسام وتنفيذ العمليات الشائعة بالصوت.

كيفية الاستخدام

1. اضغط زر المايكروفون 🎤 في واجهة المساعد الذكي أو في شريط الأدوات
2. سيطلب المتصفح إذن استخدام المايكروفون (اقبل)
3. تحدث بالأمر الصوتي بوضوح باللغة العربية
4. سينفذ النظام الأمر فورا

أمثلة على الأوامر الصوتية

📲 15. نظام QR Code

📲 صورة نتيجة مسح QR

لكل دورية رمز QR فريد يمكن مسحه بالجوال للوصول السريع لتفاصيلها.

استخدامات QR Code

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

طباعة QR جماعية

1. من لوحة التحكم، اضغط زر "طباعة QR"
2. ستُنشأ صفحة تحتوي على رموز QR لجميع الدوريات
3. اطبع الصفحة وقص كل رمز على حدة

مسح QR Code

1. افتح كاميرا الجوال أو أي تطبيق قارئ QR
2. وجه الكاميرا نحو رمز QR الملصق على الدورية
3. اضغط على الرابط الذي يظهر
4. ستفتح صفحة تفاصيل الدورية في المتصفح

🔔 16. الإشعارات والبريد الداخلي

صورة: الإشعارات - notifications.png

واجهة الإشعارات

الإشعارات الفورية

يرسل النظام إشعارات تلقائية عند:

• إنشاء بلاغ جديد
• تغيير حالة بلاغ
• اقتراب انتهاء كفالة
• انتهاء كفالة
• رسالة بريد داخلي جديدة

البريد الداخلي

نظام مراسلات داخلي بين مستخدمي النظام. يمكنك:

• إرسال رسالة لأي مستخدم آخر
• استقبال الرسائل مع إشعار فوري
• تحديد الكل كمقروء
• حذف الرسائل

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

• عدد الإشعارات: يظهر بادج أحمر على رمز الجرس بعدد الإشعارات غير المقروءة
• تحديد الكل كمقروء: اضغط "تحديد الكل كمقروء" لإزالة البادج
• مسح الكل: حذف جميع الإشعارات

📶 17. العمل بدون إنترنت

النظام مصمم للعمل في البيئة البحرية حيث قد ينقطع الإنترنت. يمكنك الاستمرار في العمل بدون اتصال.

كيف يعمل؟

• Service Worker: تقنية تحفظ ملفات التطبيق محليا على جهازك
• IndexedDB: قاعدة بيانات محلية تخزن جميع بياناتك على الجهاز
• عند انقطاع الإنترنت: يمكنك الاستمرار في تصفح البيانات وإضافة سجلات جديدة وتعديل البيانات
• عند عودة الإنترنت: المزامنة التلقائية ترفع جميع التغييرات المحلية للخادم السحابي

مؤشر التغييرات المعلقة (localPending)

إذا كانت هناك تغييرات محلية لم تُرفع بعد للخادم، سترى مؤشرا يدل على ذلك:

• مؤشر المزامنة أصفر: توجد تغييرات معلقة
• عند عودة الاتصال: يحاول النظام رفع التغييرات تلقائيا
• مزامنة يدوية: اضغط زر المزامنة اليدوية (☁️) لفرض الرفع

نظام الحفظ المتعدد الطبقات

❓ 18. الأسئلة الشائعة