«المشروع ما ينشر خارج Bolt»
بيئة Bolt تسامح في أشياء ما تسامح فيها الاستضافة: أخطاء TypeScript تمر وأنت تطوّر بس توقف البناء (build)، ومتغيرات بيئة موجودة عندك وناقصة في الاستضافة، وأحيانًا نسخة Node مختلفة، أو مكتبة تشتغل في المتصفح بس.
كيف تتأكد بنفسك: نزّل المشروع أو اربطه بـ GitHub، وعلى جهازك شغّل npm install ثم npm run build. أول خطأ يطلع لك هو غالبًا السبب كله. بعدها قارن متغيرات البيئة في ملف .env مع اللي في إعدادات الاستضافة.
«مفاتيح سرية داخل كود الواجهة»
عشان يشتغل الشي بسرعة، يحط الذكاء الاصطناعي أحيانًا مفتاح OpenAI أو مفتاح الدفع السري في كود الواجهة، أو في متغير يبدأ بـ VITE_. أي متغير يبدأ بـ VITE_ ينضاف للملفات اللي توصل متصفح كل زائر، يعني أي أحد يقدر ياخذ المفتاح ويستخدمه على حسابك.
كيف تتأكد بنفسك: افتح موقعك واضغط F12، وفي تبويب Sources دوّر على sk_ و sk- و secret و service_role. إذا لقيت مفتاح سري، غيّره من لوحة المزوّد فورًا قبل أي شي ثاني، وبعدها انقل الطلب اللي يستخدمه للسيرفر.
«الدفع يشتغل في التجربة بس»
في وضع التجربة كل شي يمشي. لما تحوّل للدفع الحقيقي تحتاج مفاتيح الوضع الحقيقي، و webhook مسجّل في الوضع الحقيقي بعد. كثير من المشاريع تعتمد على صفحة «تم الدفع» عشان تسجّل الطلب، فإذا العميل سكّر الصفحة قبل لا ترجع، ينسحب المبلغ والطلب ما ينسجّل.
كيف تتأكد بنفسك: تأكد إن المفاتيح اللي في الاستضافة مفاتيح الوضع الحقيقي، وإن فيه webhook مفعّل لنفس الوضع في لوحة مزوّد الدفع (Stripe أو Moyasar أو Tap). بعدها سوّ عملية دفع حقيقية بمبلغ صغير، وسكّر الصفحة قبل لا ترجع لموقعك: انسجّل الطلب؟