CRM_Montzar/docs/QA_CHECKLIST.md

چک‌لیست تست قبل از تحویل

هدف: هیچ باگی را کارفرما پیدا نکند. قبل از هر تحویل یا دیپلوی این مراحل را به ترتیب انجام دهید.

۱. بررسی خودکار (اجباری)

npm run check

• بیلد @mento/shared، بررسی تایپ API و وب، و تست‌های واحد API را اجرا می‌کند (حدود ۲ دقیقه).
• قبل از هر git push خودکار اجرا می‌شود و اگر خطا داشته باشد جلوی پوش را می‌گیرد.
• فقط در شرایط اضطراری: git push --no-verify.

۲. تست مرورگری خودکار (اجباری برای تغییرات ظاهری)

یک بار: فایل e2e/.env.example را به e2e/.env کپی کنید و نام کاربری و رمز را بنویسید.

npm run test:e2e

• با Edge، همهٔ صفحات اصلی را باز می‌کند و اگر خطای جاوااسکریپت یا خطای 5xx از سرور ببیند، رد می‌شود.
• فقط خواندنی است؛ چیزی ثبت یا حذف نمی‌کند.
• گزارش خطاها با عکس: npm run test:e2e:report.

۳. تست دستی (۱۰ تا ۱۵ دقیقه)

فقط بخش‌هایی را که در این تحویل تغییر کرده‌اند کامل تست کنید؛ بقیه را یک نگاه سریع.

ورود و دسترسی

• ورود با رمز و خروج
• ورود با کد یکبارمصرف
• با کاربر «فروش»: فقط پرونده‌های خودش را می‌بیند و به تنظیمات دسترسی ندارد

مشتریان

• ساخت شخص جدید، ویرایش، و دیدن در لیست
• جستجو با نام و موبایل
• پروفایل مشتری: همهٔ تب‌ها باز می‌شوند
• ورود از اکسل با یک فایل کوچک

لید و فرم عمومی

• ساخت/ویرایش فرم در فرم‌ساز؛ پیش‌نمایش با صفحهٔ عمومی یکی است
• باز کردن لینک عمومی فرم در پنجرهٔ ناشناس و ارسال آن
• لید ثبت‌شده در لیست لیدها دیده می‌شود
• کاور فرم با عکس بزرگ/کوچک درست نمایش داده می‌شود

کارها و روتین‌ها

• ساخت کار با نوع و فیلدهای سفارشی، تغییر وضعیت در کانبان
• تقویم کارها
• روتین: ثبت انجام کار امروز

فروش و مالی

• ساخت معامله و جابه‌جایی مرحله در پایپ‌لاین
• صدور پیش‌فاکتور و فاکتور، ثبت پرداخت
• ثبت چک و دیدن سررسیدها

ته‌حساب

• تنظیمات ته‌حساب: تست اتصال موفق
• دارایی‌های یک مشتری متصل: مانده حساب نمایش داده می‌شود
• جزئیات حساب: هر دو حالت «هر سند یکجا» و «ردیف‌به‌ردیف»
• ثبت سند فقط روی حساب آزمایشی (هرگز روی مشتری واقعی)

رابط کاربری عمومی

• مودال‌ها: با کلیک بیرون بسته نمی‌شوند؛ با Esc، ضربدر و انصراف بسته می‌شوند
• نمای موبایل (عرض ۳۹۰ پیکسل) برای صفحاتی که تغییر کرده‌اند
• اعداد و تاریخ‌ها فارسی و درست هستند

۴. بعد از دیپلوی (۲ دقیقه)

• سایت اصلی را باز کنید، یک بار Ctrl+F5 بزنید
• همان قابلیت جدید را یک بار روی سرور اصلی ببینید
• pm2 logs mento-crm-api --lines 50 خطای جدید ندارد

۵. یادداشت تحویل به کارفرما

با هر تحویل، کوتاه بنویسید:

• چه چیزهایی اضافه یا اصلاح شد
• کجا را ببیند (مسیر صفحه)
• چه چیزی هنوز در دست انجام است