NeuraVision بیک اینڈ: عملی سیٹ اپ اور استعمال کی رہنما

NeuraVision کیا فراہم کرتا ہے

NeuraVision ایک AI مواد تیار کرنے والی مصنوعات کا بیک اینڈ انجن ہے۔ اس ریپوزٹری میں ممبر ڈیش بورڈ، بیک اینڈ APIs، تصدیق، اور خود میزبان تجزیاتی و ٹریفک تقسیم ٹریکر کے لیے سرور سائیڈ منطق شامل ہے۔

اس ایکسپورٹ میں صرف کوڈ شامل ہے۔ اس میں لینڈنگ پیجز، مارکیٹنگ کا مواد، میڈیا، ڈیش بورڈ اثاثے، ماحول کی فائلیں، ڈیٹابیس، یا صارف کی جمع کردہ فائلیں شامل نہیں ہیں۔

پروجیکٹ کا ڈھانچہ

اہم ڈائریکٹریاں بیک اینڈ کی مخصوص ذمہ داریوں سے مطابقت رکھتی ہیں:

• api/ میں ڈاؤن لوڈز، تخلیق کی درخواستوں، OAuth، اور بلنگ کے لیے بیک اینڈ اینڈ پوائنٹس شامل ہیں۔
• functions/ تصدیق، ای میل، SMS، captcha، اور جائزوں کے لیے مشترکہ PHP مددگار فراہم کرتا ہے۔
• lk/ میں ممبر ڈیش بورڈ کی بیک اینڈ منطق شامل ہے۔
• auth/، auth.php، register.php، اور logout.php لاگ اِن، رجسٹریشن، اور Google یا Twitter OAuth فلو نافذ کرتے ہیں۔
• chat/ میں سپورٹ چیٹ ویجیٹ کا بیک اینڈ شامل ہے۔
• data/ میں مہمات بھیجنے اور CAPI ریلے کے لیے شیڈول شدہ جابز شامل ہیں۔
• a/ میں خود میزبان تجزیاتی کلیکٹر اور جغرافیائی تلاش کی منطق شامل ہے۔
• PHPMailer/ میں شامل کردہ میل لائبریری موجود ہے۔

ہر سب سسٹم کی تفصیل کے لیے ENGINE.md دیکھیں۔ یہ واضح کرتا ہے کہ کون سے حصے فعال انجن اجزا ہیں اور کون سے ڈیمو یا صرف لیڈز کے لیے ہیں۔

تقاضے اور کنفیگریشن

NeuraVision PHP 7.4 یا اس کے بعد کے ورژن پر nginx یا Apache کے پیچھے چلتا ہے۔ یہ اسٹوریج کے لیے SQLite استعمال کرتا ہے اور اسے build step کی ضرورت نہیں ہوتی۔

کنفیگریشن ماحول کے متغیرات کے ذریعے فراہم کی جاتی ہے۔ ریپوزٹری میں .env.example شامل ہے، جس میں متوقع ترتیبات درج ہیں، جن میں اشتہاری پلیٹ فارمز، SMTP یا Resend، hCaptcha، اور Telegram بوٹس کے سروس کریڈنشلز شامل ہیں۔

خالی کنفیگریشن کیز متعلقہ فیچر کو غیر فعال کر دیتی ہیں، اس لیے آپ صرف اپنی ڈپلائمنٹ کے لیے درکار سروسز کو کنفیگر کر سکتے ہیں۔ حقیقی .env فائل یا API کریڈنشلز کو سورس کنٹرول میں commit نہ کریں۔

انسٹالیشن اور ابتدائی سیٹ اپ

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 اسٹوریج

data/ کے اندر SQLite ڈیٹابیس خود بخود اس وقت بن جاتے ہیں جب ایپلیکیشن کو پہلی درخواست موصول ہوتی ہے۔ ہر ماڈیول CREATE TABLE IF NOT EXISTS استعمال کرتا ہے، اس لیے سیٹ اپ کے عمل میں الگ schema-import مرحلہ نہیں ہوتا۔

بنائے گئے ڈیٹابیس میں صارف اکاؤنٹس، ٹریکر ایونٹس، اور جائزوں جیسا ایپلیکیشن ڈیٹا شامل ہو سکتا ہے۔ ڈیٹابیس فائلیں ریپوزٹری ایکسپورٹ میں شامل نہیں ہیں اور انہیں سورس کوڈ کے بجائے ڈپلائمنٹ ڈیٹا کے طور پر سنبھالنا چاہیے۔

بنیادی استعمال

بیک اینڈ مقامی طور پر شروع کریں

ماحول کنفیگر کرنے کے بعد مقامی سرور شروع کریں:

php -S 127.0.0.1:8000

پھر مقامی پتے کے ذریعے ایپلیکیشن تک رسائی حاصل کریں اور اپنی کنفیگریشن کے تحت دستیاب تصدیق، ڈیش بورڈ، API، چیٹ، یا تجزیاتی فلو آزمائیں۔

تصدیق کنفیگر کریں

Google یا Twitter لاگ اِن کے لیے درکار OAuth سے متعلق ماحول کے متغیرات مقرر کریں۔ تصدیقی انٹری پوائنٹس میں auth/، auth.php، register.php، اور logout.php شامل ہیں۔ جب کوئی فراہم کنندہ آپ کی ڈپلائمنٹ کا حصہ نہ ہو تو اختیاری کریڈنشلز خالی چھوڑ دیں۔

سروس پر مبنی فیچرز فعال کریں

صرف اپنی ضرورت کی انٹیگریشنز کنفیگر کریں۔ مثال کے طور پر، میل کی ترسیل کے لیے مناسب SMTP یا Resend ترتیبات درکار ہیں، جبکہ captcha، Telegram، اشتہاری پلیٹ فارم، اور CAPI فیچرز کے لیے اپنے متعلقہ کریڈنشلز درکار ہیں۔ غائب یا خالی کیز ان اختیاری صلاحیتوں کو غیر فعال رکھتی ہیں۔

اعلیٰ درجے کی کنفیگریشن اور آپریشنز

کنفیگریشن کو سب سسٹمز سے منسلک کریں

ہر ماحول کے متغیر کو لازمی نہ سمجھیں۔ .env.example سے آغاز کریں، پھر ENGINE.md کے ذریعے معلوم کریں کہ کون سی کیز API، تصدیق، شیڈول شدہ جابز، تجزیاتی کلیکٹر، یا مواصلاتی فیچرز سے متعلق ہیں۔ اس سے ڈپلائمنٹ کم سے کم رہتی ہے اور خرابیوں کی تشخیص زیادہ مرکوز ہو جاتی ہے۔

صرف کوڈ والے ایکسپورٹ کو سمجھیں

ریپوزٹری میں جان بوجھ کر ممبر ڈیش بورڈ کے بصری اثاثے شامل نہیں کیے گئے، جن میں تصاویر، ویڈیو، CSS، اور JavaScript شامل ہیں۔ اس میں لینڈنگ اور قانونی صفحات، میڈیا، فونٹس، بین الاقوامی متن، اپ لوڈز، چیٹ سیشنز، چیٹ ریزیومز، OAuth اسٹیٹ فائلیں، اور SQLite ڈیٹابیس بھی شامل نہیں ہیں۔ مکمل مصنوعات میں انجن کو ضم کرتے وقت ان وسائل کو الگ سے فراہم یا محفوظ رکھنے کا منصوبہ بنائیں۔

درست ہوسٹنگ ماڈل استعمال کریں

مقامی جانچ کے لیے php -S استعمال کریں۔ سرور ڈپلائمنٹ کے لیے PHP ایپلیکیشن کو PHP-FPM کے ساتھ nginx یا Apache کے پیچھے چلائیں، اور رازوں کو ریپوزٹری میں hardcode کرنے کے بجائے ماحول کے متغیرات سرور کی کنفیگریشن کے ذریعے فراہم کریں۔

لانچ سے پہلے فیچر کی حیثیت کا جائزہ لیں

پروجیکٹ کی دستاویزات حقیقی فعال انجن اجزا کو ڈیمو یا صرف لیڈز کی فعالیت سے الگ کرتی ہیں۔ پروڈکشن میں کسی سب سسٹم پر انحصار کرنے سے پہلے ENGINE.md کا جائزہ لیں، خاص طور پر تخلیق کی درخواستوں، بلنگ، تجزیات، یا شیڈول شدہ جابز کے گرد انٹیگریشنز کی منصوبہ بندی کرتے وقت۔

نتیجہ

NeuraVision ایک PHP 7.4+ بیک اینڈ فراہم کرتا ہے جس میں SQLite اسٹوریج، ماحول پر مبنی کنفیگریشن، توثیق، APIs، ڈیش بورڈ لاجک، مواصلات، شیڈول کردہ جابز اور خود میزبان اینالیٹکس شامل ہیں۔ شروع کرنے کے لیے .env.example کو کاپی کریں، اپنی ضرورت کی سروسز کی کنفیگریشن کریں، مقامی ٹیسٹنگ کے لیے PHP سرور شروع کریں، اور پہلی درخواست پر ایپلیکیشن کو اپنی SQLite ٹیبلز بنانے دیں۔ سب سسٹمز کی حدود اور تعیناتی کی تیاری سمجھنے کے لیے ENGINE.md استعمال کریں۔