dosemate / TEST_SCENARIOS.md
DoseMate
Deploy DoseMate to Hugging Face Spaces
a0c836f
|
Raw History Blame Contribute Delete
8.99 kB
# PharmaChat — سيناريوهات اختبار الميزات الجديدة
> **قبل ما تبدأ:** اتأكد إن السيرفرين شغالين:
> - الفرونت: http://localhost:5173
> - الباك إند: http://localhost:8000 (توثيق: http://localhost:8000/docs)
>
> كل السيناريوهات دي بتشتغل من المتصفح على 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