fix(runtime): ถอด AppProviders/agent-native session gate ออก — prod build + static export ใช้ได้จริง

- app/root.tsx: ลบ <AppProviders>, DbSyncSetup (useDbSync/useNavigationState/queryClient)
  เพราะ session gate รอ /_agent-native/auth/session + /status + application-state
  ซึ่งตอบ 401 บน production build และ 404 บน static host
  → React ไม่ mount เนื้อหา, ขึ้น AppShellSkeleton + "Configuration error (2 issues)"
- คงไว้: AppToolkitProvider (design system), THEME_INIT_SCRIPT, analytics, PWA, ErrorBoundary
- sw.js VERSION v2.1.0
- README + DESIGN: บันทึกเหตุผลและกฎ "ห้ามใส่ AppProviders กลับ"
This commit is contained in:
Bkk1234 committed 2026-11-21 15:46:07 +07:00
1 parent 507cd44d49
commit d1e76ab2be
4 files changed
+77 -81

No files matched your search

+43 -32
View File
@@ -51,15 +51,15 @@ part of that build, not leave them as an empty template.
สเปกนี้เป็นข้อบังคับ ใช้กับทุกหน้าและทุกภาษาที่รองรับ:
| หัวข้อ | ค่าที่กำหนด |
|---|---|
| คำ | `AlterFlixHub` — ตัวสะกด/ตัวพิมพ์นี้เท่านั้น (ไม่ ALL CAPS, ไม่เว้นวรรค, ไม่แปล) |
| ฟอนต์ | `Jersey 15` **เท่านั้น** ห้ามใช้ Inter หรือฟอนต์อื่นแทน |
| น้ำหนัก/สไตล์ | ตามฟอนต์ดั้งเดิม — ห้ามใส่ bold/italic/uppercase/letter-spacing/เงา/ไล่สี |
| สี | `#8F0808` เท่านั้น (ทุกสถานะ รวม hover/active) |
| ขนาด header (navbar) | `text-4xl` = **36px** |
| ขนาด footer | `text-2xl` = **24px** |
| ตำแหน่ง | header: element แรก ชิดซ้ายสุด และคลิกกลับหน้าแรกได้ · footer: ซ้ายสุดของแถว |
| หัวข้อ | ค่าที่กำหนด |
| -------------------- | -------------------------------------------------------------------------------- |
| คำ | `AlterFlixHub` — ตัวสะกด/ตัวพิมพ์นี้เท่านั้น (ไม่ ALL CAPS, ไม่เว้นวรรค, ไม่แปล) |
| ฟอนต์ | `Jersey 15` **เท่านั้น** ห้ามใช้ Inter หรือฟอนต์อื่นแทน |
| น้ำหนัก/สไตล์ | ตามฟอนต์ดั้งเดิม — ห้ามใส่ bold/italic/uppercase/letter-spacing/เงา/ไล่สี |
| สี | `#8F0808` เท่านั้น (ทุกสถานะ รวม hover/active) |
| ขนาด header (navbar) | `text-4xl` = **36px** |
| ขนาด footer | `text-2xl` = **24px** |
| ตำแหน่ง | header: element แรก ชิดซ้ายสุด และคลิกกลับหน้าแรกได้ · footer: ซ้ายสุดของแถว |
- ไม่อนุญาตให้เพิ่มขนาดที่สาม หรือเปลี่ยนสี/ฟอนต์แม้ในสถานะ hover/active
- ใช้ `Logo` เป็นข้อความแทนช่องรูปที่ยังไม่มีในแกลเลอรีหน้าโรงหนัง (`Gallery`) — ช่องหลัก `size="md"` (36px), ช่องย่อย `size="sm"` (24px) เท่านั้น; ข้อความ alt ยังใช้ `gallery.main/second/third` เพื่อการเข้าถึง
@@ -86,6 +86,7 @@ part of that build, not leave them as an empty template.
- hover ของการ์ดใช้ `translate` (Tailwind `hover:-translate-y-1`) ไม่ใช้ `transform` เพราะชนกับ keyframe ของ reveal · ทุกอนิเมชันต้องมีคู่มือปิดใน `@media (prefers-reduced-motion: reduce)`
## PWA & accessibility contract (บังคับ)
- **ติดตั้งได้**: `<link rel="manifest">` อยู่ใน `app/root.tsx` (ห้ามลบ) · `public/manifest.json` ต้องมี `display: standalone`, `id`, `scope`, `start_url: "/"`, `lang` และไอคอน **PNG** 192/512 + maskable 512 (Chrome ไม่รับ SVG, iOS ไม่รับ SVG) · `apple-touch-icon` ต้องชี้ `icon-180.png`
- **ไอคอน**: ไฟล์จริงคือ `public/icon-192.png` / `icon-512.png` / `icon-maskable-512.png` / `icon-180.png` (สร้างจาก PNG 1024 ที่ฝังอยู่ใน `icon-512.svg`) — SVG เดิมเหลือไว้เป็น favicon เท่านั้น
- **service worker**: `public/sw.js` — หน้าเว็บ network-first (ออฟไลน์ → แคชหน้า → `offline.html`), static cache-first + revalidate เบื้องหลัง, ไม่แคช `/api/*` และไม่แตะ `/app/*` `/node_modules/*` `/@*` (โมดูล dev) · ลงทะเบียนผ่าน `app/lib/pwa.ts` + `<ServiceWorkerSetup/>` ใน `root.tsx`
@@ -113,17 +114,17 @@ part of that build, not leave them as an empty template.
### ข้อยกเว้นต่อเบราว์เซอร์ (exception list — ตั้งใจปล่อยไว้)
| เรื่อง | Chromium | Firefox | Safari | สิ่งที่ทำ |
|---|---|---|---|---|
| ความกว้างสกรอลบาร์ | 5px (`::-webkit-scrollbar`) | ได้แค่ `thin` (~8px) — `scrollbar-width` ไม่รับ px | overlay (ไม่แสดงถ้าไม่เลื่อน) | ยอมรับความต่างเล็กน้อย |
| สีสกรอลบาร์ตอน hover | เปลี่ยนได้ (`::-webkit-scrollbar-thumb:hover`) | **ไม่ได้** (ไม่มี pseudo-element ของ scrollbar) | ไม่ได้ | ปล่อย |
| ปุ่ม X ในช่องค้นหา | ซ่อนได้ (`::-webkit-search-cancel-button`) | **ซ่อนไม่ได้** → FF แสดง X เอง | แสดง X เอง | ปล่อย (เป็น UI ของเบราว์เซอร์) |
| `navigator.share` | ✅ (Windows/Android) | ❌ เดสก์ท็อป | ✅ ดีที่สุด | fallback คัดลอกลิงก์ |
| PWA install prompt | ✅ `beforeinstallprompt` | ❌ | ❌ (ติดตั้งผ่านเมนูแชร์) | ไม่พึ่ง event นี้ |
| `backdrop-filter` | เร็ว | ช้ากว่ามาก | กลาง | จำกัด blur ≤ 24px |
| ฟอนต์ไทย (shaping) | ต่างจาก FF เล็กน้อย | ต่างจาก Chromium เล็กน้อย | ต่างที่สุดถ้าไม่มี Noto | ยอมรับ — ทางแก้คือ self-host subset |
| `dvh` | ✅ | 101+ | 15.4+ | ใช้ได้ แต่ถ้าต้องรองรับเก่ากว่านี้ต้องมี `100vh` สำรอง |
| cache ของ SW | คงอยู่จน bump VERSION | คงอยู่ | **ถูกล้างหลังไม่ใช้งาน 7 วัน (ITP)** | ยอมรับ |
| เรื่อง | Chromium | Firefox | Safari | สิ่งที่ทำ |
| -------------------- | ---------------------------------------------- | -------------------------------------------------- | ------------------------------------ | ------------------------------------------------------ |
| ความกว้างสกรอลบาร์ | 5px (`::-webkit-scrollbar`) | ได้แค่ `thin` (~8px) — `scrollbar-width` ไม่รับ px | overlay (ไม่แสดงถ้าไม่เลื่อน) | ยอมรับความต่างเล็กน้อย |
| สีสกรอลบาร์ตอน hover | เปลี่ยนได้ (`::-webkit-scrollbar-thumb:hover`) | **ไม่ได้** (ไม่มี pseudo-element ของ scrollbar) | ไม่ได้ | ปล่อย |
| ปุ่ม X ในช่องค้นหา | ซ่อนได้ (`::-webkit-search-cancel-button`) | **ซ่อนไม่ได้** → FF แสดง X เอง | แสดง X เอง | ปล่อย (เป็น UI ของเบราว์เซอร์) |
| `navigator.share` | ✅ (Windows/Android) | ❌ เดสก์ท็อป | ✅ ดีที่สุด | fallback คัดลอกลิงก์ |
| PWA install prompt | ✅ `beforeinstallprompt` | ❌ | ❌ (ติดตั้งผ่านเมนูแชร์) | ไม่พึ่ง event นี้ |
| `backdrop-filter` | เร็ว | ช้ากว่ามาก | กลาง | จำกัด blur ≤ 24px |
| ฟอนต์ไทย (shaping) | ต่างจาก FF เล็กน้อย | ต่างจาก Chromium เล็กน้อย | ต่างที่สุดถ้าไม่มี Noto | ยอมรับ — ทางแก้คือ self-host subset |
| `dvh` | ✅ | 101+ | 15.4+ | ใช้ได้ แต่ถ้าต้องรองรับเก่ากว่านี้ต้องมี `100vh` สำรอง |
| cache ของ SW | คงอยู่จน bump VERSION | คงอยู่ | **ถูกล้างหลังไม่ใช้งาน 7 วัน (ITP)** | ยอมรับ |
## Agent-Native is structural, not visual
@@ -228,6 +229,15 @@ Single source of truth per concern — do not duplicate these:
- หมวดที่เพิ่มล่าสุด: `กลุ่มคนฉายหนัง` (Film collectives) · `หนังไทย` (Thai films)
- `ทั้งหมด` ใช้เป็น "ไม่กรอง" และไม่ถูกเสนอในชิปของหลังบ้าน (`ASSIGNABLE_CATEGORIES` ตัดออกให้)
## Runtime ของ agent-native (ถอดออกแล้ว — บังคับ)
- `app/root.tsx` **ไม่ห่อด้วย `AppProviders`** (`@agent-native/toolkit/app/providers`) และไม่เรียก `useDbSync` / `useNavigationState` อีก
- เหตุผล: provider เหล่านั้นเป็น session gate — รอ `/_agent-native/auth/session`, `/status`, `/_agent-native/application-state`
· บน production build คำขอพวกนี้ตอบ **401** และบน static host ตอบ **404** → React ไม่ mount เนื้อหา, ขึ้น `AppShellSkeleton` + "Configuration error (2 issues)"
- เว็บนี้เป็น public content site ที่มี auth ของตัวเอง (`ADMIN_*` + `/api/admin/*`) ไม่ต้องใช้ session ของ agent-native
- สิ่งที่ยังใช้ได้ปกติหลังถอด: `ThemeProvider` แบบ manual ผ่าน `THEME_INIT_SCRIPT`, `AppToolkitProvider` (design system context), analytics (`configureTracking`), PWA, หลังบ้าน
- **ห้ามใส่ `AppProviders` / `useDbSync` / `useNavigationState` กลับ** เว้นแต่จะตั้ง `BETTER_AUTH_SECRET` + `DATABASE_URL` จริงและยอมให้มีหน้า sign-in
## ชั้นกรองที่ 1 — ประเภทโรงหนัง (venue type) — บังคับ
แถบกรองหน้าแรกมี **สองชั้นในแถวเดียว** เรียงเป็น `ทั้งหมด → [3 ประเภท] │ หมวดภาพยนตร์…`
@@ -244,18 +254,18 @@ Single source of truth per concern — do not duplicate these:
## คอมโพเนนต์หลังบ้าน (`app/components/admin/`)
| ไฟล์ | ใช้ทำอะไร |
|---|---|
| `AdminSection.tsx` | การ์ดหมวดพับได้ (details/summary + badge + description) |
| `CinemaList.tsx` | รายชื่อโรง: เรียง ก-ฮ (`Intl.Collator("th")`) + ลากวาง/↑↓ สลับตำแหน่ง |
| `ChipPicker.tsx` | ชิปเลือกหลายค่า (หมวด/สิ่งอำนวยความสะดวก) + `toggleValue()` |
| `CommaListInput.tsx` | ช่องหลายค่าคั่น `,` (เก็บ draft กันตัวคั่นถูกกลืน) + `parseCommaList()` |
| `SlugInput.tsx` | slug: `normalizeSlug()` · `suggestSlug()` · `slugProblem()` |
| `PhotosEditor.tsx` | รูปโรงหนัง (`photos[]`) — รูปแรกเป็นปกการ์ดหน้าแรก |
| `TransportEditor.tsx` | วิธีเดินทาง (`transport[]`) |
| `ContactsEditor.tsx` | ช่องทางติดต่อ (`contacts[]`) |
| `CinemaFacilitiesEditor.tsx` | ข้อความสิ่งอำนวยความสะดวกต่อโรง (`facility_details`) |
| `AboutEditor.tsx` | เนื้อหาหน้า "เกี่ยวกับเรา" |
| ไฟล์ | ใช้ทำอะไร |
| ---------------------------- | ----------------------------------------------------------------------- |
| `AdminSection.tsx` | การ์ดหมวดพับได้ (details/summary + badge + description) |
| `CinemaList.tsx` | รายชื่อโรง: เรียง ก-ฮ (`Intl.Collator("th")`) + ลากวาง/↑↓ สลับตำแหน่ง |
| `ChipPicker.tsx` | ชิปเลือกหลายค่า (หมวด/สิ่งอำนวยความสะดวก) + `toggleValue()` |
| `CommaListInput.tsx` | ช่องหลายค่าคั่น `,` (เก็บ draft กันตัวคั่นถูกกลืน) + `parseCommaList()` |
| `SlugInput.tsx` | slug: `normalizeSlug()` · `suggestSlug()` · `slugProblem()` |
| `PhotosEditor.tsx` | รูปโรงหนัง (`photos[]`) — รูปแรกเป็นปกการ์ดหน้าแรก |
| `TransportEditor.tsx` | วิธีเดินทาง (`transport[]`) |
| `ContactsEditor.tsx` | ช่องทางติดต่อ (`contacts[]`) |
| `CinemaFacilitiesEditor.tsx` | ข้อความสิ่งอำนวยความสะดวกต่อโรง (`facility_details`) |
| `AboutEditor.tsx` | เนื้อหาหน้า "เกี่ยวกับเรา" |
## รูปภาพ
@@ -283,6 +293,7 @@ Single source of truth per concern — do not duplicate these:
- ตรวจด้วยสเปก `app/lib/daily-order.spec.ts` (n = 2..40 × 10 วัน, ไม่มีตำแหน่งซ้ำวันติดกัน)
## สถิติการค้นหา (privacy-first, แนว Umami)
- เก็บ event แบบ append-only ที่ `data/analytics/events.jsonl` (หมุนไฟล์เมื่อเกิน 8 MB, เก็บล่าสุด 50k event)
- ตัวรับ event: `POST /api/analytics/collect` (สาธารณะ) — ไม่ใช้คุกกี้ ไม่เก็บ IP/User-Agent ดิบ ระบุผู้เข้าชมด้วย `sha256(เกลือรายวัน | ip | ua)` 16 ตัวอักษร
- ชนิด event: `search` (query/category/result_count) · `cinema_select` (slug/source/position) · `cinema_view` · `near_me`