ملف العمل الأصلي
START-HERE.txt
تحتفظ الشيفرة وصفحات الأمثلة القابلة للتشغيل بمعرّفاتها ونصوصها التجريبية الأصلية. يشرحها الدرس وإرشادات الملفات بلغتك.
المسار العملي
أنشئ Payment Link تجريبيًا واربطه بالصفحة المرفقة، وتحقق من الدفع في حساب المزود دون بناء نظام دفع خلفي.
دورك: اختر المنتج والسعر التجريبيين، وأبقِ العمل في البيئة التجريبية، وتحقق من سجل الدفع الفعلي.
1. استخدم المشروع المرفق واطلب من مساعد البرمجة تنفيذ الجانب التقني. لا تحتاج إلى كتابة HTML أو JavaScript أو SQL بنفسك.
2. اتبع خطوات الدرس الحالي، واضبط فقط حساباتك التي يحق لك استخدامها، وافحص النتيجة في الصفحة الفعلية أو لدى مزود الخدمة.
3. افصل بين النتائج المتوقعة وما لاحظته بالفعل. إن تعذّر إجراء اختبار فعلي، سجّل الخطوة المحددة التي توقفت عندها.
المسار الأساسي: استخدم الصفحة العامة المرفقة وPayment Link تجريبيًا فقط. اطلب من مساعدك ضبط الرابط العام ونشر تلك الصفحة وحدها عندما تصبح جاهزة. إعداد الخادم وقاعدة البيانات وwebhook التفصيلي أدناه توسعة متقدمة اختيارية، وليس شرطًا لإكمال درس Payment Link هذا.
--- الإعداد المطلوب (قراءة الكود اختيارية) ---
هذا مشروع تدريب منفصل. public/ مجلد الموقع؛ ويحتوي netlify/functions/ على دوال خادم فقط. ثبّت Node وNetlify CLI لاختبار الدوال محليًا، أو انشر المشروع إلى حسابك في Netlify. ضع بيانات الاعتماد الحقيقية في متغيرات بيئة الخادم، لا في public/ أو Git أبدًا. لا يُنفّذ طلب للمزوّد بمجرد فتح هذه الملفات. يجب فحص خطوات الحساب والتسليم الحقيقي في حسابك.
1. استخدم بيئة اختبار أو sandbox في Stripe. أنشئ منتجًا وسعرًا تجريبيين لدفع مرة واحدة وPayment Link اختباريًا لهما؛ وضع رابطه العام https://buy.stripe.com/test_... في public/config.js. دوّن معرّف plink_ المطابق.
2. شغّل schema.sql في مشروع Supabase جديد قابل للاستغناء عنه. اضبط SUPABASE_URL وSUPABASE_SECRET_KEY في الخادم فقط.
3. ثبّت التبعيات باستخدام npm install في مشروع التدريب؛ وسجّل package-lock.json الناتج بالتزام مع المشروع.
4. اضبط وجهة Stripe webhook للحدثين checkout.session.completed وcheckout.session.async_payment_succeeded عند https://YOUR-HOST/.netlify/functions/mini-payment-webhook. اضبط سر توقيع نقطة النهاية وSTRIPE_SECRET_KEY، على أن يكون sk_test_ فقط، وSTRIPE_PAYMENT_LINK_ID في الخادم. يختلف سر توقيع إعادة التوجيه عبر CLI عن سر نقطة النهاية المستضافة.
5. استخدم تعليمات بطاقات الاختبار الرسمية المرتبطة في الدرس. ترفض هذه الشيفرة بيانات الاعتماد والأحداث الفعلية، وتسجل إيصالًا فقط ولا تسلّم منتجًا. ليست متجرًا كاملًا أو نظام ضرائب أو استرداد أو تنفيذ طلبات.
للأوامر المحلية الدقيقة وأسماء البيئة الخاصة، اقرأ run-locally.txt وserver-env.example.txt.