Waa Maxay Doorsoomayaasha Deegaanka iyo Sirta? Hage Cad

Doorsoomaha deegaanka (environment variable) waa dejin magac leh — sida DATABASE_URL ama STRIPE_SECRET_KEY — oo loo gudbiyo app-kaaga markii uu shaqeynayo, halkii laga qori lahaa koodka. Sirta waa doorsoome deegaan oo qiimihiisu gaar u ahaanayo: furaha API, password, ama furaha saxiixa. Qiimayaashan oo ka baxsan koodka ayaa ka dhigaya in aad beddeli karto iyada oo aan wax koodka ah tafatirin, in aad isticmaasho mid kale oo tijaabada iyo macaamiisha dhabta ah loogu talagalay, iyo in aanay ka soo baxin markaad la wadaagto ama daabacdo koodkaaga.

Maxay muhiim u tahay markaad app ku dhisayso AI

Marka app-kaagu wax faa'iido leh ka qabto adeeg kale — lacag qaado, email dir, ama model AI u wicito — wuxuu u baahan yahay furaha. Dhisayaasha app-ka AI waxay had iyo jeer weydiiyaan furahaas, iyo meesha uu furuhu ku dhammaado ayaa go'aaminaya in app-kaagu ammaan yahay iyo in kale.

Waxyaabo laba ah oo caadi ahaan khaldamo app-yada lagu dhisay AI:

• Furaha waxaa lagu dhejiyaa chat-ka ama koodka. Markaas wuxuu ku nool yahay taariikhda chat-ka, faylasha mashruuca iyo export kasta ama repository. Qof kasta oo arkaa wuxuu isticmaali karaa akoonkaaga.
• Furaha waxaa lagu isticmaalaa browser-ka. Haddii koodka u wicita Stripe ama OpenAI uu ku shaqeeyo bogga, furaha waxaa loo diraa booqde kasta. Dadku way eegaan — scanner-yada otomaatiga ahna mar walba ayay raadiyaan furayaasha la soo baxay.

Fahamka doorsoomayaasha deegaanka wuxuu kuu oggolaanayaa in aad labadaba aqoonsato oo aad weydiisato xalka.

Tusaale maalmeed: qolka hoteelka iyo amniga

Koodka app-kaaga waa sida qolka hoteelka. Dadka martida ah (iyo nadiifiyayaasha, iyo qof kasta oo aad siiso kaarka furaha) way ku soo maraan. Ma dhigtid baasaboortigaaga miiska.

Doorsoomayaasha deegaanka waa amniga qolka ku jira. Qolku wuxuu ogyahay in amni jiro iyo sida loo furo marka loo baahdo, laakiin baasaboortigu ma aha wax ku yaal meel furan. Haddii aad qolka ka guurto — tusaale ahaan, dejintaada tijaabada ka tag websaydhka dhabta ah — baasaboort kale ayaad ku dhigtaa amniga qolkaas, adigoon dib u qurxin qolka.

Sida ay u shaqeeyaan

Koodkaagu wuxuu tixraacayaa magac, qiimihiisa maya. JavaScript ee server-ka, taasi waxay u egtahay process.env.STRIPE_SECRET_KEY. Markii app-ku bilaabmo, platform-ka uu ku shaqeeyo ayaa qiimaha u buuxiya magaca. Qiimaha ka beddel dejinta platform-ka, dib u bilow ama dib u geli (redeploy), app-ku wuxuu isticmaalaa mid cusub — iyada oo aan wax koodka ah la beddelin.

Halka qiimayaashu ka yimaaddo waxay kuxirantahay meesha app-ku ku shaqeeyo:

Doorsoomayaasha dadweynaha iyo kuwa sirta ah

Doorsoome deegaan kasta ma aha mid sir ah. Waxaa wanaagsan in aad u kala saarto laba koox:

Frameworks-ka websaydhka ayaa kala soocaya sidan si cad. Vite, kaliya doorsoomayaasha magacyadoodu ku bilaabmaan VITE_ ayaa lagu daraa koodka browser-ka; Next.js, horgalaha waa NEXT_PUBLIC_. Taasi waa hab amni: wax kasta oo leh horgalahaas ayaa ku dhammaada faylasha booqde kasta soo dejiyo, markaas sirta waa in aan horgalahaas loo siin.

Tusaale shaqo: badhanka soo koobida AI

Waxaad rabtaa badhan "Soo koobi qoraalkan" oo wicitaan u sameeya model AI.

Nooca aan amniga lahayn: koodka badhanka, oo ku shaqeeya browser-ka, wuxuu si toos ah ugu wicitaa bixiyaha AI isaga oo furaha API ku qoran. Preview-ga wuu shaqeeyaa. Laakiin waxay ka dhigan tahay in qof kasta uu furi karo qalabka horumarinta ee browser-ka, uu nuqul ka sameeyo furaha, oo uu lacag ku kharash gareeyo akoonkaaga.

Nooca amniga leh:

1. Furaha waxaad ku samaysaa bixiyaha AI, oo waxaad ku kaydisaa sir magaceeda OPENAI_API_KEY (ama mid la mid ah) dejinta mashruucaaga.
2. Backend-ka waxaa ku jira route, POST /api/summarise, oo akhrisa process.env.OPENAI_API_KEY, hubinaya in isticmaaluhu galay, kadibna wicitaan u sameeya bixiyaha.
3. Badhanku wuxuu wicitaan u sameeyaa route-kaaga, mana aha bixiyaha. Browser-ku furaha ma arko.
4. Waxaad isla sirta ku darsataa dejinta app-ka la daabacay, oo waad dib u geysaa si websaydhka toosan uu leeyahay.

Habkan — browser-ku wuxuu wicitaan u sameeyaa server-kaaga, server-kiisuna furaha wuu haysaa oo wuu wicitaan u sameeyaa adeegga — wuxuu ku dhacaa lacag bixinta, email-ka, khariidadaha iyo API kasta oo lacag ah. Hagaha isticmaalka LLM API-yada wuxuu ku sharxayaa kiiska AI qoto dheer.

Ereyada muhiimka ah

• Fayl .env: qoraal ah oo ka kooban sadarka NAME=value oo loo isticmaalo horumarinta maxalliga ah. Ku dar .gitignore si aan loo commit-garayn.
• .env.example: nuqul ka kooban magacyada laakiin aan qiimaha dhabta ahi ku jirin, oo loo commit-gareeyo si dadka kale ay ogaadaan doorsoomayaasha loo baahan yahay.
• Rotate: sirta mid cusub ku beddel oo kii hore ka jebi.
• Scope / ogolaansho: bixiyeyaal badan waxay kuu oggolaanayaan furayaal u shaqeeya oo keliya qaar ka mid ah hawlaha. Furaha email-ka keliya u diri karo waa mid ka amniyo furaha wax walba sameeya.
• Furayaasha tijaabada iyo kuwa dhabta ah: bixiyeyaal sida Stripe waxay kuu siiyaan furayaal kala duwan tijaabada iyo lacagta dhabta ah. Ilaa aad furto isticmaal furayaasha tijaabada.
• Sirta saxiixa: sir loo isticmaalo in la hubiyo in fariinta, sida webhook, ay si dhab ah uga timid diraha.

Khaladaadka caadiga ah iyo fahamka khaldan

• "Repository-gaygu waa gaar, sidaas darteed furayaasha ku jira waa wanaagsan yihiin." Repository-yada gaarka ah ayaa la wadaagaa, la fork-gareeyaa, la export-gareeyaa oo laptop-yada lagu clone-gareeyaa. Furayaasha weli ma aha meel ay ku waajib tahay in ay ku jiraan. Haddii mashruucaaga ku xidhto GitHub, hubi in fayl .env aan ku jirin.
• "Waan tirtiray, sidaas darteed way baabbi'day." Git wuxuu xifdiyaa taariikhda, chat-yaduna fariimaha way xifdiyaan. Haddii furaha mar la soo baxay, ka jebi.
• Isticmaalka horgalaha dadweynaha ee sirta. VITE_OPENAI_KEY wuxuu furahaaga ku dhigaa browser bundle-ka.
• Dib u geynta oo la iska illoobo. Beddelka doorsoomaha dejinta caadi ahaan wuxuu shaqeeyaa kaliya ka dib markii app-ka dib loo bilaabo ama dib loo daabaco.
• Hal furaha wax walba. Furayaal kala duwan tijaabada iyo dhabta ah, iyo app kasta, waxay kuu fududeeyaan in aad mid ka jebiso adigoon kuwa kale burburin.
• Ma jiro xad kharash. Adeegyada lacag ku shaqeeya, dejiso miisaaniyad ama xad dashboard-ka bixiyaha, haddii furaha la soo baxo.

Waxa aad weydiisato dhisaha AI

• "Ka akhri furaha Stripe ee sirta ah doorsoome deegaan oo magaceeda STRIPE_SECRET_KEY. Isticmaal server-ka oo keliya."
• "Hubi in sir aan lagu isticmaalin koodka client-ka oo aan horgalaha VITE_ / NEXT_PUBLIC_ loo siin."
• "Samee .env.example oo liis ah doorsoomayaasha app-ku u baahan yahay, iyada oo aan qiimayaasha ku jirin, oo hubi in .env git-ka laga reebay."
• "Hubi faylasha frontend-ka la dhisay si aad u aragto qoraal kasta oo u eg furaha API."

Liiska hubinta amniga ee app-yada AI lagu dhisay wuxuu ku daboolayaa sirta iyada oo ay ku jiraan hubinta kale ee ku habboon ka hor intaan la daabicin.

Sirta Mythex

Mythex, sirta waa doorsoomayaasha deegaanka ee mashruuca ah, oo lagu geliyo labadaba preview sandbox-ka iyo app-ka la daabacay. Waxaad ku dartaa project settings → Secrets ama adigoo /secrets ku qorayo chat-ka, markii agent-ku u baahdo furaha wuxuu chat-ka ku muujinayaa kaarka sirta, sidaas darteed qiimaha wuxuu galaa goobta foomka ee aan ku jirin taariikhda fariinta. Haddii aad sirta u beddesho app-ka dhabta ah, dib u daabac si deploy-gu u qaado. Export-yada mashruuca sirta ma ku jiraan, faylasha .env ee la soo dhoofiyay waa la nadiifiyaa, sidaas darteed waa inaad mar kale ku darto dejinta. Eeg doorsoomayaasha deegaanka iyo sirta iyo sirta chat-ka dokumentiga.

Su'aalaha