# คู่มือใช้งานหลังบ้าน AlterFlixHub คู่มือนี้ตอบคำถาม "แก้ตรงไหน" ทีละงาน — ทุกอย่างอยู่ใน `http://localhost:8080/admin` (ล็อกอินด้วย `ADMIN_USERNAME` / `ADMIN_PASSWORD` ใน `.env`; ค่าเริ่มต้นคือ `it is me` / `it is me&it is me`) หน้าหลังบ้านมี 5 แท็บ: **โรงหนัง · หน้าเกี่ยวกับเรา · คำศัพท์หลายภาษา · 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. ใส่ URL (`https://…`) หรือ path ในโปรเจกต์ (`/images/ชื่อไฟล์.jpg`) 2. **รูปแรก = รูปปกการ์ดหน้าแรก** และภาพหลักในแกลเลอรีหน้า detail 3. มีไม่ครบ 3 รูป ช่องที่เหลือจะแสดงโลโก้ AlterFlixHub แทน 4. สลับลำดับด้วย ↑ ↓ · ลบด้วยถังขยะ · แล้วกด **บันทึกทั้งหมด** ไฟล์ในเครื่อง: วางที่ `public/images/…` แล้วใส่ `/images/…` --- ## 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. คำศัพท์หลายภาษา / Footer - **คำศัพท์หลายภาษา**: แก้ข้อความทุกจุดในหน้าเว็บด้วย key (เช่น `hero.subtitle`, `detail.contactTitle`) — เว้นว่าง = ใช้ค่าเดิมจาก `messages.ts` - **Footer / ไอคอน**: เพิ่ม/แก้ไอคอนโซเชียล (ชื่อไอคอน Tabler เช่น `IconBrandFacebook`) --- ## 11. สถิติการค้นหา แท็บ **สถิติการค้นหา** — เลือกช่วง 1 / 7 / 30 / 90 วัน: คำคันยอดนิยม, คำค้นที่ไม่พบผล, CTR, ผลลัพธ์เฉลี่ย, หมวดที่ถูกใช้, โรงที่ถูกเปิด/คลิก, การค้นหารายวัน ### หมวด "ยอดนิยม" ทำงานอย่างไร - ยัง**ไม่**จัดอันดับจากสถิติจนกว่าข้อมูลจะครบ **6 เดือน (180 วัน)** — ระหว่างนี้ใช้ป้าย "ยอดนิยม" ที่ติ๊กเอง - หน้าเว็บจะ**ไม่แสดงข้อความแจ้ง**เรื่องนี้ (ผู้ใช้สั่งลบ) — วันเหลือดูได้จากค่า `computePopularity()` ในเซิร์ฟเวอร์/บันทึกระบบเท่านั้น - เมื่อครบ 6 เดือน ระบบสลับไปจัดอันดับเอง: `cinema_view` = 1, `cinema_select` = 1.5, ลดน้ำหนักครึ่งชีวิต 30 วัน, นับเฉพาะ 90 วันล่าสุด, เอา top 8 --- ## 12. ข้อควรระวัง - **กด "บันทึกทั้งหมด" ทุกครั้ง** — การแก้ในฟอร์มยังไม่ถูกบันทึกจนกว่าจะกดปุ่ม - ช่องที่กรอกคั่นด้วย `,` (หมวด/ชำระเงิน) จะถูกจัดรูปให้เป็น `, ` ตอนออกจากช่อง - อย่าแก้ `data/content/content.json` ด้วยมือระหว่างเซิร์ฟเวอร์รัน — ใช้หลังบ้านหรือ API - ถ้าต้องแก้จำนวนมาก ให้ใช้ "แก้ไขดิบเป็น JSON" (ท้ายฟอร์ม) หรือ "วาง JSON เพื่อเพิ่มโรงหนัง"