- POST /api/admin/uploads (multipart, ≤8MB, ตรวจ magic bytes JPEG/PNG/WebP/AVIF) เก็บ data/uploads/cinemas/ คืน /uploads/cinemas/<slug>-<random>-<ts>.<ext> - GET /uploads/** เสิร์ฟไฟล์อัปโหลด (Nitro route, immutable cache, กัน path traversal) - PhotosEditor: ปุ่มอัปโหลด + ลากไฟล์มาวาง + Ctrl+V วางจากคลิปบอร์ด, หลายไฟล์พร้อมกัน - app/lib/upload.ts กติกากลาง + upload.spec.ts (13 tests) - docs: api.md, admin-guide.md (วิธีอัปโหลด), DESIGN.md, README
170 lines
17 KiB
Markdown
170 lines
17 KiB
Markdown
# คู่มือใช้งานหลังบ้าน AlterFlixHub
|
|
|
|
คู่มือนี้ตอบคำถาม "แก้ตรงไหน" ทีละงาน — ทุกอย่างอยู่ใน `http://localhost:8080/admin`
|
|
(ล็อกอินด้วย `ADMIN_USERNAME` / `ADMIN_PASSWORD` ใน `.env`; ค่าเริ่มต้นคือ `it is me` / `it is me&it is me`)
|
|
|
|
หน้าหลังบ้านมี 7 แท็บ: **โรงหนัง · หน้าเกี่ยวกับเรา · สำหรับคนทำโรงหนัง · สำหรับคนรักหนัง · คำศัพท์หลายภาษา · Footer / ไอคอน · สถิติการค้นหา**
|
|
|
|
---
|
|
|
|
## 1. เพิ่ม / แก้ไขโรงหนัง
|
|
|
|
แท็บ **โรงหนัง** → เลือกโรงจากรายการซ้าย (หรือกด **+ เพิ่มโรงหนัง**)
|
|
|
|
ฟอร์มแบ่งเป็น **หมวดพับได้** — คลิกหัวหมวดเพื่อกาง ทำทีละหมวดแล้วกด **บันทึกทั้งหมด** (แถบปุ่มติดล่างจอ):
|
|
|
|
| หมวด | มีอะไร |
|
|
|---|---|
|
|
| **ข้อมูลหลัก** | ชื่อ EN/TH · slug (URL) · ตัวเลือก "ซ่อนโรงนี้จากหน้าเว็บ" |
|
|
| **หมวดหมู่ & สิ่งอำนวยความสะดวก** | ชิปหมวด (เลือกได้หลายอัน) + ชิปหัวข้อสิ่งอำนวยความสะดวก + ช่องชื่อหัวข้อเฉพาะโรง |
|
|
| **การเดินทาง & การติดต่อ** | วิธีเดินทาง (icon/TH/EN) · หัวข้อ "สอบถามข้อมูลและจองตั๋ว" · ช่องทางติดต่อ (Website/Facebook/Call) · รูปภาพ · การชำระเงิน |
|
|
| **ที่ตั้ง & แผนที่** | ที่ตั้ง TH/EN · ละติจูด/ลองจิจูด · Google map URL · ที่อยู่ (บรรทัดละรายการ) |
|
|
| **คำอธิบายโรงหนัง** | คำอธิบาย TH/EN ที่แสดงใต้ชื่อโรง |
|
|
|
|
### slug (URL)
|
|
|
|
- ระบบ **ดึงจากชื่ออังกฤษให้อัตโนมัติ** จนกว่าคุณจะแก้เอง (แก้แล้วจะไม่ถูกทับ)
|
|
- พิมพ์อะไรก็ได้ระหว่างแก้ แต่ตอนออกจากช่องจะถูกจัดรูป: ตัวเล็ก, ช่องว่าง → `-`, ตัดอักขระอื่น
|
|
- ถ้า **ว่าง / ซ้ำกับโรงอื่น** ระบบไม่ยอมบันทึกและบอกเหตุผล
|
|
- ⚠️ เปลี่ยน slug แล้วลิงก์เดิมจะใช้ไม่ได้ (ยังไม่มี redirect)
|
|
|
|
### ซ่อนโรงหนัง
|
|
|
|
ติ๊ก **"ซ่อนโรงนี้จากหน้าเว็บ"** → หายจากหน้าแรก/ผลค้นหา/"โรงหนังอิสระอื่นๆ"
|
|
แต่เปิดดูด้วย URL ตรงได้ (ใช้เตรียมข้อมูลก่อนเปิดตัว) — เอาติ๊กออกแล้วบันทึกเพื่อกลับมาแสดง
|
|
|
|
### สลับลำดับโรงหนัง
|
|
|
|
รายการซ้ายมี 2 โหมด: **ลำดับที่จัดไว้** (ลากวาง หรือกด ↑ ↓) และ **ก.ไก่-ฮ.นกฮูก** (เรียงชื่อไทยให้ดู)
|
|
โหมดเรียง ก-ฮ เป็นแค่การดู — กด **ใช้ลำดับ ก-ฮ นี้** เพื่อเอาลำดับนั้นมาใช้จริง
|
|
เมื่อลำดับเปลี่ยนจะมีปุ่ม **บันทึกลำดับใหม่** (หรือกด "บันทึกทั้งหมด" ก็ได้)
|
|
|
|
> **หน้าแรกสลับการ์ดเองทุกวัน** — ลำดับที่จัดไว้จะถูกใช้เป็น "ลำดับฐาน" แล้วระบบหมุน/สลับให้อัตโนมัติ
|
|
> เพื่อไม่ให้โรงใดอยู่ตำแหน่งเดิมสองวันติดกัน (ทุกคนเห็นเหมือนกันในวันเดียวกัน) — รายละเอียดดู DESIGN.md หัวข้อ "ลำดับการ์ดหน้าแรก"
|
|
|
|
---
|
|
|
|
## 2. รูปภาพโรงหนัง
|
|
|
|
หมวด **การเดินทาง & การติดต่อ** → ส่วน **รูปภาพโรงหนัง** → **อัปโหลดรูปจากเครื่อง**
|
|
|
|
1. กด **อัปโหลดรูปจากเครื่อง** แล้วเลือกไฟล์ (เลือกหลายไฟล์พร้อมกันได้) — หรือ **ลากไฟล์มาวาง** ในกล่องนั้น หรือ **Ctrl+V** วางรูปจากคลิปบอร์ด
|
|
2. รองรับ **JPG / PNG / WebP / AVIF** ขนาดไม่เกิน **8 MB** ต่อไฟล์ · ไฟล์จะถูกเก็บที่ `data/uploads/cinemas/` และได้ URL รูปแบบ `/uploads/cinemas/<ไฟล์>` ใช้อ้างในหน้าเว็บได้ทันที
|
|
3. ถ้าอยากใช้รูปที่วางบนเว็บอยู่แล้ว กด **เพิ่มช่อง URL** แล้ววางลิงก์ (`/images/…` หรือ URL เต็ม) — **ไม่แนะนำลิงก์จาก Google Maps/Facebook** เพราะลิงก์หมดอายุและทำให้รูปแตก
|
|
4. **รูปแรก = รูปปกการ์ดหน้าแรก** และภาพหลักในแกลเลอรีหน้า detail — สลับลำดับด้วยปุ่ม ↑/↓
|
|
5. มีไม่ครบ 3 รูป ช่องที่เหลือจะแสดงโลโก้ AlterFlixHub แทน
|
|
6. อย่าลืมกด **บันทึก** ท้ายฟอร์ม — รูปจะขึ้นหน้าเว็บทันทีหลังบันทึก
|
|
|
|
ไฟล์ในเครื่อง (สำหรับรูปที่เตรียมไว้ล่วงหน้า): วางที่ `public/images/…` แล้วใส่ `/images/…` · รูปที่อัปโหลดผ่านหลังบ้านจะอยู่ที่ `data/uploads/cinemas/` (สำรองข้อมูลแยกจาก repo)
|
|
|
|
---
|
|
|
|
## 3. หมวดหมู่ (categories)
|
|
|
|
หมวด **หมวดหมู่ & สิ่งอำนวยความสะดวก** → กดชิปที่ต้องการ (เลือกได้หลายอัน) หรือพิมพ์เองในช่องใต้ชิป (คั่นด้วย `,`)
|
|
|
|
หมวดที่ใช้ได้ตอนนี้: ยอดนิยม · อาร์ตเฮาส์ · สารคดี · หนังสั้น · หนังคลาสสิก · หนังนานาชาติ · หนังนอกกระแส · หนังในกระแส · หนังฝรั่งเศส · **กลุ่มคนฉายหนัง** · **หนังไทย**
|
|
|
|
- แถบกรองหน้าแรกสร้างจากรายการเดียวกับชิปนี้
|
|
- อยากได้คำแปลหมวดอื่น → แท็บ **คำศัพท์หลายภาษา** → key `categories.<ชื่อหมวด>`
|
|
|
|
---
|
|
|
|
## 4. สิ่งอำนวยความสะดวก
|
|
|
|
1. ติ๊กชิปหัวข้อที่โรงนั้นมีจริง (โซนนั่งรอ, จุดจำหน่ายตั๋ว, ร้านอาหาร, …)
|
|
2. ใต้ชิปมีช่อง **ชื่อหัวข้อ** ของแต่ละหัวข้อ (ช่องเดียว ใช้ทั้ง TH/EN) — ว่าง = ใช้ชื่อเริ่มต้น
|
|
3. **คำอธิบาย (TH/EN)** จะแสดงเฉพาะโรง `house-cinema-samyan` (ข้อมูลครบแล้ว) — โรงอื่นไม่ต้องกรอก และหน้าเว็บจะไม่แสดงบรรทัดคำอธิบาย
|
|
4. ไม่ติ๊กเลย = หน้าเว็บขึ้น **"ไม่มีข้อมูล"**
|
|
|
|
---
|
|
|
|
## 5. การเดินทาง
|
|
|
|
หมวด **การเดินทาง & การติดต่อ** → **การเดินทาง**
|
|
|
|
- แต่ละแถว: วิธีเดินทาง (รถยนต์ส่วนตัว / รถไฟฟ้า / รถประจำทาง) + รายละเอียด TH + EN
|
|
- **+ เพิ่มวิธีเดินทาง** / ถังขยะลบ · แถวที่ยังไม่กรอกจะไม่แสดงบนหน้าเว็บ
|
|
|
|
---
|
|
|
|
## 6. การ์ด "สอบถามข้อมูลและจองตั๋ว" + ช่องทางติดต่อ
|
|
|
|
หมวด **การเดินทาง & การติดต่อ**
|
|
|
|
| อยากแก้ | ช่อง |
|
|
|---|---|
|
|
| หัวข้อการ์ด | "หัวข้อ 'สอบถามข้อมูลและจองตั๋ว' (เฉพาะโรงนี้)" — ว่าง = ใช้ค่ากลาง |
|
|
| Website / Facebook / Call | แถว **ช่องทางติดต่อ** → ป้ายชื่อ / ข้อความที่แสดง / ลิงก์ |
|
|
| เพิ่มช่องทางใหม่ | **+ เพิ่มช่องทางติดต่อ** (ป้ายชื่อมีตัวเลือกแนะนำ) |
|
|
| เบอร์โทรให้กดโทรได้ | ลิงก์ใส่ `tel:+668…` |
|
|
|
|
ค่ากลางของหัวข้อ (มีผลทุกโรงที่ไม่ได้กรอก) → แท็บ **คำศัพท์หลายภาษา** → `detail.contactTitle`
|
|
|
|
---
|
|
|
|
## 7. ที่ตั้งและแผนที่
|
|
|
|
หมวด **ที่ตั้ง & แผนที่**
|
|
|
|
- แผนที่ในหน้า detail เลือกแหล่งตามลำดับ: **Google map URL** → **พิกัด (ละติจูด/ลองจิจูด)** → ถ้าไม่มีทั้งคู่ขึ้น **"ไม่มีข้อมูล"**
|
|
- ใส่พิกัดเป็นทศนิยม (เช่น `13.7466` / `100.5347`) — `0` ถือว่ายังไม่กรอก
|
|
- ที่อยู่ใส่ "บรรทัดละรายการ" (ไม่ใช้ comma เพราะที่อยู่ EN มี comma)
|
|
|
|
---
|
|
|
|
## 8. การชำระเงิน
|
|
|
|
ช่อง **ชำระเงิน** (คั่นด้วย `,`) — ค่าเริ่มต้นของโรงใหม่คือ `เงินสด` และลบได้
|
|
พิมพ์ `,` ได้ตามปกติ (ระบบเก็บข้อความดิบระหว่างพิมพ์แล้วจัดรูปให้ตอนออกจากช่อง)
|
|
|
|
---
|
|
|
|
## 9. หน้า "เกี่ยวกับเรา"
|
|
|
|
แท็บ **หน้าเกี่ยวกับเรา** → เลือกภาษา (TH/EN) → แก้ `title`, `lead`, แต่ละหัวข้อ, หัวข้อ/ข้อความติดต่อ
|
|
มีตัวอย่างหน้าเว็บสด และปุ่ม **คืนค่าตั้งต้น** ต่อภาษา
|
|
|
|
---
|
|
|
|
## 10. หน้า "สำหรับคนทำโรงหนัง" และ "สำหรับคนรักหนัง" (บทความ)
|
|
|
|
สองหน้านี้ใช้ตัวแก้ไขแบบเดียวกัน ต่างกันแค่แท็บ — **สำหรับคนทำโรงหนัง** → `/for-cinemas` · **สำหรับคนรักหนัง** → `/for-film-lovers`
|
|
|
|
ในแท็บ เลือกภาษา (TH/EN) แล้วเขียนบทความแบบบล็อก:
|
|
|
|
- **+ เพิ่มย่อหน้า** — เพิ่มช่องข้อความทีละย่อหน้า (ขึ้นบรรทัดใหม่ได้ตามที่พิมพ์)
|
|
- **+ เพิ่มรูปภาพ** — ใส่ลิงก์รูป (`/images/…` หรือ URL เต็ม) + คำอธิบายรูป (alt จำเป็นต่อการเข้าถึง) + คำบรรยายใต้รูป (ไม่ใส่ก็ได้) พร้อมพรีวิวรูปในฟอร์ม
|
|
- ปุ่ม **↑ ↓** สลับลำดับบล็อก · **ลบ** เอาบล็อกออก
|
|
- แก้ **หัวเรื่อง (H1)**, **คำเกริ่นนำ**, และ **การ์ดติดต่อ** (หัวข้อ + ข้อความ) ได้ในแท็บเดียวกัน
|
|
- ตัวนับด้านบนบอกจำนวนย่อหน้า/รูป · ปุ่ม **คืนค่าตั้งต้น** คืนข้อความเริ่มต้นของภาษานั้น
|
|
- กด **บันทึกหน้าสำหรับคนทำโรงหนัง** / **บันทึกหน้าสำหรับคนรักหนัง** → หน้าเว็บอัปเดตทันที (รูปแสดงตามลำดับที่วางไว้)
|
|
|
|
---
|
|
|
|
## 11. คำศัพท์หลายภาษา / Footer
|
|
|
|
- **คำศัพท์หลายภาษา**: แก้ข้อความทุกจุดในหน้าเว็บด้วย key (เช่น `hero.subtitle`, `detail.contactTitle`) — เว้นว่าง = ใช้ค่าเดิมจาก `messages.ts`
|
|
- **Footer / ไอคอน**: เพิ่ม/แก้ไอคอนโซเชียล (ชื่อไอคอน Tabler เช่น `IconBrandFacebook`)
|
|
|
|
---
|
|
|
|
## 12. สถิติการค้นหา
|
|
|
|
แท็บ **สถิติการค้นหา** — เลือกช่วง 1 / 7 / 30 / 90 วัน: คำคันยอดนิยม, คำค้นที่ไม่พบผล, CTR, ผลลัพธ์เฉลี่ย, หมวดที่ถูกใช้, โรงที่ถูกเปิด/คลิก, การค้นหารายวัน
|
|
|
|
### หมวด "ยอดนิยม" ทำงานอย่างไร
|
|
|
|
- ยัง**ไม่**จัดอันดับจากสถิติจนกว่าข้อมูลจะครบ **6 เดือน (180 วัน)** — ระหว่างนี้ใช้ป้าย "ยอดนิยม" ที่ติ๊กเอง
|
|
- หน้าเว็บจะ**ไม่แสดงข้อความแจ้ง**เรื่องนี้ (ผู้ใช้สั่งลบ) — วันเหลือดูได้จากค่า `computePopularity()` ในเซิร์ฟเวอร์/บันทึกระบบเท่านั้น
|
|
- เมื่อครบ 6 เดือน ระบบสลับไปจัดอันดับเอง: `cinema_view` = 1, `cinema_select` = 1.5, ลดน้ำหนักครึ่งชีวิต 30 วัน, นับเฉพาะ 90 วันล่าสุด, เอา top 8
|
|
|
|
---
|
|
|
|
## 13. ข้อควรระวัง
|
|
|
|
- **กด "บันทึกทั้งหมด" ทุกครั้ง** — การแก้ในฟอร์มยังไม่ถูกบันทึกจนกว่าจะกดปุ่ม
|
|
- ช่องที่กรอกคั่นด้วย `,` (หมวด/ชำระเงิน) จะถูกจัดรูปให้เป็น `, ` ตอนออกจากช่อง
|
|
- อย่าแก้ `data/content/content.json` ด้วยมือระหว่างเซิร์ฟเวอร์รัน — ใช้หลังบ้านหรือ API
|
|
- ถ้าต้องแก้จำนวนมาก ให้ใช้ "แก้ไขดิบเป็น JSON" (ท้ายฟอร์ม) หรือ "วาง JSON เพื่อเพิ่มโรงหนัง"
|