# Turf Edge AI - خطة الرفع للإنترنت والبيع

## الهدف

تحويل النموذج الحالي من صفحة محلية إلى SaaS مدفوع يجمع المهتمين، يبيع اشتراكًا شهريًا، ويقدم تحليلًا احتماليًا لسباقات الخيل في فرنسا.

## المرحلة 1: صفحة عرض وجمع مهتمين

الملفات الجاهزة الآن:

- `racing.html`: صفحة العرض والتجربة.
- `TURF_EDGE_AI_BRAND_AR.md`: الهوية التجارية المعتمدة بعد اختيار اسم Turf Edge AI.
- `TURF_EDGE_AI_DOMAIN_SETUP_AR.md`: خطوات شراء وربط `turfedgeai.com`.
- `TURF_EDGE_AI_SUPABASE_SETUP_AR.md`: خطوات إنشاء قاعدة بيانات Supabase وربط المفاتيح.
- `racing.css`: التصميم.
- `racing.js`: مولد الورقة ونموذج الانتظار المحلي.
- `racing-member.html`: بوابة المشترك التجريبية لاختيار الخطة وتجهيز ملف الحساب قبل ربط Auth/Stripe.
- `racing-checkout.html`: صفحة Checkout Studio لتجهيز payload الدفع قبل ربط Stripe.
- `racing-admin.html`: لوحة تشغيل محلية للسباقات والنشرة اليومية وملف snapshot، وفيها لوحة جاهزية البيع على الإنترنت وخطة إطلاق قابلة للنسخ أو التحميل.
- `api/create-checkout-session.js`: endpoint آمن لإنشاء Stripe Checkout Session.
- `api/stripe-webhook.js`: endpoint لتحديث الاشتراك بعد نجاح الدفع.
- `api/sync-member.js`: endpoint لنقل بيانات بوابة المشترك إلى Supabase.
- `RACING_EDGE_OS_BACKEND_KIT_AR.md`: شرح ربط backend وStripe وSupabase.
- `RACING_EDGE_OS_LAUNCH_CHECKLIST_AR.md`: قائمة إطلاق عملية قبل البيع.
- `RACING_EDGE_OS_PRODUCTION_HANDOFF_AR.md`: ملف تسليم الإنتاج بالمفاتيح والحسابات المطلوبة للرفع الحقيقي.
- `vercel.json`: إعدادات نشر وأمان أساسية.
- `assets/racing-premium-hero.png`: صورة hero.
- `assets/racing-social-ad.png`: إعلان مربع.
- `assets/racing-ai-command.png`: صورة محرك AI.
- `RACING_EDGE_OS_MARKETING_AR.md`: نصوص التسويق.
- `RACING_EDGE_OS_DATA_RESEARCH_AR.md`: خريطة البيانات.
- `RACING_EDGE_OS_SUPABASE_SCHEMA.sql`: مخطط قاعدة البيانات للنسخة المدفوعة.

ما يجب فعله عند النشر:

- شراء الدومين المختار `turfedgeai.com` أو البديل الأقرب إذا لم يكن متاحا.
- رفع الموقع على Vercel أو Netlify أو Cloudflare Pages.
- تحويل نموذج الانتظار من localStorage إلى قاعدة بيانات حقيقية.
- إضافة Google Analytics أو Plausible.
- إضافة Pixel للإعلانات إذا تم استخدام Meta Ads.

## المرحلة 2: الحسابات والدفع

الخدمات المقترحة:

- Supabase للحسابات وقاعدة البيانات.
- PayPal للاشتراكات عند اكتمال تحقق الحساب.
- Crypto كفاتورة دفع مؤتمتة بعد مراجعة قانونية ومحاسبية.
- CMI / Maroc Pay لاحقا كبوابة محلية إذا توفر حساب تاجر.
- Resend أو Brevo للإيميلات.
- Vercel Cron لجلب السباقات يوميًا.

الجداول الأولى:

- users
- waitlist_leads
- subscriptions
- premium_reports
- member_access_events
- races
- runners
- predictions
- tickets
- ticket_history
- consent_logs
- responsible_limits

تم تجهيز ملف SQL كبداية لهذه الجداول. يمكن نسخه إلى Supabase SQL Editor بعد إنشاء المشروع.

خطوات الدفع:

1. Free plan: عرض محدود.
2. Pro: 29 EUR/mo.
3. Elite: 79 EUR/mo.
4. API/Studio: 199 EUR/mo.

ربط بوابة المشترك:

- تحويل `racing-member.html` من localStorage إلى Supabase Auth.
- تحويل `racing-checkout.html` إلى endpoint آمن يفتح مسار الدفع المختار.
- عند التسجيل ننشئ `profiles` و`subscriptions`.
- عند اختيار خطة ننشئ اشتراكا أو فاتورة دفع ونحفظ بيانات المزود في `subscriptions`.
- عند تحميل تقرير Premium نحفظ نسخة في `premium_reports`.
- عند فتح ميزة مدفوعة نسجل حدثا في `member_access_events` للمراقبة والتحليل.

## المرحلة 3: البيانات

لا تبدأ بجمع آلي عشوائي واسع من مواقع السباقات قبل مراجعة الشروط. الأفضل:

- MVP يدوي أو CSV في البداية.
- شراكة بيانات أو API مرخصة لاحقًا.
- فصل مصادر official عن مصادر market/pronostic.
- تسجيل source_url ووقت snapshot لكل معلومة.

مصادر المرحلة الأولى:

- France Galop للـ galop.
- LeTROT للـ trot.
- PMU للكوت والrapports إذا توفر ترخيص أو شراكة.
- Open-Meteo للطقس.
- IFCE/SIRE للهوية والنسب في المرحلة المتقدمة.

## المرحلة 4: محرك التحليل

ابدأ بـ scoring شفاف:

- form
- distance
- surface/going
- class
- jockey/driver
- trainer
- market movement
- consistency
- risk penalty

ثم:

- backtesting.
- Monte Carlo.
- calibration.
- value alerts.
- model confidence.

## المرحلة 5: الامتثال والثقة

صفحات مطلوبة قبل البيع:

- Terms of Service.
- Privacy Policy.
- Responsible Gaming.
- Data Sources.
- Contact/Support.

رسائل ثابتة:

- +18 فقط.
- لا توجد أرباح مضمونة.
- Turf Edge AI لا يقبل رهانات أو أموال رهانات.
- المنتج تحليل احتمالي فقط.
- يجب على المستخدم احترام ميزانيته وحدوده.

## مؤشرات النجاح

قبل بناء backend كامل، اختبر:

- 100 مهتم في القائمة.
- 20 مكالمة أو رسالة من مستخدمين محتملين.
- 10 مستخدمين مستعدين للدفع.
- نسبة نقر من الإعلان إلى الصفحة فوق 2%.
- نسبة تسجيل من الصفحة فوق 8%.

إذا تحققت هذه الأرقام، انتقل إلى النسخة المدفوعة.

## أول حملة إعلانية

الصورة: `assets/racing-social-ad.png`

العنوان:

> قبل أن تراهن، افهم السباق.

النص:

> Turf Edge AI يحلل الخيول، الكوت، الأرضية، الطقس، والمدربين، ثم يقترح ورقة لعب حسب نوع الرهان والميزانية. +18، تحليل احتمالي فقط، لا ضمان للربح.

CTA:

> احجز مكانك في التجربة المبكرة.
## تحديث الدفع الآلي متعدد الطرق

تم اعتماد نظام دفع مرن:

- `PayPal`
  للاشتراك الشهري الآلي.
- `Cards`
  عبر تجربة الدفع التي يوفرها:
  `PayPal`
  أو لاحقا:
  `CMI / Maroc Pay`
- `Crypto`
  كفاتورة دفع تؤكد عبر webhook وتفتح مدة وصول.
- `Payoneer`
  للعملاء الخاصين أو الشركات.
- `Bank transfer`
  للفواتير الكبيرة لاحقا.

قاعدة السعر:

سعر الخطة هو الحد الأدنى فقط، ولا يوجد سقف أعلى للدفع.

ملفات مهمة:

- `TURF_EDGE_AI_PAYMENT_METHODS_AR.md`
- `TURF_EDGE_AI_PAYMENT_SETUP_AR.md`
- `TURF_EDGE_AI_PAYPAL_MIGRATION.sql`
- `api/create-paypal-plan.js`
- `api/paypal-confirm-subscription.js`
- `api/paypal-webhook.js`
- `api/create-crypto-invoice.js`
- `api/crypto-webhook.js`

قبل النشر الفعلي:

1. شغل:
   `TURF_EDGE_AI_PAYPAL_MIGRATION.sql`
   في:
   `Supabase SQL Editor`
   الحالة:
   تم تشغيله بنجاح.
2. ضع متغيرات:
   `Supabase`
   في:
   `Vercel`
3. اترك متغيرات:
   `PayPal`
   فارغة مؤقتا إلى حين اكتمال تحقق الهوية.
4. جرب:
   `racing-checkout.html?plan=pro`
5. اختبر مبلغ الحد الأدنى:
   `29 EUR`
6. اختبر مبلغا أعلى:
   `50 EUR`
7. تأكد أن جدول:
   `subscriptions`
   يتحدث تلقائيا.