159 lines
12 KiB
Markdown
159 lines
12 KiB
Markdown
# DESIGN.md — เอกลักษณ์งานออกแบบ Atroute
|
||
|
||
> ไฟล์นี้คือ "รัฐธรรมนูญ" ของงานออกแบบ — **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) — สีเดียวตัดกันสูง อ่านง่ายจากระยะไกล
|
||
|
||
---
|
||
|
||
*ไฟล์นี้มีผลบังคับใช้กับทุกงานออกแบบในโปรเจกต์ — ถ้าอยากเปลี่ยนทิศทางศิลป์ ต้องแก้ไฟล์นี้ก่อน แล้วค่อยเขียนโค้ด*
|