Files
web-at-transit-mock/DESIGN.md
T
Bkk1234 c44f79b7d9 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#/...
2026-09-03 00:08:04 +07:00

159 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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) — สีเดียวตัดกันสูง อ่านง่ายจากระยะไกล
---
*ไฟล์นี้มีผลบังคับใช้กับทุกงานออกแบบในโปรเจกต์ — ถ้าอยากเปลี่ยนทิศทางศิลป์ ต้องแก้ไฟล์นี้ก่อน แล้วค่อยเขียนโค้ด*