Files
web-at-transit-mock/DESIGN.md
T
Bkk1234 c44f79b7d9 Rebuild mock as hash-routed SPA with i18n and PWA refresh
- 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#/...
2026-09-03 00:08:04 +07:00

12 KiB
Raw Blame History

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

: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, ตัวอักษร --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) — สีเดียวตัดกันสูง อ่านง่ายจากระยะไกล

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