# 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 | หน้า | |---|---| | `/` | หน้าแรก — ฮีโร่ค้นหา, แถบหมวด, กริดการ์ดโรงหนัง (รูปปกจาก `photos[0]` · **ลำดับการ์ดสลับเองทุกวัน** ไม่ให้ซ้ำตำแหน่งเดิม 2 วันติดกัน) | | `/cinema/` | รายละเอียดโรง — แกลเลอรี, สรุป, การเดินทาง, สิ่งอำนวยความสะดวก, ที่ตั้ง (แผนที่), ติดต่อ/ชำระเงิน | | `/about` | เกี่ยวกับเรา (เนื้อหาจากหลังบ้าน) | | `/admin` | หลังบ้าน (5 แท็บ) — ดู [docs/admin-guide.md](docs/admin-guide.md) | รองรับ **ไทย/อังกฤษ** สลับที่ header หรือ `?lang=en` (จำค่าไว้ใน cookie + localStorage) ## หลังบ้าน `http://localhost:8080/admin` — ล็อกอินด้วย `ADMIN_USERNAME` / `ADMIN_PASSWORD` (ค่าเริ่มต้น `it is me` / `it is me&it is me`) แก้ได้: โรงหนัง (ชื่อ/slug/หมวด/สิ่งอำนวยความสะดวก/การเดินทาง/ติดต่อ/รูปภาพ/ที่ตั้ง/คำอธิบาย) · หน้าเกี่ยวกับเรา · คำศัพท์ทุกคำในหน้าเว็บ · Footer · ดูสถิติการค้นหา คู่มือทีละงาน: **[docs/admin-guide.md](docs/admin-guide.md)** ## โครงสร้าง ``` app/ routes/ _index (หน้าแรก) · cinema.$slug · about · admin / admin_.login components/ site/ SiteShell · SiteHeader/Footer · Logo · CinemaCard · CinemaGrid cinema/ Gallery · CinemaSummary · TransportList · FacilitiesSection · LocationPanel · ContactPanel admin/ AdminSection · CinemaList · ChipPicker · CommaListInput · SlugInput · PhotosEditor · TransportEditor · ContactsEditor · CinemaFacilitiesEditor · AboutEditor lib/ cinemas · content.server · map-embed · popularity.server · analytics.* · i18n/ · geo server/ routes/api/ admin/* (login, content, import, analytics) · analytics/collect data/ content/content.json แหล่งข้อมูลจริงของโรงหนัง/คำศัพท์/about (แก้ผ่านหลังบ้าน) analytics/events.jsonl สถิติแบบ append-only docs/ admin-guide.md คู่มือใช้งานหลังบ้าน (ภาษาไทย) api.md API reference architecture.html แผนผังการทำงาน Frontend/Backend/Data (เปิดด้วยเบราว์เซอร์) DESIGN.md สัญญาการออกแบบ (บังคับ) — สี ฟอนต์ โลโก้ layout กติกาข้อมูล AGENTS.md กฎสำหรับ agent/AI ที่แก้โค้ดโปรเจกต์นี้ ``` ## ข้อมูลและสถิติ - โรงหนัง/คำศัพท์/หน้าเกี่ยวกับเรา เก็บที่ `data/content/content.json` (หลังบ้านเขียนแบบ atomic) - สถิติเก็บที่ `data/analytics/events.jsonl` — event: `search`, `cinema_select`, `cinema_view`, `near_me`; ไม่ใช้คุกกี้ ไม่เก็บ IP/UA ดิบ - หมวด "ยอดนิยม" จะเริ่มจัดอันดับจากสถิติจริงเมื่อข้อมูลครบ **6 เดือน** ก่อนหน้านั้นใช้ป้ายที่ตั้งมือ - ตั้ง `ANALYTICS_SALT` ใน `.env` ก่อน deploy จริง ## เอกสารอื่น - [DESIGN.md](DESIGN.md) — สัญญาการออกแบบ: พาเลตต์ ฟอนต์ โลโก้ layout ฟิลด์ข้อมูล และกติกากันข้อมูลหาย - [docs/api.md](docs/api.md) — endpoint ทั้งหมด (method/path/auth/body) - [docs/architecture.html](docs/architecture.html) — แผนผังการทำงาน - [DEVELOPING.md](DEVELOPING.md) — คู่มือ framework ของ starter (ไม่ใช่ของเฉพาะโปรเจกต์นี้)