# 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) — สีเดียวตัดกันสูง อ่านง่ายจากระยะไกล --- *ไฟล์นี้มีผลบังคับใช้กับทุกงานออกแบบในโปรเจกต์ — ถ้าอยากเปลี่ยนทิศทางศิลป์ ต้องแก้ไฟล์นี้ก่อน แล้วค่อยเขียนโค้ด*