Pitchbar پیکربندی خود را از .env استاندارد لاراول میخواند، با لغوهایی برای برخی کلیدها از طریق صفحه تنظیمات برنامه مدیریت پلتفرم، تا بتوانید اعتبارنامههای Stripe / ایمیل / هوش مصنوعی را بدون استقرار مجدد تغییر دهید.
الزامی
متغیر
دلیل
APP_KEY
کلید اصلی رمزگذاری. با php artisan key:generate تولید کنید. بدون مهاجرت رمزگذاری مجدد، هرگز آن را تغییر ندهید.
APP_URL
آدرس عمومی، برای ساخت قطعههای ویجت، بازخوانی OAuth، آدرسهای امضا شده استفاده میشود.
Cloudflare Workers AI (ترجیح داده میشود). بهطور خودکار Llama 3.3 70B + bge-base-en-v1.5 را متصل میکند.
OPENAI_API_KEY
OpenAI مستقیم.
OPENROUTER_API_KEY
OpenRouter (مسیریاب بین سرویسدهندههای متعدد).
LLM_PROVIDER را برای اتصال اجباری تنظیم کنید (cloudflare، openai، openrouter). در صورت تنظیم نشدن، حلکننده براساس کلیدهای موجود و با اولویت بالا انتخاب میکند.
ذخیرهساز جستجوی هوشمند
متغیر
سرویسدهنده
CLOUDFLARE_VECTORIZE_INDEX
نام شاخص Vectorize کلودفلر. از CLOUDFLARE_ACCOUNT_ID + توکن استفاده میکند. پیشفرض pitchbar-chunks.
QDRANT_URL + QDRANT_API_KEY
Qdrant.
برای اجباری کردن، VECTOR_PROVIDER را تنظیم کنید. براساس کلیدهای موجود بهطور خودکار متصل میشود (Vectorize ترجیح داده میشود).
خزنده
متغیر
راهبرد
(از CLOUDFLARE_* استفاده میکند)
بارگذاری کامل صفحات با کلودفلر. ترجیح داده میشود.
BROWSERLESS_TOKEN + BROWSERLESS_URL
بازگشت Browserless.
(هیچکدام)
HTTP ساده. رایگان؛ بدون اجرای جاوااسکریپت.
متغیر
هدف
CRAWL_MAX_PAGES_PER_SOURCE
حداکثر صفحات گسترشیافته در هر منبع. پیشفرض ۵۰۰ (از ۲۵ افزایش یافته است — خریدارانی که نقشههای سایت ۱۰۰ آدرسی اضافه میکردند، ۷۵ صفحه را بیصدا از دست میدادند). سقف پس از بازگشت شاخص نقشه سایت + حذف تکراری اعمال میشود.
CRAWL_PAGE_DISPATCH_DELAY
تأخیر در هر صفحه (ثانیه) هنگام گسترش صفحات نقشه سایت تا همزمانی کوچک بارگذاری کامل صفحات با کلودفلر در هر حساب، خطای ۴۲۹ ندهد. پیشفرض 2.
CLOUDFLARE_BROWSER_RENDERING
برای اجباری کردن مسیر Browserless / HTTP ساده حتی در صورت وجود کلیدهای کلودفلر، روی false تنظیم کنید. پیشفرض true.
RAG / بازیابی
متغیر
هدف
RAG_CONFIDENCE_THRESHOLD
آستانه شباهت پیشفرض برای دستیاران فروش تازه ایجاد شده. 0.5 برای Cloudflare bge-base-en-v1.5 (امتیاز کسینوسی ANN آن کمتر از OpenAI است). 0.78 برای OpenAI text-embedding-3-small. براساس LLM_PROVIDER بهطور خودکار حل میشود.
RAG_RERANK_ENABLED
برای غیرفعال کردن عبور رمزگشای متقابل bge-reranker-base، روی false تنظیم کنید. در صورت وجود کلیدهای کلودفلر، پیشفرض true است.
VECTOR_DIM
لغو ابعاد جستجوی هوشمند. برای حل خودکار از مدل جستجوی هوشمند پیکربندیشده از طریق نقشه مدلهای شناختهشده (bge-base=768، bge-m3=1024، text-embedding-3-small=1536 و غیره) خالی بگذارید. فقط زمانی بهطور صریح تنظیم کنید که به یک مدل لیستنشده اشاره میکنید. تغییر این مقدار در یک نصب موجود نیاز به php artisan vector:rebuild-index دارد — شاخص Vectorize با ابعاد فعال در زمان ایجاد اولیه تأمین میشود و نمیتوان آن را درجا تغییر اندازه داد.
درگاه هوش مصنوعی کلودفلر (اختیاری)
متغیر
هدف
CLOUDFLARE_AI_GATEWAY_URL
در صورت تنظیم، فراخوانیهای Workers AI از طریق درگاه هوش مصنوعی کلودفلر مسیریابی میشوند — قابلیت مشاهده، کش، محدودیت نرخ.
نام مجموعه Qdrant در صورت استفاده از بازگشت ذخیرهساز جستجوی هوشمند Qdrant. پیشفرض pitchbar_chunks.
S3 / R2 (ذخیرهسازی اشیاء برای آپلود فایلها)
متغیر
هدف
AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY
اعتبارنامههای سطل. برای Cloudflare R2، از جفت کلید/مخفی توکن R2 استفاده کنید.
AWS_DEFAULT_REGION
منطقه سطل. برای R2 از auto استفاده کنید.
AWS_BUCKET
نام سطل.
AWS_ENDPOINT
نقطه پایانی سازگار با S3 سفارشی. برای R2 الزامی است (مثلاً https://<accountid>.r2.cloudflarestorage.com). برای AWS S3 بومی خالی بگذارید.
AWS_USE_PATH_STYLE_ENDPOINT
true برای R2 و بیشتر پیادهسازیهای غیر AWS S3؛ false برای AWS بومی.
فرانتاند (Vite)
متغیر
هدف
VITE_WIDGET_CDN_URL
آدرس پایهای که بارگذار ویجت بازدیدکننده استفاده میکند. در حالت توسعه پیشفرض http://localhost:5173 است. در تولید، به مبدأ عمومی که /widget/widget.js را ارائه میدهد اشاره کنید.
Stripe
متغیر
هدف
STRIPE_KEY
کلید عمومی.
STRIPE_SECRET
کلید مخفی. برای همگامسازی پلن و Cashier استفاده میشود.
STRIPE_WEBHOOK_SECRET
کلید مخفی امضای وبهوکهای ورودی (whsec_…).
CASHIER_CURRENCY
پیشفرض usd.
Reverb (بیدرنگ)
متغیر
هدف
REVERB_APP_KEY
کلید عمومی برنامه. در payload راهاندازی ویجت نصب شده است.
برچسب پیشفرض "قدرت گرفته از Pitchbar". برای برچسب سفید در app_settings لغو کنید.
BRANDING_URL
آدرسی که برچسب به آن لینک میدهد.
BRANDING_FOOTER_LOGO_PATH
مسیر ذخیرهسازی تصویر لوگوی فوتر.
قابلیت مشاهده
متغیر
هدف
SENTRY_LARAVEL_DSN
گزارش خطا. (برخی میزبانها هنوز نام قدیمی SENTRY_DSN را ارسال میکنند؛ SDK لاراول از نسخه v4.x به بعد SENTRY_LARAVEL_DSN را میخواند — برای سازگاری با نسخههای قبلی در صورت مهاجرت، هر دو را در .env نگه دارید.)
OAuth گوگل (درایو + داکس + شیت) — یک مشتری OAuth در کنسول GCP با حوزههای drive.readonly، documents.readonly و spreadsheets.readonly ثبت کنید. حذف spreadsheets.readonly نوع منبع گوگل شیت را مسدود میکند.
ویجت دمو بازاریابی
متغیر
هدف
MARKETING_DEMO_AGENT_ID
UUID یک دستیار فروش منتشرشده که ویجت دموی زنده را در صفحات بازاریابی اجرا میکند. آدرس سایت بازاریابی را به allowed_origins آن دستیار فروش اضافه کنید.
DEMO
برای باز کردن لینکهای ورود / شروع کنید در یک زبانه جدید در سایت بازاریابی، روی true تنظیم کنید — برای بازبینانی که در حال کاوش در یک دموی زنده CodeCanyon هستند مفید است تا وقتی وارد برنامه میشوند، صفحه بازاریابی را از دست ندهند.
زمانبندی صف (cron پردازشگر Cloudflare)
متغیر
هدف
INTERNAL_QUEUE_TOKEN
کلید مخفی مشترک حامل که از POST /api/v1/internal/queue-tick محافظت میکند. پردازشگر cron Cloudflare هر ۶۰ ثانیه این را پینگ میکند تا زمانی که زمانبندی درونخوشهای در دسترس نباشد، صف را هدایت کند.
لغوهای تنظیمات برنامه
ردیف تکی app_settings لغوهای رمزگذاریشده با متن ساده را برای موارد زیر ذخیره میکند:
کلید مخفی Stripe + کلید مخفی وبهوک + کلید عمومی.
تنظیمات درایور ایمیل.
کلیدهای Cloudflare / OpenAI / OpenRouter.
برندینگ (برچسب، آدرس، لوگو).
AppSettingsOverrideServiceProvider این را در زمان راهاندازی خوانده و در config() ادغام میکند. تنظیم از طریق پنل مدیریت برای تولید ترجیح داده میشود — نیازی به استقرار مجدد در زمان تغییر کلید ندارید.
چرخش APP_KEY نیاز به یک مهاجرت دستی دارد. ستونهای رمزگذاریشده در app_settings با کلید قدیمی مهر و موم شدهاند؛ چرخش بدون رمزگذاری مجدد، آنها را غیرقابل خواندن میکند.