موضوع ها

خطاها و رفع مشکلات

راه‌حل سریع مشکلاتی که ممکن است با آن مواجه شوید

خطاهای کاربری

خطاهای سرور

اسکریپت WorkSuite یا همان WorkSuite CRM یکی از بهترین CRM ایرانی با قابلیت‌های Project Management، HRM، ERP و Ticketing است. اما گاهی به دلیل پیچیدگی عملکردی، ممکن است خطاهایی در نصب، لایسنس، ورود یا پردازش رخ دهد. در این مستندات، به تحلیل دقیق خطاها و رفع مشکلات WorkSuite “جدیدترین CRM فارسی” و “سیستم مدیریت ارتباط با مشتری فارسی” می‌پردازیم.

1. خطای تایم‌اوت یا Time Out و خطای ۵۰۰ پس از ثبت لایسنس

🔍 شرح مشکل

بعد از ثبت لایسنس یا فعال‌سازی افزونه، گاهاً پیام خطای “Time Out” یا خطای داخلی سرور (HTTP 500) ظاهر می‌شود و مانع ورود یا نمایش صفحات مدیریتی می‌شود.

✅ راه‌حل‌ها

1.افزایش max_execution_time و memory_limit در php.ini، مخصوصاً اگر در هاست اشتراکی یا منابع محدود هستید.

2.فعال‌سازی ماژول‌های PHP‌ حیاتی مانند curl, gd, mbstring، در پنل مدیریتی یا phpinfo.

3.بررسی لاگ خطاهای سرور (error_log) برای شناسایی خطای دقیق.

4.به‌روزرسانی نسخه PHP به حداقل 8.2 یا بالاتر (حتی پیشنهادی PHP ۸.2+).

5.از آنجایی‌که نسخه ۵.۵.۱۲ شامل بهبودهای متعدد در رفع تایم‌اوت و ۵۰۰ها است، مطمئن شوید که اسکریپت شما به این نسخه به‌روز شده و مشکل لایسنس حل‌شده باشد

2. خطای کندی عملکرد و تاخیر ورود به داشبورد

🔍 شرح مشکل

وقتی کاربر وارد سیستم می‌شود، بارگذاری سنگین یا کندی در نمایش داشبورد، بخش پروژه‌ها یا گزارش‌ها مشاهده می‌شود.

✅ راه‌حل‌ها

  • اطمینان از پایگاه داده بهینه (پاکسازی لاگ بیش از حد، جدول‌های سنگین).

  • فعالسازی کش یا Cache در تنظیمات یا Query (Redis یا Memcached اگر ممکن است).

  • بررسی دلیل کندی در شبکه یا دیتاسنتر؛ می‌توانید با استفاده از CDN بخش‌های فایل استاتیک را سریع‌تر کنید.

  • بروز رسانی به آخرین نسخه منتشر شده

  • تهیه هاست پیشنهادی ورک سوییت فا

3. خطای عدم ثبت لایسنس ماژول‌ها یا خطای ۵۰۰ پس از فعال‌سازی

🔍 شرح مشکل

برخی از ماژول‌های جدید پس از نصب، خطای “500” یا هشدار “تایم‌اوت” نشان می‌دهند یا در صفحه لایسنس خطا می‌گیرند.

✅ راه‌حل‌ها

  • مطمئن شوید لایسنس ماژول‌ها معتبر و فعال است. در بیش‌ترین نسخه‌های مدرن (مثلاً ۵.۵.۱۲) مشکلات ثبت لایسنس رفع شده‌اند.

  • بررسی کنید تنظیمات CURL فعال و بدون فایروال‌های داخلی باشد تا ارتباط سرور لایسنس برقرار شود.

  • اگر در لوکال یا محیط staging هستید، مطمئن شوید اتصال HTTPS/SSL برقرار است.

4. رفع خطاهای تقویم/شیفت شب و مشکلات زمان‌بندی

🔍 شرح مشکل

– تاخیر یا عدم نمایش صحیح زمان‌ها.
– تقویم از دوشنبه شروع می‌شود، یا شیفت شب‌ها ثبت نمی‌شوند.

✅ راه‌حل‌ها

  • نسخه ۵.۵.۱۲ و بالاتر این مشکلات را به‌صورت جزئی/کلی حل کرده.

  • از طریق پنل تنظیمات → زمان/شهر، بازنشانی timezone را انجام دهید.

  • بررسی داده‌های شیفت: اگر ثبت نمی‌شود، بخصوص در شیفت شب‌ها، اگر خطای “ثبت نمی‌شود”، نسخه PHP را ارتقا دهید و اسکریپت را بروزرسانی نمایید.

5. خطای عدم نمایش گزارش یا نمودار در داشبورد

🔍 شرح مشکل

نمودارهای داشبورد، گزارش‌ها یا داشبورد مدیریت مشتری بارگذاری نمی‌شود یا صفحات سفید نمایش می‌دهد.

✅ راه‌حل‌ها

  • بررسی کنید کتابخانه Chart.js یا فایل‌های JS به‌درستی بارگزاری شوند.

  • بروزرسانی نسخه ۵.۵.۱۲ مشکلات بارگزاری گزارش را رفع کرده.

  • در کنسول مرورگر Developer Tools خطاهای JS را بررسی کنید و فایل‌های  (404) را اصلاح نمایید.

6. خطای شیفت شب در حضور و غیاب

🔍 شرح مشکل

ثبت حضور برای شیفت شب ثبت نمی‌شود یا با خطای زمانی مواجه است.

✅ راه‌حل‌ها

  • نسخه ۵.۵.۱۲ بهبودهایی داشته در حضور و غیاب شبانه

  • فعال‌سازی تنظیمات Night Shift در ماژول HR.

  • اطمینان از بروزرسانی Timezone روی سرور.

7. خطای ایمیل یا پیامک ارسال نمی‌شود

🔍 شرح مشکل

اعلان ایمیل یا SMS ، ارسال پیامک یا ایمیل‌های ورود مشتریان یا ثبت تیکت انجام نمی‌شود.

✅ راه‌حل‌ها

  • بررسی تنظیمات SMTP: اطمینان از فعال‌سازی TLS/SSL و Credential‌های معتبر.

  • فعال‌سازی Extensionهای PHP مانند php_openssl, php_smtp.

  • استفاده از ماژول‌های پیامکی معتبر (مثل KavehNegar یا IPPanel) برای اطمینان از ارسال پیامک.

8. مشکل چندزبانه بودن یا ترجمه UI

🔍 شرح مشکل

عناصر UI حتی پس از نصب فارسی‌ساز، ناقص یا انگلیسی نمایش داده می‌شود.

✅ راه‌حل‌ها

  • بررسی ماژول Language و اجرای دوباره database migration.

  • چک کنید پوشه /resources/lang/fa/*.php وجود دارد و فایل‌ها خوانا هستند.

  • چنانچه کاربرانی گزارش کرده‌اند ترجمه ناقص است، نسخه ۵.۵.۱۲ کامل رفع کرده.

۱۰. خطای تکراری شدن رکورد (Time‑Log, Invoice, Task)

🔍 شرح مشکل

ساعات تکراری ثبت می‌شوند، فاکتورها دو بار نمایش داده می‌شوند یا یک Task چند بار در لیست می‌آید.

✅ راه‌حل‌ها

  • بررسی unique constraints در سطح جدول MySQL؛

  • نسخه ۵.۵.1 و بالاتر این خطاها را رفع داده‌اند .

11. خطای دسترسی مستقیم (permissions/access denied)

🔍 شرح مشکل

بعضی کاربران اجازه مشاهده گزارش یا ماژول‌هایی مثل Invoice، Contract یا Ticket را ندارند.

✅ راه‌حل‌ها

  • بررسی نقش‌های Role & Permissions در User Management.

  • اگر نیاز است یک نقش جدید بسازید، بخش‌هایی مثل “View Contracts”, “Manage Ticket Assignments” را فعال کنید.

  • تأکید مجدد اینکه نسخه ۵.۵.0+ شامل رفع مشکلات Role-based access هست .

📌 نکات تکمیلی جهت بهینه‌سازی

  1. پشتیبانی فنی ۶ ماهه همراه با بروزرسانی خودکار، که موارد امنیتی و UI/UX را تا ۵.۵.۱۲ پوشش داده.

  2. ماژول پیامک و احراز هویت SMS فعال شود تا در فرآیند ورود خطا نداشته باشید.

  3. بروزرسانی منظم اسکریپت، حداقل به نسخه ۵.۵.۱۲، برای برخورداری از رفع خطاهای شدید، به‌ویژه timeout، access، login issues، و caching.

🔚 جمع‌بندی

با رعایت این دستورالعمل‌‌ها، اسکریپت WorkSuite CRM شما به عنوان یک از جدیدترین CRM فارسی با ساختار کاملاً امن و سریع اجرا خواهد شد:

  • خطاهای لایسنس، تایم‌اوت، بارگذاری، شیفت شب و چندزبانه رفع می‌شود؛

  • لاگ‌ها بررسی شده، دیتابیس و حافظه بهینه می‌شود؛

  • نسخه اسکریپت به‌روز است و ماژول‌های کلیدی فعال و عملکرد صحیح دارند؛

  • تجربه کاربری و عملکرد کلی اسکریپت در سطح یک بهترین سیستم مدیریت ارتباط با مشتری فارسی قرار می‌گیرد.

در صورت داشتن پشتیبانی فعال و نیاز به راهنمایی دقیق‌تری برای هر خطا (همراه با کدهای نمونه یا تنظیمات سرور) ثبت تیکت انجام دهید