I-Backend ye-NeuraVision: Umhlahlandlela Osebenzayo Wokusetha Nokusebenzisa

Okunikezwa yi-NeuraVision

I-NeuraVision iyinjini engemuva yomkhiqizo okhiqiza okuqukethwe nge-AI. Le repository iqukethe umqondo osebenza ohlangothini lweseva wedeshibhodi yamalungu, ama-API angemuva, ukuqinisekiswa kobunikazi, kanye nomlandeli ozisingathayo wezibalo nokuhlukaniswa kwethrafikhi.

Ukukhishwa kuqukethe ikhodi kuphela. Akuqukethe amakhasi okuqala, okuqukethwe kokumaketha, imidiya, izinsiza zedeshibhodi, amafayela emvelo, amabhange edatha, noma amafayela athunyelwe abasebenzisi.

Isakhiwo Sephrojekthi

Ama-directory amakhulu ahambisana nemisebenzi ethile yangemuva:

• api/ iqukethe ama-endpoint angemuva okulanda, izicelo zokukhiqiza, i-OAuth, nokukhokhisa.
• functions/ inikeza abasizi be-PHP ababelwana ngabo bokuqinisekisa ubunikazi, i-imeyili, i-SMS, i-captcha, nezibuyekezo.
• lk/ iqukethe umqondo wangemuva wedeshbhodi yamalungu.
• auth/, auth.php, register.php, kanye ne-logout.php kusebenzisa ukungena, ukubhalisa, kanye nezinqubo ze-Google noma ze-Twitter OAuth.
• chat/ iqukethe umqondo wangemuva wewijethi yengxoxo yosizo.
• data/ iqukethe imisebenzi ehleliwe yokuthumela imikhankaso kanye nama-relay e-CAPI.
• a/ iqukethe umqoqi wezibalo ozisingathayo kanye nomqondo wokubheka indawo.
• PHPMailer/ iqukethe umtapo wezincwadi wemeyili ofakwe ngaphakathi.

Ukuze uthole incazelo yesistimu ngayinye, bheka ku-ENGINE.md. Ichaza ukuthi yiziphi izingxenye eziyizinjini ezisebenzayo nokuthi yiziphi izindawo zedemo noma ezihloselwe ukuqoqa abaholayo kuphela.

Izidingo Nokucushwa

I-NeuraVision isebenza ku-PHP 7.4 noma entsha ngemuva kwe-nginx noma i-Apache. Isebenzisa i-SQLite ukugcina idatha futhi ayidingi isinyathelo sokwakha.

Ukucushwa kunikezwa ngama-environment variable. I-repository ifaka i-.env.example, echaza izilungiselelo ezilindelekile, okuhlanganisa imininingwane yezinsizakalo zamapulatifomu okukhangisa, i-SMTP noma i-Resend, i-hCaptcha, nama-bot e-Telegram.

Okhiye bokucushwa abangenalutho bakhubaza isici esihlobene, ngakho ungacusha kuphela izinsizakalo ezidingekayo ekusetshenzisweni kwakho. Ungalokothi ufake ifayela langempela le-.env noma imininingwane ye-API ekulawulweni komthombo.

Ukufakwa Nokusethwa Kokuqala

1. Thola i-repository kuseva noma emshinini wokuthuthukisa.
2. Kopisha ifayela lokucushwa lesibonelo ulifake efayilini lendawo lemvelo:

cp .env.example .env

1. Vula i-.env bese ugcwalisa okhiye obudingwa yizinhlelo ohlose ukuzisebenzisa. Bheka ku-ENGINE.md nakuma-call e-getenv(...) kuyo yonke ikhodi ukuze ubone amagama ama-variable afanele.
2. Qalisa iseva yokuthuthukisa eyakhelwe ku-PHP usuka ku-directory yephrojekthi:

php -S 127.0.0.1:8000

Ekusetshenzisweni, khomba i-PHP-FPM kanye ne-nginx noma i-Apache kufolda yephrojekthi esikhundleni sokusebenzisa iseva yokuthuthukisa eyakhelwe ngaphakathi.

Ukugcinwa Kwedatha Kwe-SQLite

Amabhange edatha e-SQLite angaphansi kwe-data/ adalwa ngokuzenzakalelayo lapho uhlelo luthola isicelo salo sokuqala. Imojuli ngayinye isebenzisa i-CREATE TABLE IF NOT EXISTS, ngakho asikho isinyathelo esihlukile sokungenisa i-schema enqubweni yokusetha.

Amabhange edatha akhiqiziwe angaba nedatha yohlelo efana nama-akhawunti abasebenzisi, imicimbi yomlandeli, nezibuyekezo. Amafayela ebhange ledatha awafakiwe ekukhishweni kwe-repository futhi kufanele aphathwe njengedatha yokusetshenziswa, hhayi ikhodi yomthombo.

Ukusetshenziswa Okuyisisekelo

Qalisa i-backend endaweni

Ngemva kokucusha imvelo, qalisa iseva yendawo:

php -S 127.0.0.1:8000

Bese ufinyelela uhlelo usebenzisa ikheli lendawo futhi uhlole izinqubo ezitholakalayo zokuqinisekisa ubunikazi, ideshibhodi, i-API, ingxoxo, noma izibalo ezisekelwa ukucushwa kwakho.

Qinisekisa ubunikazi

Setha ama-environment variable ahlobene ne-OAuth adingekayo ekungeneni nge-Google noma nge-Twitter. Izindawo zokuqala zokuqinisekisa ubunikazi zifaka i-auth/, auth.php, register.php, kanye ne-logout.php. Shiya imininingwane yokuzikhethela ingenalutho lapho umhlinzeki engeyona ingxenye yokusetshenziswa kwakho.

Vumela izici ezisekelwe ezinsizakalweni

Cusha kuphela ukuhlanganiswa okudingayo. Isibonelo, ukuthunyelwa kwemeyili kudinga izilungiselelo ezifanele ze-SMTP noma ze-Resend, kanti izici ze-captcha, Telegram, amapulatifomu okukhangisa, ne-CAPI zidinga imininingwane yazo. Okhiye abashodayo noma abangenalutho bashiya lezo zici zokuzikhethela zikhubazekile.

Ukucushwa Okuthuthukile Nemisebenzi

Qondanisa ukucushwa nezinhlelo ezingaphansi

Ungaphathi yonke i-environment variable njengento eyimpoqo. Qala nge-.env.example, bese usebenzisa i-ENGINE.md ukuze unqume ukuthi yibaphi okhiye abaqondene ne-API, ukuqinisekiswa kobunikazi, imisebenzi ehleliwe, umqoqi wezibalo, noma izici zokuxhumana. Lokhu kugcina ukusetshenziswa kuncane futhi kwenza ukuxazulula izinkinga kugxile kakhulu.

Qonda ukukhishwa kwekhodi kuphela

I-repository ayifaki ngamabomu izinsiza ezibonakalayo zedeshibhodi yamalungu, okuhlanganisa izithombe, ividiyo, i-CSS, ne-JavaScript. Futhi ayifaki amakhasi okuqala nawezomthetho, imidiya, amafonti, okuqukethwe kokuhumusha, okulayishiwe, izikhathi zezingxoxo, ukuqhubeka kwezingxoxo, amafayela esimo se-OAuth, namabhange edatha e-SQLite. Hlela ukuhlinzeka noma ukugcina lezi zinsiza ngokwehlukana lapho uhlanganisa injini nomkhiqizo ophelele.

Sebenzisa uhlobo olufanele lokusingatha

Sebenzisa i-php -S ekuhloleni kwasendaweni. Ekusetshenzisweni kuseva, sebenzisa uhlelo lwe-PHP ngemuva kwe-nginx noma i-Apache ene-PHP-FPM, futhi unikeze ama-environment variable ngokucushwa kweseva esikhundleni sokubhala izimfihlo ngokuqondile ku-repository.

Buyekeza isimo sezici ngaphambi kokwethula

Imibhalo yephrojekthi ihlukanisa izingxenye zenjini ezisebenza ngempela emisebenzini yedemo noma ehloselwe ukuqoqa abaholayo kuphela. Buyekeza i-ENGINE.md ngaphambi kokuthembela kunoma yiluphi uhlelo olungaphansi ekukhiqizeni, ikakhulukazi lapho uhlela ukuhlanganiswa okuhlobene nezicelo zokukhiqiza, ukukhokhisa, izibalo, noma imisebenzi ehleliwe.

Isiphetho

INeuraVision inikeza i-backend ye-PHP 7.4+ enesitoreji se-SQLite, ukumiswa okusekelwe endaweni, ukuqinisekiswa kobunikazi, ama-API, ingqondo yedeshibhodi, ukuxhumana, imisebenzi ehleliwe, kanye nezibalo ezisingathwa uwena. Ukuze uqalise, kopisha .env.example, lungisa amasevisi owadingayo, qalisa iseva ye-PHP ukuze uhlole endaweni, bese uvumela uhlelo lokusebenza ukuthi lwenze amathebula alo e-SQLite esicelweni sokuqala. Sebenzisa ENGINE.md ukuze uqonde imingcele yezinhlelo ezingaphansi nokulungela ukuthunyelwa.