Files
web-at-transit-mock/README.md
T
phattaranun.a dd27606d43 Add setup.sh pack mode and clarify README image workflow
- setup.sh now supports `./setup.sh pack` to re-zip .image/ into
  resource/images.zip (cds to repo root, guards missing .image/, removes
  stale zip first)
- README: document extract-then-edit-then-pack order instead of the raw
  zip command that failed on a fresh clone
2026-09-12 15:23:26 +07:00

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)
└── .image/                  ← รูปทั้งหมด (hidden — เกิดหลังรัน setup.sh, ไม่ commit)

วิธี run

cd web-at-transit-mock
./setup.sh                      # 1. แตก resource/images.zip → .image/ (ครั้งเดียว)
python3 -m http.server 8090     # 2. รัน static server

แล้วเปิดเบราว์เซอร์ที่:

http://localhost:8090/ui/index.html

เงื่อนไขสำคัญ

  1. ต้องรัน ./setup.sh ก่อน — ไม่งั้นรูปพังทั้งหน้า (relative path ../.image/... หาไฟล์ไม่เจอ)
  2. ต้อง serve จาก root ของ repo (ไม่ใช่จาก ui/) — รูปและข้อมูลอ้างอิงด้วย relative path
  3. ห้ามเปิด file:// — fetch JSON + relative path จะใช้ไม่ได้ ต้องผ่าน static server เสมอ
  4. เปลี่ยน port ได้โดยแก้เลข 8090 (เช่น python3 -m http.server 8080)

การจัดการรูปภาพ (images)

รูปทั้งหมด (~31MB) อยู่ใน folder hidden .image/ (ถูก .gitignore → ไม่ push ขึ้น git) โดยแจกผ่านไฟล์เดียว resource/images.zip:

  • แตกไฟล์ (ครั้งแรกหลัง clone):

    ./setup.sh
    
  • เพิ่ม/เปลี่ยนรูป: แก้ไฟล์ใน .image/ แล้ว re-zip:

    ./setup.sh pack
    

    แล้ว commit resource/images.zip

  • ห้าม commit ไฟล์ใน .image/ — อยู่ใน .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