- Single-page shell (ui/index.html) + vanilla hash router; each screen is a partial - New #/check schedule view (all stop times open, no collapse) wired to the 'check schedules' CTA; contact-operator box, route map and gallery trimmed from it - Mobile-first responsive.css (375px iPhone 8 up to 27-inch/1440p) - TH/EN i18n system (data-i18n, browser-language detect, topbar switcher) - Shared form controls moved to _shared.css (mu-btn, custom select chevron, focus-visible ring); footer contact column now mailto:[email protected] - SW v9: JS network-first, precache i18n.js + all partials - Legacy pages become redirect stubs to index.html#/...
12 KiB
DESIGN.md — เอกลักษณ์งานออกแบบ AT Transit
ไฟล์นี้คือ "รัฐธรรมนูญ" ของงานออกแบบ — AI agent ต้องอ่านก่อนแก้ UI ทุกครั้ง และต้องปฏิบัติตามกฎ "ห้ามทำ" อย่างเคร่งครัด ไม่งั้นงานจะกลับไปเป็นเว็บ AI ทั่วไป ที่เห็นกันเต็มอินเทอร์เน็ต (purple gradient + การ์ดมน ๆ + emoji)
1. เอกลักษณ์ (Design Signature)
Concept: "กระดานเดินรถสถานี" (Station Departure Board)
จินตนาการว่า user กำลังยืนอยู่ใต้จอไฟแสดงตารางเดินรถในสถานีขนส่งจริง — ตัวหนังสือไฟสีเหลืองอำพันบนพื้นดำ, ป้ายเส้นทางเขียว-ครีมของรถโดยสารไทย, กลิ่นอายตารางรถไฟภาษาไทย
สามเสาหลักของงานออกแบบนี้:
- ข้อมูลต้องอ่านได้จากระยะไกล — จอแสดงข้อมูล ตัวเลข/เวลาต้องใหญ่ คอนทราสต์สูง
- ความงามมาจากของจริง — สีจากรถโดยสารไทย, ตัวเลขแบบ flip-board, เส้นแบ่งแบบตารางเวลา ไม่ใช่ gradient สวย ๆ ที่ไม่มีเหตุผล
- สี = ภาษาสถานะ — เขียว = มีรอบ, แดง = ออกแล้ว, เทา = ไม่มีข้อมูล ไม่ใช่แค่ของตกแต่ง
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. โทเคนสี (ใช้ค่าที่กำหนดเท่านั้น — ห้ามคิดเลขใหม่เอง)
: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)
--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, ตัวอักษร--ambermono 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ขอบ--line2px, โฟกัส = ขอบ--green-700— ไม่มี glow
6. วิธีเขียนงานออกแบบใหม่ (สำหรับ AI)
เมื่อได้รับงาน "ออกแบบ/ปรับ UI" ให้ทำตามลำดับ:
- ห้ามเริ่มเขียนโค้ดทันที — เขียน mockup spec 1 ย่อหน้า: concept นี้คืออะไร, ใช้สี/ฟอนต์/ลวดลายอะไร, อ้างอิงของจริงอะไร
- ใช้โทเคนจากหัวข้อ 3–4 เท่านั้น — ถ้าสี/ขนาดไม่พอ ค่อยเพิ่มในไฟล์นี้ (ไม่ใช่ inline ในโค้ด)
- เขียน JSX ตาม spec เดิม (class เดิม) แล้วปรับ CSS ใน
globals.css— ห้ามสร้าง class ใหม่ทั้งชุดโดยไม่จำเป็น - ตรวจกฎ "ห้ามทำ" (หัวข้อ 2) ก่อนสรุปงาน
7. เอกสารอ้างอิงเชิงภาพ (moodboard ภาษา)
- กระดานแสดงตารางเดินรถ บขส. / สถานีขนส่งทั่วไทย — พื้นดำ ไฟเหลือง
- ป้ายข้างรถโดยสารปรับอากาศสาย กรุงเทพฯ–อ่างทอง — เขียว-ครีม ตัวหนังสือหนา
- ตารางรถไฟไทย (แบบกระดาษ) — เส้นแบ่งบาง ๆ ตัวเลขเรียงเป็นคอลัมน์
- ป้ายชื่อสถานีรถไฟญี่ปุ่น (JR) — สีเดียวตัดกันสูง อ่านง่ายจากระยะไกล
ไฟล์นี้มีผลบังคับใช้กับทุกงานออกแบบในโปรเจกต์ — ถ้าอยากเปลี่ยนทิศทางศิลป์ ต้องแก้ไฟล์นี้ก่อน แล้วค่อยเขียนโค้ด