Rebuild mock as hash-routed SPA with i18n and PWA refresh

- Single-page shell (ui/index.html) + vanilla hash router; each screen is a partial
- New #/check schedule view (all stop times open, no collapse) wired to the
  'check schedules' CTA; contact-operator box, route map and gallery trimmed from it
- Mobile-first responsive.css (375px iPhone 8 up to 27-inch/1440p)
- TH/EN i18n system (data-i18n, browser-language detect, topbar switcher)
- Shared form controls moved to _shared.css (mu-btn, custom select chevron,
  focus-visible ring); footer contact column now mailto:[email protected]
- SW v9: JS network-first, precache i18n.js + all partials
- Legacy pages become redirect stubs to index.html#/...
This commit is contained in:
Bkk1234 committed 2026-09-03 00:08:04 +07:00
1 parent 8a6133fd77
commit c44f79b7d9
41 files changed
+4214 -2359

No files matched your search

+158
View File
@@ -0,0 +1,158 @@
# DESIGN.md — เอกลักษณ์งานออกแบบ AT Transit
> ไฟล์นี้คือ "รัฐธรรมนูญ" ของงานออกแบบ — **AI agent ต้องอ่านก่อนแก้ UI ทุกครั้ง**
> และต้องปฏิบัติตามกฎ "ห้ามทำ" อย่างเคร่งครัด ไม่งั้นงานจะกลับไปเป็นเว็บ AI ทั่วไป
> ที่เห็นกันเต็มอินเทอร์เน็ต (purple gradient + การ์ดมน ๆ + emoji)
---
## 1. เอกลักษณ์ (Design Signature)
**Concept: "กระดานเดินรถสถานี" (Station Departure Board)**
จินตนาการว่า user กำลังยืนอยู่ใต้จอไฟแสดงตารางเดินรถในสถานีขนส่งจริง —
ตัวหนังสือไฟสีเหลืองอำพันบนพื้นดำ, ป้ายเส้นทางเขียว-ครีมของรถโดยสารไทย,
กลิ่นอายตารางรถไฟภาษาไทย
สามเสาหลักของงานออกแบบนี้:
1. **ข้อมูลต้องอ่านได้จากระยะไกล** — จอแสดงข้อมูล ตัวเลข/เวลาต้องใหญ่ คอนทราสต์สูง
2. **ความงามมาจากของจริง** — สีจากรถโดยสารไทย, ตัวเลขแบบ flip-board, เส้นแบ่งแบบตารางเวลา
ไม่ใช่ gradient สวย ๆ ที่ไม่มีเหตุผล
3. **สี = ภาษาสถานะ** — เขียว = มีรอบ, แดง = ออกแล้ว, เทา = ไม่มีข้อมูล ไม่ใช่แค่ของตกแต่ง
---
## 2. กฎ "ห้ามทำ" (ฉีกสไตล์ AI ทั่วไป)
รายการนี้คือลายเซ็นของเว็บ AI ยุค 2024–2025 — **ห้าม** ใช้เด็ดขาด:
| # | ห้าม | เพราะ |
|---|---|---|
| 1 | ❌ 135° pastel gradient (เช่น `linear-gradient(135deg, #8b5cf6, #c084fc)`) | ลายเซ็น AI อันดับหนึ่ง |
| 2 | ❌ "Aurora" gradient หัวหน้าเว็บ (ม่วง→น้ำเงิน) + ตัวหนังสือ gradient บนพื้นอ่อน | เหมือน template ทุกเว็บ |
| 3 | ❌ Glassmorphism (`backdrop-filter: blur`) | ใช้เฉพาะแถบนำทางที่จำเป็นจริง ๆ |
| 4 | ❌ **Emoji เป็น icon** (🚏🕒📍🛣️🧭) | ใช้ SVG icon หรือ glyph ตัวพิมพ์ |
| 5 | ❌ Blob / รูปทรงออร์แกนิกเป็นพื้นหลัง | ใช้เส้นตาราง/ลวดลายเรขาคณิตแทน |
| 6 | ❌ การ์ดมน ๆ พื้นสีพาสเทล (`--sky-50` ฯลฯ) รัศมี 16–22px | ใช้เส้นขอบแบ่ง ไม่ใช่สีพื้น+เงา |
| 7 | ❌ Badge "✨ ยินดีต้อนรับ", sparkle, star | ไร้สาระ ไม่ได้ให้ข้อมูล |
| 8 | ❌ Drop shadow ทั่วหน้า | แบ่งองค์ประกอบด้วย border + whitespace |
| 9 | ❌ ฟอนต์แฟนซี/display เกินจำเป็น | ใช้ระบบฟอนต์เดียวตลอด (ดูหัวข้อ 4) |
| 10 | ❌ คำว่า "template / mockup / demo" ใน UI | โปรเจกต์จริง ไม่ใช่ template |
| 11 | ❌ สีฟ้า-ม่วงเป็นสีหลักของแอป | สีหลักคือ **เขียวรถโดยสาร + ครีม + อำพัน** |
> ตรวจงานก่อนส่งทุกครั้ง: ถ้าเห็นรายการข้างต้นในโค้ด/ดีไซน์ = แก้ก่อน merge
---
## 3. โทเคนสี (ใช้ค่าที่กำหนดเท่านั้น — ห้ามคิดเลขใหม่เอง)
```css
:root {
/* พื้นฐาน */
--board: #0e1a13; /* พื้นดำ-เขียวของกระดานเดินรถ */
--ink: #14211a; /* ตัวอักษรหลัก */
--paper: #f7f1e2; /* ครีม — พื้นหลังหลัก */
--card: #fffdf6; /* พื้นการ์ด */
--line: #ddd5c0; /* เส้นขอบ */
--muted: #6b7268; /* ตัวอักษรรอง */
/* สีประจำตัว (Thai bus livery) */
--green-700: #14532d; /* เขียวเข้ม — ป้ายสายรถ */
--green-500: #1f7a3d; /* เขียวสด — สถานะมีรอบ */
--green-50: #e4efe4; /* พื้น badge เขียวอ่อน */
/* สถานะ */
--amber: #f2a900; /* อำพัน — เวลาออกเดินทาง (flip-board) */
--amber-50: #fdf1d3;
--red: #c93a3a; /* แดง — ออกรถแล้ว / ยกเลิก */
--red-50: #fbe4e4;
/* โครงสร้าง */
--radius: 8px; /* มุมโค้งเล็ก เท่านั้น */
--radius-sm: 4px;
--shadow: none; /* ห้ามใช้ shadow เป็นเครื่องมือแบ่งองค์ประกอบ */
--line-w: 1px;
}
```
### กติกาสีต่อสถานะ
| องค์ประกอบ | สี |
|---|---|
| เวลาเดินรถ (departure time) | `--amber` บนพื้น `--board` — flip-board |
| ป้ายสถานะ "มีรอบ/เปิดให้บริการ" | `--green-500` |
| ป้ายสถานะ "ออกรถแล้ว/ปิด" | `--red` |
| ข้อมูลว่าง / ไม่มีพิกัด | `--muted` |
| หมวดเส้นทาง (zone) | ใช้เส้นใต้/แท็กสีเขียวเข้มต่างเฉด — **ไม่ใช่** ม่วง/ชมพู/ฟ้า |
---
## 4. ตัวพิมพ์ (Typography)
```css
--font-display: "Prompt", "Noto Sans Thai", sans-serif; /* หัวเรื่อง — หนัก 700–800 */
--font-body: "Noto Sans Thai", "Sarabun", sans-serif; /* เนื้อหา */
--font-mono: "IBM Plex Mono", ui-monospace, monospace; /* เวลา + เลขสาย + ตัวเลข */
```
| ระดับ | ฟอนต์ | ขนาด | ลักษณะ |
|---|---|---|---|
| H1 (hero) | display 800 | clamp(2.2rem, 6vw, 3.4rem) | ตัวตรง ไม่มี gradient |
| H2 (section) | display 700 | 1.35rem | + เส้นใต้สั้น 24px สี `--green-700` |
| เลขสาย/เวลา | mono 700 | 1.1–1.6rem | `font-variant-numeric: tabular-nums` |
| ป้าย micro-label | body 600 | 0.72rem | ภาษาอังกฤษ ตัวพิมพ์ใหญ่ `letter-spacing: 0.14em`, สี muted |
**กฎ:** เวลาทุกตำแหน่งต้อง mono + tabular-nums — ตัวเลขต้องเรียงตรงกันแบบตารางเดินรถจริง
---
## 5. องค์ประกอบ (Component Spec)
### การ์ดเส้นทาง / ป้าย (route card / stop tile)
- พื้น `--card`, ขอบ `1px solid --line`, `radius: 8px`
- หัวการ์ด: เลขสาย mono ใหญ่บนพื้น `--board` ตัวอักษร `--amber`
- ชื่อ: body 700 ขนาด 1rem
- ข้อมูลรอง: muted 0.85rem
- hover: ขอบเปลี่ยนเป็น `--green-700` + แปลงเป็น `translateY(-1px)` — ห้ามใส่ shadow
### ป้ายเวลา (departure chip)
- พื้น `--board`, ตัวอักษร `--amber` mono 700 — จำลองไฟกระดานเดินรถ
- กลุ่มเวลาวางเป็น grid เรียงจากน้อยไปมาก แนวตั้ง/แนวนอนตามพื้นที่
### ป้ายสถานะ (status badge)
- พื้นสีอ่อน (`--green-50` / `--red-50` / `--amber-50`) + ตัวอักษรสีเข้มของเฉดนั้น
- ใช้เฉพาะบอกสถานะจริง ไม่ใช่แค่ตกแต่ง
### แถบนำทาง (topbar)
- พื้น `--board` (เข้ม) ตัวอักษรครีม — ต่างจากเว็บทั่วไปที่ topbar ขาว
- active menu = เส้นใต้ `--amber`
- CTA "เช็กเวลาเดินรถ" = พื้น `--amber` ตัวอักษร `--ink` หนา
### แผนที่ (Leaflet)
- marker เปลี่ยนจาก gradient วงกลม เป็น pin สี่เหลี่ยมมนสีเขียว/อำพันตามสถานะ
- เส้นทางวิ่ง: `--green-700` หนา 5px (แทนม่วง)
### ฟอร์มค้นหา
- พื้น `--paper` ขอบ `--line` 2px, โฟกัส = ขอบ `--green-700` — ไม่มี glow
---
## 6. วิธีเขียนงานออกแบบใหม่ (สำหรับ AI)
เมื่อได้รับงาน "ออกแบบ/ปรับ UI" ให้ทำตามลำดับ:
1. **ห้ามเริ่มเขียนโค้ดทันที** — เขียน mockup spec 1 ย่อหน้า: concept นี้คืออะไร, ใช้สี/ฟอนต์/ลวดลายอะไร, อ้างอิงของจริงอะไร
2. ใช้โทเคนจากหัวข้อ 3–4 เท่านั้น — ถ้าสี/ขนาดไม่พอ ค่อยเพิ่มในไฟล์นี้ (ไม่ใช่ inline ในโค้ด)
3. เขียน JSX ตาม spec เดิม (class เดิม) แล้วปรับ CSS ใน `globals.css` — ห้ามสร้าง class ใหม่ทั้งชุดโดยไม่จำเป็น
4. ตรวจกฎ "ห้ามทำ" (หัวข้อ 2) ก่อนสรุปงาน
## 7. เอกสารอ้างอิงเชิงภาพ (moodboard ภาษา)
- กระดานแสดงตารางเดินรถ บขส. / สถานีขนส่งทั่วไทย — พื้นดำ ไฟเหลือง
- ป้ายข้างรถโดยสารปรับอากาศสาย กรุงเทพฯ–อ่างทอง — เขียว-ครีม ตัวหนังสือหนา
- ตารางรถไฟไทย (แบบกระดาษ) — เส้นแบ่งบาง ๆ ตัวเลขเรียงเป็นคอลัมน์
- ป้ายชื่อสถานีรถไฟญี่ปุ่น (JR) — สีเดียวตัดกันสูง อ่านง่ายจากระยะไกล
---
*ไฟล์นี้มีผลบังคับใช้กับทุกงานออกแบบในโปรเจกต์ — ถ้าอยากเปลี่ยนทิศทางศิลป์ ต้องแก้ไฟล์นี้ก่อน แล้วค่อยเขียนโค้ด*