# AGENTS.md — คำสั่งสำหรับ AI coding agent โปรเจกต์: **web-at-transit-mock** — mockup/ดีไซน์ HTML ต้นแบบของเว็บข้อมูลการเดินรถ สถานีขนส่งผู้โดยสารจังหวัดอ่างทอง (AT Transit) > หมายเหตุ: repo นี้เป็น **static HTML mockup** (ยังไม่มี backend / framework) > ส่วน implementation จริง (Next.js) อยู่ที่ `web-at-transit` — เวลาทำงานกับ repo นี้ > ให้แก้ HTML/CSS ตรง ๆ อย่าแนะนำให้ย้ายไป framework อ่านไฟล์นี้ก่อนทำงานเสมอ เพื่อประหยัด token อย่าเดาโครงสร้าง --- ## โครงสร้าง ``` web-at-transit-mock/ ├── maintheme.png ← ภาพธีม/ดีไซน์ต้นแบบ (เปิดดูเพื่อจับอารมณ์สีและ layout) ├── ui/ ← ★ Single-page app (static HTML + vanilla JS) │ ├── index.html SHELL หน้าเดียว — header +
+ footer │ ├── router.js hash router: สลับ view โดยไม่โหลดหน้าใหม่ │ ├── sw.js / pwa.js / manifest.json ← PWA + อัปเดตอัตโนมัติ (ดูข้อ 11) │ ├── _shared.css สไตล์ร่วมทุก view (โหลดจาก shell) │ ├── responsive.css ★ Mobile-first layer — base = iPhone 8 (375px) │ │ ขยายตาม min-width: 480/640/768/1024/1280/1600px │ │ (component ใน #view ต้องใช้ prefix `#view`) │ ├── partials/ ★ view ละ 1 ไฟล์ (router fetch + inject ที่ #view) │ │ ├── home.html + home.init.js ← #/ (selectors + marquee) │ │ ├── busStop.html ← #/stops │ │ ├── busDetail.html ← #/routes, #/routes/:id │ │ ├── busDetailExpanded.html ← #/routes/expanded │ │ ├── stopDetail.html ← #/stops/:code │ │ ├── credits.html ← #/credits │ │ └── icons-sprite.svg ← Lucide sprite │ ├── busStop.html / busDetail.html / ... ← เหลือแค่ redirect stub → #/... └── resource/ ├── data/ ข้อมูล mock: routes.json, schedules.json, stations.json, │ provinces.json, route_groups.json └── images/ รูปทั้งหมด (routes/, partners/, landmarks/, qrcode/, icons/) ``` **ทุกหน้าเป็น hash URL** (`#/stops`, `#/routes/101`, `#/stops/at_main_terminal`) — ลิงก์ภายในทั้งหมดเป็น `` ไม่มีการโหลดหน้าใหม่เลย (no reflash) ## วิธีเปิดดูผลงาน ```bash cd D:\Git\web-at-transit-mock python -m http.server 8090 # เปิด http://localhost:8090/ui/index.html ``` (ใช้ static server เสมอ — ห้ามเปิด file:// เพราะ relative path และ fetch JSON จะพัง) ## กฎบังคับ 1. **ห้ามใส่ framework/build step** — repo นี้เป็น static HTML + vanilla JS เท่านั้น 2. **ทุกหน้าเป็น SPA view ผ่าน hash router** — ห้ามสร้างไฟล์ HTML หน้าใหม่ ถ้าจะเพิ่มหน้าจอใหม่: สร้าง `partials/.html` (+ `