Files
sprinkler-calculation/DESIGN.md
T
2026-11-16 01:39:59 +07:00

84 lines
8.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# DESIGN.md — ค่าออกแบบของเว็บ farm-planning
> เวอร์ชัน 2 (16 พ.ย. 2026) — เปลี่ยนธีมเป็น **ฟ้า-ขาว** ตามที่ผู้ใช้กำหนด
> เอกสารนี้คือค่าที่ใช้จริงในโค้ด: ถ้าจะเปลี่ยน ต้องแก้ที่นี่ก่อน แล้วแก้โค้ดตาม
## 0. ที่มาของการตัดสินใจ (สำคัญ)
| ส่วน | มาจากไหน |
|---|---|
| **โครงสร้างหน้า** (Hero → เครื่องมือ/ฟีเจอร์ → ประโยชน์ → ความน่าเชื่อถือ → CTA) | `ui-ux-pro-max` pattern "Feature-Rich Showcase" + โครงหน้า `fastwork.com/selling` ที่ผู้ใช้ให้เป็นต้นแบบ (hero + service row + การ์ดหลักฐาน) |
| **ค่าสี / ฟอนต์ / รัศมี** | ผู้ใช้กำหนด "ธีม ฟ้า-ขาว" · โทเคนน้ำเงินมาจากพาเลตต์ SaaS (`#2563EB`) และตรวจคอนทราสต์ทุกคู่ด้วยการคำนวณ WCAG |
| **คู่สีที่ยืนยันแล้ว** | ขาว/`#2563EB` = 5.17:1 · ขาว/`#1D4ED8` = 6.70:1 · `#1D4ED8`/`#EFF6FF` = 6.16:1 · `#475569`/ขาว = 7.58:1 · `#1E293B`/`#F8FAFC` = 13.98:1 |
## 1. สี
| โทเคน | ค่า | ใช้ที่ |
|---|---|---|
| `--primary` | `#2563eb` | ปุ่มหลัก, พื้นหลังปุ่มติดตั้ง, ปุ่มขึ้นบน |
| `--primary-dark` | `#1d4ed8` | ตัวเลขผลลัพธ์, nav ที่ active, ลิงก์ hover |
| `--primary-soft` | `#eff6ff` | พื้นชิป/ป้าย, พื้น hover ของ nav, หัวการ์ด |
| `--primary-line` | `#bfdbfe` | ขอบชิป, ขอบปุ่มรอง, ขอบ hover |
| `--bg` | `#f8fafc` | พื้นหลังเว็บ (ทั้งแอป) |
| `--surface` | `#ffffff` | การ์ด, ฟอร์ม, footer |
| `--ink` | `#1e293b` | ตัวอักษรหลัก |
| `--muted` | `#475569` | คำอธิบาย/hint |
| `--line` | `#e2e8f0` | เส้นขอบ/เส้นคั่น |
| `--warn` / `--warn-soft` | `#b45309` / `#fffbeb` | กล่องคำเตือน |
| `--ok` / `--ok-soft` | `#166534` / `#f0fdf4` | ป้าย "ออนไลน์" |
| `--danger` / `--danger-soft` | `#b91c1c` / `#fef2f2` | ข้อความผิดพลาด |
`theme-color` (meta + manifest) = `#2563eb` · `background_color` (manifest) = `#f8fafc`
**ห้าม** ใช้สีส้ม `#F05F40` ของเทมเพลตเดิมในหน้าเว็บ — เป็นสีตกค้างจาก creative.css
(ตรวจแล้วทุกหน้าปัจจุบันไม่มี element ที่คำนวณออกมาเป็นสีนี้)
## 2. ฟอนต์
| ใช้ที่ | ฟอนต์ |
|---|---|
| เนื้อความ | `Sarabun` → `Kanit` → system-ui |
| หัวข้อ (h1–h5, `.page-title`, `.section-head h2`) | `Kanit` |
| ตัวเลขผลลัพธ์ / build badge | `font-variant-numeric: tabular-nums` / `ui-monospace` |
ขนาด: เนื้อความ 16px, line-height 1.6 · hero h1 1.65rem (มือถือ) → 2.15rem (≥640) → 2.5rem (≥1024)
· `.page-title` 1.55rem → 2rem · `.section-head h2` 1.35rem → 1.6rem
## 3. ระยะและรัศมี
- mobile-first: base = มือถือ, ขยายด้วย `@media (min-width: 640/768/1024px)` เท่านั้น
- รัศมี: `--r-sm` 8px (input, ชิป) · `--r-md` 12px (ปุ่ม, tool row) · `--r-lg` 16px (การ์ด, ฟอร์ม, ผลลัพธ์)
- เงา: `--shadow-sm` (การ์ดปกติ) → `--shadow-md` (hover, ปุ่มลอย) — ไม่ใช้เงาหนัก
- ทุกปุ่ม/ช่องกรอก/แถวที่กดได้สูง **≥ 44px** (วัดที่ 360/768/1280 แล้ว)
- `.view-root` padding-top 64px (68px ที่ ≥1024) เผื่อ navbar fixed
## 4. คอมโพเนนต์
| ชื่อ | กติกา |
|---|---|
| `#mainNav` | พื้นขาว 96% + เส้นขอบล่าง · แบรนด์สีน้ำเงิน / น้ำหนัก 600 · ลิงก์เทา `--muted` / active = พื้น `--primary-soft` + น้ำเงิน (ไม่ใช้สีพื้นทึบ) |
| `.hero` | พื้น gradient ฟ้าอ่อน + radial จากมุมซ้ายบน, ปิดท้ายด้วยเส้นขอบล่าง · `.hero-eyebrow` ชิป, `.hero h1` มี `<strong>` เป็นสีน้ำเงิน, `.hero-cta` 2 ปุ่ม, `.hero-stats` 2→4 คอลัมน์ |
| `.tool-row` | แถวเครื่องมือแบบ service row: ไอคอน 44px ในพื้นฟ้าอ่อน + ชื่อ + meta + ปลายทาง ("คำนวณ →") · hover ยกขึ้น 1px + เงา · `.tool-row--soon` จาง + กดไม่ได้ + `.chip--soon` |
| `.card` | พื้นขาว ขอบ `--line` รัศมี 16px · hover เปลี่ยนขอบเป็น `--primary-line` + เงา · การ์ดที่เป็นลิงก์ทั้งใบให้สีตัวอักษรเป็น `inherit` |
| `.feature-card` | การ์ด 3 ใบในส่วน "ตัวเลขที่ให้ไป ตรวจย้อนได้" · มี `.feature-card__num` วงกลมเลขลำดับ |
| `.calc` | ฟอร์มในการ์ดขาว: 1 คอลัมน์ → 2 คอลัมน์ที่ ≥640 · ปุ่ม/ช่องเต็มความกว้างด้วย `.field--wide` |
| `.result` | การ์ดขาว ขอบซ้าย 4px สี `--primary` · `.result-value` 1.9rem ตัวหนา สี `--primary-dark` |
| `.steps` | ตาราง "ที่มาของค่า" — แถวสลับสีอ่อน, คอลัมน์ขวาชิดขวา + tabular-nums |
| `.warn-list` | กล่องเหลืองอ่อน ขอบ `#fde68a` ตัวอักษร `--warn` · ซ่อนด้วย `hidden` + `[hidden]{display:none}` |
| `#install-btn` | มือถือเต็มความกว้างล่างจอ / ≥640px กว้าง 15rem มุมขวาล่าง · พื้น `--primary` |
| `#myBtn` | ปุ่มลอยมุมขวาล่าง ทรงแคปซูล พื้น `--primary` |
## 5. Interaction / a11y
- ระยะเปลี่ยนสถานะ 150–200ms (hover/press), ปุ่มกดแล้วขยับ 1px
- `:focus-visible` = outline 2px `--primary` + offset 2px (ไม่ลบ focus ring)
- `prefers-reduced-motion: reduce` → ปิด transition/animation และ scroll แบบ smooth
- ไม่ใช้ emoji เป็นไอคอน · ไอคอนใช้ SVG ในโปรเจกต์ (`flat icon/`) ที่อยู่ใน PRECACHE
- ภาษาไทยบนหน้าเว็บ: ใช้ "ต้นทาง/กลางทาง/ปลายทาง" ไม่ใช้ "จุดเปลี่ยน"; เลี่ยงคำอังกฤษลอย (คำเทคนิคที่จำเป็นให้คงไว้พร้อมคำอธิบาย)
## 6. ข้อห้าม
- ห้าม hardcode สีใน partial — ใช้ตัวแปรจาก `:root` ใน `assets/css/app.css`
- ห้ามใส่ `!important` ยกเว้นกรณีชนกับ `css/creative.css` ของเทมเพลตเดิม (ระบุเหตุผลในคอมเมนต์)
- ห้ามเพิ่มไลบรารี UI ใหม่ถ้าเขียน vanilla CSS ได้