12 KiB
DESIGN.md — เอกลักษณ์งานออกแบบ Atroute
ไฟล์นี้คือ "รัฐธรรมนูญ" ของงานออกแบบ — AI agent ต้องอ่านก่อนแก้ UI ทุกครั้ง และต้องปฏิบัติตามกฎ "ห้ามทำ" อย่างเคร่งครัด ไม่งั้นงานจะกลายเป็นเว็บ AI slop ที่เห็นกันเต็มอินเทอร์เน็ต (gradient ม่วงสุ่ม ๆ + การ์ดแก้ว + blob + emoji + เงาหว่าน)
1. เอกลักษณ์ (Design Signature)
Concept: "ขาวไล่ม่วง" (White-to-Purple) — พื้นขาวสะอาด มีม่วงเฉดเดียวเป็นตัวชูโรง
หัวใจคือ ม่วงหนึ่งเฉด + ความนิ่งของตัวพิมพ์ ไม่ใช่การไล่สีรุ้งแบบ template:
ม่วง #7a4cc0 ถูกใช้อย่างตั้งใจ (ปุ่ม / CTA / รหัสป้าย / แอคเซนต์) บนพื้นขาวที่ไล่
ไปม่วงจาง ๆ แทบไม่เห็น เพื่อให้ข้อมูลอ่านง่ายและไม่แย่งความสนใจ
สามเสาหลัก:
- ข้อมูลต้องอ่านได้ชัดเจน — ตัวเลข/รหัสใช้ฟอนต์ mono + tabular-nums เรียงตรงกัน
- ม่วงหนึ่งเฉด มีเหตุผล — ม่วง = แบรนด์/แอคเซนต์, ไม่ใช่สีสุ่ม 5 เฉดไร้ความหมาย
- สี = ภาษาสถานะ — เขียว = มีรอบ, แดง = ออกแล้ว, เทา = ไม่มีข้อมูล ไม่ใช่ของตกแต่ง
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. โทเคนสี (ใช้ค่าที่กำหนดเท่านั้น — ห้ามคิดเลขใหม่เอง)
: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)
--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" ให้ทำตามลำดับ:
- ห้ามเริ่มเขียนโค้ดทันที — เขียน mockup spec 1 ย่อหน้า: concept นี้คืออะไร, ใช้สี/ฟอนต์/ลวดลายอะไร
- ใช้โทเคนจากหัวข้อ 3–4 เท่านั้น — ถ้าสี/ขนาดไม่พอ ค่อยเพิ่มในไฟล์นี้ (ไม่ใช่ inline ในโค้ด)
- ใช้ class เดิม + ปรับ CSS ตาม spec — ห้ามสร้าง class ใหม่ทั้งชุดโดยไม่จำเป็น
- ตรวจกฎ "ห้ามทำ" (หัวข้อ 2) ก่อนสรุปงาน
7. เอกสารอ้างอิงเชิงภาพ (moodboard ภาษา)
- พื้นหลังไล่เฉดขาว→ม่วงอ่อน (single-hue fade) — สะอาด ไม่มีสีรุ้ง
- ป้าย/CTA ม่วง
#7a4cc0ตัดกับพื้นขาว — แอคเซนต์เดียว ชัดเจน - ตัวเลขรหัสป้ายแบบ mono + tabular — เรียงตรงกันเหมือนป้ายจริง
- เส้นแบ่งบาง ๆ ม่วงอ่อน
#e7e0f6— แบ่งองค์ประกอบ ไม่ใช้เงา
ไฟล์นี้มีผลบังคับใช้กับทุกงานออกแบบในโปรเจกต์ — ถ้าอยากเปลี่ยนทิศทางศิลป์ ต้องแก้ไฟล์นี้ก่อน แล้วค่อยเขียนโค้ด