NeuraVision Backendi: Amaliy sozlash va foydalanish bo‘yicha qo‘llanma

NeuraVision nimalarni taqdim etadi

NeuraVision sun’iy intellekt yordamida kontent yaratish mahsulotining backend dvigatelidir. Ushbu repozitoriy a’zolar paneli, backend API’lari, autentifikatsiya hamda o‘z serveringizda ishlaydigan analitika va trafikni taqsimlash kuzatuvchisining server tomonidagi mantiqini o‘z ichiga oladi.

Eksport faqat kodni o‘z ichiga oladi. Unda landing sahifalari, marketing kontenti, media fayllar, panel aktivlari, muhit fayllari, ma’lumotlar bazalari yoki foydalanuvchilar yuborgan fayllar mavjud emas.

Loyiha tuzilishi

Asosiy kataloglar backend’ning muayyan vazifalariga mos keladi:

• api/ yuklab olish, generatsiya so‘rovlari, OAuth va billing uchun backend endpointlarini o‘z ichiga oladi.
• functions/ autentifikatsiya, elektron pochta, SMS, captcha va sharhlar uchun umumiy PHP yordamchi funksiyalarini taqdim etadi.
• lk/ a’zolar panelining backend mantiqini o‘z ichiga oladi.
• auth/, auth.php, register.php va logout.php tizimga kirish, ro‘yxatdan o‘tish hamda Google yoki Twitter OAuth jarayonlarini amalga oshiradi.
• chat/ qo‘llab-quvvatlash chat vidjeti backend’ini o‘z ichiga oladi.
• data/ kampaniya xabarlari va CAPI relay’lari uchun rejalashtirilgan vazifalarni o‘z ichiga oladi.
• a/ o‘z serveringizda ishlaydigan analitika to‘plagichi va geo-aniqlash mantiqini o‘z ichiga oladi.
• PHPMailer/ repozitoriyga kiritilgan pochta kutubxonasini o‘z ichiga oladi.

Quyi tizimlar bo‘yicha batafsil ma’lumot uchun ENGINE.md fayliga murojaat qiling. Unda qaysi qismlar ishlaydigan dvigatel komponentlari, qaysilari esa demo yoki faqat lead yig‘ishga mo‘ljallangan sohalar ekani tushuntiriladi.

Talablar va konfiguratsiya

NeuraVision nginx yoki Apache ortida PHP 7.4 yoki undan yangiroq versiyada ishlaydi. Saqlash uchun SQLite’dan foydalanadi va build bosqichini talab qilmaydi.

Konfiguratsiya muhit o‘zgaruvchilari orqali taqdim etiladi. Repozitoriyda .env.example mavjud bo‘lib, unda reklama platformalari, SMTP yoki Resend, hCaptcha va Telegram botlari uchun xizmat ma’lumotlari kabi kutiladigan sozlamalar hujjatlashtirilgan.

Bo‘sh konfiguratsiya kalitlari tegishli funksiyani o‘chiradi, shuning uchun faqat joylashtirishingiz uchun zarur xizmatlarni sozlashingiz mumkin. Haqiqiy .env fayli yoki API ma’lumotlarini manba kodini boshqarish tizimiga yubormang.

O‘rnatish va dastlabki sozlash

1. Repozitoriyni server yoki ishlab chiqish kompyuteriga oling.
2. Namunaviy konfiguratsiya faylini mahalliy muhit fayliga nusxalang:

cp .env.example .env

1. .env faylini oching va foydalanmoqchi bo‘lgan quyi tizimlar uchun zarur kalitlarni to‘ldiring. Tegishli o‘zgaruvchi nomlarini aniqlash uchun ENGINE.md fayli va kod bo‘ylab uchraydigan getenv(...) chaqiruvlariga murojaat qiling.
2. Loyiha katalogidan PHP’ning ichki ishlab chiqish serverini ishga tushiring:

php -S 127.0.0.1:8000

Joylashtirish uchun ichki ishlab chiqish serveridan foydalanish o‘rniga PHP-FPM hamda nginx yoki Apache’ni loyiha papkasiga yo‘naltiring.

SQLite xotirasi

data/ ichidagi SQLite ma’lumotlar bazalari dastur birinchi so‘rovni qabul qilganda avtomatik yaratiladi. Har bir modul CREATE TABLE IF NOT EXISTS dan foydalanadi, shuning uchun sozlash jarayonida alohida sxema importi bosqichi mavjud emas.

Yaratilgan ma’lumotlar bazalarida foydalanuvchi hisoblari, kuzatuvchi hodisalari va sharhlar kabi dastur ma’lumotlari bo‘lishi mumkin. Ma’lumotlar bazasi fayllari repozitoriy eksportiga kiritilmagan va manba kodi emas, balki joylashtirish ma’lumotlari sifatida boshqarilishi kerak.

Asosiy foydalanish

Backend’ni mahalliy ishga tushirish

Muhitni sozlaganingizdan so‘ng mahalliy serverni ishga tushiring:

php -S 127.0.0.1:8000

So‘ngra ilovaga mahalliy manzil orqali kiring va konfiguratsiyangiz qo‘llab-quvvatlaydigan autentifikatsiya, panel, API, chat yoki analitika jarayonlarini sinab ko‘ring.

Autentifikatsiyani sozlash

Google yoki Twitter orqali kirish uchun zarur OAuth muhit o‘zgaruvchilarini belgilang. Autentifikatsiya kirish nuqtalariga auth/, auth.php, register.php va logout.php kiradi. Provayder joylashtirishingiz tarkibiga kirmasa, ixtiyoriy ma’lumotlarni bo‘sh qoldiring.

Xizmatlarga bog‘liq funksiyalarni yoqish

Faqat kerakli integratsiyalarni sozlang. Masalan, pochta yetkazib berish uchun tegishli SMTP yoki Resend sozlamalari, captcha, Telegram, reklama platformalari va CAPI funksiyalari uchun esa tegishli ma’lumotlar talab qilinadi. Yetishmayotgan yoki bo‘sh kalitlar ushbu ixtiyoriy imkoniyatlarni o‘chirilgan holda qoldiradi.

Kengaytirilgan konfiguratsiya va amaliyotlar

Konfiguratsiyani quyi tizimlarga moslashtirish

Har bir muhit o‘zgaruvchisini majburiy deb hisoblamang. .env.example faylidan boshlang, so‘ngra qaysi kalitlar API, autentifikatsiya, rejalashtirilgan vazifalar, analitika to‘plagichi yoki aloqa funksiyalariga tegishli ekanini aniqlash uchun ENGINE.md faylidan foydalaning. Bu joylashtirishni ixcham saqlaydi va muammolarni bartaraf etishni yanada maqsadli qiladi.

Faqat koddan iborat eksportni tushunish

Repozitoriy a’zolar panelining vizual aktivlarini, jumladan rasmlar, video, CSS va JavaScript’ni ataylab o‘z ichiga olmaydi. Shuningdek, unda landing va huquqiy sahifalar, media fayllar, shriftlar, lokalizatsiya matnlari, yuklamalar, chat sessiyalari, chat davomlari, OAuth holat fayllari va SQLite ma’lumotlar bazalari mavjud emas. Dvigatelni to‘liq mahsulotga integratsiya qilishda ushbu resurslarni alohida taqdim etish yoki saqlashni rejalashtiring.

To‘g‘ri hosting modelidan foydalanish

Mahalliy sinov uchun php -S dan foydalaning. Serverga joylashtirishda PHP ilovasini PHP-FPM bilan nginx yoki Apache ortida ishga tushiring va maxfiy ma’lumotlarni repozitoriyga qattiq yozish o‘rniga muhit o‘zgaruvchilarini server konfiguratsiyasi orqali taqdim eting.

Ishga tushirishdan oldin funksiyalar holatini tekshirish

Loyiha hujjatlarida haqiqatan ishlaydigan dvigatel komponentlari demo yoki faqat lead yig‘ishga mo‘ljallangan funksiyalardan ajratib ko‘rsatilgan. Ishlab chiqarish muhitida quyi tizimga tayanishdan oldin, ayniqsa generatsiya so‘rovlari, billing, analitika yoki rejalashtirilgan vazifalar bo‘yicha integratsiyalarni rejalashtirayotganda, ENGINE.md faylini ko‘rib chiqing.

Xulosa

NeuraVision SQLite xotirasi, muhitga asoslangan konfiguratsiya, autentifikatsiya, API'lar, boshqaruv paneli mantiqi, kommunikatsiyalar, rejalashtirilgan vazifalar va o‘z serveringizda joylashtiriladigan analitika bilan PHP 7.4+ backendini taqdim etadi. Ishni boshlash uchun .env.example faylidan nusxa oling, kerakli xizmatlarni sozlang, mahalliy sinov uchun PHP serverini ishga tushiring va ilovaga birinchi so‘rovda SQLite jadvallarini yaratishga ruxsat bering. Quyi tizimlar chegaralari va joylashtirishga tayyorlikni tushunish uchun ENGINE.md faylidan foydalaning.