Files
web-alterflixhub/docs/admin-guide.md
T
2026-11-01 17:24:44 +07:00

153 lines
14 KiB
Markdown

# คู่มือใช้งานหลังบ้าน 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 เพื่อเพิ่มโรงหนัง"