# AlterFlixHub ไดเรกทอรีโรงหนังอิสระ/อาร์ตเฮาส์และกลุ่มคนฉายหนังในประเทศไทย — ค้นหาโรงตามชื่อ/สถานที่/หมวดหมู่ ดูรายละเอียดการเดินทาง ที่ตั้ง และช่องทางติดต่อของแต่ละโรง พร้อมหลังบ้านที่แก้เนื้อหาเองได้โดยไม่ต้องแตะโค้ด Stack: **React Router 8 (SSR) + Vite 8 + Tailwind 4 + TypeScript** บน Agent-Native runtime (Node/h3) · ข้อมูลเก็บเป็นไฟล์ JSON ใน `data/` · สถิติแบบ privacy-first (ไม่มีคุกกี้ ไม่เก็บ IP) ## เริ่มใช้งาน ```bash cp .env.example .env # ครั้งแรกเท่านั้น pnpm install pnpm dev # http://localhost:8080 ``` | คำสั่ง | ทำอะไร | | --------------------------- | ------------------------------------ | | `pnpm typecheck` | ตรวจ TypeScript ทั้งโปรเจกต์ | | `pnpm test` | รันสเปกทั้งหมด (vitest) | | `pnpm build` / `pnpm start` | build / รันโปรดักชัน | | `pnpm agent-native:doctor` | ตรวจสุขภาพโปรเจกต์ตามกฎของ framework | ## หน้าเว็บ | Route | หน้า | | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `/` | หน้าแรก — ฮีโร่ค้นหา, แถบหมวด, กริดการ์ดโรงหนัง (ลำดับการ์ด **สลับเองทุกวัน** ไม่ให้ซ้ำตำแหน่งเดิม 2 วันติดกัน) · รองรับลิงก์ค้นหาตรง `/?q=<คำค้น>` | | `/cinema/` | รายละเอียดโรง — แกลเลอรี (กดลูกศรเลื่อนได้), สรุป, การเดินทาง, สิ่งอำนวยความสะดวก, ที่ตั้ง (แผนที่), ติดต่อ/ชำระเงิน, ปุ่มแชร์ | | `/c/` | ลิงก์ย่อสำหรับแชร์ → **302** ไป `/cinema/` | | `/for-film-lovers` | บทความ "สำหรับคนรักหนัง" (แก้จากหลังบ้าน) | | `/for-cinemas` | บทความ "สำหรับคนทำโรงหนัง" (แก้จากหลังบ้าน) | | `/about` | เกี่ยวกับเรา (แก้จากหลังบ้าน) | | `/admin` · `/admin/login` | หลังบ้าน 7 แท็บ — ดู [docs/admin-guide.md](docs/admin-guide.md) · `noindex` | | `/sitemap.xml` · `/robots.txt` · `/ai.txt` | ไฟล์สำหรับ crawler (sitemap/robots สร้างสดตามโดเมนของ request) | รองรับ **ไทย/อังกฤษ** สลับที่ header (ปุ่มเดียว + dropdown) หรือ `?lang=en` (จำค่าใน cookie + localStorage) ## คุณสมบัติหลัก - **กรองสองชั้น** — ประเภทโรงหนัง (ท้องถิ่น / อินดี้ / กลุ่มคนฉายหนัง) แล้วต่อด้วยหมวดภาพยนตร์ - **ค้นหา** — AND หลายคำ เรียงสลับได้ · ค้นทุกอย่างที่เห็นบนการ์ด (`name`, `name_th`, สถานที่, ที่อยู่, การเดินทาง, หมวด/แท็ก, คำอธิบาย) · ตัดวรรณยุกต์/สระบน-ล่าง และ normalize ตัวคั่น → พิมพ์ไม่ครบหรือไม่มีวรรณยุกต์ก็เจอ · เรียงผลตามความตรงของชื่อ - **หาโรงใกล้ฉัน** — `navigator.geolocation` + ระยะเส้นตรง และระยะตามถนน (OSRM) - **แชร์** — `navigator.share` → clipboard → fallback `