# UI port — web-at-transit-mock → web-at-transit (Next.js) Frontend ของ repo นี้เป็น **พอร์ต 1:1 จาก mock** (`D:\Git\workspace\web-at-transit-mock`) มาร์กอัป/CSS/ข้อความ/ตรรกะ ต้องตรงกับ mock — mock คือแหล่งความจริงของดีไซน์ อ่าน `DESIGN.md` ก่อนแก้ UI ทุกครั้ง ## โครงสร้าง frontend ``` frontend/ ├─ src/app/ route จริง (mock เดิมใช้ hash router) │ ├─ page.tsx / หน้าแรก │ ├─ stops/page.tsx /stops ป้ายหยุดรถ + ค้นหา │ ├─ stops/[code]/page.tsx /stops/:code รายละเอียดป้าย │ ├─ routes/page.tsx /routes รายละเอียดสาย │ ├─ routes/[routeId]/page.tsx /routes/:id │ ├─ check/{,[routeId]}/ /check, /check/:id │ ├─ blog/{,[postId]}/ /blog, /blog/:postId │ ├─ about/page.tsx /about │ ├─ credits/page.tsx /credits │ └─ files/[...path]/route.ts proxy → backend /files (SeaweedFS) ├─ src/components/ │ ├─ views/*.tsx มาร์กอัปแต่ละหน้า (แปลงจาก partials ของ mock) │ ├─ SiteHeader.tsx topbar + nav (แทน index.html) │ ├─ SiteFooter.tsx footer + สายยอดนิยม + ตัวเลขผู้เข้าชม │ ├─ IconSprite.tsx SVG symbols (#ic-*) │ ├─ PageRuntime.tsx เรียก mount() ของหน้า หลัง runtime พร้อม │ └─ SiteBoot.tsx โหลด shared libs + apply i18n ทุกหน้า ├─ src/lib/ │ ├─ runtime.ts boot shared libs, mountPage(), route context │ └─ ui/*.ts ตรรกะที่พอร์ตจาก ui/*.js (แก้เฉพาะ path + mount()) ├─ src/styles/ │ ├─ _shared.css · map.css · shell.css · responsive.css │ └─ pages/*.css CSS ของ partial แต่ละหน้า └─ public/ ├─ image/ ← .image ของ mock ├─ resource/data/ ← resource/data ของ mock (JSON + geojson + scheduleslist) ├─ content/{blog,about}-data/ เนื้อหาบทความ ├─ locales/{th,en}.json คำแปล (I18N) └─ vendor/{fonts,leaflet} K2D ฝังในโปรเจกต์ + Leaflet ``` ## กฎที่ต้องถือ (บทเรียนจากการพอร์ต) 1. **CSS ของแต่ละหน้า import ใน view ของหน้านั้น** (`src/components/views/*.tsx`) - ห้าม import รวมใน `layout.tsx`: CSS ทุกหน้าจะทับกัน (เช่น `.mu-toolbar` ของ route.css ทับ stops.css) — เกิดแล้วระหว่างพอร์ต - ห้ามครอบ `@layer` และห้ามเติม `#view` นำหน้า selector เพื่อจัดลำดับ: ทั้งสองวิธีเปลี่ยน specificity ทำให้ rule ที่ mock ตั้งใจให้ responsive ชนะ กลับแพ้ (เช่น `.mu-stop-grid` กลายเป็น 2 คอลัมน์แทน 3) - ที่ถูกคือ: import ต่อ route → Next แยก CSS chunk ต่อหน้า และโหลด base chunk ก่อน = ลำดับเดียวกับ mock ที่ inject `