AI แยกโค้ด frontend กับ backend: รวมเป็นแอปเดียว หรือแยกสองโปรเจกต์

ZIP ที่มีโฟลเดอร์ frontend กับ backend ขึ้น BrewInTH ไม่ได้ทั้งก้อน เพราะหนึ่งโปรเจกต์รันได้หนึ่งแอป วิธีรวมเป็นแอปเดียว หรือแยกสองโปรเจกต์ พร้อม prompt
ให้ AI อย่าง ChatGPT, Claude หรือ Cursor สร้างเว็บที่มีระบบหลังบ้าน หลายครั้งจะได้โปรเจกต์ที่แบ่งเป็นสองโฟลเดอร์ คือ frontend/ สำหรับหน้าเว็บที่ทำด้วย React หรือ Vue และ backend/ สำหรับ API ที่ทำด้วย Express หรือ FastAPI พอบีบทั้งโฟลเดอร์เป็น ZIP แล้วส่งที่หน้า อัปโหลดแล้วขึ้นเว็บ กลับเจอข้อความ ไฟล์ชุดนี้มีมากกว่าหนึ่งแอป แล้วไม่รู้จะไปต่อทางไหน
บทความนี้อธิบายว่าทำไม BrewInTH ไม่รับ ZIP แบบนี้ทั้งก้อน แล้วพาทำทั้งสองทางที่ระบบแนะนำ คือรวมเป็นแอปเดียว หรือแยกเป็นสองโปรเจกต์ พร้อมข้อความสั่ง AI ที่คัดลอกไปใช้ได้ และจุดที่มักพลาดของแต่ละทาง
สรุปสั้นก่อนอ่าน
📦 หนึ่งโปรเจกต์บน BrewInTH รันได้หนึ่งแอป ZIP ที่มีหลายแอปแยกโฟลเดอร์และไม่มีแอปที่รากจึงถูกปฏิเสธ พร้อมบอกชื่อโฟลเดอร์ที่พบ
🧩 ทางที่ 1 รวมเป็นแอปเดียว: server เสิร์ฟหน้าเว็บที่ build แล้วด้วย ได้ที่อยู่เดียว ไม่ต้องตั้ง CORS และใช้แพ็กเกจ Free ได้
🔀 ทางที่ 2 แยกสองโปรเจกต์: หน้าเว็บโปรเจกต์หนึ่ง API อีกโปรเจกต์หนึ่ง ต้องตั้ง CORS และใส่ที่อยู่ API ไว้ในไฟล์ที่ใช้ตอน build
⚠️ ทางรวมแบบ Node.js: package.json ที่รากต้องมีคำสั่ง start และมี library ของ server เช่น express ไม่งั้นระบบเข้าใจว่าเป็นเว็บหน้าบ้านล้วน
✅ เว็บส่วนใหญ่ใช้ทางรวมได้ง่ายกว่า เลือกแยกเมื่อ API ต้องให้แอปมือถือหรือระบบอื่นเรียกใช้ด้วย
ทำไมระบบไม่รับ ZIP ที่มี frontend/ กับ backend/
บน BrewInTH หนึ่งโปรเจกต์คือแอปหนึ่งตัว มีที่อยู่เว็บชุดเดียว ใช้เทคโนโลยีเดียว และมีคำสั่งเริ่มแอปคำสั่งเดียว ตอนรับ ZIP ระบบมองหาไฟล์กำหนดโปรเจกต์ เช่น package.json, requirements.txt หรือ composer.json ถ้าเจอที่รากของ ZIP ระบบถือว่าทั้ง ZIP เป็นแอปเดียว แต่ถ้าที่รากไม่มี และเจอหลายโฟลเดอร์ (ลึกไม่เกินสองชั้น) ที่ต่างมีไฟล์กำหนดโปรเจกต์ของตัวเอง ระบบจะไม่เดาว่าควรรันตัวไหน
หน้า อัปโหลดแล้วขึ้นเว็บ จึงหยุดก่อนสร้างหรือเผยแพร่อะไร แล้วบอกว่าเจอแอปอะไรในโฟลเดอร์ไหน เช่น
ไฟล์ชุดนี้มี 2 แอปแยกโฟลเดอร์: backend/ (Node.js (express)), frontend/ (Vite) — หนึ่งโปรเจกต์ขึ้นได้หนึ่งแอป: ให้ AI รวมเป็นแอปเดียว (เช่น ให้ฝั่ง server เสิร์ฟไฟล์ที่ build จากฝั่งหน้าเว็บ) หรือส่งทีละโฟลเดอร์เป็นคนละโปรเจกต์
ถ้าให้ AI agent นำขึ้นผ่านลิงก์และ token ก็ติดกฎเดียวกัน ขั้นตรวจก่อนเผยแพร่จะบอกว่าไม่พบไฟล์กำหนดโปรเจกต์ที่รากของ ZIP และไม่ให้เผยแพร่จนกว่าจะแก้

รวมหรือแยก เลือกแบบไหนดี
ทั้งสองทางใช้ได้จริง ต่างกันที่ความง่ายและการดูแลต่อ

- รวมเป็นแอปเดียว เหมาะกับเว็บทั่วไป เช่น ร้านค้า ระบบจองคิว หรือระบบหลังบ้านขององค์กร ที่หน้าเว็บกับ API ใช้ด้วยกันเสมอ
- แยกสองโปรเจกต์ เหมาะเมื่อ API ต้องให้แอปมือถือหรือระบบของคนอื่นเรียกใช้ด้วย หรืออยากอัปเดตหน้าเว็บกับ API แยกจังหวะกัน
แพ็กเกจ Free สร้างได้ 1 โปรเจกต์ ถ้าเลือกแยก ต้องใช้แพ็กเกจที่ได้ตั้งแต่ 2 โปรเจกต์ขึ้นไป เช่น Starter 99 บาทต่อเดือน หรือ Seed 749 บาทต่อปี
ทางที่ 1: รวมเป็นแอปเดียว (เหมาะกับเว็บส่วนใหญ่)
หลักของทางนี้คือให้ server ตัวเดียวทำสองหน้าที่ คำขอที่ขึ้นต้นด้วย /api ให้ server ตอบเป็นข้อมูล ส่วนคำขออื่นให้ส่งไฟล์หน้าเว็บที่ build แล้ว ถ้าเป็นที่อยู่ของหน้าที่ไม่มีไฟล์จริง เช่น /orders/15 ของ React Router ให้ตอบ index.html เพื่อให้ router ฝั่งเบราว์เซอร์ทำงานต่อ
เมื่อหน้าเว็บกับ API อยู่ที่อยู่เดียวกัน หน้าเว็บเรียก API ด้วยที่อยู่สั้น ๆ อย่าง /api/products ได้เลย ไม่ต้องเปิด CORS ไม่ต้องจำที่อยู่ API ไว้ที่ไหน และเมื่อเชื่อมโดเมนของตัวเองภายหลัง ก็ไม่ต้องแก้โค้ด

ระบบทำอะไรกับแอป Node.js แบบรวม
ตอนเผยแพร่ ระบบอ่าน package.json ที่รากของ ZIP แล้วทำตามลำดับนี้
- ติดตั้ง dependency ด้วย
npm ciถ้ามีpackage-lock.jsonหรือnpm installถ้าไม่มี - รัน
npm run buildถ้า package.json มีคำสั่ง build ขั้นนี้คือที่ที่ใช้ build หน้าเว็บ - เริ่มแอปด้วย
npm startถ้าไม่มีคำสั่ง start จะหาไฟล์server.js,index.jsหรือmain.jsที่ราก
server ต้องฟังพอร์ตจากค่า PORT ที่ระบบตั้งให้ และอ่านค่าลับ เช่น รหัสฐานข้อมูล จาก environment variable
⚠️ จุดที่พลาดบ่อยที่สุด ถ้า package.json ที่รากมีเครื่องมือ build หน้าเว็บ เช่นviteหรือreact-scriptsแต่ไม่มี library ของ server เช่นexpress,fastify,honoหรือ@nestjs/coreระบบจะถือว่าเป็นเว็บหน้าบ้านล้วน คือ build แล้วเผยแพร่เฉพาะไฟล์ที่ได้ ไม่รัน server ของคุณเลย หน้าสรุปจะมีบรรทัด "เว็บ Vite: build แล้วเผยแพร่ไฟล์ที่ได้เป็นเว็บ static" ถ้าเห็นบรรทัดนี้ทั้งที่ตั้งใจรวม ให้ย้าย library ของ server ไปไว้ใน dependencies ของ package.json ที่ราก
ข้อความสั่ง AI ให้รวมเป็นแอปเดียว
โปรเจกต์นี้มีโฟลเดอร์ frontend/ (หน้าเว็บ) และ backend/ (API)
ช่วยรวมให้ขึ้นเป็นแอปเดียวบน BrewInTH ดังนี้
1. ให้ server ใน backend เสิร์ฟไฟล์ที่ build จาก frontend สำหรับทุกที่อยู่ที่ไม่ได้ขึ้นต้นด้วย /api
และตอบ index.html ให้ที่อยู่ของหน้าที่ไม่มีไฟล์จริง เพื่อให้ router ฝั่งหน้าเว็บทำงาน
2. ย้าย API ทั้งหมดไปอยู่ใต้ /api และให้หน้าเว็บเรียก API ด้วยที่อยู่แบบสั้น เช่น /api/products
(เอาที่อยู่ localhost ออก และไม่ต้องเปิด CORS)
3. ทำ package.json ที่รากโปรเจกต์ ให้มี
- dependencies ของ server (เช่น express) อยู่ในไฟล์นี้
- "build" = คำสั่งติดตั้งและ build หน้าเว็บ
- "start" = คำสั่งเริ่ม server
แล้วสร้าง package-lock.json ที่รากด้วย
4. ให้ server ฟังพอร์ตจาก process.env.PORT และอ่านค่าลับจาก environment variable
5. บอกฉันว่าต้องบีบโฟลเดอร์ไหนเป็น ZIP โดยไม่ใส่ node_modules
ได้ ZIP แล้วส่งที่หน้า อัปโหลดแล้วขึ้นเว็บ ตามปกติ ถ้าแอปใช้ฐานข้อมูล หน้านี้อ่าน package.json ลึกลงไปสองชั้นเพื่อดูว่าใช้ฐานข้อมูลหรือ Redis อะไร จึงสร้างฐานข้อมูลให้ได้แม้ library อยู่ใน backend/package.json
ถ้า server ไม่ใช่ Node.js
- PHP หรือ Laravel ถ้ามี package.json ที่ราก ระบบรัน
npm run buildให้ตอนเผยแพร่ด้วย - ภาษาอื่น เช่น Python หรือ Go ขั้น build ของภาษาเหล่านี้ไม่รัน npm ให้ AI build หน้าเว็บก่อน แล้วใส่โฟลเดอร์ผลลัพธ์ (เช่น
dist/) ไว้ใน ZIP ให้ server เสิร์ฟ ส่วนไฟล์กำหนดโปรเจกต์ของ server เช่นrequirements.txtต้องอยู่ที่ราก
ทางที่ 2: แยกเป็นสองโปรเจกต์
ทางนี้หน้าเว็บกับ API เป็นคนละโปรเจกต์ คนละที่อยู่ เช่น myshop.host.brewinth.net เป็นหน้าเว็บ และ myshop-api.host.brewinth.net เป็น API ทำตามลำดับนี้
- สร้างสองโปรเจกต์ ตั้งชื่อให้รู้ว่าตัวไหนคือหน้าเว็บ ตัวไหนคือ API
- ส่ง API ขึ้นก่อน บีบเฉพาะโฟลเดอร์
backendเป็น ZIP แล้วส่งเข้าโปรเจกต์ API ระบบถือว่าเวอร์ชันใหม่พร้อมเมื่อหน้าแรก/ตอบสำเร็จ ถ้า API ไม่มีหน้า/ให้ใส่ที่อยู่ เช่น/api/healthในช่อง Path ตรวจความพร้อม ของแท็บ ตั้งค่าแอป - เปิด CORS ที่ API BrewInTH ไม่ใส่ CORS ให้แอปเอง ต้องให้ AI เปิดในโค้ดของ API เฉพาะที่อยู่ของหน้าเว็บ (และโดเมนจริงเมื่อเชื่อมแล้ว) ไม่ใช่
* - ใส่ที่อยู่ API ไว้ในไฟล์ของหน้าเว็บ ขั้น build ไม่ได้อ่านค่าจากตั้งค่าแอป ค่าอย่าง
VITE_API_URLจึงต้องอยู่ในไฟล์.env.productionที่ส่งไปกับโค้ด ระวังไฟล์ชื่อ.envที่รากของ ZIP เพราะหน้าอัปโหลดแล้วขึ้นเว็บจะย้ายค่าในไฟล์นั้นไปเก็บเป็นค่าตั้งแอปและไม่อัปโหลดตัวไฟล์ ค่าที่ใช้ตอน build จึงหายไป - ส่งหน้าเว็บ บีบเฉพาะโฟลเดอร์
frontendแล้วส่งเข้าโปรเจกต์หน้าเว็บ ระบบ build แล้วเผยแพร่ไฟล์ในโฟลเดอร์dist/,build/หรือout/และตอบindex.htmlให้ที่อยู่ของหน้าที่ไม่มีไฟล์จริง ส่วนไฟล์อย่าง.jsหรือรูปที่หาไม่เจอจะได้ 404
อีกเรื่องที่ควรรู้คือ ระบบล็อกอินที่เก็บ session ใน cookie มักต้องตั้งค่าเพิ่มเมื่อหน้าเว็บกับ API อยู่คนละที่อยู่ ถ้า AI บอกว่าต้องแก้เรื่องนี้เยอะ ทางรวมอาจง่ายกว่า
ข้อความสั่ง AI ให้แยกสองโปรเจกต์
จะแยกขึ้นเป็นสองโปรเจกต์บน BrewInTH
- API (โฟลเดอร์ backend) อยู่ที่ https://myshop-api.host.brewinth.net
- หน้าเว็บ (โฟลเดอร์ frontend) อยู่ที่ https://myshop.host.brewinth.net
ช่วยแก้ให้
1. backend เปิด CORS เฉพาะ https://myshop.host.brewinth.net (ไม่ใช้ *)
และมี GET /api/health ที่ตอบ 200
2. backend ฟังพอร์ตจาก PORT และอ่านค่าลับจาก environment variable
3. frontend อ่านที่อยู่ API จาก VITE_API_URL และสร้างไฟล์ frontend/.env.production
ที่มี VITE_API_URL=https://myshop-api.host.brewinth.net (ห้ามใส่ค่าลับในไฟล์นี้)
4. แต่ละโฟลเดอร์มี package.json และ lockfile ของตัวเอง
แล้วบอกว่าต้องบีบโฟลเดอร์ไหนส่งเข้าโปรเจกต์ไหน
เปลี่ยนที่อยู่ในข้อความเป็นที่อยู่จริงของโปรเจกต์คุณก่อนส่ง ค่าใน .env.production ทุกคนที่เปิดเว็บมองเห็นได้ จึงใส่ได้แค่ที่อยู่ API ไม่ใช่รหัสหรือ key
คำถามที่พบบ่อย
ให้ AI agent นำขึ้นผ่านลิงก์และ token แทนการอัปโหลดเองได้ไหม
ได้ กฎเดียวกันคือ ZIP ต้องมีไฟล์กำหนดโปรเจกต์ที่ราก บอก AI ตั้งแต่แรกว่าเลือกทางไหน ถ้าเลือกแยก ต้องออก token ให้ทีละโปรเจกต์ เพราะ token หนึ่งใช้ได้กับโปรเจกต์เดียว
ใช้ npm workspaces ได้ไหม
ได้ ถ้า package.json ที่รากชี้ไปที่โฟลเดอร์ frontend และ backend ระบบถือว่าทั้ง ZIP เป็นแอปเดียว และ npm ci ที่รากติดตั้งของทุกโฟลเดอร์ให้ เงื่อนไขเหมือนทางรวมทุกข้อ คือที่รากต้องมีคำสั่ง build กับ start และถ้ามี vite ในไฟล์ที่ราก ต้องมี library ของ server อยู่ด้วย
backend เป็น Python (FastAPI หรือ Django) รวมได้ไหม
ได้ ให้ AI build หน้าเว็บก่อน แล้วให้ FastAPI หรือ Django เสิร์ฟโฟลเดอร์ผลลัพธ์ โดยมี requirements.txt อยู่ที่รากของ ZIP เพราะขั้น build ของ Python ไม่รัน npm ให้
หน้าเว็บเรียก API แล้วเจอ error เรื่อง CORS
แปลว่าหน้าเว็บกับ API อยู่คนละที่อยู่ ถ้าใช้ทางรวม ให้หน้าเว็บเรียก /api/... แทนที่อยู่เต็ม ถ้าใช้ทางแยก ให้ API อนุญาตที่อยู่ของหน้าเว็บ และเมื่อเชื่อมโดเมนของตัวเองแล้ว ต้องเพิ่มโดเมนนั้นด้วย
แยกไปแล้ว อยากเปลี่ยนเป็นรวมทีหลังได้ไหม
ได้ ถ้าโปรเจกต์หน้าเว็บเคยนำขึ้นผ่านหน้าอัปโหลดแล้วขึ้นเว็บ ให้ส่ง ZIP ชุดที่รวมแล้วเข้าโปรเจกต์เดิม ที่อยู่เว็บเดิมใช้ต่อได้ แล้วค่อยพักหรือลบโปรเจกต์ API ที่ไม่ใช้แล้ว
สรุป
ข้อความ "ไฟล์ชุดนี้มีมากกว่าหนึ่งแอป" ไม่ได้แปลว่าเว็บของคุณขึ้นไม่ได้ แค่ต้องเลือกว่าจะให้เป็นแอปเดียวหรือสองโปรเจกต์ เว็บส่วนใหญ่รวมเป็นแอปเดียวได้ง่ายกว่า เพราะได้ที่อยู่เดียว ไม่ต้องตั้ง CORS และอัปเดตด้วย ZIP ไฟล์เดียว เลือกแยกเมื่อ API ต้องให้ระบบอื่นใช้ด้วย แล้วอย่าลืมเปิด CORS และใส่ที่อยู่ API ใน .env.production
