Files
web-alterflixhub/README.md
T
Bkk1234 ba51bdfb02 feat(docker): Dockerfile + docker-compose (พอร์ตมาจาก env PORT/HOST_PORT)
- Dockerfile 3 stage: deps (pnpm + build tools สำหรับ node-pty) → build (agent-native build) → runtime (node:22-bookworm-slim, user node, HEALTHCHECK ตาม PORT)
- docker-compose.yml: PORT = พอร์ตในคอนเทนเนอร์, HOST_PORT = พอร์ตที่แมปออก host (8080 บนเครื่องนี้ถูกยึด จึงตั้งต้นที่ 8095), TZ, mount ./data เก็บ content/uploads/analytics/pglite
- .dockerignore ตัด node_modules/.output/data/.env ออกจาก build context
- README: section "รันด้วย Docker" + ตาราง env; .env.example: PORT/HOST_PORT
2026-11-21 20:59:44 +07:00

17 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 หน้า
/ หน้าแรก — ฮีโร่ค้นหา, แถบหมวด, กริดการ์ดโรงหนัง (ลำดับการ์ด สลับเองทุกวัน ไม่ให้ซ้ำตำแหน่งเดิม 2 วันติดกัน) · รองรับลิงก์ค้นหาตรง /?q=<คำค้น>
/cinema/<slug> รายละเอียดโรง — แกลเลอรี (กดลูกศรเลื่อนได้), สรุป, การเดินทาง, สิ่งอำนวยความสะดวก, ที่ตั้ง (แผนที่), ติดต่อ/ชำระเงิน, ปุ่มแชร์
/c/<slug> ลิงก์ย่อสำหรับแชร์ → 302 ไป /cinema/<slug>
/for-film-lovers บทความ "สำหรับคนรักหนัง" (แก้จากหลังบ้าน)
/for-cinemas บทความ "สำหรับคนทำโรงหนัง" (แก้จากหลังบ้าน)
/about เกี่ยวกับเรา (แก้จากหลังบ้าน)
/admin · /admin/login หลังบ้าน 7 แท็บ — ดู 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 <textarea> · ลิงก์ย่อ /c/<slug> บนโดเมนจริงของ request · บอกผลด้วย aria-live
  • PWA — manifest + service worker (navigate network-first, asset cache-first) + /offline.html · ติดตั้งลงจอโฮมได้
  • แอนิเมชันเบา — reveal ตอนเลื่อน/โหลด ใช้เฉพาะ transform/opacity · ตัวอนิเมชันผูกกับ media query prefers-reduced-motion (ไม่ผูกคลาสที่ hydration ลบได้) · ผู้ใช้ที่ขอ reduced motion เห็นเนื้อหานิ่งครบทันที
  • หน้าตาเท่ากันทุกเอนจิน — Chromium / Firefox / Safari: สกรอลบาร์ (::-webkit-scrollbar + scrollbar-width), color-scheme: dark, ::selection, ฟอร์ม ≥16px บนมือถือ (iOS ไม่ซูมเอง), tap-highlight · ข้อยกเว้นที่ตั้งใจปล่อยไว้ (สกรอลบาร์ hover, ปุ่ม X ของ FF, install prompt, ฟอนต์ไทย) จดไว้ใน DESIGN.md หัวข้อ "Cross-engine parity"
  • SEO + กัน AI — canonical/OG/Twitter/JSON-LD (WebSite, Organization, BreadcrumbList, MovieTheater, Article), sitemap.xml จากข้อมูลจริง, robots.txt บล็อก AI crawler 21 ตัว, ai.txt
  • สถิติ — event search / cinema_select / cinema_view / near_me · หมวด "ยอดนิยม" เริ่มจัดอันดับจริงเมื่อข้อมูลครบ 6 เดือน

หลังบ้าน

http://localhost:8080/admin — ล็อกอินด้วย ADMIN_USERNAME / ADMIN_PASSWORD (ค่าเริ่มต้น it is me / it is me&it is me)

7 แท็บ: โรงหนัง (ชื่อ/slug/หมวด/สิ่งอำนวยความสะดวก/การเดินทาง/ติดต่อ/รูปภาพ — อัปโหลดจากเครื่อง/ลากวาง/วาง URL/ที่ตั้ง/คำอธิบาย) · หน้าเกี่ยวกับเรา · สำหรับคนรักหนัง · สำหรับคนทำโรงหนัง · คำศัพท์หลายภาษา · Footer-ไอคอน · สถิติการค้นหา

คู่มือทีละงาน: docs/admin-guide.md

โครงสร้าง

app/
  routes/          _index · cinema.$slug · c.$slug · about · for-film-lovers · for-cinemas · admin · admin_.login
  components/
    site/          SiteShell · SiteHeader/Footer · NavLink · Logo · CinemaCard · CinemaGrid · Reveal · ShareButton · ArticlePage
    cinema/        Gallery · CinemaSummary · TransportList · FacilitiesSection · LocationPanel · ContactPanel
    admin/         AdminSection · CinemaList · ChipPicker · CommaListInput · SlugInput · PhotosEditor · TransportEditor ·
                   ContactsEditor · CinemaFacilitiesEditor · AboutEditor · ArticleEditor · ArticleBlockCard · form-styles
  hooks/           use-reveal · use-near-me · use-navigation-state
  lib/             cinemas (ค้นหา/กรอง) · search · gallery · article · content.* · map-embed · geo · daily-order
                   motion · pwa · share · share-origin · seo · site · sitemap · request-origin · page-origin
                   analytics.* · popularity.server · i18n/ · design-tokens
server/
  routes/          [...page].get.ts (SSR) · robots.txt.ts · sitemap.xml.ts
  routes/api/      admin/* (login, session, content, import, analytics) · analytics/collect
public/            manifest.json · sw.js · offline.html · ai.txt · og/ · icon-*.png
data/
  content/content.json    แหล่งข้อมูลจริงของโรงหนัง/คำศัพท์/บทความ (แก้ผ่านหลังบ้าน)
  analytics/events.jsonl  สถิติแบบ append-only
docs/
  admin-guide.md   คู่มือใช้งานหลังบ้าน (ภาษาไทย)
  api.md           API reference
  architecture.html แผนผังการทำงาน Frontend/Backend/Data (เปิดด้วยเบราว์เซอร์)
  push-to-gitea.md วิธี push ขึ้น Gitea
DESIGN.md          สัญญาการออกแบบ (บังคับ) — สี ฟอนต์ โลโก้ layout motion SEO กติกาข้อมูล
AGENTS.md          กฎสำหรับ agent/AI ที่แก้โค้ดโปรเจกต์นี้

โดเมนและ env

ระบบไม่ฝังโดเมนในโค้ด — canonical/OG/JSON-LD/sitemap/robots/ลิงก์แชร์ มาจาก origin ของ request (app/lib/request-origin.ts รองรับ x-forwarded-host / x-forwarded-proto ของ reverse proxy)

env จำเป็น ใช้ทำอะไร
ADMIN_USERNAME · ADMIN_PASSWORD · ADMIN_SESSION_SECRET แนะนำ บัญชีหลังบ้าน + กุญแจเซ็น cookie
ANALYTICS_SALT แนะนำ เกลือ hash ผู้เข้าชม (กันคาดเดา)
SITE_URL / SHARE_ORIGIN ไม่ต้อง บังคับโดเมนเฉพาะกรณี (ปกติปล่อยว่าง)

รันด้วย Docker

cp .env.example .env      # ครั้งแรกเท่านั้น
docker compose up -d --build
# → http://localhost:8095   (แก้พอร์ตด้วย HOST_PORT)
docker compose logs -f    # ดู log
docker compose down       # หยุด
env ค่าตั้งต้น หน้าที่
HOST_PORT 8095 พอร์ตที่แมปออกเครื่อง host
PORT 8080 พอร์ตที่ Nitro ฟังในคอนเทนเนอร์ (process.env.PORT)
TZ — โซนเวลาในคอนเทนเนอร์ (ส่งผ่าน env_file: .env)

ทั้งสองตัวอยู่ใน .env หรือสั่งตรงหน้า command ก็ได้: PORT=9001 HOST_PORT=9001 docker compose up -d

  • ไฟล์: Dockerfile (3 stage: deps → build → runtime, node:22-bookworm-slim, รันด้วย user node) · docker-compose.yml · .dockerignore
  • ข้อมูลไม่หาย: ./data ถูก mount เป็น volume → content/content.json, uploads/, analytics/, pglite/ ยังอยู่หลัง docker compose down (ลบ volume = docker compose down -v เท่านั้นถึงจะหาย)
  • แก้เนื้อหาด้วยหลังบ้านแล้วไม่ต้อง rebuild — data/ เป็น mount ไม่ได้อบใน image · แต่ถ้าแก้ โค้ด ต้อง docker compose up -d --build
  • ถ้าพอร์ต 8080 บน host ถูกยึดอยู่แล้ว ให้ตั้ง HOST_PORT อื่น (ค่าตั้งต้น 8095)
  • log ที่ขึ้น DEPLOY_SETTINGS_REQUIRED / [automations] queued-run sweep failed มาจากตัวจับเวลา automation/trigger ของ agent-native ที่ต้องใช้ hosted Postgres — ไม่กระทบหน้าเว็บ (ตั้ง DATABASE_URL ถ้าจะใช้จริง)

Static export (โฮสต์แบบไฟล์นิ่ง / มี index.html)

แอปนี้เป็น SSR + หลังบ้านเขียนไฟล์ได้ → ค่าปกติรันเป็น Node server (node .output/server/index.mjs) ถ้าต้องการ ไฟล์นิ่งที่มี index.html ใช้สคริปต์ export (ดึง HTML ทุกหน้าจากตัว server ที่รันอยู่):

สำคัญ: app/root.tsx ไม่ใช้ AppProviders ของ agent-native แล้ว (ถอด session/navigation/application-state ออก) เพราะ provider นั้นรอ /_agent-native/auth/session + /status ซึ่งตอบ 401/404 บน production build และบน static host ทำให้ทั้ง prod build และ static export ค้างที่ skeleton + ขึ้น "Configuration error" · ห้ามใส่กลับ ถ้าไม่ได้ตั้ง auth+DB จริง

pnpm build                              # ได้ .output (preset node)
PORT=8090 node .output/server/index.mjs  # เปิด server ตัวจริง
pnpm export:static http://127.0.0.1:8090 static-export
python -m http.server 8091 --directory static-export   # ทดสอบแบบ static

ผลลัพธ์: static-export/index.html, about/index.html, cinema/<slug>/index.html (ทุกโรงที่ไม่ hidden), c/<slug>/index.html (redirect), sitemap.xml, robots.txt, assets/, images/, 404.html

ข้อจำกัดที่ตั้งใจ (static ไม่มี backend)

  • ไม่มี /admin และ /api/* — ต้องใช้ Node server ถ้าจะแก้เนื้อห ผมเพิ่ม/แก้ผ่านหลังบ้าน
  • ไม่มี ?_data= ของ React Router → สคริปต์ inject ตัวดักคลิก (data-static-export-nav) ให้ทุก link เป็นการโหลดหน้าเต็ม (ทุกหน้ามี HTML ของตัวเอง) — คลิก/ย้อนกลับ/รีเฟรชทำงานปกติ แต่ไม่มีการเปลี่ยนหน้าแบบ SPA
  • ลิงก์แชร์ /c/<slug> กลายเป็นหน้า meta refresh + JS redirect (ไม่ใช่ 302 ของ server)
  • canonical/OG ถูกอบตอน export — ตั้ง SITE_URL ตอนรัน server ก่อน export ถ้าต้องการโดเมนจริงใน meta

เอกสารอื่น

  • DESIGN.md — สัญญาการออกแบบ: พาเลตต์ ฟอนต์ โลโก้ layout motion PWA SEO และกติกากันข้อมูลหาย
  • docs/api.md — endpoint ทั้งหมด (method/path/auth/body)
  • docs/architecture.html — แผนผังการทำงาน
  • docs/push-to-gitea.md — วิธี push ขึ้น Gitea
  • DEVELOPING.md — คู่มือ framework ของ starter (ไม่ใช่ของเฉพาะโปรเจกต์นี้)