- 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
17 KiB
คู่มือใช้งานหลังบ้าน 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. รูปภาพโรงหนัง
หมวด การเดินทาง & การติดต่อ → ส่วน รูปภาพโรงหนัง → อัปโหลดรูปจากเครื่อง
- กด อัปโหลดรูปจากเครื่อง แล้วเลือกไฟล์ (เลือกหลายไฟล์พร้อมกันได้) — หรือ ลากไฟล์มาวาง ในกล่องนั้น หรือ Ctrl+V วางรูปจากคลิปบอร์ด
- รองรับ JPG / PNG / WebP / AVIF ขนาดไม่เกิน 8 MB ต่อไฟล์ · ไฟล์จะถูกเก็บที่
data/uploads/cinemas/และได้ URL รูปแบบ/uploads/cinemas/<ไฟล์>ใช้อ้างในหน้าเว็บได้ทันที - ถ้าอยากใช้รูปที่วางบนเว็บอยู่แล้ว กด เพิ่มช่อง URL แล้ววางลิงก์ (
/images/…หรือ URL เต็ม) — ไม่แนะนำลิงก์จาก Google Maps/Facebook เพราะลิงก์หมดอายุและทำให้รูปแตก - รูปแรก = รูปปกการ์ดหน้าแรก และภาพหลักในแกลเลอรีหน้า detail — สลับลำดับด้วยปุ่ม ↑/↓
- มีไม่ครบ 3 รูป ช่องที่เหลือจะแสดงโลโก้ AlterFlixHub แทน
- อย่าลืมกด บันทึก ท้ายฟอร์ม — รูปจะขึ้นหน้าเว็บทันทีหลังบันทึก
ไฟล์ในเครื่อง (สำหรับรูปที่เตรียมไว้ล่วงหน้า): วางที่ public/images/… แล้วใส่ /images/… · รูปที่อัปโหลดผ่านหลังบ้านจะอยู่ที่ data/uploads/cinemas/ (สำรองข้อมูลแยกจาก repo)
3. หมวดหมู่ (categories)
หมวด หมวดหมู่ & สิ่งอำนวยความสะดวก → กดชิปที่ต้องการ (เลือกได้หลายอัน) หรือพิมพ์เองในช่องใต้ชิป (คั่นด้วย ,)
หมวดที่ใช้ได้ตอนนี้: ยอดนิยม · อาร์ตเฮาส์ · สารคดี · หนังสั้น · หนังคลาสสิก · หนังนานาชาติ · หนังนอกกระแส · หนังในกระแส · หนังฝรั่งเศส · กลุ่มคนฉายหนัง · หนังไทย
- แถบกรองหน้าแรกสร้างจากรายการเดียวกับชิปนี้
- อยากได้คำแปลหมวดอื่น → แท็บ คำศัพท์หลายภาษา → key
categories.<ชื่อหมวด>
4. สิ่งอำนวยความสะดวก
- ติ๊กชิปหัวข้อที่โรงนั้นมีจริง (โซนนั่งรอ, จุดจำหน่ายตั๋ว, ร้านอาหาร, …)
- ใต้ชิปมีช่อง ชื่อหัวข้อ ของแต่ละหัวข้อ (ช่องเดียว ใช้ทั้ง TH/EN) — ว่าง = ใช้ชื่อเริ่มต้น
- คำอธิบาย (TH/EN) จะแสดงเฉพาะโรง
house-cinema-samyan(ข้อมูลครบแล้ว) — โรงอื่นไม่ต้องกรอก และหน้าเว็บจะไม่แสดงบรรทัดคำอธิบาย - ไม่ติ๊กเลย = หน้าเว็บขึ้น "ไม่มีข้อมูล"
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 เพื่อเพิ่มโรงหนัง"