PharmaChat — سيناريوهات اختبار الميزات الجديدة
قبل ما تبدأ: اتأكد إن السيرفرين شغالين:
كل السيناريوهات دي بتشتغل من المتصفح على http://localhost:5173
1) الحسابات (Sign up / Login / الجلسة)
| # |
الخطوات |
النتيجة المتوقعة |
| 1.1 |
افتح الموقع |
يحوّلك تلقائياً على /login |
| 1.2 |
اضغط "Sign up"، سجّل (اسم + إيميل + باسورد 6 حروف على الأقل) |
يدخّلك على الـDashboard فوراً |
| 1.3 |
اعمل refresh للصفحة (F5) |
تفضل داخل (الجلسة محفوظة في localStorage) |
| 1.4 |
اضغط Logout من الـsidebar |
يرجّعك لصفحة الدخول |
| 1.5 |
جرّب تسجّل بنفس الإيميل تاني |
رسالة خطأ "Email already registered" |
| 1.6 |
جرّب باسورد أقل من 6 حروف |
رسالة "Password must be at least 6 characters" |
| 1.7 |
جرّب Login بباسورد غلط |
"Invalid email or password" |
2) الجدول والـ Drug-Drug Interaction (أهم جزء)
روح على Schedule من الـsidebar.
سيناريو A — تفاعل خطير (HIGH) بدون فجوة رقمية
| الخطوات |
النتيجة المتوقعة |
ضيف Warfarin + Aspirin ثم Generate |
بانر تحذير أحمر [HIGH]: Warfarin ↔ Aspirin، والرسالة "افصل بينهما حسب النصيحة — استشر الصيدلي" (لأن الفجوة غير معروفة، فالنظام مبيخمّنش وقت) |
سيناريو B — تفاعل متوسط بفجوة تتطبّق تلقائياً
| الخطوات |
النتيجة المتوقعة |
ابدأ جدول جديد بـ Amlodipine + Aspirin فقط (دوايين مش مربوطين بالأكل بالقوة) |
الجرعات تتباعد، والبانر يقول "تمت المباعدة تلقائياً" لو نجح الفصل |
سيناريو C — الربط بمواعيد الأكل + استنتاج عدد الجرعات
| الخطوات |
النتيجة المتوقعة |
ضيف Metformin لوحده ثم Generate |
جرعاته تتحط على مواعيد الوجبات (doses_per_day في البيانات = null، فالنظام يستنتج العدد ويربطه بالأكل "with dinner / at bedtime") |
سيناريو D — جدول بسيط بدواء واحد
| الخطوات |
النتيجة المتوقعة |
ابدأ جديد بـ Atorvastatin فقط |
timeline بجرعة واحدة، من غير أي تحذيرات |
سيناريو E — تعديل القائمة وإعادة التوليد
| الخطوات |
النتيجة المتوقعة |
| امسح دواء بالـ X من الـchip، وضيف غيره، واضغط "Regenerate" |
الـtimeline والتحذيرات تتحدّث حسب القائمة الجديدة |
💡 تركيبة العرض القوية: Warfarin + Aspirin + Ibuprofen + Metformin معاً → هتشوف تحذيرين HIGH (Warfarin مع كل واحد) + تفاعل moderate (Aspirin↔Ibuprofen) + Metformin مربوط بالأكل.
3) جرعات اليوم (Taken / Snooze / Skip)
بعد ما تعمل جدول، روح على Today's Doses.
| # |
الخطوات |
النتيجة المتوقعة |
| 3.1 |
اضغط Taken على جرعة |
الحالة تبقى "Taken ✓"، ويطلع toast بالنقاط المكتسبة |
| 3.2 |
اضغط Skip (زرار التخطّي) |
toast فيه إرشاد الجرعة الفائتة المأخوذ من بيانات الدواء نفسه |
| 3.3 |
اضغط Snooze (الساعة) |
الحالة "مؤجّلة" + جرعة جديدة تتعمل بعد 15 دقيقة |
| 3.4 |
جرعة اتعمل عليها أكشن |
الأزرار تختفي وتفضل الحالة ثابتة |
4) النقاط والبادجز والـ Leaderboard
| # |
الخطوات |
النتيجة المتوقعة |
| 4.1 |
خد أول جرعة في حياتك |
بادج first_dose يظهر في الـDashboard |
| 4.2 |
شوف الـDashboard |
كروت: النقاط، الـstreak، الجرعة القادمة |
| 4.3 |
جرعة في معادها (±30 دقيقة) |
+10 نقاط |
| 4.4 |
جرعة متأخرة عن معادها |
+5 نقاط |
| 4.5 |
روح Leaderboard |
ترتيب بالميداليات 🥇🥈🥉، وحسابك متعلّم "(You)" |
| 4.6 |
بدّل بين All time / This week / This month |
الترتيب يتفلتر حسب الفترة |
💡 عشان تشوف المنافسة: اعمل حسابين مختلفين (افتح نافذة incognito للتاني)، خد جرعات في كل واحد بأعداد مختلفة، وقارن في الـLeaderboard.
5) الـ Caregiver (مقدّم الرعاية)
روح على Profile.
| # |
الخطوات |
النتيجة المتوقعة |
| 5.1 |
حط اسم + إيميل caregiver واضغط Save |
"Saved!" |
| 5.2 |
حط إيميل بصيغة غلط |
رسالة "Invalid caregiver email" |
| 5.3 |
بعد ما تحط caregiver، خد جرعة |
السيرفر يحاول يبعت إيميل (يشتغل فعلياً لو ظبّطت SMTP في .env — غير كده بيتسجّل في اللوج بس) |
ℹ️ من غير إعدادات SMTP في .env، الإيميل مبيكسرش التطبيق — بيتسجّل كـ no-op في لوج السيرفر بس.
6) اللغة و RTL
| # |
الخطوات |
النتيجة المتوقعة |
| 6.1 |
من Profile أو صفحة الدخول، بدّل لـ العربية |
كل الواجهات الجديدة تترجم + الاتجاه يقلب RTL |
| 6.2 |
ارجع لـ English |
يرجع LTR، والاختيار محفوظ بعد الـrefresh |
7) إشعارات Web Push
| # |
الخطوات |
النتيجة المتوقعة |
| 7.1 |
من Profile اضغط Enable reminders |
المتصفح يطلب إذن الإشعارات |
| 7.2 |
لو مفاتيح VAPID مش متظبطة في .env |
رسالة واضحة إن السيرفر ناقصه مفاتيح VAPID (متوقّع في وضع الديمو الحالي) |
| 7.3 |
لو ظبّطت VAPID (شوف SETUP_ADHERENCE.md) واشتركت |
اشتراكك يتسجّل، وأي جرعة معادها يجي يوصلك إشعار من الـService Worker حتى لو التاب مقفول |
💡 لاختبار سريع للـpush بعد تظبيط VAPID: اعمل Snooze لجرعة بدقيقة، واستنى الـscheduler (بيشتغل كل دقيقة).
8) تصدير التقويم (.ics)
| # |
الخطوات |
النتيجة المتوقعة |
| 8.1 |
من صفحة Schedule بعد التوليد، اضغط Export to calendar |
ينزّل ملف pharmachat-schedule.ics يفتح في Google/Apple Calendar كأحداث يومية متكررة بتذكير |
9) حالات حدية (Edge cases)
| # |
الخطوات |
النتيجة المتوقعة |
| 9.1 |
اضغط Generate من غير ما تضيف أي دواء |
رسالة "No medications added yet" |
| 9.2 |
جرّب تضيف نفس الدواء مرتين |
"Medication already added" |
| 9.3 |
ابحث عن دواء مش موجود في القاعدة |
القائمة تفضل فاضية |
| 9.4 |
افتح /today قبل ما تعمل أي جدول |
رسالة "ابنِ جدولك أولاً" |
| 9.5 |
امسح الـtoken من localStorage يدوياً واعمل طلب |
يحوّلك تلقائياً لـ /login (401 interceptor) |
بديل: اختبار سريع كامل من الـ API
لو عايز تتأكد من الباك إند من غير المتصفح، الـ Swagger UI جاهز:
http://localhost:8000/docs — اعمل /auth/signup، خد الـtoken، اضغط "Authorize"
وحطّه، وبعدين جرّب باقي الـendpoints (medications, schedule, notifications, gamification).
الأدوية المتاحة في القاعدة (18 دواء)
Metformin · Lisinopril · Atorvastatin · Amlodipine · Omeprazole · Ibuprofen ·
Acetaminophen · Aspirin · Naproxen · Diphenhydramine · Apixaban · Clopidogrel ·
Furosemide · Hydrochlorothiazide · Losartan · Metoprolol · Simvastatin · Warfarin