- Compress resource/images/ (~31MB) into resource/images.zip and untrack the 62 individual binaries so future image changes do not bloat git history - Add setup.sh to unpack the zip after clone (idempotent) - gitignore resource/images/ and .DS_Store - Document run + image-management steps in README.md
3.8 KiB
3.8 KiB
web-at-transit-mock
Static HTML mockup / ดีไซน์ต้นแบบเว็บข้อมูลการเดินรถ — สถานีขนส่งผู้โดยสารจังหวัดอ่างทอง (AT Transit)
repo นี้เป็น static HTML + vanilla JS (ไม่มี backend / framework / build step) ส่วน implementation จริง (Next.js) อยู่ที่
web-at-transit
โครงสร้าง
web-at-transit-mock/
├── maintheme.png ← ภาพธีม/ดีไซน์ต้นแบบ
├── ui/ ← Single-page app (hash router)
│ ├── index.html shell หน้าเดียว
│ ├── router.js / i18n.js / pwa.js / sw.js
│ ├── _shared.css / responsive.css
│ └── partials/ view ละ 1 ไฟล์ (router fetch + inject)
└── resource/
├── data/ ← ข้อมูล mock: routes.json, schedules.json, stations.json, ...
├── images.zip ← ★ รูปทั้งหมด (บีบไว้ — แตกด้วย setup.sh)
└── images/ ← (เกิดหลังรัน setup.sh — ไม่ commit)
วิธี run
cd web-at-transit-mock
./setup.sh # 1. แตก resource/images.zip → resource/images/ (ครั้งเดียว)
python3 -m http.server 8090 # 2. รัน static server
แล้วเปิดเบราว์เซอร์ที่:
http://localhost:8090/ui/index.html
เงื่อนไขสำคัญ
- ต้องรัน
./setup.shก่อน — ไม่งั้นรูปพังทั้งหน้า (relative path../resource/images/...หาไฟล์ไม่เจอ) - ต้อง serve จาก root ของ repo (ไม่ใช่จาก
ui/) — รูปและข้อมูลอ้างอิงด้วย relative path - ห้ามเปิด
file://— fetch JSON + relative path จะใช้ไม่ได้ ต้องผ่าน static server เสมอ - เปลี่ยน port ได้โดยแก้เลข
8090(เช่นpython3 -m http.server 8080)
การจัดการรูปภาพ (images)
รูปทั้งหมด (~31MB) ถูกบีบเป็นไฟล์เดียว resource/images.zip เพื่อไม่ให้ git พองจาก binary:
-
แตกไฟล์:
./setup.sh(idempotent — ถ้ามีresource/images/แล้วจะข้าม) -
เพิ่ม/เปลี่ยนรูป: แก้ที่
resource/images/แล้ว re-zip:cd resource && zip -r -X images.zip images -x "*.DS_Store"แล้ว commit
resource/images.zip -
ห้าม commit ไฟล์ใน
resource/images/— อยู่ใน.gitignoreแล้ว
หมายเหตุ (ไม่ต้องแก้)
ui/index.htmlอ้าง../../frontend-web-transit/web-transit/css/main-theme.css— ไฟล์นี้ไม่อยู่ใน repo (ดู AGENTS.md ข้อ 12) จะขึ้น 404 ใน DevTools แต่ไม่กระทบ การแสดงผล เพราะสไตล์จริงอยู่ที่_shared.css- Google Fonts (
fonts.googleapis.com) ต้องต่อเน็ต — ถ้า offline ฟอนต์จะ fallback เป็น system font แต่หน้าไม่พัง - รายละเอียดกฎการแก้โค้ดฉบับเต็ม ดูใน
AGENTS.mdและDESIGN.md