# ระบบ CMS Pages และ Section Block ของ DBK Platform

> **Platform scope:** HomAroma content blocks are reference-tenant examples, not a restriction on tenant verticals. See [`docs/PLATFORM_OVERVIEW.md`](docs/PLATFORM_OVERVIEW.md).

## การทำงานของระบบ CMS Pages และ Section Block

ระบบนี้ออกแบบมาในรูปแบบของ **Dynamic Page Builder** หรือ **Headless CMS** ที่ให้ผู้ใช้งานสามารถประกอบหน้าเว็บ (Page) ได้เองโดยการเรียงต่อ Block (Section) ต่างๆ เข้าด้วยกัน โดยมีโครงสร้างการทำงานหลักๆ ดังนี้:

1. **Database Structure**:
   - `Page`: เก็บข้อมูลพื้นฐานของหน้าเว็บ เช่น `slug`, `title`, สถานะการเผยแพร่ เป็นต้น
   - `PageSection`: เก็บข้อมูลของแต่ละ Block ภายในหน้านั้นๆ โดยมีความสัมพันธ์แบบ 1-to-many กับ `Page` (1 หน้ามีได้หลาย Section)

2. **การจัดเก็บข้อมูล (Data Storage)**:
   - แต่ละ `PageSection` จะมีฟิลด์ `type` เพื่อระบุว่า Block นี้คือ Component อะไร (เช่น `HERO`, `TEXT`, `PRODUCTS`)
   - ข้อมูลเนื้อหาและตั้งค่าของแต่ละ Block จะถูกเก็บไว้ในฟิลด์ `payload` ในรูปแบบ **JSON** ซึ่งทำให้มีความยืดหยุ่นสูง สามารถรองรับโครงสร้างข้อมูลที่แตกต่างกันของแต่ละ Block ได้โดยไม่ต้องแก้ Schema ฐานข้อมูล

3. **โครงสร้างของ Payload**:
   - `localized string`: รองรับหลายภาษา มักจะเป็น Object เช่น `{ "th": "...", "en": "..." }`
   - `plain string`: ค่าข้อความธรรมดาที่ไม่ต้องแปล
   - `optional`: ข้อมูลที่สามารถเว้นว่างได้

---

## รายการ Section Block ทั้งหมด (17 Blocks)

ปัจจุบันระบบรองรับ Block Section ทั้งหมด 17 ประเภท โดยแต่ละประเภทมีค่า (Payload) ดังต่อไปนี้:

### 1. `HERO`
- **หน้าที่**: แบนเนอร์หลักขนาดใหญ่สำหรับส่วนบนสุดของหน้า (เหมาะสำหรับหน้าแรกหรือแคมเปญ)
- **ค่าใน Payload**:
  - `tagline` (localized string)
  - `title` (localized string)
  - `description` (localized string)
  - `imageUrl` (plain string)
  - `buttonText` (localized string)
  - `buttonLink` (plain string)

### 2. `BANNER`
- **หน้าที่**: รูปภาพแบนเนอร์แนวนอนพร้อมปุ่มกด (Call to Action)
- **ค่าใน Payload**:
  - `imageUrl` (plain string)
  - `linkUrl` (plain string)
  - `title` (localized string) *optional*
  - `description` (localized string) *optional*
  - `buttonText` (localized string) *optional*

### 3. `TEXT`
- **หน้าที่**: Block สำหรับแสดงข้อความธรรมดา
- **ค่าใน Payload**:
  - `title` (localized string) *optional*
  - `content` (localized string)
  - `textAlign` (plain string) *optional*: `left`, `center`, `right`

### 4. `ANNOUNCEMENT_BAR`
- **หน้าที่**: แถบประกาศข้อความด้านบนสุดที่สามารถเลื่อน (Rotate) ได้
- **ค่าใน Payload**:
  - `slides` (array of localized strings)
  - `backgroundColor` (plain string) *optional*
  - `textColor` (plain string) *optional*
  - `speed` (number) *optional*

### 5. `NEWSLETTER`
- **หน้าที่**: ฟอร์มรับสมัครรับข่าวสาร (Newsletter)
- **ค่าใน Payload**:
  - `title` (localized string)
  - `description` (localized string)
  - `buttonText` (localized string)
  - `placeholderText` (plain string) *optional*
  - `showPrivacyCheckbox` (boolean)
  - `privacyText` (plain string) *optional*

### 6. `EDITORIAL_TILE`
- **หน้าที่**: แสดงเนื้อหาแบบช่องภาพคู่กับข้อความ (Side-by-side)
- **ค่าใน Payload**:
  - `title` (localized string)
  - `description` (localized string)
  - `imageUrl` (plain string)
  - `imagePosition` (plain string): `left` หรือ `right`
  - `buttonText` (plain string) *optional*
  - `buttonLink` (plain string) *optional*
  - `backgroundColor` (plain string) *optional*
  - `textColor` (plain string) *optional*

### 7. `EDITORIAL_CAROUSEL`
- **หน้าที่**: สไลด์แสดงเนื้อหาบทความแบบเรื่องราว (Storytelling)
- **ค่าใน Payload**:
  - `title` (localized string)
  - `slides` (array of objects): แต่ละสไลด์มี
    - `category` (localized string)
    - `title` (localized string)
    - `description` (localized string)
    - `imageUrl` (plain string)
    - `buttonText` (plain string) *optional*
    - `buttonLink` (plain string) *optional*

### 8. `PRODUCTS`
- **หน้าที่**: แสดงรายการสินค้าแบบ Grid หรือลิสต์
- **ค่าใน Payload**:
  - `title` (localized string)
  - `subtitle` (localized string) *optional*
  - `type` (plain string): `featured`, `scent`, หรือ `custom`
  - `scentId` (number) *optional*
  - `productIds` (array of numbers) *optional*
  - `limit` (number) *optional*
  - `layout` (plain string) *optional*: `grid` หรือ `carousel`
  - `enableQuickShop` (boolean) *optional*

### 9. `CATEGORIES`
- **หน้าที่**: แสดงหมวดหมู่สินค้า
- **ค่าใน Payload**:
  - `title` (localized string)
  - `subtitle` (localized string) *optional*
  - `categoryIds` (array of numbers) *optional*

### 10. `HERO_ARTICLE`
- **หน้าที่**: ส่วนหัวของบทความ (Article Header)
- **ค่าใน Payload**:
  - `title` (localized string)
  - `subtitle` (localized string) *optional*
  - `author` (localized string) *optional*
  - `category` (localized string) *optional*
  - `publishDate` (plain string) *optional*
  - `date` (plain string) *optional*
  - `imageUrl` (plain string)
  - `backgroundImageUrl` (plain string) *optional*
  - `overlayColor` (plain string) *optional*

### 11. `RICH_TEXT`
- **หน้าที่**: Block สำหรับเนื้อหาแบบ HTML ที่สามารถจัดรูปแบบได้
- **ค่าใน Payload**:
  - `title` (localized string) *optional*
  - `content` (localized string) *required* (รองรับ HTML)

### 12. `SCENT_NOTES_BREAKDOWN`
- **หน้าที่**: อธิบายเลเยอร์ของกลิ่นน้ำหอม (Top, Heart/Middle, Base Notes)
- **ค่าใน Payload**:
  - `title` (localized string) *optional*
  - `description` (localized string) *optional*
  - `topNotes` (array of strings or localized string objects)
  - `heartNotes` (array of strings or localized string objects) *หมายเหตุ: ผูกรวมกับ middleNotes*
  - `middleNotes` (array of strings or localized string objects)
  - `baseNotes` (array of strings or localized string objects)

### 13. `QUOTE_CALLOUT`
- **หน้าที่**: แสดงคำคมหรือข้อความเน้นพิเศษ
- **ค่าใน Payload**:
  - `quote` (localized string) *required*
  - `author` (localized string) *optional*
  - `role` (localized string) *optional*

### 14. `PRODUCT_CAROUSEL`
- **หน้าที่**: แสดงสินค้าที่แนะนำในรูปแบบ Carousel
- **ค่าใน Payload**:
  - `title` (localized string) *optional*
  - `description` (localized string) *optional*
  - `collectionId` (plain string) *optional*
  - `limit` (number) *optional*
  - `showPrice` (boolean) *optional*
  - `showAddToCart` (boolean) *optional*
  - `products` (optional explicit product list)

### 15. `ACCORDION`
- **หน้าที่**: แสดงข้อมูลแบบถาม-ตอบ หรือเนื้อหาที่พับเก็บได้ (FAQ)
- **ค่าใน Payload**:
  - `title` (localized string) *optional*
  - `categories` (*required* array): แต่ละหมวดหมู่มี
    - `name` (localized string)
    - `icon` (plain string) *optional*
    - `questions` (*required* array): แต่ละคำถามมี
      - `q` (localized string)
      - `a` (localized string)

### 16. `CONTACT_INFO`
- **หน้าที่**: แสดงข้อมูลการติดต่อ (ที่อยู่, อีเมล, Line ฯลฯ)
- **ค่าใน Payload**:
  - `title` (localized string) *optional*
  - `address` (localized string) *required*
  - `email` (plain string) *required*
  - `line` (plain string) *required*
  - `hours` (localized string) *required*

### 17. `CONTACT_FORM`
- **หน้าที่**: ส่วนหัวสำหรับแบบฟอร์มการติดต่อ
- **ค่าใน Payload**:
  - `title` (localized string) *optional*
  - `subtitle` (localized string) *optional*