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

+27 -22
View File
@@ -12,25 +12,25 @@ pnpm install
pnpm dev # http://localhost:8080
```
| คำสั่ง | ทำอะไร |
|---|---|
| `pnpm typecheck` | ตรวจ TypeScript ทั้งโปรเจกต์ |
| `pnpm test` | รันสเปกทั้งหมด (vitest) |
| `pnpm build` / `pnpm start` | build / รันโปรดักชัน |
| `pnpm agent-native:doctor` | ตรวจสุขภาพโปรเจกต์ตามกฎของ framework |
| คำสั่ง | ทำอะไร |
| --------------------------- | ------------------------------------ |
| `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](docs/admin-guide.md) · `noindex` |
| `/sitemap.xml` · `/robots.txt` · `/ai.txt` | ไฟล์สำหรับ crawler (sitemap/robots สร้างสดตามโดเมนของ request) |
| Route | หน้า |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/` | หน้าแรก — ฮีโร่ค้นหา, แถบหมวด, กริดการ์ดโรงหนัง (ลำดับการ์ด **สลับเองทุกวัน** ไม่ให้ซ้ำตำแหน่งเดิม 2 วันติดกัน) · รองรับลิงก์ค้นหาตรง `/?q=<คำค้น>` |
| `/cinema/<slug>` | รายละเอียดโรง — แกลเลอรี (กดลูกศรเลื่อนได้), สรุป, การเดินทาง, สิ่งอำนวยความสะดวก, ที่ตั้ง (แผนที่), ติดต่อ/ชำระเงิน, ปุ่มแชร์ |
| `/c/<slug>` | ลิงก์ย่อสำหรับแชร์ → **302** ไป `/cinema/<slug>` |
| `/for-film-lovers` | บทความ "สำหรับคนรักหนัง" (แก้จากหลังบ้าน) |
| `/for-cinemas` | บทความ "สำหรับคนทำโรงหนัง" (แก้จากหลังบ้าน) |
| `/about` | เกี่ยวกับเรา (แก้จากหลังบ้าน) |
| `/admin` · `/admin/login` | หลังบ้าน 7 แท็บ — ดู [docs/admin-guide.md](docs/admin-guide.md) · `noindex` |
| `/sitemap.xml` · `/robots.txt` · `/ai.txt` | ไฟล์สำหรับ crawler (sitemap/robots สร้างสดตามโดเมนของ request) |
รองรับ **ไทย/อังกฤษ** สลับที่ header (ปุ่มเดียว + dropdown) หรือ `?lang=en` (จำค่าใน cookie + localStorage)
@@ -88,17 +88,21 @@ AGENTS.md กฎสำหรับ agent/AI ที่แก้โค้
ระบบ**ไม่ฝังโดเมนในโค้ด** — 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` | ไม่ต้อง | บังคับโดเมนเฉพาะกรณี (ปกติปล่อยว่าง) |
| env | จำเป็น | ใช้ทำอะไร |
| ------------------------------------------------------------ | ------- | ------------------------------------ |
| `ADMIN_USERNAME` · `ADMIN_PASSWORD` · `ADMIN_SESSION_SECRET` | แนะนำ | บัญชีหลังบ้าน + กุญแจเซ็น cookie |
| `ANALYTICS_SALT` | แนะนำ | เกลือ hash ผู้เข้าชม (กันคาดเดา) |
| `SITE_URL` / `SHARE_ORIGIN` | ไม่ต้อง | บังคับโดเมนเฉพาะกรณี (ปกติปล่อยว่าง) |
## Static export (โฮสต์แบบไฟล์นิ่ง / มี `index.html`)
แอปนี้เป็น SSR + หลังบ้านเขียนไฟล์ได้ → ค่าปกติต้องรันเป็น Node server (`node .output/server/index.mjs`)
แอปนี้เป็น 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 จริง
```bash
pnpm build # ได้ .output (preset node)
PORT=8090 node .output/server/index.mjs # เปิด server ตัวจริง
@@ -109,6 +113,7 @@ python -m http.server 8091 --directory static-export # ทดสอบแบ
ผลลัพธ์: `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)