- Rename resource/images/ to .resource/ (dot-prefixed, gitignored, never pushed) - Repackage resource/images.zip to contain .resource/ at the archive root - Update setup.sh to extract the zip to .resource/ - Update all image references from ../resource/images/ to ../.resource/ across ui HTML, manifest.json and sw.js - Sync .gitignore, README.md and AGENTS.md with the new layout
68 lines
3.8 KiB
Markdown
68 lines
3.8 KiB
Markdown
# 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)
|
|
└── .resource/ ← รูปทั้งหมด (hidden — เกิดหลังรัน setup.sh, ไม่ commit)
|
|
```
|
|
|
|
## วิธี run
|
|
|
|
```bash
|
|
cd web-at-transit-mock
|
|
./setup.sh # 1. แตก resource/images.zip → .resource/ (ครั้งเดียว)
|
|
python3 -m http.server 8090 # 2. รัน static server
|
|
```
|
|
|
|
แล้วเปิดเบราว์เซอร์ที่:
|
|
|
|
```
|
|
http://localhost:8090/ui/index.html
|
|
```
|
|
|
|
### เงื่อนไขสำคัญ
|
|
|
|
1. **ต้องรัน `./setup.sh` ก่อน** — ไม่งั้นรูปพังทั้งหน้า (relative path `../.resource/...` หาไฟล์ไม่เจอ)
|
|
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 `.resource/` (ถูก `.gitignore` → ไม่ push ขึ้น git)
|
|
โดยแจกผ่านไฟล์เดียว `resource/images.zip`:
|
|
|
|
- **แตกไฟล์**: `./setup.sh` (idempotent — ถ้ามี `.resource/` แล้วจะข้าม)
|
|
- **เพิ่ม/เปลี่ยนรูป**: แก้ที่ `.resource/` แล้ว re-zip:
|
|
|
|
```bash
|
|
zip -r -X resource/images.zip .resource -x "*.DS_Store"
|
|
```
|
|
|
|
แล้ว commit `resource/images.zip`
|
|
- **ห้าม commit ไฟล์ใน `.resource/`** — อยู่ใน `.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`
|