2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00
2026-11-01 17:24:44 +07:00

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 (ไม่ใช่ของเฉพาะโปรเจกต์นี้)
S
Description
No description provided
Readme
26 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 88.6%
JavaScript 5.4%
Python 3.2%
CSS 2.3%
HTML 0.4%