1cfaeb152672d6c32abcb2d5d2268f2cfcd243fa
Schedules — กติกา "จุดนี้ = เวลาจุดอ้างอิง ± n นาที"
- ฟิลด์ derive { from_station_id, offset_min } คำนวณที่ ui/partials/schedules.js (ท่อเดียว) รองรับอ้างจุดข้ามทิศ
- จุดย่อยของ "8 other_stop" ใช้ offsets_min จับคู่ตามลำดับ (เช่น ตลาดสามโก้ = ตลาดท่าช้าง +45 นาที)
- เครื่องมือ resource/tools/derive-times.py + ตาราง resource/data/derive-times.csv (--check / --audit ชี้จุดที่ควรตั้งกฎ)
- แยกตารางเป็นรายสาย: scheduleslist/schedules<route_id>.json และ schedules.json เป็นสารบัญ (โหลดแบบ lazy + cache)
- ตรวจจับวันทำงาน/วันหยุด + schema 3 (weekday/holiday → directions) · ไฟล์ข้อมูลเป็น CRLF ทั้งชุด
- ล้างค่าที่ไม่ใช่ HH:MM ที่ฝังใน times (ทำให้ KPI เพี้ยน) + กันค่าหลอกในตัวสรุปเวลา
UI
- หน้ารายละเอียดป้าย/ตารางเวลา ขับเคลื่อนด้วย JSON (stopDetail.init.js) · จุดขึ้นรถประจำทางอื่นๆ รองรับหลายจุดต่อสาย
- #/stops: แสดง 6 ป้ายแรก + ปุ่ม "แสดงป้ายทั้งหมด" (โหลดรูปเฉพาะที่แสดง) · ชิปสาย → #/routes/<route_id>
- หน้าแรก: ตัดตัวเลือก "ทุกสถานีในจังหวัดนี้" · ตัวกรองจังหวัด/สถานี + ปุ่มแชร์ (share URL)
- การ์ดติดต่อ: ไอคอน/ชื่อ/สีเปลี่ยนตามชนิด URL (Facebook / LINE / เว็บไซต์) + ปุ่มเปิดลิงก์จาก web_url
- รูปรองรับหลายนามสกุล (.jpg → .jpeg → .webp → .png) · ป้าย "ประมาณ" + หมายเหตุสำหรับตารางที่คำนวณ
- หน้าเครดิตเหลือ 3 หมวด · แก้ข้อความหมวดแผนที่ให้ตรงกับข้อมูลจริง
- แผนที่ Leaflet (vendor ในโปรเจกต์ ไม่ใช้ CDN): เส้นทาง + หมุด + ป๊อปอัป · แก้ CSS ที่ทำให้ SVG ยุบ 0x0
เครื่องมือและเอกสาร
- qgis-to-web.py อ่าน .shp ตรง → geojson-web (สร้างใหม่ 10 ไฟล์) + audit-geojson.py ตรวจ 3 ส่วน
- stop-km.py วัดระยะ กม. ตามเส้นจริง → stop-km.json · schedules-editor.html (แก้ทีละไฟล์ · มุมมองตารางแบบ Excel)
- AGENTS.md: กติกา derive · offsets_min · นามสกุลรูป · ชิปสาย · หน้ารายละเอียดป้ายมาจากไหน
web-at-transit-mock
Static HTML mockup / ดีไซน์ต้นแบบเว็บข้อมูลการเดินรถ — สถานีขนส่งผู้โดยสารจังหวัดอ่างทอง (Atroute)
repo นี้เป็น static HTML + vanilla JS (ไม่มี backend / framework / build step) ส่วน implementation จริง (Next.js) อยู่ที่
web-at-transit
โครงสร้าง
web-at-transit-mock/
├── maintheme.png ← ภาพธีม/ดีไซน์ต้นแบบ
├── Makefile ← คำสั่งรวม (make setup / pack / serve)
├── 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 ← ★ รูปทั้งหมด (บีบไว้ — แตกด้วย make setup)
└── .image/ ← รูปทั้งหมด (hidden — เกิดหลัง make setup, ไม่ commit)
วิธี run
cd web-at-transit-mock
make setup # 1. แตก resource/images.zip → .image/ (ครั้งเดียว)
make serve # 2. รัน static server (Ctrl+C เพื่อหยุด)
แล้วเปิดเบราว์เซอร์ที่:
http://localhost:8090/ui/index.html
ดูคำสั่งทั้งหมด: make help
เงื่อนไขสำคัญ
- ต้องรัน
make setupก่อน — ไม่งั้นรูปพังทั้งหน้า (relative path../.image/...หาไฟล์ไม่เจอ) - ต้อง serve จาก root ของ repo (ไม่ใช่จาก
ui/) — รูปและข้อมูลอ้างอิงด้วย relative path - ห้ามเปิด
file://— fetch JSON + relative path จะใช้ไม่ได้ ต้องผ่าน static server เสมอ - เปลี่ยน port ได้ด้วย
make serve PORT=8080
การจัดการรูปภาพ (images)
รูปทั้งหมด (~31MB) อยู่ใน folder hidden .image/ (ถูก .gitignore → ไม่ push ขึ้น git)
โดยแจกผ่านไฟล์เดียว resource/images.zip:
-
แตกไฟล์ (ครั้งแรกหลัง clone):
make setup -
เพิ่ม/เปลี่ยนรูป: แก้ไฟล์ใน
.image/แล้ว re-zip:make 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
Languages
JavaScript
43.8%
HTML
37.5%
Python
11.2%
CSS
7.2%
Shell
0.2%
Other
0.1%