6.2 KiB
AlterFlixHub
ไดเรกทอรีโรงหนังอิสระ/อาร์ตเฮาส์และกลุ่มคนฉายหนังในประเทศไทย — ค้นหาโรงตามชื่อ/จังหวัด/หมวดหมู่ ดูรายละเอียดการเดินทาง ที่ตั้ง และช่องทางติดต่อของแต่ละโรง พร้อมหลังบ้านสำหรับแก้ข้อมูลได้เองโดยไม่ต้องแตะโค้ด
Stack: React Router 8 (SSR) + Vite 8 + Tailwind 4 + TypeScript บน Agent-Native runtime (Node/h3) · ข้อมูลเก็บเป็นไฟล์ JSON ใน data/ · สถิติแบบ privacy-first (ไม่มีคุกกี้ ไม่เก็บ IP)
เริ่มใช้งาน
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/<slug> |
รายละเอียดโรง — แกลเลอรี, สรุป, การเดินทาง, สิ่งอำนวยความสะดวก, ที่ตั้ง (แผนที่), ติดต่อ/ชำระเงิน |
/about |
เกี่ยวกับเรา (เนื้อหาจากหลังบ้าน) |
/admin |
หลังบ้าน (5 แท็บ) — ดู 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
โครงสร้าง
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 — สัญญาการออกแบบ: พาเลตต์ ฟอนต์ โลโก้ layout ฟิลด์ข้อมูล และกติกากันข้อมูลหาย
- docs/api.md — endpoint ทั้งหมด (method/path/auth/body)
- docs/architecture.html — แผนผังการทำงาน
- DEVELOPING.md — คู่มือ framework ของ starter (ไม่ใช่ของเฉพาะโปรเจกต์นี้)