Yeqa uye kokucuketse lokuyinhloko

Tinguquko Temkhatsi

Yonkhe iprojekthi ye-ChurchApps isebenzisa ifayela le-.env lekulungiselela endzaweni. Ngayinye yetiprojekthi ifaka ifayela lesampula lolungiselwa kutsi uyakopisha bese uyalungisa. Leli phepha limboza tinguquko temkhatsi te-API, ema-web app, nema-mobile app, kanye nendlela yekukhetha phakati kwetindzawo tedemo netendzawo letendzeni.

Ngaphambi Kokuqala

Indlela Lejwayelekile​

  1. Funa dotenv.sample.txt noma .env.sample endzaweni yemzuzo weprojekthi.
  2. Yikopisha ibe .env.
  3. Lungisa tinkhomba njengoba kudzingeka.
# Sibonelo lweprojekthi ene-.env.sample
cp .env.sample .env

# Sibonelo lweprojekthi ene-dotenv.sample.txt
cp dotenv.sample.txt .env
sicwayiso

Ungalokhi emafayela .env ku-version control. Aqukete imfihlo njengetitifakelo tedatabhethi, tikhiye te-API, nemakhiyi e-JWT. Yonkhe iprojekthi ye-ChurchApps ifaka .env ku-.gitignore, kodvwa hlala uhlola kahle ngaphambi kokuthumela ekhodi.

Kukhetha Indzawo Ye-API​

Sinqumo lesibaluleke kakhulu kutsi i-frontend yakho icondzise kuphi tikhombo te-API. Kukhona tinketho letimbili:

Inketho 1: I-API Yedemo (Iyanconywa Kuntfuntfo Lwe-Frontend)​

Sebentisa indzawo yedemo yelabelwanako. Akudzingeki i-API yendzawo noma kusetfwa kwedatabhethi. Isebentisa likhodi lelisha kakhulu kusuka ku-main, nedatha yayo yesampula igcwaliswa kabusuku ngabusuku.

# Indlela yesisekelo yeURL
https://api.demo.churchapps.org/{module}

# Tibonelo tetimodyuli te-URL
https://api.demo.churchapps.org/membership
https://api.demo.churchapps.org/attendance
https://api.demo.churchapps.org/content
https://api.demo.churchapps.org/giving
https://api.demo.churchapps.org/messaging
https://api.demo.churchapps.org/doing
sicwayiso

Indzawo yekuhlola (api.staging.churchapps.org, api.staging.lessons.church, nakutikhomba letihlobene nato) seyiyekiwe. Tifayela tesampula te-.env letitsite tingase tisafake ema-URL ekuhlola; tishintshe ngetinkhomba tedemo noma tendzawo letikhonjiswe kuleli phepha. Alikho i-API ye-Lessons yelabelwanako yekungakakhiqizi -- sebentisa i-LessonsApi endzaweni (iletfwa ku-port 8090) uma uyidzinga.

Inketho 2: I-API Yendzawo​

Gijima iprojekthi ye-Api ekhompyutha yakho. Idzinga i-MySQL 8.0+ nemadatabhethi adalwe ngemodyuli ngayinye. Bona umhlahlandlela we-kusetfwa kwendzawo kwe-API.

# Indlela yesisekelo yeURL
http://localhost:8084/{module}

# Tibonelo tetimodyuli te-URL
http://localhost:8084/membership
http://localhost:8084/attendance
http://localhost:8084/content
http://localhost:8084/giving
http://localhost:8084/messaging
http://localhost:8084/doing

Tinguquko Temkhatsi Te-API​

Iprojekthi yesisekelo ye-Api (.env.sample) inetilungiselelo letinyenti kakhulu. Nansi tinguquko letibalulekile:

Tilungiselelo Letabelanako​

InguqukoIncazeloSibonelo
ENVIRONMENTIndzawo yekusebentadev
SERVER_PORTI-HTTP port yeseva yendzawo yekuthuthukisa8084
ENCRYPTION_KEYLikhiye lekubhalela le-192-bit yedatha lebucayiaSecretKeyOfExactly192BitsLength
JWT_SECRETImfihlo yekusayina ama-JSON Web Tokenjwt-secret-dev
FILE_STORELapho kugcinwa khona emafayela lalayishiwe (disk noma s3)disk
CORS_ORIGINTindzawo te-CORS letivumelekile (* yendzawo yekuthuthukisa)*

Kuxhumana Nedatabhethi​

I-URL yesisekelo yodvwa icondzisa i-API ku-MySQL. I-API ibeka indzawo yedatha ngayinye yemodyuli (/membership, /attendance, /content, /giving, /messaging, /doing, /reporting) kusuka kulesisekelo.

InguqukoSibonelo
API_DATABASE_URLmysql://root:password@localhost:3306
seluleko

Vuselela root:password ngetitifakelo takho te-MySQL letitfolo. Yonkhe i-database yemodyuli kufanele ibe khona ngaphambi kokugijima i-API. Sebentisa npm run initdb kutsi udale sakhiwo lwedatha lwayo yonkhe imodyuli, noma npm run initdb:membership kwemodyuli lenye.

Tilungiselelo Te-WebSocket​

InguqukoIncazeloSibonelo
SOCKET_PORTPort yeseva ye-WebSocket8087
SOCKET_URLI-URL ye-WebSocket lamaklayenti ayakhumbelela kuyows://localhost:8087

Tinguquko Temkhatsi Te-Web App​

B1Admin (React + Vite)​

Ifayela lesampula: .env.sample

InguqukoIncazeloSibonelo (Demo)
REACT_APP_STAGELibito lendzawodemo
PORTPort yeseva yekuthuthukisa3101
REACT_APP_API_BASEI-URL yesisekelo leyodvwa yazo tonkhe tI-API ye-ChurchApps (/membership, /attendance, /content, /giving, /messaging, /doing, /reporting tiyangezelwa ngekutfola)https://api.demo.churchapps.org
REACT_APP_CONTENT_ROOTI-URL yekulethwa kwemkhatsihttps://democontent.churchapps.org
REACT_APP_GOOGLE_ANALYTICSI-ID ye-Google Analytics (ayikho ibalulekile)UA-123456789-1

Kuze kuthuthukiswe i-API yendzawo, chaza i-URL yesisekelo kuleyo stack yakho yendzawo:

REACT_APP_API_BASE=http://localhost:8084

B1App (Next.js)​

Ifayela lesampula: .env.sample

InguqukoIncazeloSibonelo (Demo)
NEXT_PUBLIC_API_BASEI-URL yesisekelo leyodvwa yazo tonkhe tI-API ye-ChurchApps (/membership, /attendance, /content, /giving, /messaging, /doing, /reporting tiyangezelwa ngekutfola)https://api.demo.churchapps.org
NEXT_PUBLIC_CONTENT_ROOTI-URL yekulethwa kwemkhatsihttps://democontent.churchapps.org
NEXT_PUBLIC_GOOGLE_ANALYTICSI-ID ye-Google Analytics (ayikho ibalulekile)UA-123456789-1
imininingwane

I-Next.js idinga sicalo NEXT_PUBLIC_ kunoma yiphi inguquko yemkhatsi ledingeka kutsi itfolakale ku-browser. Tinguquko letisebenta ku-server kayidingi sicalo lesi.

LessonsApp (Next.js)​

Ifayela lesampula: dotenv.sample.txt

InguqukoIncazeloSibonelo (LessonsApi Yendzawo)
STAGESigaba sendzawo (shiya ingasetfwanga noma dev kuze kuthuthukiswe endzaweni)dev
NEXT_PUBLIC_LESSONS_APII-URL ye-Lessons APIhttp://localhost:8090
NEXT_PUBLIC_CONTENT_ROOTI-URL yekulethwa kwemkhatsihttp://localhost:8090/content
NEXT_PUBLIC_API_BASEIsisekelo se-API ye-ChurchApps lesetfwa kungena ngayo (yamukelwa kuphela uma i-STAGE ingasetfwanga noma ibe dev)https://api.demo.churchapps.org

Tinguquko Temkhatsi Te-Mobile App​

B1Checkin (React Native / Expo)​

Ifayela lesampula: dotenv.sample.txt

InguqukoIncazeloSibonelo
EXPO_PUBLIC_STAGEIkhetha sette ye-API i-app ehlanganisa kuyo: dev (i-API yendzawo ku-http://127.0.0.1:8084), staging, noma prod (yona leyisendleko uma ingasetfwanga)dev

I-B1Checkin isebentisa emamodyuli e-API ye-Membership ne-Attendance kuphela, kanye ne-URL yekulethwa kwemkhatsi; tindzawo tato ngalesigaba ngasinye tibekwe ku-src/helpers/EnvironmentHelper.ts.

imininingwane

I-Expo ifaka kuphela tinguquko letinesicalo EXPO_PUBLIC_ ku-bundle yeapp. Qala kabusha i-dev server ngemyalo yarn start --reset-cache uma ushintsha i-.env.


Incwadzi Lesheshi Yekusheshisa: Tindzawo Tetifayela Tesampula​

IprojekthiIfayela Lesampula
Api.env.sample
B1Admin.env.sample
B1App.env.sample
B1Checkindotenv.sample.txt
LessonsAppdotenv.sample.txt
AskApidotenv.sample.txt