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:
1 parent
507cd44d49
commit
d1e76ab2be
4 files changed
+77
-81
No files matched your search
@@ -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`
|
||||
|
||||
Reference in new issue
Block a user