test(e2e): complete and verify 11 E2E test suites with strict mutation testing and CI integration

This commit is contained in:
parsa aghaei committed 2026-08-25 17:10:53 +03:30
1 parent 6ef293ea59
commit e6018f3a37
21 files changed
+771 -58

No files matched your search

+32 -8
View File
@@ -66,13 +66,37 @@
---
## ۳. برنامه تکمیل و توسعه تست‌های مفقود (Action Plan)
برای رسیدن به پوشش ۱۰۰٪ سیستم، فایل‌های تست جدید زیر باید ایجاد و تست‌های موجود با رویکرد پایداری انتخاب‌گرها و پوشش سناریوهای منفی بازنویسی شوند:
## ۳. وضعیت پوشش نهایی سوئیت ۱۱گانه (Final 11 Test Suites Status)
تمام ۱۱ سوئیت تست زیر با استانداردهای بدون `if-isVisible`، حذف سلکتورهای فال‌بک، assertion دقیق روی مقادیر رشته‌ای و محاسبات ریاضی، و اعتبارسنجی با Mutation Testing پیاده‌سازی و در CI ادغام شدند:
1. `tests/e2e/storefront/shop-filter-search.spec.ts`: تست کامل جستجو، فیلتر دسته‌ها، ماشین‌حساب دوز و حالت‌های بدون نتیجه.
2. `tests/e2e/storefront/cart-operations.spec.ts`: تست تعاملی سبد خرید، تغییر تعداد، حذف، کوپن تخفیف و سقف خرید.
3. `tests/e2e/storefront/order-tracking.spec.ts`: تست پیگیری سفارشات با سناریوهای موفق و ناموفق.
4. `tests/e2e/storefront/user-auth-pets.spec.ts`: تست ورود کاربر، OTP، اضافه کردن پت جدید و پروفایل.
5. `tests/e2e/admin/admin-orders-flow.spec.ts`: تست مدیریت سفارشات، تغییر وضعیت فاکتور و فیلترها در پنل مدیریت.
6. `tests/e2e/admin/admin-blogs-crud.spec.ts`: تست ایجاد و ویرایش مقالات وبلاگ و دانشنامه در پنل ادمین.
7. `tests/e2e/admin/admin-b2b-submissions.spec.ts`: تست مشاهده و مدیریت فرم‌های ثبت شده B2B و تماس.
2. `tests/e2e/storefront/order-tracking.spec.ts`: تست پیگیری سفارشات با سناریوهای موفق و ناموفق.
3. `tests/e2e/storefront/cart-operations.spec.ts`: تست تعاملی سبد خرید، محاسبه دقیق ریاضی `unitPrice * 2`، تغییر تعداد، حذف و سبد خالی.
4. `tests/e2e/admin/admin-orders-flow.spec.ts`: تست مدیریت سفارشات، تغییر وضعیت فاکتور و فیلترها در پنل مدیریت.
5. `tests/e2e/admin/admin-blogs-crud.spec.ts`: تست ایجاد و ویرایش مقالات وبلاگ و دانشنامه در پنل ادمین.
6. `tests/e2e/admin/admin-b2b-submissions.spec.ts`: تست مشاهده و مدیریت فرم‌های ثبت شده B2B و تماس.
7. `tests/e2e/storefront/auth-otp-recovery.spec.ts`: تست جریان OTP و بازیابی و تنظیم رمز عبور جدید.
8. `tests/e2e/admin/admin-rbac-roles.spec.ts`: تفکیک سطوح دسترسی، نقش‌های کاربران و ادمین ارشد.
9. `tests/e2e/storefront/error-pages-404-500.spec.ts`: رندر و ناوبری صفحات خطای ۴۰۴ و ۵۰۰.
10. `tests/e2e/security/xss-ratelimit.spec.ts`: تست مقاومت امنیتی در برابر حملات XSS و محدودیت نرخ ارسال پیامک (Cooldown Timer).
11. `tests/e2e/storefront/concurrency-stock.spec.ts`: رقابت موازی همزمان (Parallel Race با `Promise.all`) روی آخرین موجودی کالا در دو کانتکست مجزا.
---
## ۴. راهنمای نگهداری و افزودن فیچرهای جدید بدون شکستن تست‌ها (Developer Maintenance Guide)
برای اینکه توسعه‌دهندگان جدید یا تغییرات آینده باعث رگرسیون یا شکست بی‌دلیل سوئیت نشوند، قوانین زیر الزامی است:
1. **استفاده اجباری از `data-testid`**:
- برای هر المان قابل تعامل جدید (دکمه، اینپوت، کارت، فیلتر)، به جای اتکا به کلاس CSS یا متن فارسی، حتماً `data-testid="..."` اضافه کنید.
2. **پرهیز از Assertionهای شکننده متن یا کلاس**:
- از چک کردن کلاس‌های ظاهری (مانند `text-canina-blue`) خودداری کنید. به جای آن، وضعیت بیزینسی (مقدار عددی، مقدار فیلد فرم با `.toHaveValue()`, یا URL با `.toHaveURL()`) را راستی‌آزمایی کنید.
3. **ممنوعیت استفاده از الگوی کاذب `if (await element.isVisible())`**:
- اگر حضور یک المان بخشی از کارکرد صفحه است، آن را مستقیماً با `await expect(locator).toBeVisible()` بنویسید تا در صورت بروز باگ، تست فیل شود و بی‌صدا عبور نکند.
4. **اجرای محلی قبل از Push**:
- همیشه قبل از ایجاد PR یا Push، دستور زیر را اجرا کنید:
```bash
npx playwright test --project=chromium-desktop --project=admin-chromium
```
5. **به‌روزرسانی خودکار در گیت‌هاب/گیتیا (CI Pipeline)**:
- فایل `.gitea/workflows/e2e.yml` روی هر Push و Pull Request روی برنچ‌های `main` و `develop` تمام سوئیت‌ها را به طور خودکار اجرا می‌کند.