dosemate / TEST_SCENARIOS.md
DoseMate
Deploy DoseMate to Hugging Face Spaces
a0c836f
|
Raw History Blame Contribute Delete
8.99 kB

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