Easy CMS คืออะไร

Easy CMS คือ headless CMS ที่ติดตั้งเข้าไปในแอป Nuxt หรือ Next.js ด้วย npm และทำงานอยู่ใน server ของแอปคุณเอง จึงไม่ต้องมีบริการ CMS แยกให้ดูแล จ่ายเงิน หรือคอย sync ข้อมูล:

• กำหนดเนื้อหาด้วยโค้ด collection, field, กฎสิทธิ์ และ hook อยู่ใน easy-cms.config.ts ซึ่ง review และเก็บเวอร์ชันได้เหมือนโค้ดส่วนอื่น
• ผู้แก้เนื้อหาได้หน้า admin ที่ /admin: รายการ ฟอร์มที่สร้างให้อัตโนมัติ rich text คลังสื่อที่มี โฟลเดอร์และตัวอย่างไฟล์ ฉบับร่าง ประวัติ และตัวอย่างสด เป็นภาษาไทยและอังกฤษ
• ทีมควบคุมได้: บทบาทและสิทธิ์ ที่ตั้งในหน้า admin single sign-on และ audit log ว่าใครเปลี่ยนอะไร
• หน้าเว็บอ่านเนื้อหา ผ่าน Local API ที่มี type บน server (useEasyCMS() ใน Nuxt, getEasyCMS(config) ใน Next.js) และ client ใดก็ใช้ REST API ที่ /api/cms ได้
• ข้อมูลอยู่ในฐานข้อมูลของคุณ: SQLite (ไฟล์ หรือ Turso) หรือ Postgres (server หรือ PGlite สำหรับพัฒนาในเครื่อง) Easy CMS ยุ่งเฉพาะตารางที่ขึ้นต้นด้วย prefix ของมัน (ecms_)

ส่วนต่างๆ ทำงานร่วมกันอย่างไร

┌────────────────── แอป Nuxt / Next.js ของคุณ ──────────────────┐
│  หน้าเว็บ ──► Local API (มี type)    browser ──► /api/cms      │
│  ผู้แก้เนื้อหา ──► /admin                                       │
│                  @easy-cms/nuxt | @easy-cms/next              │
│                        @easy-cms/core                         │
│          SQLite / Postgres (ตาราง ecms_) · ไฟล์อัปโหลด           │
└───────────────────────────────────────────────────────────────┘

• @easy-cms/core รวมทุกอย่างที่สำคัญไว้: config, การตรวจสอบข้อมูล, สิทธิ์, hook, ฉบับร่าง, Local API และ REST API เป็น TypeScript ธรรมดาบน Request/Response แบบ Web standard ไม่มี framework อยู่ข้างใน
• adapter ติดตั้ง core เข้ากับ framework: Nuxt module, route handler ของ Next.js หรือ standalone server สำหรับ frontend อื่นๆ
• adapter ฐานข้อมูล (@easy-cms/db-sqlite หรือ @easy-cms/db-postgres) เก็บเอกสารเป็นตารางและคอลัมน์จริง คุณจึงยัง query ด้วย SQL ได้
• หน้า admin (@easy-cms/admin) เป็นแอป Vue ที่ build มาแล้ว คุณไม่ต้อง build เอง มันอ่าน config จาก API แล้ววาดฟอร์มให้

คำศัพท์ในคู่มือนี้

เมื่อไหร่ที่เหมาะ

• คุณทำเว็บด้วย Nuxt หรือ Next.js และอยากได้ระบบแก้เนื้อหาโดยไม่ต้องมีบริการเพิ่ม
• คุณทำเว็บด้วย Vite, React, Vue หรือ static site generator และอยากได้ backend CMS ขนาดเล็กที่ดูแลเอง: รันเป็น standalone server
• คุณชอบให้ schema อยู่ใน TypeScript และใน git ผ่าน review ใน pull request
• คุณ deploy แอป server หนึ่งตัวคู่กับฐานข้อมูล (VPS, container, แพลตฟอร์มอย่าง Railway หรือ Render หรือ serverless คู่กับ Postgres)
• ผู้แก้เนื้อหาทำงานเป็นภาษาไทย อังกฤษ หรือทั้งสองภาษา
• คุณอยากลองบน Vercel หรือ Netlify ก่อน: deploy starter ในคลิกเดียว

เมื่อไหร่ที่ไม่เหมาะ

• ผู้แก้เนื้อหาต้องเปลี่ยนโครงสร้างเนื้อหาเองโดยไม่มีนักพัฒนา เพราะที่นี่โครงสร้างคือโค้ด
• คุณต้องใช้ edge runtime: Easy CMS ต้องใช้ Node.js 22.12 ขึ้นไป
• คุณต้องการ integration สำเร็จรูปจำนวนมากตั้งแต่วันนี้

ขั้นต่อไป

• เริ่มใช้งาน: เพิ่ม Easy CMS ให้โปรเจกต์ในไม่กี่นาที
• การตั้งค่า: ตัวเลือกทั้งหมดของ easy-cms.config.ts