عملیات
دستورات آرتیزن
Pitchbar علاوه بر دستورات استاندارد لاراول، چندین دستور php artisan نیز ارائه میدهد — این دستورات برای تیک زدن صف، بازسازی جستجوی هوشمند، تازهسازی منابع، تغذیه دمو و چند کاور راحتی مدیریتی کاربرد دارند. هر کدام را با --help اجرا کنید تا گزینهها را مشاهده کنید.
عملیاتی
| دستور | کاربرد |
|---|---|
php artisan pitchbar:queue-tick |
یک دسته محدود از وظایف صف را پردازش کرده و خارج میشود. برای پردازش با محرک cron خارجی در هاستهای اشتراکی طراحی شده است (پردازشگر Cloudflare → POST /api/v1/internal/queue-tick → این دستور). برای تنظیم کامل cron خارجی به استقرار مراجعه کنید.
پرچمها: --queues=crawl,index,default، --max-jobs=20، --max-time=55.
|
php artisan vector:setup |
شاخص/مجموعه جستجوی هوشمند را بهصورت idempotent ایجاد میکند — Vectorize در Cloudflare یا Qdrant. یک بار در نصب تازه قبل از اولین اسکن اجرا کنید. اجرای مجدد آن بیخطر است؛ در صورت وجود شاخص، کار را متوقف میکند. نام مستعار قدیمی qdrant:setup همچنان کار میکند.
|
php artisan vector:rebuild-index |
جریان بازیابی برای تغییرات مدل جستجوی هوشمند. شاخص Vectorize را حذف میکند، هر تکه محلی را حذف میکند، هر منبع را به pending بازنشانی میکند، شاخص را با ابعاد مطابق با مدل جستجوی هوشمند پیکربندیشده فعلی بازسازی میکند و IndexDocumentJob را برای هر سند با متن ذخیرهشده دوباره ارسال میکند. پس از تغییر CLOUDFLARE_EMBED_MODEL بین مدلهای با ابعاد مختلف (مثلاً bge-base 768 → bge-m3 1024) از این استفاده کنید. پرچمها: --force برای رد کردن درخواست تأیید، --dim=N برای لغو ابعاد حلشده. برای نقشه کامل مدل→ابعاد به دانش مراجعه کنید.
|
php artisan pitchbar:audit-vectors |
تکههای پایگاه داده را با شاخص جستجوی هوشمند مقایسه کرده و مغایرتها را گزارش میکند (تکههایی که در پایگاه داده وجود دارند اما در شاخص وجود ندارند و بالعکس). فقط خواندنی. پس از تأمین مجدد Vectorize یا هنگام بررسی "ربات صفحه X را نمیداند" مفید است. |
php artisan pitchbar:refresh-stale-sources |
منابعی که محتوای آنها قدیمیتر از N روز است (پیشفرض ۷) را دوباره خزش میکند. این را شبانه از طریق cron خارجی خود زمانبندی کنید اگر بازخوانی خودکار میخواهید؛ بدون آن، منابع تنها زمانی دوباره همگامسازی میشوند که اپراتور روی Refresh کلیک کند. |
php artisan pitchbar:sync-oauth-sources |
منابع نوتین / گوگل داکس که ممکن است محتوای آنها قدیمی باشد را دوباره دریافت میکند. همان ایده refresh-stale-sources اما فقط اتصالات مبتنی بر OAuth را طی میکند (جایی که فایل ممکن است در داخل نوتین / درایو بدون وبهوک تغییر کرده باشد).
|
php artisan pitchbar:suggest-from-gaps |
سوالات تکرارشونده بیپاسخ (ثبتشده توسط DetectGapJob) را طی کرده و پیشنهادات CuratedAnswer را پیشنویس میکند. یک اعلان مدیریتی تولید میکند؛ پاسخ دستی بهعنوان پیشنویس ایجاد میشود، هرگز منتشر نمیشود.
|
راحتی مدیریت
| دستور | کاربرد |
|---|---|
php artisan pitchbar:make-admin {email} |
یک کاربر موجود را به super_admin ارتقا میدهد. --demote را برای بازگرداندن آنها به مشتری وارد کنید. از این برای اولین مدیر ارشد خود پس از ثبتنام استفاده کنید — هیچ رابطی برای افزایش نقش وجود ندارد.
|
php artisan pitchbar:build-wp-plugin |
wp-plugin/pitchbar/ را در یک فایل زیپ آماده نصب برای توزیع بستهبندی میکند. قبل از زیپ کردن، تمام فایلهای زبان .po را به .mo کامپایل میکند.
|
php artisan pitchbar:seed-demo-agent |
دستیار فروش دموی استفادهشده توسط ویجت سایت بازاریابی را ایجاد یا بازخوانی میکند. فقط در نصبهایی با DEMO=true (دموی عمومی pitchbar.io) معنی دارد. idempotent.
|
php artisan pitchbar:seed-local-test |
یک دستیار فروش "تست محلی" منتشر شده + قطعه اسکریپت برای نصب در یک پروژه خواهر در زمان توسعه ایجاد میکند. زمانی مفید است که ویجت را بهصورت محلی میسازید و یک دستیار فروش ثابت در بین راهاندازیهای مجدد میخواهید. |
تخته داخلی (کانبان)
تخته مدیریت داخلی در /admin/board توسط این دستورات پشتیبانی میشود. برای فرآیند خودکار کامل به تخته مدیریت مراجعه کنید. مرجع سریع:
php artisan board:add "عنوان" --body="..." --label=...— یک کارت به بکلاگ اضافه میکند.php artisan board:start <id-or-title>— یک کارت را به در حال انجام منتقل میکند.php artisan board:done <id-or-title> --test="..." --release="v2.0.0"— کارت را با یک برنامه تست UI میبندد و نسخه انتشار را ثبت میکند.php artisan board:stamp-version vX.Y.Z --status=done— نسخه انتشار را روی تمام کارتهای تازه انجامشده عقبپر میکند.php artisan board:seed— بکلاگ اولیه را تغذیه میکند (idempotent).
تاریخچه تغییرات
برای صفحه یادداشتهای انتشار عمومی به تاریخچه تغییرات مراجعه کنید. دستورات سمت نگهدارنده:
php artisan changelog:add— یک ورودی جدید بهصورت تعاملی اضافه میکند. یک فایلdatabase/changelog-entries/v{version}.mdجدید مینویسد؛ سایت در حال اجرا این فایلهای مارکداون را مستقیماً از طریقChangelogStoreمیخواند (بدون جدول پایگاه داده — جدول اصلیchangelog_entriesدر2026_05_09_120539به نفع فروشگاه مبتنی بر فایل حذف شد).