Files
Bkk1234 70cc81b923 Put the hamburger at the far right of the mobile topbar
Previous order was (menu)(theme)(language). Swapped so the row reads
logo ... (theme)(language)(menu) and the hamburger sits flush against the
right padding edge, which is where the thumb menu is expected.

Measured 360/375/414px: brand starts at 14px, menu ends exactly on the
right padding edge, 8px gaps, no horizontal overflow.
2026-10-23 23:49:51 +07:00

28 KiB
Raw Permalink Blame History

DESIGN.md — เอกลักษณ์งานออกแบบ Atroute

ขอบเขต: ใช้กับ UI ใน frontend/ (Next.js App Router) ซึ่งพอร์ตมาจาก mock (D:\Git\workspace\web-at-transit-mock) แบบ 1:1 — mock คือแหล่งความจริงของดีไซน์ AI agent ต้องอ่านไฟล์นี้ก่อนแก้ UI ทุกครั้ง และห้ามฝ่าฝืนกฎ "ห้ามทำ"


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;    /* เส้นขอบม่วงอ่อน */

  /* หมวดเส้นทาง (route_group ใน routes.json) — ใช้กับ "เลขสาย" (chip) เท่านั้น */
  --group-bangkok:         #1f5fbf;  /* เข้ากรุงเทพฯ — น้ำเงิน */
  --group-interprovincial: #7a4cc0;  /* ระหว่างจังหวัด — ม่วง (ม่วงแบรนด์) */
  --group-in-province:     #d6388f;  /* ภายในจังหวัด — ชมพู */
  --group-municipal:       #6b7268;  /* ภายในเทศบาล — เทา (สำรอง ยังไม่มีสายใช้) */

  /* สถานะ */
  --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)

3.1 ระบบภาษา (i18n)

คำแปลแยกเป็น ไฟล์ต่อภาษา — frontend/locales/<รหัสภาษา>.json (แบน: "key": "ข้อความ")

  • ภาษาที่รองรับ ประกาศที่ frontend/i18n.js → SUPPORTED (ปัจจุบัน th, en) · ภาษาตั้งต้น th ใช้เป็น fallback เมื่อคีย์ขาดในภาษาปัจจุบัน
  • เพิ่มภาษาใหม่ = วางไฟล์ frontend/locales/<รหัส>.json + เพิ่มรหัสใน SUPPORTED
    • เพิ่ม ./locales/<รหัส>.json ใน PRECACHE ของ frontend/sw.js (ไม่ต้องแก้โค้ดอื่น)
  • โหลดแบบ lazy เฉพาะภาษาที่ใช้ (+ ภาษาตั้งต้น) — ไม่ดึงทุกภาษามาทั้งหน้า
  • ข้อความใน HTML คือ fallback — ถ้าโหลดไฟล์ภาษาไม่สำเร็จ ระบบจะ ไม่เขียนทับ (คงข้อความเดิมไว้)
  • สลับภาษา → I18N.setLang() โหลดไฟล์ภาษาให้เสร็จก่อน แล้วประกาศ event langchange ให้หน้าวาดใหม่ (กันข้อความที่ JS สร้างค้างเป็นภาษาเก่า) · จำค่าไว้ใน localStorage('at_lang')
  • <html lang> ถูกอัปเดตตามภาษาที่เลือกอัตโนมัติ (a11y · การตัดคำ · เลือกฟอนต์)
  • ชื่อเฉพาะไม่แปล — ชื่อสถานี จังหวัด สายรถ (ภาษาไทยเสมอ)
  • ตรวจก่อน commit: python resource/tools/check-i18n.py

3.2 ธีม (Theme) — สว่าง / มืด / ตามเวลาเครื่อง

ไฟล์: frontend/src/styles/theme.css (โทเคน) · frontend/src/components/ThemeSwitch.tsx (ตัวสลับ)

โหมดที่รองรับ

โหมด ค่า data-theme กติกา
สว่าง light ผู้ใช้เลือกเอง
มืด dark ผู้ใช้เลือกเอง
ตามเวลา auto 06:00–17:59 = สว่าง · 18:00–05:59 = มืด (เวลาจากเครื่องผู้ใช้)
  • ค่าเริ่มต้น = auto · เก็บที่ localStorage['at_theme']
  • สคริปต์ inline ใน src/app/layout.tsx ตั้ง data-theme ก่อน paint → ไม่มีจอขาววูบ
  • โหมด auto ตรวจซ้ำทุก 60 วินาที + ทุกครั้งที่กลับเข้าแท็บ (visibilitychange)
  • color-scheme ถูกตั้งตามธีม → สกรอลบาร์/คอนโทรลเบราว์เซอร์กลมกลืน

กฎการใช้สี (สำคัญ)

ห้ามใส่ hex ตรง ๆ ในไฟล์ CSS อีก — ใช้โทเคนใน theme.css เท่านั้น

โทเคน สว่าง มืด ใช้กับ
--c-bg #f7f9fd #120e1e พื้นหลังหน้า
--c-surface #ffffff #171225 การ์ด/แถบนำทาง
--c-surface-2 #faf7ff #1f1833 พื้นรอง
--c-surface-3 #f4f2fa #251d3d พื้นตติยภูมิ
--c-ink #1f2a44 #ece9f7 ข้อความหลัก
--c-ink-2 #5f6b83 #a9a2c4 ข้อความรอง
--c-border #e7e2f6 #352b52 เส้นขอบ
--c-brand #7a4cc0 #7a4cc0 พื้นม่วง (คงที่)
--c-brand-ink #7a4cc0 #b892f5 ตัวอักษรม่วง
--c-tint-purple/pink/green/amber/cyan อ่อน เข้มจัด พื้นตามหมวด
--c-ok/warn/danger/info เข้ม สว่าง ข้อความสถานะ
--c-glass / -70 / -24 ขาวโปร่ง ดำโปร่ง พื้นผิวโปร่งแสง

ตรวจแล้ว (WCAG AA)

  • ข้อความบนพื้น: 0 จุดต่ำกว่า 4.5:1 ทั้งโหมดสว่างและมืด (สแกน 8 หน้า)
  • ปุ่มธีม 34×34px · 40×40px บนจอสัมผัส (@media (pointer: coarse))
  • aria-checked + role="radiogroup" + :focus-visible 2px
  • ไม่มี horizontal overflow ที่ 375px

ข้อควรระวัง

  • แผนที่ (Leaflet) ยังใช้ไทล์สว่าง — ตั้งใจให้เป็นเช่นนั้น (อ่านถนนง่ายกว่า)
  • --c-brand คงที่ทั้ง 2 ธีม เพื่อรักษาเอกลักษณ์ม่วง; ที่เปลี่ยนคือ --c-brand-ink (ตัวอักษร)

4. ตัวพิมพ์ (Typography)

--font-display: "K2D", "Prompt", "Noto Sans Thai", sans-serif;   /* หัวเรื่อง — หนัก 600–800 (มีหัวแบบไทย) */
--font-body:    "K2D", "Noto Sans Thai", "Sarabun", sans-serif;  /* เนื้อหา — อ่านง่ายบนจอเล็ก */
--font-mono:    "IBM Plex Mono", ui-monospace, monospace;       /* เวลา + เลขสาย + ตัวเลข */

ทำไม K2D: ฟอนต์ไทย มีหัว (Loop) หัวเหลี่ยมโมเดิร์น ไม่เชย · น้ำหนักครบ 300–800 · ตัวเลขสวย (เข้าคู่กับ IBM Plex Mono ที่ใช้กับเวลา/เลขสาย) · ใบอนุญาต SIL OFL

ฝังไว้ในโปรเจกต์ (ไม่พึ่ง CDN): ไฟล์อยู่ที่ frontend/vendor/fonts/ — k2d.css (@font-face 18 กฎ · 6 น้ำหนัก × subset thai/latin/latin-ext · ~218 KB) + ไฟล์ .woff2 18 ไฟล์ · precache ใน sw.js → ทำงานออฟไลน์ได้จริง · อัปเดตฟอนต์ = โหลดชุดใหม่ทับ แล้ว bump VERSION ใน sw.js · Prompt / Noto Sans Thai ยังโหลดจาก Google Fonts เป็นตัวสำรองใน Fallback chain (ออฟไลน์จะถอยไป system-ui)

ระดับ ฟอนต์ ขนาด ลักษณะ
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

ปุ่มแชร์หน้านี้ (.mu-share-row / .mu-share-btn)

ใช้ร่วมทุกหน้า — / · /stops/:code · /routes/:id · /check/:id (ประกาศใน styles/_shared.css ไม่ใช่ CSS ของหน้าใดหน้าหนึ่ง — เคยหลุดไปอยู่ใน pages/home.css ทำให้หน้าอื่นไม่มีสไตล์)

  • variant = ปุ่มรอง (ghost) เพราะไม่ใช่ CTA หลักของหน้า — CTA หลักคือ topbar .mu-action-btn
  • พื้น --c-surface · ขอบ 1px solid --c-border · ตัวอักษร --c-brand-ink · weight 700
  • min-height: 44px (48px เมื่อ @media (pointer: coarse)) · padding: 10px 18px · gap: 6px
  • ไอคอน .ic 16px · font-size: .85rem · line-height: 1
  • hover = ขอบ #d8c9f2 + พื้น --c-surface-2 (ไม่มี shadow) · active = translateY(1px)
  • โฟกัส = outline: 2px solid var(--c-focus) + offset: 2px — ห้ามใช้สีดำ/เทา
  • ข้อความสถานะ .mu-share-status ใช้ --c-ink-2 · ลิงก์ที่คัดลอก .mu-share-url ใช้ mono + tabular-nums + word-break: break-all
  • ปุ่มแชร์ LINE ใช้ --c-brand-ink (ม่วง) — ไม่ใช้เขียว เพราะ DESIGN ใช้แอคเซนต์เดียว
  • มือถือ (<560px) = ปุ่มเต็มความกว้าง ข้อความชิดซ้าย

สเกลที่บังคับใช้ (radius / type)

หมวด ค่าที่อนุญาต โทเคน
มุมโค้ง 4px · 8px · pill เท่านั้น --radius-sm · --radius · --radius-pill
ขนาดตัวอักษร 0.72 · 0.78 · 0.85 · 0.95 · 1 · 1.1 · 1.2 · 1.35 · 1.5 · 1.6 · 1.8 · 2 · 2.2 rem —
ปุ่ม min-height 44px (48px จอสัมผัส) · radius 8px · font-size .85rem · weight 700 —
โฟกัส outline 2px solid var(--c-focus) · offset 2px —

ค่า 12/14/16/18/20/22px และ 0.68/0.7/0.74/0.8/0.82/0.9/1.05 ฯลฯ ถูกยุบในรอบปรับปรุงนี้ — ห้ามเพิ่มค่าใหม่นอกตาราง ถ้าจำเป็นให้เพิ่มในไฟล์นี้ก่อน

ชิปรหัส / เวลา (code chip / departure chip)

  • รหัสป้าย/เลขสาย: พื้น --grad-brand ตัวอักษรขาว mono 700
  • กลุ่มเวลาวางเป็น grid เรียงจากน้อยไปมาก

เลขสายหน้า /routes/:id — พื้นหลังตามหมวดเส้นทาง

เลขสาย (.mu-route-chip) เปลี่ยนสีพื้นหลังตาม หมวดเส้นทาง ที่ประกาศใน frontend/public/resource/data/routes.json → route_group (นิยามหมวดอยู่ที่ route_groups.json) เพื่อให้อ่านปราดเดียวรู้ว่าสายนั้นเป็นสายประเภทใด

หมวด (route_group) สี โทเคน คลาส CSS
bangkok — เข้ากรุงเทพฯ น้ำเงิน --group-bangkok .grp-bangkok
interprovincial — ระหว่างจังหวัด ม่วง --group-interprovincial .grp-interprovincial
in_province — ภายในจังหวัด ชมพู --group-in-province .grp-in_province
municipal — ภายในเทศบาล เทา (สำรอง) --group-municipal .grp-municipal
ไม่ระบุ / ไม่รู้จัก ม่วงแบรนด์ (ค่าเริ่มต้น) --grad-brand (ไม่มีคลาส)
  • ใช้เฉพาะ การ์ดหัวเรื่องหน้ารายละเอียดสาย (/routes/:id) — chip เล็กในหน้า /stops ยังใช้ม่วงแบรนด์
  • เพิ่มหมวดใหม่ = เพิ่ม route_group ใน route_groups.json + โทเคนสีใน §3 + กฎ .grp-<key> ใน busDetail.html
  • สีของหมวด ไม่ใช่ สีสถานะ — ห้ามนำไปใช้กับ badge สถานะ (§5 ป้ายสถานะ)

ป้ายสถานะ (status badge)

  • พื้นสีอ่อน (--green-50 / --red-50 / --amber-50) + ตัวอักษรสีเข้มของเฉดนั้น
  • ใช้เฉพาะบอกสถานะจริง ไม่ใช่แค่ตกแต่ง

หัวโซน (zone head) — ป้ายหัวข้อ + บรรทัดข้อมูล

ใช้กับทุกโซนที่มีป้ายกำกับ (.mu-zone-head) เช่น /check (ตารางเวลาเดินรถทุกจุดจอด) และ /routes/:id (แผนที่)

  • ป้ายหัวข้อ (.mu-zone-tag) — แคปซูลสีอ่อนตามโทนของโซน (tag-purple / tag-sky / tag-pink / tag-yellow)
  • บรรทัดข้อมูลต้องแยกเป็น "ชิ้น" (.mu-zone-seg) ไม่ใช่สตริงยาว ๆ ที่ต่อด้วย · เอง
    • เหตุผล: ภาษาไทยไม่มีเว้นวรรค → ถ้าเป็นสตริงเดียว เบราว์เซอร์จะ ตัดกลางชื่อสถานี
    • แต่ละชิ้นเป็น flex item → ตัดบรรทัดเป็นหน่วย · ตัวคั่น · วาดด้วย ::after (ท้ายชิ้น ไม่ขึ้นต้นบรรทัด)
    • ชิ้นที่เล็กลง (เช่น ชื่อสถานีในวงเล็บ .mu-zone-at) ช่วยให้บรรทัดจัดเรียงสวยขึ้น
  • มือถือ (<768px) — ป้ายหัวข้อบรรทัดบน · บรรทัดข้อมูลเต็มความกว้าง เรียงลงมา (flex + wrap)
  • จอใหญ่ (≥768px) — เปลี่ยนเป็น grid 2 คอลัมน์: ป้ายหัวข้อซ้าย · บรรทัดข้อมูลคอลัมน์ขวา · จำกัดความยาวบรรทัด max-width: 82ch (กันบรรทัดยาวเกินอ่านยาก)
  • ห้ามใช้ flex โดยไม่ใส่ flex-wrap ร่วมกับลูกที่เป็น flex-basis:100% (จะถูกบีบรวมแถวเดียว)

แถบนำทาง (topbar)

  • พื้น --paper (ขาว) ตัวอักษร --ink ขอบล่าง 1px solid --line
  • active menu = เส้นใต้ --purple
  • CTA "เช็กเวลาเดินรถ" = พื้น --grad-brand ตัวอักษรขาวหนา

เครื่องมือในแถบนำทาง — "ปุ่มละเรื่อง" (.mu-topbar-tools)

ห้ามวางกลุ่มปุ่มเรียงเป็นแถว (เช่น ปุ่มธีม 3 ปุ่ม + ปุ่มภาษา 2 ปุ่ม = 5 ปุ่ม) เพราะทำให้แถบนำทางแน่นและล้นบนจอเล็ก

ปุ่ม แสดง กดแล้ว
ธีม (.mu-pop-btn) ไอคอนของโหมดที่ใช้อยู่ (สว่าง/มืด/ตามเวลา) เปิดเมนู 3 ตัวเลือก role="menuitemradio"
ภาษา (.mu-pop-btn-lang) รหัสภาษาที่ใช้อยู่ (ไทย / EN) + chevron เปิดเมนู 2 ภาษา
  • มือถือ (<640px) — โลโก้ชิดซ้าย · (ธีม)(ภาษา)(3 ขีด) ชิดขวา โดย 3 ขีดอยู่ขวาสุด: flex-wrap: nowrap · margin-inline-start: auto ที่ .mu-topbar-tools · order: 2 (tools) / 3 (menu)
  • ≥640px — เมนู 3 ขีดซ่อน แสดง .mu-nav แทน · ≥1024px เพิ่มปุ่ม CTA
  • ปุ่มกลมเหลี่ยม height 40px · radius 8px · ขอบ --c-border · ตัวอักษร --c-brand-ink
  • จอสัมผัส → 44px
  • ระยะห่างระหว่างปุ่ม ≥ 8px (WCAG 2.5.8)
  • เมนู .mu-pop-panel ชิดขวา z-index: 1200 (เหนือ topbar 1100 · ใต้ visitor dialog 3000)
  • ปิดเมนูด้วย: เลือกแล้ว · คลิกนอก · Esc (คืนโฟกัสที่ปุ่ม)
  • ข้อความในเมนูมีทั้งไทยและอังกฤษกำกับ (.mu-pop-item-th / .mu-pop-item-en)

ปุ่มขอบ (.mu-btn.outline)

พื้นโปร่งใส + ขอบและตัวอักษร --c-brand-ink — ต้องมีกฎนี้เสมอ ถ้าไม่มี เบราว์เซอร์จะใส่พื้นเทาอ่อนเองและหลุดธีมในโหมดมืด

ฟอร์มค้นหา

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

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


9. รูปภาพ (Asset cache)

รูปทุกตัวเติม ?v=<เวอร์ชันแอป> อัตโนมัติผ่าน frontend/imageurl.js — เปลี่ยนรูปทับชื่อเดิมแล้ว ต้องรัน python resource/tools/bump-version.py เพื่อให้ทุกเครื่องเห็นของใหม่ (รายละเอียดใน AGENTS.md)