الواجهة الخلفية ديال NeuraVision: دليل عملي للإعداد والاستعمال

شنو كتوفّر NeuraVision

NeuraVision هي المحرّك الخلفي ديال منتوج كينشئ المحتوى بالذكاء الاصطناعي. هاد المستودع فيه المنطق اللي كيخدم فالخادم ديال لوحة الأعضاء، وواجهات API الخلفية، والمصادقة، ومتتبّع التحليلات وتقسيم الزيارات المستضاف ذاتياً.

هاد التصدير فيه الكود بوحدو. ما فيه لا صفحات الهبوط، لا المحتوى التسويقي، لا الوسائط، لا موارد لوحة التحكم، لا ملفات البيئة، لا قواعد البيانات، ولا الملفات اللي كيحمّلوها المستخدمين.

بنية المشروع

المجلدات الرئيسية مرتبطة بمسؤوليات محددة فالخلفية:

• api/ فيه نقاط النهاية الخلفية ديال التحميلات، وطلبات التوليد، وOAuth، والفوترة.
• functions/ كيوفّر دوال PHP مشتركة للمصادقة، والبريد الإلكتروني، والرسائل النصية، وcaptcha، والتقييمات.
• lk/ فيه منطق الخلفية ديال لوحة الأعضاء.
• auth/ وauth.php وregister.php وlogout.php كينفّذو تسجيل الدخول، والتسجيل، وتدفّقات OAuth ديال Google أو Twitter.
• chat/ فيه الخلفية ديال ويدجت دردشة الدعم.
• data/ فيه المهام المجدولة ديال إرسال الحملات وترحيل CAPI.
• a/ فيه جامع التحليلات المستضاف ذاتياً ومنطق البحث الجغرافي.
• PHPMailer/ فيه مكتبة البريد المضمّنة فالمشروع.

باش تعرف وصف كل نظام فرعي، راجع ENGINE.md. هاد الملف كيشرح شنو هي مكوّنات المحرّك اللي خدامة وشنو هي الأجزاء التجريبية أو المخصّصة لجمع العملاء المحتملين.

المتطلبات والإعدادات

NeuraVision كتخدم بـ PHP 7.4 أو أحدث من ورا nginx أو Apache. كتستعمل SQLite للتخزين وما كتحتاجش لخطوة بناء.

الإعدادات كتتزوّد عبر متغيّرات البيئة. المستودع فيه .env.example، اللي كيوثّق الإعدادات المتوقعة، ومن بينها بيانات الولوج لخدمات منصات الإعلانات، وSMTP أو Resend، وhCaptcha، وبوتات Telegram.

مفاتيح الإعدادات الخاوية كتعطّل الميزة المرتبطة بها، وبهذا تقدر تهيّأ غير الخدمات اللي محتاجها فالنشر ديالك. ما تديرش ملف .env حقيقي ولا بيانات API فمستودع الكود.

التثبيت والإعداد الأولي

1. جيّب المستودع للخادم أو لجهاز التطوير.
2. نسخ ملف الإعدادات النموذجي لملف بيئة محلي:

cp .env.example .env

1. حلّ .env وعَمّر المفاتيح اللي محتاجاها الأنظمة الفرعية اللي ناوي تستعمل. رجع لـ ENGINE.md ولنداءات getenv(...) فالكود كامل باش تحدد أسماء المتغيّرات المناسبة.
2. شغّل خادم التطوير المدمج ديال PHP من مجلد المشروع:

php -S 127.0.0.1:8000

فالنشر، وجّه PHP-FPM وnginx أو Apache لمجلد المشروع بلا ما تستعمل خادم التطوير المدمج.

تخزين SQLite

قواعد بيانات SQLite اللي كاينة تحت data/ كتتخلق أوتوماتيكياً ملي التطبيق كيتلقى أول طلب. كل وحدة كتستعمل CREATE TABLE IF NOT EXISTS، وبهذا ما كايناش خطوة منفصلة لاستيراد المخطط فعملية الإعداد.

قواعد البيانات اللي كتتولّد تقدر تحتوي على بيانات التطبيق بحال حسابات المستخدمين، وأحداث المتتبّع، والتقييمات. ملفات قواعد البيانات ما داخلاش فالتصدير ديال المستودع، وخصّها تتعامل معها كبيانات ديال النشر ماشي ككود المصدر.

الاستعمال الأساسي

شغّل الخلفية محلياً

من بعد ما تهيّأ البيئة، شغّل الخادم المحلي:

php -S 127.0.0.1:8000

من بعد دخل للتطبيق عبر العنوان المحلي وجرّب تدفّقات المصادقة، ولوحة التحكم، وAPI، والدردشة، أو التحليلات المتاحة حسب الإعدادات ديالك.

تهيئة المصادقة

حدّد متغيّرات البيئة المرتبطة بـ OAuth واللازمة لتسجيل الدخول عبر Google أو Twitter. نقاط الدخول ديال المصادقة كتشمل auth/ وauth.php وregister.php وlogout.php. خلّي بيانات الولوج الاختيارية خاوية إلا كان مزوّد الخدمة ما داخلش فالنشر ديالك.

فعّل الميزات المرتبطة بالخدمات

هيّأ غير التكاملات اللي محتاج. مثلاً، إرسال البريد كيحتاج إعدادات SMTP أو Resend المناسبة، بينما captcha وTelegram ومنصات الإعلانات وميزات CAPI كيحتاجو بيانات الولوج الخاصة بكل خدمة. المفاتيح الناقصة أو الخاوية كتخلّي هاد القدرات الاختيارية معطّلة.

الإعدادات والعمليات المتقدمة

ربط الإعدادات بالأنظمة الفرعية

ما تعتبرش كل متغيّرات البيئة إجبارية. بدا بـ .env.example، ومن بعد استعمل ENGINE.md باش تعرف شنو هي المفاتيح التابعة لـ API، والمصادقة، والمهام المجدولة، وجامع التحليلات، أو ميزات التواصل. هاد الشي كيخلّي النشر مختصراً وكيعاون على تركيز تشخيص المشاكل.

فهم التصدير اللي فيه الكود بوحدو

المستودع كيستثني عن قصد الموارد البصرية ديال لوحة الأعضاء، ومن بينها الصور، والفيديو، وCSS، وJavaScript. وكيستثني حتى صفحات الهبوط والصفحات القانونية، والوسائط، والخطوط، ونصوص التدويل، والملفات المرفوعة، وجلسات الدردشة، واستئنافات الدردشة، وملفات حالة OAuth، وقواعد بيانات SQLite. خطّط باش توفّر أو تحافظ على هاد الموارد بشكل منفصل ملي تدمج المحرّك فمنتوج كامل.

استعمل نموذج الاستضافة المناسب

استعمل php -S للاختبار المحلي. فالنشر على خادم، شغّل تطبيق PHP من ورا nginx أو Apache مع PHP-FPM، ووفّر متغيّرات البيئة عبر إعدادات الخادم بلا ما تكتب الأسرار مباشرة فالمستودع.

راجع حالة الميزات قبل الإطلاق

توثيق المشروع كيفرّق بين مكوّنات المحرّك الحقيقية والخدامة وبين الوظائف التجريبية أو المخصّصة لجمع العملاء المحتملين. راجع ENGINE.md قبل ما تعتمد على شي نظام فرعي فالإنتاج، خصوصاً إلا كنت كتخطّط لتكاملات حول طلبات التوليد، أو الفوترة، أو التحليلات، أو المهام المجدولة.

الخلاصة

NeuraVision كتوفّر واجهة خلفية بـ PHP 7.4 أو أحدث، مع تخزين SQLite، وإعدادات معتمدة على البيئة، والمصادقة، وواجهات API، ومنطق لوحة التحكّم، والتواصل، والمهام المبرمجة، وتحليلات مستضافة ذاتياً. باش تبدا، كوپي .env.example، وضبط الخدمات اللي محتاج، وشغّل خادم PHP للاختبار المحلي، وخلي التطبيق ينشئ جداول SQLite ديالو فـ أول طلب. استعمل ENGINE.md باش تفهم حدود الأنظمة الفرعية واش جاهزة للنشر.