Files
web-at-transit-mock/DESIGN.md
T
2026-09-23 00:53:14 +07:00

162 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 — เอกลักษณ์งานออกแบบ Atroute
> ไฟล์นี้คือ "รัฐธรรมนูญ" ของงานออกแบบ — **AI agent ต้องอ่านก่อนแก้ UI ทุกครั้ง**
> และต้องปฏิบัติตามกฎ "ห้ามทำ" อย่างเคร่งครัด ไม่งั้นงานจะกลายเป็นเว็บ AI slop
> ที่เห็นกันเต็มอินเทอร์เน็ต (gradient ม่วงสุ่ม ๆ + การ์ดแก้ว + blob + emoji + เงาหว่าน)
---
## 1. เอกลักษณ์ (Design Signature)
**Concept: "ขาวไล่ม่วง" (White-to-Purple)** — พื้นขาวสะอาด มีม่วงเฉดเดียวเป็นตัวชูโรง
หัวใจคือ **ม่วงหนึ่งเฉด + ความนิ่งของตัวพิมพ์** ไม่ใช่การไล่สีรุ้งแบบ template:
ม่วง `#7a4cc0` ถูกใช้อย่างตั้งใจ (ปุ่ม / CTA / รหัสป้าย / แอคเซนต์) บนพื้นขาวที่ไล่
ไปม่วงจาง ๆ แทบไม่เห็น เพื่อให้ข้อมูลอ่านง่ายและไม่แย่งความสนใจ
สามเสาหลัก:
1. **ข้อมูลต้องอ่านได้ชัดเจน** — ตัวเลข/รหัสใช้ฟอนต์ mono + tabular-nums เรียงตรงกัน
2. **ม่วงหนึ่งเฉด มีเหตุผล** — ม่วง = แบรนด์/แอคเซนต์, ไม่ใช่สีสุ่ม 5 เฉดไร้ความหมาย
3. **สี = ภาษาสถานะ** — เขียว = มีรอบ, แดง = ออกแล้ว, เทา = ไม่มีข้อมูล ไม่ใช่ของตกแต่ง
---
## 2. กฎ "ห้ามทำ" (ฉีกสไตล์ AI slop)
รายการนี้คือลายเซ็นของเว็บ AI ยุค 2024–2025 — **ห้าม** ใช้เด็ดขาด:
| # | ห้าม | เพราะ |
|---|---|---|
| 1 | ❌ **Aurora gradient หลายสี** (ม่วง→ชมพู→ฟ้า→เขียว ผสมกันแนวทแยง) | ลายเซ็น AI อันดับหนึ่ง |
| 2 | ❌ **ม่วงสุ่ม 5+ เฉด** ไม่มีความหมาย (ม่วง 50/100/200/…/900 หว่านเต็มหน้า) | ยึดม่วงเฉดเดียว `#7a4cc0` + อ่อน `#b07ce0` |
| 3 | ❌ Glassmorphism (`backdrop-filter: blur`) | ใช้เฉพาะแถบนำทางที่จำเป็นจริง ๆ |
| 4 | ❌ **Emoji เป็น icon** (🚏🕒📍🛣️🧭) | ใช้ SVG icon หรือ glyph ตัวพิมพ์ |
| 5 | ❌ Blob / รูปทรงออร์แกนิกลอย ๆ เป็นพื้นหลัง | ใช้เส้นขอบ/ตาราง/ลวดลายเรขาคณิต |
| 6 | ❌ การ์ดมน ๆ พื้นสีพาสเทล รัศมี 16–22px | ใช้เส้นขอบ 1px + `radius: 8px` ไม่ใช่สีพื้น+เงา |
| 7 | ❌ Badge "✨ ยินดีต้อนรับ", sparkle, star | ไร้สาระ ไม่ได้ให้ข้อมูล |
| 8 | ❌ Drop shadow ทั่วหน้า | แบ่งองค์ประกอบด้วย border + whitespace |
| 9 | ❌ ฟอนต์แฟนซี/display เกินจำเป็น | ใช้ระบบฟอนต์เดียวตลอด (ดูหัวข้อ 4) |
| 10 | ❌ คำว่า "template / mockup / demo" ใน UI | โปรเจกต์จริง ไม่ใช่ template |
| 11 | ❌ ตัวหนังสือ gradient (text-clip) บนพื้นอ่อน | ตัวหนังสือสีทึบ ตรง ไม่มี gradient |
> ตรวจงานก่อนส่งทุกครั้ง: ถ้าเห็นรายการข้างต้นในโค้ด/ดีไซน์ = แก้ก่อน merge
---
## 3. โทเคนสี (ใช้ค่าที่กำหนดเท่านั้น — ห้ามคิดเลขใหม่เอง)
```css
:root {
/* ม่วง — สีหลักเฉดเดียวของแบรนด์ */
--purple-700: #6d28d9; /* ม่วงเข้ม — hover / เน้น */
--purple: #7a4cc0; /* ม่วงหลัก — ปุ่ม / CTA / แอคเซนต์ */
--purple-300: #b07ce0; /* ม่วงอ่อน — ปลาย gradient / ขอบโฟกัส */
--purple-50: #f3ecff; /* พื้นม่วงอ่อน — badge / ชิป */
--purple-25: #faf7ff; /* พื้นไล่ม่วงจางสุด — hover / hero */
/* พื้นฐาน */
--paper: #ffffff; /* พื้นขาวหลัก */
--ink: #1f2a44; /* ตัวอักษรหลัก (น้ำเงินเข้ม) */
--muted: #6f7b95; /* ตัวอักษรรอง */
--line: #e7e0f6; /* เส้นขอบม่วงอ่อน */
/* สถานะ */
--green-500: #1f8765; /* มีรอบ / เปิดให้บริการ */
--green-50: #e4efe4;
--amber: #c47b1d; /* เตือน / หมายเหตุ (ไม่ใช่สีหลัก) */
--amber-50: #fff6e8;
--red: #c93a3a; /* ออกรถแล้ว / ยกเลิก */
--red-50: #fbe4e4;
/* โครงสร้าง */
--radius: 8px; /* มุมโค้งเล็ก เท่านั้น */
--radius-sm: 4px;
--shadow: none; /* ห้ามใช้ shadow เป็นเครื่องมือแบ่งองค์ประกอบ */
--line-w: 1px;
/* gradient ที่อนุญาต (ใช้ซ้ำได้) */
--grad-brand: linear-gradient(135deg, #7a4cc0, #b07ce0); /* ปุ่ม/ชิป/CTA */
--grad-bg: linear-gradient(180deg, #ffffff, #faf7ff, #f4f0fd); /* พื้นหลังหน้า */
}
```
### กติกาสีต่อสถานะ
| องค์ประกอบ | สี |
|---|---|
| แอคเซนต์ / ปุ่ม / CTA / รหัสป้าย | `--grad-brand` (ม่วงหลัก) |
| พื้นหลังหน้า | `--grad-bg` (ขาว→ม่วงจาง) |
| ป้ายสถานะ "มีรอบ/เปิดให้บริการ" | `--green-500` |
| ป้ายสถานะ "ออกรถแล้ว/ปิด" | `--red` |
| ข้อมูลว่าง / ไม่มีพิกัด | `--muted` |
| หมายเหตุ / เตือน | `--amber` (ใช้ sparingly) |
---
## 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 สี `--purple` |
| เลขสาย/รหัสป้าย/เวลา | 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)
- พื้น `--paper`, ขอบ `1px solid --line`, `radius: 8px`
- หัวการ์ด / รหัสป้าย: ตัวเลข mono ใหญ่บนพื้น `--grad-brand` ตัวอักษรขาว
- ชื่อ: body 700 ขนาด 1rem
- ข้อมูลรอง: muted 0.85rem
- hover: ขอบเปลี่ยนเป็น `--purple-300` + `translateY(-1px)` — **ห้ามใส่ shadow**
### ชิปรหัส / เวลา (code chip / departure chip)
- รหัสป้าย/เลขสาย: พื้น `--grad-brand` ตัวอักษรขาว mono 700
- กลุ่มเวลาวางเป็น grid เรียงจากน้อยไปมาก
### ป้ายสถานะ (status badge)
- พื้นสีอ่อน (`--green-50` / `--red-50` / `--amber-50`) + ตัวอักษรสีเข้มของเฉดนั้น
- ใช้เฉพาะบอกสถานะจริง ไม่ใช่แค่ตกแต่ง
### แถบนำทาง (topbar)
- พื้น `--paper` (ขาว) ตัวอักษร `--ink` ขอบล่าง `1px solid --line`
- active menu = เส้นใต้ `--purple`
- CTA "เช็กเวลาเดินรถ" = พื้น `--grad-brand` ตัวอักษรขาวหนา
### ฟอร์มค้นหา
- พื้น `--paper` ขอบ `--line`, โฟกัส = ขอบ `--purple-300` — ไม่มี glow
- ช่องกรอกแบบแบ่งกล่อง (รหัสป้าย) ใช้ mono + กล่องละ 1 หลัก
---
## 6. วิธีเขียนงานออกแบบใหม่ (สำหรับ AI)
เมื่อได้รับงาน "ออกแบบ/ปรับ UI" ให้ทำตามลำดับ:
1. **ห้ามเริ่มเขียนโค้ดทันที** — เขียน mockup spec 1 ย่อหน้า: concept นี้คืออะไร, ใช้สี/ฟอนต์/ลวดลายอะไร
2. ใช้โทเคนจากหัวข้อ 3–4 เท่านั้น — ถ้าสี/ขนาดไม่พอ ค่อยเพิ่มในไฟล์นี้ (ไม่ใช่ inline ในโค้ด)
3. ใช้ class เดิม + ปรับ CSS ตาม spec — ห้ามสร้าง class ใหม่ทั้งชุดโดยไม่จำเป็น
4. ตรวจกฎ "ห้ามทำ" (หัวข้อ 2) ก่อนสรุปงาน
## 7. เอกสารอ้างอิงเชิงภาพ (moodboard ภาษา)
- พื้นหลังไล่เฉดขาว→ม่วงอ่อน (single-hue fade) — สะอาด ไม่มีสีรุ้ง
- ป้าย/CTA ม่วง `#7a4cc0` ตัดกับพื้นขาว — แอคเซนต์เดียว ชัดเจน
- ตัวเลขรหัสป้ายแบบ mono + tabular — เรียงตรงกันเหมือนป้ายจริง
- เส้นแบ่งบาง ๆ ม่วงอ่อน `#e7e0f6` — แบ่งองค์ประกอบ ไม่ใช้เงา
---
*ไฟล์นี้มีผลบังคับใช้กับทุกงานออกแบบในโปรเจกต์ — ถ้าอยากเปลี่ยนทิศทางศิลป์ ต้องแก้ไฟล์นี้ก่อน แล้วค่อยเขียนโค้ด*