Files
hobbypj-contents/DESIGN.md
T
Bkk1234 c00bc62272 feat: hobby project landing page (PWA + SPA) with admin backoffice
- landing page: welcome hero, live search, project card grid (10 projects from owner list)
- warm brown/white theme (fastwork-inspired layout), embedded K2D Thai font
- PWA: manifest, PIL-generated icons, versioned service worker with auto-update
- backoffice at #/admin: edit name/description/url, reorder, delete, publish
- server/publish.mjs: zero-dependency static server + PUT api/projects with
  validation, JSON write, git commit and push; loopback-only unless ADMIN_TOKEN
- docs: README, DESIGN.md (color/type contract), AGENTS.md
2026-11-19 01:03:13 +07:00

76 lines
7.6 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 — กติกาการออกแบบ (ใช้กับทุกหน้าในโปรเจคนี้)
เอกสารนี้คือ “รัฐธรรมนูญ” ของหน้าตา เว็บนี้ ถ้าจะเปลี่ยนสี ระยะ หรือส่วนประกอบ ต้องแก้ไฟล์นี้ก่อนแล้วจึงแก้โค้ด
## 1. แนวคิด
- เว็บรวมโปรเจคอดิเรกส่วนตัว: **เรียบ อบอุ่น อ่านง่าย** ไม่ใช่เว็บขายของ
- โครงหน้าและจังหวะการวางอ้างอิง **fastwork.com** (ฮีโร่ + ช่องค้นหา + การ์ดเป็นตาราง + ฟุตเตอร์ 3 คอลัมน์)
- ธีมสี: **น้ำตาล + ขาว** เลือกเฉดน้ำตาลที่ “สดและสว่าง” (โมก้า-คาราเมล) หลีกเลี่ยงน้ำตาลเข้มแบบซีเปีย/วินเทจที่สื่อถึงความเก่า
- ภาษาไทยทั้งหน้า ไม่มีคำอังกฤษลอยเป็นป้าย/หัวข้อ (ชื่อโดเมนและคำเทคนิคเท่านั้นที่คงอังกฤษ)
## 2. โทเคนสี (ตรวจคอนทราสต์บนพื้นขาวแล้ว)
| โทเคน | ค่า | คอนทราสต์บน #FFFFFF | ใช้กับ |
|---|---|---|---|
| `--brand-50` | `#FDF7F2` | — | พื้นอ่อน, พื้นไอคอน |
| `--brand-100` | `#FAEADF` | — | ป้ายนับจำนวน, พื้น chip ที่เลือก |
| `--brand-200` | `#F3D5C1` | — | เส้นขอบอ่อน |
| `--brand-300` | `#E8B695` | — | เส้นขอบ hover |
| `--brand-400` | `#D99368` | 2.52:1 | **กราฟิกเท่านั้น ห้ามใช้เป็นตัวอักษร** |
| `--brand-500` | `#C4703C` | 3.66:1 | ไอคอน/เส้นตกแต่ง (ไม่ใช่เนื้อหา) |
| `--brand-600` | `#A85A2C` | 5.04:1 | ตัวอักษรเน้น, โฟกัสริง |
| `--brand-700` | `#8A4722` | 6.99:1 | ปุ่มหลัก, ลิงก์ |
| `--brand-800` | `#6B3620` | 9.66:1 | หัวข้อย่อย, ตัวอักษรเน้นเข้ม |
| `--brand-900` | `#3D241A` | 14.33:1 | หัวข้อหลัก |
| `--foreground` | `#241A15` | 17.02:1 | เนื้อความ |
| `--muted-foreground` | `#6F6159` | 5.95:1 | คำอธิบาย, ข้อความรอง |
| `--border` | `#EADFD6` | — | เส้นขอบการ์ด |
| `--border-strong` | `#DCCABA` | — | ขอบช่องกรอก/เส้นแบ่งที่ต้องเห็นชัด |
| `--surface-2` | `#FBF6F1` | — | พื้นพาเนล/ฟุตเตอร์ |
กติกา: ตัวอักษรทุกตัวต้อง ≥ 4.5:1 บนพื้นของตัวเอง · ปุ่มหลักใช้พื้น `--brand-700` + ตัวอักษรขาว (6.99:1)
## 3. ตัวอักษร
- ฟอนต์: **K2D** (ฝังใน `fonts/`, 3 น้ำหนัก: 400 / 500 / 700) — ไทยมีหัว อ่านง่ายบนจอเล็ก
- ฐาน: `16px`, `line-height 1.6`; หัวข้อ `line-height 1.25` และ `letter-spacing` ติดลบเล็กน้อย
- หัวเรื่องฮีโร่: `clamp(1.6rem, 1.15rem + 2.05vw, 2.5rem)` กว้างสุด `24ch` (ข้อความต้อนรับยาว จึงต้องคุมความกว้าง)
- ห้ามใช้ตัวอักษรเล็กกว่า 12px ในเนื้อหา
## 4. ระยะ / มุม / เงา
- สเกลระยะ: 4 · 8 · 12 · 16 · 20 · 24 · 32 · 40 · 48 · 64 · 80 px
- มุมโค้ง: `8 / 12 / 16 / 22 / pill` — การ์ดใช้ 16, ช่องกรอกใช้ 12, ปุ่มใช้ pill
- เงา: ใช้เฉพาะตอนยกการ์ดขึ้น (hover) และปุ่มหลัก — ไม่ใส่เงาซ้อนหลายชั้น
## 5. ส่วนประกอบ
- **Header**: สูง 64px (มือถือ) / 72px (≥900px), sticky, พื้นขาว 92% + blur, ขอบล่าง 1px
- **ปุ่ม**: สูงขั้นต่ำ 44px (44×44 ตาม WCAG 2.5.8) · `primary` (น้ำตาลเข้ม+ขาว) · `ghost` (ขาว+ขอบ) · `quiet` · `danger`
- **ช่องค้นหา**: pill, เงา, ไอคอนซ้าย, ปุ่มล้างคำค้นหา 32×32 (มี label ให้ screen reader)
- **การ์ดโปรเจค**: ไอคอน 46×46 (พื้น `--brand-50`), ชื่อเป็นลิงก์ที่ขยายพื้นที่คลิกเต็มใบด้วย `::after`, คำอธิบาย 3 บรรทัดตัดด้วย `-webkit-line-clamp`, ท้ายการ์ดมี host + “เปิดเว็บไซต์”
- **ฮีโร่**: พื้นไล่เฉดอุ่นอ่อน + การ์ดลอย 3 ใบจากข้อมูลจริง (แสดงเฉพาะ ≥1080px, `aria-hidden`)
- **หลังบ้าน**: พาเนล + การ์ดรายการ, ปุ่มเลื่อนขึ้น/ลง/ลบ, แถบบันทึกแบบ sticky ด้านล่าง, `<dialog>` ยืนยันการลบ/ทิ้งการแก้ไข
## 6. สิ่งที่ห้าม
- ห้ามใช้อิโมจิเป็นไอคอน (ใช้ SVG เส้น 1.7px ใน `ui/ui.js`)
- ห้ามใช้สีน้ำตาลเข้ม `#3E2A20`-ลงไปเป็นพื้นปุ่มใหญ่ (ดูแก่) — ใช้ได้แค่ตัวอักษร
- ห้ามใส่คำอังกฤษลอยเป็นหัวข้อ/ป้ายบนหน้าไทย
- ห้ามลบ focus ring; ทุกองค์ประกอบที่โฟกัสได้ต้องเห็น ring น้ำตาล
- ห้ามใช้ `transform`/animation กับการเปลี่ยน layout; ต้องเคารพ `prefers-reduced-motion`
## 7. Responsive
- มือถือก่อน: การ์ด 1 คอลัมน์ (<700px) → 2 (≥700px) → 3 (≥1000px)
- การ์ดลอยในฮีโร่แสดงเฉพาะ ≥1080px
- ตรวจที่ 375 / 768 / 1024 / 1440 px และต้องไม่มี horizontal scroll
## 8. PWA
- `manifest.json`: `display: standalone`, `start_url: ./`, `theme_color: #8A4722`
- ไอคอน PNG จริง 192 / 512 / 512-maskable / 180 (สร้างจาก `make_icons` ด้วย PIL ไม่ใช้ตัวอักษร)
- `sw.js`: network-first สำหรับ HTML/CSS/JS/JSON, cache-first สำหรับรูป/ฟอนต์, ข้าม `/api/`
- แก้ `sw.js` หรือรายการ `PRECACHE` → ต้อง bump `VERSION` และ `<meta name="app-version">` พร้อมกัน