Files
web-alterflixhub/docs/admin-guide.md
T
Bkk1234 42572020d8 fix(contacts): ช่องทางติดต่อกดใช้ได้จริง (tel:/mailto:/โซเชียล) + ซ่อมข้อมูลเดิม
ปัญหา: href ในข้อมูลดิบไม่สม่ำเสมอ (ว่าง / www. ไม่มี scheme / เบอร์ไม่มี tel: /
facebook ติด fbclid) ทำให้กดแล้วไม่เกิดอะไร และปุ่มโทรใช้ไม่ได้

- app/lib/contact-link.ts: resolveContact() จับคู่ลิงก์ตามชนิด
  · เบอร์ → tel:+66… (แปลง 0 นำหน้า, ตัดขีด/ช่องว่าง/วงเล็บ)
  · อีเมล → mailto: · LINE @id → line.me · เว็บ → https + ตัด fbclid/_rdc/utm_*
- ContactPanel: ไอคอนตามชนิด (phone/mail/fb/ig/line/ticket/globe),
  tel/mailto เปิดแท็บเดิม, เว็บเปิดแท็บใหม่; แถวที่ไม่มีลิงก์แสดงเป็นข้อความ (ไม่หลอกให้กด)
- sanitizeCinemas: คำนวณ href ใหม่ทุกครั้งที่บันทึก → ข้อมูลเก่าไม่กลับมาเพี้ยน
- ContactsEditor: auto-format ตอนออกจากช่อง + พรีวิว "✓ กดโทรได้ → tel:+66…"
- scripts/audit-contacts.mjs [--fix]: ตรวจ/ซ่อมทั้งไฟล์ (แก้ไป 13 จุด, สำรองข้อมูลแล้ว)
- contact-link.spec.ts 13 tests · docs: admin-guide/api/DESIGN
2026-11-15 23:56:46 +07:00

184 lines
19 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:` เอง — ใส่เบอร์ในช่อง **ข้อความที่แสดง** ระบบเติมลิงก์ให้ |
**ระบบสร้างลิงก์ให้อัตโนมัติ** (เห็นข้อความ `✓ กดโทรได้ → tel:+66…` ใต้แถวนั้น)
| กรอก | ได้ลิงก์ |
|---|---|
| `098-869-0997` หรือ `0 9886 90997` | `tel:+66988690997` (แปลง 0 → +66 ให้) |
| `[email protected]` | `mailto:[email protected]` |
| `www.housesamyan.com` / `lidoconnect.com` | `https://…` (เปิดแท็บใหม่) |
| `https://web.facebook.com/x/?_rdc=1&_rdr` | `https://www.facebook.com/x/` (ตัด `fbclid`, `_rdc`, `utm_*` ให้) |
| `@lineid` | `https://line.me/R/ti/p/~lineid` |
- ถ้าขึ้น **⚠ ค่านี้ยังใช้เป็นลิงก์ไม่ได้** = ข้อความนั้นไม่ใช่เบอร์/อีเมล/โดเมน → แก้ค่าให้เป็นอย่างใดอย่างหนึ่ง
- แถวที่ไม่มีลิงก์จะแสดงเป็น **ข้อความธรรมดา** (ไม่หลอกให้กด)
- ตรวจ/ซ่อมทั้งไฟล์พร้อมกัน: `node scripts/audit-contacts.mjs` (ดู) · `node scripts/audit-contacts.mjs --fix` (เขียนกลับ + สำรองไฟล์)
ค่ากลางของหัวข้อ (มีผลทุกโรงที่ไม่ได้กรอก) → แท็บ **คำศัพท์หลายภาษา** → `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 เพื่อเพิ่มโรงหนัง"