Backend ya NeuraVision: Mwongozo wa Kivitendo wa Usanidi na Matumizi

NeuraVision Inatoa Nini

NeuraVision ni injini ya upande wa nyuma kwa bidhaa ya kutengeneza maudhui kwa kutumia AI. Hifadhi hii ina mantiki ya upande wa seva kwa dashibodi ya wanachama, API za upande wa nyuma, uthibitishaji, na kifuatiliaji cha uchanganuzi na mgawanyo wa trafiki kinachojihifadhi chenyewe.

Uhamishaji huu una msimbo pekee. Hauhusishi kurasa za kutua, maudhui ya uuzaji, midia, vipengee vya dashibodi, faili za mazingira, hifadhidata, au faili zilizowasilishwa na watumiaji.

Muundo wa Mradi

Saraka kuu zinaendana na majukumu mahususi ya upande wa nyuma:

• api/ ina ncha za upande wa nyuma za upakuaji, maombi ya utengenezaji, OAuth, na malipo.
• functions/ hutoa visaidizi vya PHP vinavyoshirikiwa kwa uthibitishaji, barua pepe, SMS, captcha, na hakiki.
• lk/ ina mantiki ya upande wa nyuma ya dashibodi ya wanachama.
• auth/, auth.php, register.php, na logout.php hutekeleza kuingia, usajili, na mtiririko wa OAuth wa Google au Twitter.
• chat/ ina upande wa nyuma wa wijeti ya gumzo la usaidizi.
• data/ ina kazi zilizopangwa za kutuma kampeni na relay za CAPI.
• a/ ina kikusanyaji cha uchanganuzi kinachojihifadhi chenyewe na mantiki ya utafutaji wa eneo la kijiografia.
• PHPMailer/ ina maktaba ya barua iliyojumuishwa kwenye mradi.

Kwa maelezo ya kila mfumo mdogo, soma ENGINE.md. Inaeleza ni sehemu zipi ni vipengee halisi vinavyofanya kazi vya injini na zipi ni maeneo ya onyesho au yanayolenga kupata wateja.

Mahitaji na Usanidi

NeuraVision huendeshwa kwenye PHP 7.4 au mpya zaidi nyuma ya nginx au Apache. Hutumia SQLite kwa uhifadhi na haihitaji hatua ya kuunda.

Usanidi hutolewa kupitia vigezo vya mazingira. Hifadhi hii inajumuisha .env.example, inayoorodhesha mipangilio inayotarajiwa, ikiwemo vitambulisho vya huduma za majukwaa ya matangazo, SMTP au Resend, hCaptcha, na roboti za Telegram.

Funguo tupu za usanidi huzima kipengele husika, hivyo unaweza kusanidi huduma zinazohitajika tu kwa uwekaji wako. Usikabidhi faili halisi ya .env au vitambulisho vya API kwenye udhibiti wa msimbo.

Usakinishaji na Usanidi wa Awali

1. Pata hifadhi kwenye seva au mashine ya kutengenezea.
2. Copy faili ya mfano ya usanidi kwenye faili ya mazingira ya ndani:

cp .env.example .env

1. Fungua .env na ujaze funguo zinazohitajika na mifumo midogo unayokusudia kutumia. Rejelea ENGINE.md na miito ya getenv(...) iliyo kote kwenye msimbo ili kutambua majina ya vigezo husika.
2. Anzisha seva ya maendeleo iliyojengwa ndani ya PHP kutoka kwenye saraka ya mradi:

php -S 127.0.0.1:8000

Kwa uwekaji, elekeza PHP-FPM na nginx au Apache kwenye folda ya mradi badala ya kutumia seva ya maendeleo iliyojengwa ndani.

Uhifadhi wa SQLite

Hifadhidata za SQLite zilizo chini ya data/ huundwa kiotomatiki programu inapopokea ombi lake la kwanza. Kila moduli hutumia CREATE TABLE IF NOT EXISTS, kwa hiyo hakuna hatua tofauti ya kuingiza skima wakati wa usanidi.

Hifadhidata zinazozalishwa zinaweza kuwa na data ya programu kama akaunti za watumiaji, matukio ya kifuatiliaji, na hakiki. Faili za hifadhidata hazijajumuishwa kwenye uhamishaji wa hifadhi na zinapaswa kushughulikiwa kama data ya uwekaji badala ya msimbo chanzo.

Matumizi ya Msingi

Anzisha upande wa nyuma ndani ya kompyuta

Baada ya kusanidi mazingira, anzisha seva ya ndani:

php -S 127.0.0.1:8000

Kisha fikia programu kupitia anwani ya ndani na ujaribu mtiririko unaopatikana wa uthibitishaji, dashibodi, API, gumzo, au uchanganuzi unaoungwa mkono na usanidi wako.

Sanidi uthibitishaji

Weka vigezo vya mazingira vinavyohusiana na OAuth vinavyohitajika kwa kuingia kwa Google au Twitter. Njia za kuanzia uthibitishaji zinajumuisha auth/, auth.php, register.php, na logout.php. Acha vitambulisho vya hiari vikiwa tupu wakati mtoa huduma si sehemu ya uwekaji wako.

Washa vipengele vinavyotegemea huduma

Sanidi miunganisho unayohitaji tu. Kwa mfano, uwasilishaji wa barua unahitaji mipangilio inayofaa ya SMTP au Resend, huku vipengele vya captcha, Telegram, majukwaa ya matangazo, na CAPI vikihitaji vitambulisho vyake. Funguo zinazokosekana au zilizo tupu huacha uwezo huo wa hiari ukiwa umezimwa.

Usanidi na Uendeshaji wa Kina

Husisha usanidi na mifumo midogo

Usichukulie kila kigezo cha mazingira kuwa cha lazima. Anza na .env.example, kisha tumia ENGINE.md kubaini ni funguo zipi ni za API, uthibitishaji, kazi zilizopangwa, kikusanyaji cha uchanganuzi, au vipengele vya mawasiliano. Hii huweka uwekaji kuwa mdogo na kufanya utatuzi wa matatizo ulengwe zaidi.

Elewa uhamishaji wa msimbo pekee

Hifadhi hii haijumuishi kwa makusudi vipengee vya kuona vya dashibodi ya wanachama, ikiwemo picha, video, CSS, na JavaScript. Pia haijumuishi kurasa za kutua na za kisheria, midia, fonti, maudhui ya tafsiri, vipakiaji, vipindi vya gumzo, miendelezo ya gumzo, faili za hali ya OAuth, na hifadhidata za SQLite. Panga kutoa au kuhifadhi rasilimali hizi kando unapounganisha injini kwenye bidhaa kamili.

Tumia muundo sahihi wa upangishaji

Tumia php -S kwa majaribio ya ndani. Kwa uwekaji kwenye seva, endesha programu ya PHP nyuma ya nginx au Apache pamoja na PHP-FPM, na toa vigezo vya mazingira kupitia usanidi wa seva badala ya kuweka siri moja kwa moja kwenye hifadhi.

Kagua hali ya vipengele kabla ya kuzindua

Hati za mradi zinatofautisha vipengee halisi vinavyofanya kazi vya injini na utendaji wa onyesho au unaolenga kupata wateja. Kagua ENGINE.md kabla ya kutegemea mfumo mdogo katika uzalishaji, hasa unapopanga miunganisho inayohusu maombi ya utengenezaji, malipo, uchanganuzi, au kazi zilizopangwa.

Hitimisho

NeuraVision hutoa mfumo wa nyuma wa PHP 7.4+ wenye hifadhi ya SQLite, usanidi unaotegemea mazingira, uthibitishaji, API, mantiki ya dashibodi, mawasiliano, kazi zilizopangwa, na uchanganuzi unaojihudumia. Ili kuanza, nakili .env.example, sanidi huduma unazohitaji, anzisha seva ya PHP kwa majaribio ya ndani, na uruhusu programu kuunda majedwali yake ya SQLite kwenye ombi la kwanza. Tumia ENGINE.md kuelewa mipaka ya mifumo midogo na utayari wa kupeleka programu.