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

12 KiB
Raw Blame History

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. โทเคนสี (ใช้ค่าที่กำหนดเท่านั้น — ห้ามคิดเลขใหม่เอง)

: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" ให้ทำตามลำดับ:

  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 — แบ่งองค์ประกอบ ไม่ใช้เงา

ไฟล์นี้มีผลบังคับใช้กับทุกงานออกแบบในโปรเจกต์ — ถ้าอยากเปลี่ยนทิศทางศิลป์ ต้องแก้ไฟล์นี้ก่อน แล้วค่อยเขียนโค้ด