AlterFlixHub — แผนผังการทำงาน

เว็บรวมโรงหนังอิสระและอาร์ตเฮาส์ · React Router 8 (SSR) ฝั่งหน้าเว็บ + Node/h3 (agent-native) ฝั่งหลังบ้าน · ข้อมูลโรงหนังเก็บเป็นไฟล์ JSON ใน data/ และสถิติแบบ append-only

Frontend (browser) Backend (server) Data (ดิสก์/SQL) บริการภายนอก

Frontend — เบราว์เซอร์

User / เบราว์เซอร์ เปิดหน้าแรก · ค้นหา/กรอง · กด “ใกล้ฉัน” · สลับภาษา TH/EN
Routes — app/routes/
/ HeroSection + CinemaGrid
/cinema/:slug Gallery, Summary, Transport, Location
/about เนื้อหาจาก data/content
/for-cinemas บทความ 블록 (ย่อหน้า/รูป) จาก data/content · ธีมเดียวกับ /about
/for-film-lovers บทความแบบบล็อก · ใช้ ArticlePage ร่วมกับ /for-cinemas
/c/:slug ลิงก์ย่อสำหรับแชร์ → 302 redirect ไป /cinema/:slug
/sitemap.xml · /robots.txt · /ai.txt ไฟล์สำหรับ crawler — sitemap สร้างจากข้อมูลจริง (Nitro route), robots/ai เป็น static ใน public/
/admin login + แดชบอร์ด 7 แท็บ
SiteShell + SiteHeader / SiteFooter กรอบหน้า: BackdropFrame (glow) · Logo (Jersey 15) · nav คนรักหนัง/โรงหนัง/เกี่ยวกับเรา · ปุ่มภาษา (dropdown) (มือถือ: ยุบในเมนู)
Providers — app/root.tsx
ContentProvider useContent() → cinemas / about / forCinemas / forFilmLovers / terms / footer
LocaleProvider ?lang → localStorage → cookie → ไทย
NearMeProvider Geolocation API → ระยะทางต่อ slug
AppProviders / DbSync query client + useDbSync (real-time)
Client libs — app/lib/
cinemas.ts filterCinemas · findCinemaBySlug · formatDistance
geo.ts ระยะเส้นตรง + เรียก OSRM ตามถนน
analytics-client.ts trackEvent() · debounce 900 ms · กัน event ซ้ำ
i18n/messages.ts ข้อความ TH/EN ทุกคำใน UI
map-embed.ts URL แผนที่: map_url → พิกัด → null (แสดง "ไม่มีข้อมูล")
seo.ts · site.ts pageMeta (title/canonical/OG/Twitter) + JSON-LD · ข้อมูลระดับเว็บ (ชื่อ/คำอธิบาย/og image)
request-origin.ts · page-origin.ts หา origin จาก request (x-forwarded-host/proto) — ไม่ฝังโดเมนในโค้ด
sitemap.ts · article.ts · share.ts สร้าง sitemap XML · จัดการบล็อกบทความ (ย่อหน้า/รูป) · แชร์ + คัดลอกลิงก์ย่อ
motion.ts · pwa.ts เปิดใช้แอนิเมชันก่อน paint (เคารพ reduced-motion) · ลงทะเบียน service worker
หลังบ้าน /admin AdminSection (หมวดพับ) · CinemaList (ก-ฮ + ลากสลับ) · SlugInput · ChipPicker · CommaListInput · PhotosEditor · TransportEditor · ContactsEditor · CinemaFacilitiesEditor · ArticleEditor (บทความแบบบล็อก)
HTTP
/ JSON

Backend — Node / h3 (agent-native)

root loader — readContent() ทำงานตอน SSR ทุกคำขอ: อ่าน store → ส่งเข้า ContentProvider พร้อม HTML แรก (cache ตาม mtime ของไฟล์)
API routes — server/routes/api/
admin/login · logout · session cookie HttpOnly เซ็น HMAC · 8 ชม. · env ADMIN_*
admin/content GET/PUT อ่าน/บันทึก cinemas · terms · footer · about · forCinemas · forFilmLovers
admin/cinemas/import วาง JSON ทับตาม slug
admin/analytics สรุปสถิติ 1/7/30/90 วัน
analytics/collect (สาธารณะ) รับ event · ไม่ใช้คุกกี้ · ไม่เก็บ IP/UA ดิบ
middleware/auth.ts runAuthGuard() คุมทุก path /admin
ไฟล์สำหรับ crawler — server/routes/
/robots.txt สร้างสด: เปิด search engine, ปิด /api/ /admin /_agent-native/ /c/, บล็อก AI crawler 21 ตัว · Sitemap: ตามโดเมนของ request
/sitemap.xml สร้างจากข้อมูลจริง (หน้า static + โรงที่ไม่ hidden) · โดเมนจาก request · ไม่ throw ถ้าอ่าน content ไม่ได้
public/ai.txt ประกาศไม่ให้นำเนื้อหาไปฝึกโมเดล AI (static, ไม่มีโดเมนในเนื้อหา)
Server libs
content.server.ts sanitize ทุกฟิลด์ · เขียนแบบ atomic (temp → rename) · seed เฉพาะเมื่อไฟล์ไม่มี (ห้ามทับของจริง)
popularity.server.ts อันดับ "ยอดนิยม" จาก events · ต้องมีประวัติ ≥ 180 วัน · decay ครึ่งชีวิต 30 วัน · top 8 · memo 5 นาที
analytics.server.ts summarize() · หมุนไฟล์ 8 MB · เก็บ 50k event
actions/ navigate · view-screen · provider-api-request (เครื่องมือ agent)
server/db.ts Drizzle + pglite (ยังไม่เปิดใช้ตาราง)
plugins/config.ts homePath / · ปิด integrations / terminal / sentry · email-branding อ่าน app.name
อ่าน/เขียน
ไฟล์

บริการภายนอก

OSRM ระยะทาง/เวลาเดินทางตามถนนจริง (ปุ่ม “ใกล้ฉัน”)
OpenStreetMap พิกัดอ้างอิงของโรงหนัง + แผนที่
Google Fonts Jersey 15 · Noto Sans Thai (Inter + IBM Plex Thai Looped ฝังในโปรเจกต์)
AI SDK providers OpenAI / Anthropic / Google ฯลฯ สำหรับ actions ของ agent

Data layer — data/ (ไฟล์บนดิสก์ + SQL)

แหล่งข้อมูลจริง
data/content/content.json แหล่งเดียวของ cinemas · site.terms · footer · about{th,en} · forCinemas{th,en} · forFilmLovers{th,en} (blocks) — หน้าเว็บอ่านผ่าน readContent() เท่านั้น
data/analytics/events.jsonl append-only: search / cinema_select / cinema_view / near_me
data/pglite/ SQL ฝังในเครื่อง (Drizzle) — ยังว่าง รอตารางแรก
app/lib/content-seed.ts ค่าเริ่มต้น: CINEMAS + ข้อความ i18n → สร้าง content.json ครั้งแรก

เส้นทางการทำงานหลัก

ทุกเส้นเริ่มจากเบราว์เซอร์ เว้นแต่ระบุไว้เป็นอย่างอื่น — ลำดับเลขคือลำดับที่เกิดจริง

1 · เปิดหน้า (SSR + hydration)

  1. 1GET / หรือ /aboutเบราว์เซอร์ขอเอกสาร
  2. 2root loaderreadContent() อ่าน content.json
  3. 3SSR HTMLส่งเนื้อหาพร้อมหน้าแรก
  4. 4HydrateContentProvider + LocaleProvider
  5. 5Client navLink เปลี่ยนหน้าโดยไม่โหลดใหม่

2 · ค้นหา / กรอง / ใกล้ฉัน

  1. 1พิมพ์ค้นหาfilterCinemas() ในหน่วยความจำ
  2. 2กด “ใกล้ฉัน”Geolocation API (ขอเมื่อกดเท่านั้น)
  3. 3เรียก OSRMระยะทางตามถนน · ล้มเหลวใช้เส้นตรง
  4. 4เรียงผลNearMeProvider แจก distances
  5. 5trackEvent("near_me")ไม่บล็อก UI

3 · บันทึกสถิติ (privacy-first)

  1. 1หยุดพิมพ์ 900 msต้องมี ≥ 2 ตัวอักษร
  2. 2POST /api/analytics/collectไม่แนบคุกกี้
  3. 3hash ผู้เข้าชมsha256(salt รายวัน | ip | ua) 16 ตัว
  4. 4append events.jsonlหมุนไฟล์ 8 MB · เก็บ 50k
  5. 5admin/analyticssummarize() → การ์ดสถิติ

4 · แก้เนื้อหาผ่านหลังบ้าน

  1. 1POST admin/loginตรวจ env ADMIN_USERNAME/PASSWORD
  2. 2cookie HMACHttpOnly · 8 ชม.
  3. 3แก้ใน AboutEditor / แท็บอื่นตัวอย่างหน้าเว็บสด
  4. 4PUT admin/contentsanitize ก่อนบันทึก
  5. 5atomic writetemp → rename · cache ใหม่ตาม mtime

5 · หมวด "ยอดนิยม" (สถิติจริง ต้องครบ 6 เดือน)

  1. 1ผู้ใช้กด "ยอดนิยม"หน้าแรกขอข้อมูลจาก loader
  2. 2computePopularity()อ่าน events.jsonl (memo 5 นาที)
  3. 3เช็กประวัติ ≥ 180 วันยังไม่ครบ → ไม่จัดอันดับ
  4. 4ยังไม่ครบใช้ป้าย tags เงียบ ๆ ไม่มีข้อความบนหน้าเว็บ
  5. 5ครบแล้วview=1 · select=1.5 · decay 30 วัน · top 8 (ตัด hidden)

6 · แก้ข้อมูลผ่านหลังบ้าน (5 แท็บ · ฟอร์มเป็นหมวดพับ)

  1. 1เลือกโรงจากรายการซ้ายเรียง ก-ฮ หรือลากสลับลำดับ
  2. 2กางหมวดที่ต้องการAdminSection (details/summary)
  3. 3แก้ช่องslug อัตโนมัติ · ชิปหมวด/สิ่งอำนวยความสะดวก · การเดินทาง · ติดต่อ · รูป · ที่ตั้ง
  4. 4บันทึกทั้งหมดPUT /api/admin/content (เฉพาะ অংশที่ส่ง)
  5. 5sanitize + atomic writeแล้ว loader รอบถัดไปอ่านค่าใหม่

7 · ลำดับการ์ดหน้าแรก (สลับทุกวัน · ห้ามซ้ำตำแหน่งเดิม)

  1. 1loader ส่ง orderKeyวันที่แบบ UTC (YYYY-MM-DD)
  2. 2dailyOrder()seeded shuffle จากลำดับที่แอดมินจัด
  3. 3rotate ตาม offset รายวันoffset 1..n-1 · วันติดกันไม่เท่ากัน
  4. 4ทุกโรงเลื่อนตำแหน่งไม่มีใครอยู่ช่องเดิม 2 วันติดกัน
  5. 5กรองหมวด/คำค้นหรือเรียงตามระยะทางถ้ากด "ใกล้ฉัน"
กฎที่ยึดทั้งระบบ: หน้าเว็บอ่านข้อมูลผ่าน useContent() เท่านั้น ไม่ import ข้อมูลดิบ · ข้อความทุกคำมาจาก messages.ts + ส่วนที่แก้ได้จาก terms/about · ฟอนต์: หัวข้อ Inter + Noto Sans Thai, เนื้อหายาว IBM Plex Sans Thai Looped (font-content), โลโก้ Jersey 15