دليل الإدارة والتسليم

١. الحسابات والصلاحيات

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

٢. إضافة صيدلية ونشرها

1. افتح لوحة الإدارة وسجّل الدخول، ثم اختر إضافة صيدلية.
2. أدخل الاسم والعنوان بالعربية ورقم الهاتف. أضف الترجمة الإنجليزية والمعلم القريب والرقم الإضافي إذا توفرت.
3. اختر بغداد والمنطقة الصحيحة. تشمل المناطق المضافة: شارع فلسطين، زيونة، الحارثية، المنصور، حي الجامعة، الجادرية، السيدية، علي الصالح، والدورة.
4. اضغط موقع الصيدلية على الخريطة، أو أدخل خط العرض وخط الطول من إحداثيات مؤكدة. تحريك الخريطة أو اختيار المنطقة وحده لا يكفي لتثبيت موقع الصيدلية.
5. ارفع الصور، وأدخل مواعيد العمل والمناوبات. اكتب تاريخ آخر تحقق بعد مراجعة المعلومات فعلاً مع الصيدلية.
6. يمكنك حفظ الصيدلية دون نشرها أثناء تجهيز المعلومات. عندما تكتمل المراجعة فعّل إظهار الصيدلية للزوار ثم اختر حفظ الصيدلية.
7. افتح الموقع العام وابحث عن اسمها للتأكد من الاسم والعنوان والهاتف والصور والحالة ومكان العلامة على الخريطة.

لتعديل صيدلية موجودة، اضغط تعديل في صفها داخل لوحة الإدارة. لإخفائها عن الجمهور ألغِ خيار النشر واحفظ. احتفظ بخيار بيانات نموذجية / وهمية للعينات فقط؛ أرقام العينات لا توفر زر اتصال.

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

٣. رفع الصور

من نموذج إضافة الصيدلية أو تعديلها اختر صورة نهارية وصورة ليلية من جهازك. يقبل الموقع JPEG / PNG / WebP حتى ٣ ميغابايت للصورة وبحد أقصى ٢٠ مليون بكسل. انتظر ظهور المعاينة وانتهاء الرفع ثم احفظ الصيدلية.

يعرض الموقع الصورة النهارية من ٦ صباحاً إلى ٦ مساءً بتوقيت بغداد، والليلية بقية اليوم. إذا توفرت صورة واحدة يستخدمها للحالتين، وإذا لم توجد صور يعرض رسماً بديلاً. يزيل الخادم بيانات الصورة الوصفية ويضغطها تلقائياً.

لتبديل الصورة اختر ملفاً جديداً، ولإزالة ارتباط الصورة اضغط حذف الصورة ثم احفظ. استخدم صوراً واضحة لواجهة الصيدلية يحق للفريق نشرها؛ لا تُقبل روابط صور خارجية أو ملفات SVG.

٤. المواعيد والمناوبات والحالة المؤقتة

جميع الأوقات بتوقيت بغداد. الحالة «مفتوحة» أو «مغلقة» تحسب من البيانات المسجلة والوقت الحالي؛ ليست تأكيداً مباشراً لوجود موظف في الصيدلية.

• مواعيد منتظمة: أضف فترة أو أكثر لكل يوم. اليوم الذي لا يحتوي فترات يُعد مغلقاً.
• العمل بعد منتصف الليل: الفترة 20:00 → 02:00 تعني الفتح مساء ذلك اليوم والإغلاق الساعة الثانية من اليوم التالي. لا تستخدم بداية ونهاية متساويتين.
• تعمل ٢٤ ساعة: اختر هذا النوع صراحة إذا كانت الصيدلية تعمل طوال اليوم.
• مناوبة: أضف تاريخ ووقت بداية ونهاية المناوبة، على أن تكون النهاية بعد البداية. حذف المناوبة يلغي أثرها بعد الحفظ.
• تغيير مؤقت: عند وجود إغلاق طارئ أو فتح استثنائي اختر الحالة ووقت انتهاء صالحاً. السبب خاص بالإدارة. بعد الانتهاء يعود النظام تلقائياً للجداول.

ترتيب احتساب الحالة: التغيير المؤقت الساري، ثم المناوبة السارية، ثم العمل ٢٤ ساعة، ثم الجدول الأسبوعي. الفترة تشمل لحظة بدايتها وتنتهي عند وقت الإغلاق.

راجع المواعيد عند كل تغيير، واطلب من الصيدلية إبلاغ الإدارة بالمناوبات والإغلاقات الاستثنائية. يظهر للزوار تنبيه للاتصال قبل الذهاب.

٥. حساب الصيدلية والاشتراك

1. احفظ سجل الصيدلية أولاً. من صفها في لوحة الإدارة اضغط الإحصائيات والاشتراك.
2. أنشئ اسم مستخدم وكلمة مرور خاصة بصاحب الصيدلية، واربط الحساب بالسجل الصحيح. سلّم البيانات له بوسيلة خاصة.
3. سجّل اسم خطة الاشتراك وتاريخ البداية وتاريخ الانتهاء، ثم اضغط حفظ الاشتراك. تتولى الإدارة تحديث هذه البيانات عند التجديد أو التصحيح. يبقى الاشتراك سارياً حتى نهاية يوم الانتهاء بتوقيت بغداد.
4. يدخل صاحب الصيدلية من /owner ببياناته لمتابعة أرقام صيدليته ومدة اشتراكها. لا تظهر هذه المعلومات للزوار.

هذه متابعة يدوية للاشتراكات؛ لا يوجد تحصيل أموال أو بوابة دفع أو تجديد مالي تلقائي. ظهور اشتراك فعّال لا يثبت دفع مبلغ. راجع تاريخ الانتهاء مع الصيدلية ورتب التجديد خارج الموقع.

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

٦. كيف نقرأ الإحصائيات؟

تعرض اللوحة نشاط آخر ٣٠ يوماً، مع أرقام خاصة بكل صيدلية. تستطيع الإدارة رؤيتها، ويستطيع حساب الصيدلية رؤية أرقام الصيدلية المرتبطة به فقط.

يُحتسب كل نوع حدث مرة واحدة لكل متصفح وصيدلية في اليوم. تكرار تحديث الصفحة أو فتح التفاصيل في اليوم نفسه لا يزيد نفس المؤشر لذلك المتصفح. المتصفح نفسه قد يظهر في أكثر من مؤشر وفي أكثر من يوم؛ لا تجمع الأرقام بوصفها عدد أشخاص مختلفين.

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

٧. البحث قبل تحديد الموقع أو بعده

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

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

إذا لم تظهر صيدلية، جرّب جزءاً أقصر من الاسم، واختر منطقتها الصحيحة، وأظهر جميع الحالات. قد تكون غير منشورة أو لم تُضف إلى الدليل بعد.

٨. تقييم الخمس نجوم

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

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

٩. أين يستخدم الموقع الذكاء الاصطناعي؟

زر البحث بالذكاء الاصطناعي يستخدم OpenAI، عند تفعيله، لفهم الطلب المكتوب بلغة طبيعية أو باللهجة العراقية وتحويله إلى مرشحات بحث: اسم الصيدلية، المنطقة، والحالة المطلوبة. مثال: «أريد صيدلية مناوبة بالمنصور». البحث العادي بالاسم متاح بشكل مستقل.

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

توضح واجهة البحث هل استُخدم OpenAI فعلاً، أو تفسير سابق محفوظ مؤقتاً، أم البحث العادي. تحفظ تفسيرات طلبات المنطقة والحالة العامة التي لا تتضمن اسم صيدلية لمدة ٢٤ ساعة لإعادة استخدامها دون طلب مدفوع جديد، ولا تحفظ أسماء البحث أو نص الطلب. إذا كانت الخدمة غير مفعلة، أو وصل الحد، أو تعذر الاتصال، يستمر البحث العادي وتظهر رسالة بذلك. لا يعد هذا المسار البديل دليلاً على إجراء استدعاء ذكاء اصطناعي.

ضبط التكلفة

لا يبدأ أي طلب مدفوع إلا بعد أن يضيف المسؤول التقني مفتاح OpenAI على الخادم ويفعّل الخدمة صراحة. لا يوضع المفتاح داخل الصفحة أو ملفات المتصفح أو الدليل.

يحجز التطبيق $0.005 لكل محاولة مدفوعة؛ لذلك يسمح السقف الافتراضي لدولارين بحد أقصى ٤٠٠ محاولة في الشهر رغم أن حد عدد الطلبات هو ٥٠٠. تبقى المحاولة محسوبة حتى عند فشلها أو انتهاء مهلة الاتصال، لمنع التكرار غير المحدود.

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

هذا سقف يطبقه التطبيق على طلباته وفق تقديره للتكلفة، وليس ضماناً لفاتورة حساب OpenAI بكامله. استخدام المفتاح في مشروع آخر لا يدخل في هذه الحدود. يخصص المسؤول مشروعاً ومفتاحاً لهذا الموقع، ويتابع الاستهلاك والتسعير عند التفعيل أو تغيير النموذج.

يرسل البحث الذكي نص البحث والمنطقة المختارة إلى الخدمة لفهم الطلب؛ لذلك يكفي كتابة اسم الصيدلية أو المنطقة والحالة المطلوبة، دون بيانات صحية أو شخصية.

١٠. سيناريو عرض المشروع للدكتور

1. جهّز صيدلية نموذجية منشورة، وعلّمها بأنها بيانات وهمية. جهّز جدولاً أو مناوبة مناسبة لوقت العرض.
2. تأكد مع المسؤول التقني من تفعيل OpenAI على الخادم وتوفر الحصة، ثم جرّب طلباً حقيقياً قبل العرض.
3. افتح الموقع دون تحديد الموقع، وابحث باسم الصيدلية لإظهار أن البحث الأساسي مستقل عن إذن الموقع.
4. استخدم البحث الذكي واكتب مثلاً «أريد صيدلية مناوبة بالمنصور». أظهر رسالة استخدام الذكاء الاصطناعي والنتائج المطابقة للسجلات.
5. اشرح أن النموذج فهم العبارة، بينما قاعدة البيانات والجداول حددت النتائج والحالة. إذا ظهر البحث العادي، وضح أن هذا اختبار للمسار البديل، ثم عالج سبب تعطل الخدمة قبل إثبات شرط الذكاء الاصطناعي.
6. افتح التفاصيل وسجّل تقييماً. ادخل بحساب الصيدلية وأظهر الإحصائيات والاشتراك، ثم بحساب الإدارة وأظهر إضافة صيدلية وتعديلها.
7. لشرح منع التكرار، افتح التفاصيل مرة ثانية من المتصفح نفسه في اليوم نفسه؛ لا يُفترض أن يتضاعف مؤشر زيارات الملف.

الصور والجداول التي تدخلها الإدارة، والحساب العادي للمسافة والإحصائيات، ليست بحد ذاتها استخداماً للذكاء الاصطناعي. الدليل العملي هنا هو طلب البحث الذي نفّذه OpenAI فعلاً.

١١. كيف يستلم الكروب الموقع ويديره؟

العمل اليومي لا يحتاج برمجة: عضو مخوّل يدخل لوحة الإدارة ويضيف الصيدليات والصور والمواعيد من النماذج. المسؤول التقني يتولى الاستضافة والنطاق والنسخ الاحتياطية والمفاتيح.

1. تسليم الملكية: استلام مستودع المصدر، وحسابات أو صلاحيات الاستضافة وقاعدة البيانات، والتحقق من ملكية النطاق وربطه. توثيق اسم المسؤول عن كل حساب وتكلفته.
2. تجهيز الدخول: تسليم حساب إداري خاص للفريق، وتغيير كلمات المرور عند التسليم. إنشاء حساب منفصل لكل صيدلية تحتاج لوحة خاصة.
3. تدريب عملي: ينفذ عضو من الفريق أمام المسؤول إضافة سجل تجريبي، رفع الصورتين، ضبط الموقع والمواعيد، النشر، التعديل، إنشاء حساب صيدلية وتحديث الاشتراك.
4. تفعيل الذكاء الاصطناعي: يضبط المسؤول مفتاح الخدمة وحدودها ويختبر طلباً حقيقياً ومسار الرجوع للبحث العادي. يتأكد الفريق من ظهور وضع التشغيل بوضوح.
5. البيانات الحقيقية: مراجعة الاسم والعنوان والهاتف والإحداثيات والصور والمواعيد مع كل صيدلية؛ إزالة نشر العينات عند الانتقال إلى الخدمة الفعلية.
6. النسخ الاحتياطي: تحديد مسؤول وجدول لنسخ قاعدة البيانات، وتجربة الاستعادة. قاعدة البيانات تشمل الصور والحسابات والإحصائيات والتقييمات والاشتراكات؛ إعادة نشر الكود وحدها لا تعد نسخة احتياطية.
7. فحص الإطلاق: تجربة الهاتف والحاسوب، العربية والإنجليزية، تسجيل الدخول والخروج، رفع صورة، البحث، إذن الموقع، لوحة الصيدلية، وحدود البحث الذكي على رابط النشر الفعلي.

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

١٢. حل المشاكل الشائعة

الصيدلية لا تظهر للزوار

تحقق من حفظ السجل وتفعيل النشر والمنطقة المختارة ومرشح الحالة ونص البحث.

الحالة لا تطابق الواقع

راجع التغيير المؤقت أولاً، ثم المناوبة ونوع العمل والجدول الأسبوعي. صحح البيانات بعد التواصل مع الصيدلية.

الصورة لا تُرفع

استخدم ملف JPEG / PNG / WebP صالحاً لا يزيد عن ٣ ميغابايت، ثم انتظر اكتمال الرفع واحفظ.

لا يظهر الموقع أو الخريطة

البحث يبقى متاحاً. يمكن للزائر السماح بالموقع من إعدادات المتصفح، وللإدارة إدخال الإحداثيات يدوياً عند تعذر الخريطة.

لا تزيد الإحصائيات عند تكرار الزيارة

هذا متوقع إذا كان نفس المتصفح قد سجّل نفس الحدث للصيدلية اليوم. حدّث لوحة الإحصائيات بعد تفاعل جديد.

البحث الذكي عاد إلى البحث العادي

راجع رسالة الواجهة؛ قد تكون الخدمة غير مفعلة أو الحصة منتهية أو الاتصال متعذراً. يتولى المسؤول التقني مراجعة الإعدادات دون إظهار المفتاح للزوار.

انتهت جلسة الدخول أو رفض الحفظ

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