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 · นามสกุลรูป · ชิปสาย · หน้ารายละเอียดป้ายมาจากไหน
34 KiB
AGENTS.md — คำสั่งสำหรับ AI coding agent
โปรเจกต์: web-at-transit-mock — mockup/ดีไซน์ HTML ต้นแบบของเว็บข้อมูลการเดินรถ สถานีขนส่งผู้โดยสารจังหวัดอ่างทอง (Atroute)
หมายเหตุ: repo นี้เป็น static HTML mockup (ยังไม่มี backend / framework) ส่วน implementation จริง (Next.js) อยู่ที่
web-at-transit— เวลาทำงานกับ repo นี้ ให้แก้ HTML/CSS ตรง ๆ อย่าแนะนำให้ย้ายไป framework
อ่านไฟล์นี้ก่อนทำงานเสมอ เพื่อประหยัด token อย่าเดาโครงสร้าง
โครงสร้าง
web-at-transit-mock/
├── maintheme.png ← ภาพธีม/ดีไซน์ต้นแบบ (เปิดดูเพื่อจับอารมณ์สีและ layout)
├── ui/ ← ★ Single-page app (static HTML + vanilla JS)
│ ├── index.html SHELL หน้าเดียว — header + <div id="view"> + footer
│ ├── router.js hash router: สลับ view โดยไม่โหลดหน้าใหม่
│ ├── sw.js / pwa.js / manifest.json ← PWA + อัปเดตอัตโนมัติ (ดูข้อ 11)
│ ├── _shared.css สไตล์ร่วมทุก view (โหลดจาก shell)
│ ├── responsive.css ★ Mobile-first layer — base = iPhone 8 (375px)
│ │ ขยายตาม min-width: 480/640/768/1024/1280/1600px
│ │ (component ใน #view ต้องใช้ prefix `#view`)
│ ├── partials/ ★ view ละ 1 ไฟล์ (router fetch + inject ที่ #view)
│ │ ├── home.html + home.init.js ← #/ (selectors + marquee)
│ │ ├── busStop.html ← #/stops
│ │ ├── busDetail.html ← #/routes, #/routes/:id
│ │ ├── busDetailExpanded.html ← #/routes/expanded
│ │ ├── stopDetail.html ← #/stops/:code
│ │ ├── credits.html ← #/credits
│ │ └── icons-sprite.svg ← Lucide sprite
│ ├── busStop.html / busDetail.html / ... ← เหลือแค่ redirect stub → #/...
├── resource/
│ ├── data/ ข้อมูล mock: routes.json, schedules.json, stations.json,
│ │ provinces.json, route_groups.json
│ └── images.zip ← รูปทั้งหมดบีบรวม (แตกด้วย setup.sh)
└── .image/ ← รูปทั้งหมด (hidden — เกิดหลังรัน setup.sh, ไม่ commit)
ทุกหน้าเป็น hash URL (#/stops, #/routes/101, #/stops/at_main_terminal) —
ลิงก์ภายในทั้งหมดเป็น <a href="#/..."> ไม่มีการโหลดหน้าใหม่เลย (no reflash)
วิธีเปิดดูผลงาน
cd D:\Git\web-at-transit-mock
python -m http.server 8090 # เปิด http://localhost:8090/ui/index.html
(ใช้ static server เสมอ — ห้ามเปิด file:// เพราะ relative path และ fetch JSON จะพัง)
กฎบังคับ
- ห้ามใส่ framework/build step — repo นี้เป็น static HTML + vanilla JS เท่านั้น
- ทุกหน้าเป็น SPA view ผ่าน hash router — ห้ามสร้างไฟล์ HTML หน้าใหม่
ถ้าจะเพิ่มหน้าจอใหม่: สร้าง
partials/<view>.html(+<script>/<style>ในไฟล์นั้น) แล้วเพิ่ม route ในui/router.js(VIEWS + parseHash) - ลิงก์ภายในใช้
href="#/..."เสมอ — ห้ามhref="./xxx.html"(จะโหลดหน้าใหม่) และห้ามlocation.href/location.replaceไปหน้า html ยกเว้นใน redirect stub <style>และ<script>ของ view ให้อยู่ใน partial ของมัน — router inject แล้ว รัน<script>ให้อัตโนมัติ ถ้า script ต้องอ่าน params ให้ใช้window.__route- ทุกหน้าโหลด
_shared.css— สไตล์ร่วมต้องอยู่ที่นี่ ไม่ใช่ inline ในแต่ละหน้า (ยกเว้นสไตล์เฉพาะหน้าที่จำเป็นจริง ๆ ให้อยู่ใน<style>ใน partial) - class ที่ขึ้นต้น
mu-= component ร่วม (เช่น.mu-card,.mu-cover,.mu-hero) — ถ้าจะเพิ่ม component ใหม่ ใช้ prefixmu-ด้วย - รูปอ้างอิงผ่าน
../.image/...— อย่า copy รูปเข้า ui/ - ข้อมูลตัวอย่างมาจาก
resource/data/*.json— ถ้าจะเพิ่มเส้นทาง/ป้าย ต้องเพิ่มข้อมูล ใน JSON ให้ตรงกัน (ไม่ hardcode เฉพาะหน้า) - ข้อความ UI เป็นภาษาไทย — ภาษาอังกฤษใช้เป็น label รองเท่านั้น
- อ่าน
DESIGN.mdก่อนแก้ UI ทุกครั้ง — มีกฎ "ห้ามทำ" ที่กันสไตล์ AI genric และโทเคนสี/ฟอนต์ตายตัว - ไอคอนใช้ระบบ Lucide sprite เท่านั้น — ห้ามใช้ emoji แทนไอคอน (DESIGN.md ข้อ 4):
- ไอคอนต้นฉบับ (MIT):
.image/icons/lucide/ - sprite:
ui/partials/icons-sprite.svg(symbol ชื่อic-<ชื่อ>) - ใช้งาน:
<svg class="ic" aria-hidden="true"><use href="#ic-ชื่อ"/></svg>(CSS.icใน_shared.css) - เพิ่มไอคอนใหม่: ดาวน์โหลดจาก https://lucide.dev → เก็บ SVG ใน
.image/icons/lucide/→ เพิ่ม<symbol>ใน sprite → อัปเดตรายการในui/credits.html
- ไอคอนต้นฉบับ (MIT):
main-theme.css(อ้างอิงจาก HTML) ไม่อยู่ใน repo นี้ — ถ้าแก้สไตล์ให้แก้ที่_shared.cssแทน อย่าไปสร้าง main-theme.css ใหม่- PWA / Service Worker (ui/sw.js) — ห้ามแก้กลไกโดยไม่เข้าใจ:
- HTML/CSS/JS/partials/JSON → network-first (ออนไลน์ได้ของใหม่เสมอ, ออฟไลน์ใช้ cache)
- รูป/ฟอนต์ → cache-first
- เนื้อหา HTML/CSS/JS เปลี่ยน = เห็นผลทันทีโดยผู้ใช้ไม่ต้องล้างแคช (network-first)
- เฉพาะแก้
sw.jsเองเท่านั้น ต้อง bumpVERSIONใน sw.js (เช่น2026.09.02.9) → cache ใหม่ถูกสร้าง + cache เก่าถูกลบอัตโนมัติตอน activate - อย่าลืม: ทุกหน้า HTML ต้องมี
<link rel="manifest">+<script src="./pwa.js">(ถ้าสร้างหน้าใหม่) และถ้าเพิ่มไฟล์ shell (หน้า/partial/CSS/JS หลัก) ให้เพิ่มในPRECACHE
- หลายภาษา (i18n) — ระบบอยู่ใน
ui/i18n.js(ไทย/อังกฤษ):- ข้อความ UI ห้าม hardcode ภาษาเดียว — ใช้
data-i18n="key"บน element (ข้อความ) หรือdata-i18n-attr="placeholder:key,aria-label:key"(attribute) - ตัวเลขในข้อความ:
data-i18n="key" data-i18n-n="6"→ dict ใช้{n}(เช่น... · {n} เส้นทาง) - เพิ่มคำแปล: เติม key ใน
DICT.th+DICT.enในui/i18n.js(key หาย = แสดง key เปล่า ๆ ให้เห็นชัด) - ข้อความที่ JS สร้าง: เรียก
window.I18N.t('key', {n})(ดูpartials/home.init.js) - ภาษาเริ่มต้น: อ่านจาก
localStorage('at_lang')→ ถ้าไม่มี ใช้ภาษา browser (navigator.language) - ปุ่มสลับ:
<button data-i18n-switch="en">EN</button>— เปลี่ยนภาษาแล้ว router จะ render หน้าใหม่ให้อัตโนมัติ (ฟัง eventlangchange) - ชื่อเฉพาะ (ชื่อสถานี/จังหวัด/สายรถ) ไม่ต้องแปล — คงภาษาไทย
- ข้อความ UI ห้าม hardcode ภาษาเดียว — ใช้
ข้อมูลเส้นทางจาก GIS (QGIS → GeoJSON → แผนที่)
- ห้ามแก้
resource/data/geojson-web/*.geojsonด้วยมือ — เป็นไฟล์ที่ "สร้าง" จาก shapefile ในresource/data/QGIS Project/*.shp(ตารางจับคู่SHP_MAPอยู่ในสคริปต์) — user แก้ใน QGIS แล้วกด Save - แปลง/อัปเดตด้วยคำสั่งเดียว (ไม่ใช่ build step ของเว็บ — รันมือเมื่อข้อมูลเส้นเปลี่ยน):
python resource/tools/qgis-to-web.py --check # ตรวจก่อน (ไม่เขียนไฟล์) — "เหมือนเดิม ✓" = ไม่มีอะไรเปลี่ยน python resource/tools/qgis-to-web.py # เขียนจริง (--from geojson = ทางเดิมผ่าน GeoJSON-2/) python resource/tools/qgis-to-web.py --list # ดูตารางรหัสสาย ↔ ไฟล์ .shp - สคริปต์จะปฏิเสธไฟล์ที่ CRS ไม่ใช่ WGS84 (พิกัดเป็น UTM) และตัดจุดที่หลุดกรอบประเทศไทย
- ตรวจสุขภาพข้อมูลก่อนใช้:
python resource/tools/audit-geojson.py(CRS · พิกัดว่าง/ซ้ำ · ช่วงเส้นตัดตรง · ปลายเส้นตรงจุดจอดไหม · ไฟล์ซ้ำ/ไม่ถูกใช้) - กติกา + ตารางเลเยอร์↔รหัสสาย + วิธี export:
resource/data/QGIS Project/GeoJSON-2/README.md - แผนที่ใช้ Leaflet (vendor ใน
ui/vendor/leaflet/) — ห้ามให้ CSS ภายนอกกำหนด width/height ของsvg.leaflet-zoom-animated(จะถูกยุบเป็น 0×0 แล้ว "เส้นทางไม่แสดง" — มี guard ในui/map.cssแล้ว) - ตรวจว่าเส้นทางแสดงจริง ต้องวัด
getBoundingClientRect()เทียบกับกล่องแผนที่ — นับ<path>ใน DOM ไม่พอ
📌 กติกาจุดขึ้นรถประจำทางอื่นๆ (
8 other_stop.json): ดูresource/data/8 other_stop.md— ระบุสายที่ ห้ามเพิ่ม entry และรายการที่ห้ามลบ
ลำดับการอ่านไฟล์เมื่อเริ่มงาน
AGENTS.md(ไฟล์นี้) →DESIGN.md(ถ้าแตะ UI)- หน้าที่เกี่ยวข้อง (
ui/*.html) +_shared.css+maintheme.png(ถ้าต้องการอารมณ์ดีไซน์) resource/data/*.jsonที่เกี่ยวข้อง (ถ้าแตะข้อมูล)
หมายเหตุ
- commit ล่าสุดเน้น: sponsor marquee (เลื่อนสปอนเซอร์), ลบไฟล์ backup HTML
.gitignoreว่างเปล่า — ถ้าเพิ่มไฟล์ขยะ (เช่น .DS_Store) ให้เพิ่มใน .gitignore- งานถัดไปที่คาดว่าเกี่ยวข้อง: นำดีไซน์นี้ไป implement ใน
web-at-transit(Next.js)
หน้ารายละเอียดป้าย #/stops/<รหัสป้าย> — ข้อมูลมาจากไหน
หน้า ui/partials/stopDetail.html เป็น "โครงเปล่า" ล้วน ๆ (มีแต่ <style> + element ที่มี id)
ข้อมูลทั้งหมดเรนเดอร์โดย ui/partials/stopDetail.init.js จาก JSON — ห้ามฝังข้อมูลป้ายลง HTML
| ส่วนบนหน้า | มาจาก |
|---|---|
| ชื่อป้าย · ประเภท · รหัส · จังหวัด | resource/data/stations.json (station_name_th, station_type, station_code, city_th, province_th) |
| สายรถที่ผ่านป้ายนี้ + เวลารถ | routes.json (station_ids) × schedules.json (schema 2 ผ่านตัวอ่านกลาง ui/partials/schedules.js) |
| จำนวนสาย · เที่ยวต่อวัน · เวลาบริการ (เปิด–ปิด) · เที่ยวถัดไป | คำนวณอัตโนมัติ จากข้อมูลข้างบน (ไม่ต้องกรอก) |
| แผนที่ | ui/map.js (ATMap.forStop) วาดจาก geojson-web/*.geojson |
| รูปป้าย | หาเองจาก busstop_list.json (ป้ายใกล้สุดภายใน 3 กม. → .image/stops/<หลัก กม.>.jpg) หรือกำหนดเอง |
ฟิลด์เสริม (ไม่ใส่ก็ได้ — ถ้าไม่ใส่ ส่วนนั้นจะซ่อนเอง) ใส่ใน stations.json ของป้ายนั้น:
{ "station_id": 1, "station_code": "at_main_terminal",
"photo": "../.image/stops/54950.jpg",
"description": "ข้อความแนะนำป้าย (แทนประโยคอัตโนมัติ)",
"facilities": ["ห้องน้ำ", "ที่พักคอย", "ร้านอาหาร"],
"landmarks": [ { "img": "../.image/landmarks/temple.png", "caption": "วัดสำคัญ", "sub": "เดิน 5 นาที" } ],
"landmarks_note": "คำโปรยใต้หัวข้อใกล้เคียงป้าย" }
URL ที่ใช้ได้: #/stops/<station_code> และ #/stops/<station_code>?route=<รหัสสาย> (กรองเฉพาะสายนั้น)
ตารางเดินรถแยก "วันทำงาน / วันหยุด" (ดีไซน์ที่ไม่ต้องแก้โค้ดหน้าไหน)
หลักคิด: ใส่ตรรกะไว้ที่ตัวอ่านกลาง ui/partials/schedules.js ที่เดียว → หน้า check/busDetail/home/stopDetail
เรียก API เดิม (Schedules.records/route/directions/times/countTrips) แล้วได้ข้อมูลของ "วันนี้" ให้เอง
เพิ่มฟิลด์ไม่บังคับ 2 ระดับ (ไม่ใส่ = พฤติกรรมเดิมทุกอย่าง):
| ระดับ | ฟิลด์ | ความหมาย |
|---|---|---|
| ทิศทาง | "service": "weekday" | "holiday" |
ทั้งทิศทางใช้เฉพาะวันนั้น (ไม่ใส่/"all" = ทุกวัน) |
| จุดจอด | "groups": [ { "label": "วันหยุด", "dayType": "holiday", "times": ["10:00"] } ] |
เวลาที่เพิ่มเฉพาะบางวัน — times[] ยังเป็นตารางพื้นฐานทุกวัน |
การตรวจจับวัน: เสาร์–อาทิตย์ = วันหยุด · นักขัตฤกษ์อ่านจาก resource/data/holidays.json (เจ้าของข้อมูลต้องกรอกเอง — ห้ามเดา)
ความปลอดภัย: ถ้ากรองแล้วไม่มีทิศเหลือ → ถอยไปใช้ทั้งหมด + ติดธง fallback (หน้าเว็บไม่มีทางว่างเปล่า) + เครื่องมือแก้ไขเตือนไว้
GUI: resource/data/schedules-editor.html มีช่อง "ใช้กับวัน" ต่อทิศ + ตรวจจับคำในหมายเหตุ (วันทำงาน/วันหยุด) แล้วเสนอให้ตั้งค่า
หน้าเว็บ: หน้า #/check จะขึ้น "ตารางวันทำงาน (จ–ศ)" / "ตารางวันหยุด" ต่อท้ายคำอธิบาย เฉพาะสายที่มีการแยกตารางตามวัน
จุดกลางทาง "ไม่ต้องทำตาราง" — คำนวณจากต้นทาง (autoTimes)
หลักคิด: 1 ทิศ มีจุดที่กรอกเวลาจริง (ต้นทาง/จุดอ้างอิง) ส่วนจุดอื่นปล่อยว่างได้ → ระบบคำนวณให้จาก
เวลา + (ผลต่าง กม. ÷ ความเร็ว) แล้วทำเครื่องหมายว่าเป็น ค่าประมาณ (ไม่ใช่ตารางผู้ประกอบการ)
ต้องมีอะไรบ้าง
- พิกัดของจุดนั้นใน
stations.json(ถ้าเป็น 'จุดขึ้นรถประจำทางอื่นๆ' → ใช้พิกัดจาก8 other_stop.json) - ค่า
kmของจุดในschedules.json— วัดด้วยpython resource/tools/stop-km.py(วัดตามเส้นจริงในgeojson-web/) - ตั้ง
"autoTimes": trueที่ทิศนั้น (และ"speedKmh": 40ถ้าต้องการความเร็วอื่น) — ตั้งได้จาก GUI ช่อง "คำนวณจากต้นทาง"
กติกาในท่อกลาง (ui/partials/schedules.js)
- จุดที่มี
times[]จริง → ใช้ของจริงเสมอ (ไม่คำนวณทับ) - จุดที่ว่าง → หาจุดที่มีเวลาซึ่งอยู่ใกล้ที่สุด (ตาม กม.) แล้วบวก/ลบเวลาตามระยะ
- ไม่มี
kmหรือไม่มีจุดอ้างอิง → ถอยไปแสดง "ยังไม่มีข้อมูล" เหมือนเดิม (ไม่พัง) - หน้าเว็บแสดงเวลาที่คำนวณด้วย กรอบเส้นประ + ข้อความ "~ เวลาคำนวณจากต้นทาง (ประมาณ)" เสมอ
อย่าลืม: ถ้าแก้พิกัด/เส้นทางใหม่ ให้รัน stop-km.py ซ้ำ (ค่า กม. จะเปลี่ยน)
เครื่องมือแก้ schedules.json — กติกา UX (resource/data/schedules-editor.html)
- ตัวเลือกจุดจอด คัดจาก
station_orderของสายนั้น (ไม่ใช่สถานีทั้งจังหวัด)- ถ้าเป็น
station_id 8= "จุดขึ้นรถประจำทางอื่นๆ" → แสดงชื่อจุดจริงของสายนั้นจาก8 other_stop.json(รองรับรหัสเพี้ยนสลับหลัก เช่น1101= สาย1011แบบเดียวกับui/partials/otherStop.js) - จุดที่อยู่นอก
station_orderยังคงแสดงได้ (ไม่หาย) + บอกให้เห็นว่าอยู่นอกลำดับ
- ถ้าเป็น
- "สร้างตารางเวลาอัตโนมัติ" เป็นการ์ดแยก ต่อทิศ (ไม่อยู่ในหัวการ์ดทิศ)
- ขั้น 1 เลือก จุดอ้างอิง จาก dropdown ที่แสดงเฉพาะจุดในทิศนั้นที่มีตารางเวลาอยู่แล้ว (พร้อมจำนวนเที่ยว) → เก็บเป็น
"baseSid" - ขั้น 2 ใส่ เวลาเดินทางโดยประมาณ (นาที) → เก็บเป็น
"travelMin"(ระบบคำนวณความเร็วให้เอง) - ขั้น 3 เลือก จุดเป้าหมาย จาก
station_orderของสายนั้น (บอกสถานะ: มีตารางแล้ว / ว่างอยู่ / ยังไม่มีในทิศนี้ → จะเพิ่มจุดให้) → เก็บเป็น"autoFor": [station_id]· ถ้าไม่เลือก = ทุกจุดที่ว่าง · ถ้าจุดเป้าหมายยังไม่มีเป็นจุดในทิศนั้น ระบบจะ เพิ่มจุดให้อัตโนมัติ ตอนกดใช้ตาราง - ขั้น 4 กด คำนวณตาราง → พรีวิว (แถวเป้าหมายมี 🎯) → เลือก "ใช้ตารางนี้ (คำนวณอัตโนมัติ)" หรือ "เติมเวลาลงข้อมูลจริง" · "เติมเวลาลงข้อมูลจริง" จะเติม เฉพาะจุดเป้าหมาย ถ้าเลือกไว้ (ไม่ทับจุดอื่น)
- ค่าที่พิมพ์ในแผงเป็นการชั่วคราว (ไม่แตะไฟล์จนกว่าจะกดปุ่ม) · เปิด/ปิดพรีวิวไม่ทำให้ไฟล์ "ยังไม่บันทึก"
- ขั้น 1 เลือก จุดอ้างอิง จาก dropdown ที่แสดงเฉพาะจุดในทิศนั้นที่มีตารางเวลาอยู่แล้ว (พร้อมจำนวนเที่ยว) → เก็บเป็น
- ค่าที่คำนวณไม่เคยถูกเขียนลง
schedules.json—kmอยู่ในresource/data/stop-km.json(generated) - ตัวอ่านกลาง
ui/partials/schedules.jsรองรับbaseSid(จุดอ้างอิง) →baseEnd→ อัตโนมัติ ตามลำดับความสำคัญ และautoForจำกัดว่าคำนวณเฉพาะจุดใด (ไม่ใส่ = ทุกจุดที่ว่าง)
เครื่องยนต์ตรวจวัน (จันทร์–อาทิตย์) — อยู่ที่ท่อกลางที่เดียว
อยู่ที่ ui/partials/schedules.js เท่านั้น → หน้า check/busDetail/home/stopDetail ได้ผลเหมือนกัน ไม่ต้องแก้โค้ดหน้าไหน
ลำดับการตัดสิน (แม่น → หลวม):
"days": ["sat","sun"]ระบุตรง ๆ → ใช้ตามนั้น"service": "weekday" | "holiday" | "all"→ เทียบกับวันนี้- ไม่ระบุ → ตรวจคำอัตโนมัติ จาก
dir_label+dir_note/noteของทุกจุดในทิศนั้น (เจอ "วันหยุด/นักขัตฤกษ์/ส-อา/weekend" = วันหยุด · "วันทำงาน/จ-ศ/ธรรมดา/workday" = วันทำงาน ไม่เดาถ้าเจอทั้งคู่) - ตัดสินไม่ได้ → แสดงทุกวัน (ไม่ซ่อนข้อมูล) + ป้าย "ยังไม่ระบุวันของตาราง"
วันหยุด = เสาร์–อาทิตย์ + นักขัตฤกษ์ จาก resource/data/holidays.json (เจ้าของข้อมูลกรอกเอง ห้ามเดา)
API ที่เพิ่ม: Schedules.dayInfo(date) → {dayType, weekday, weekday_th, date} · Schedules.dayKey(date) → 'mon'…'sun'
· Schedules.detectDay(text) · Schedules.detectDayOfDir(dir) · Schedules.serviceOf(dir|null, dir) → {day, from, matches, conflict?, unknown?}
การป้องกันข้อมูลหาย: ถ้ากรองตามวันแล้วไม่มีทิศเหลือ → ถอยไปแสดงทั้งหมด + ติดธง fallback
รูปภาพ — นามสกุลที่รองรับ (.jpg / .jpeg / .webp / .png)
ทุกรูปในเว็บไล่ลองนามสกุลอัตโนมัติ — ใส่ไฟล์นามสกุลไหนก็ได้ ไม่ต้องแก้โค้ด
| ลำดับ | นามสกุล |
|---|---|
| 1 | .jpg |
| 2 | .jpeg |
| 3 | .webp |
| 4 | .png |
ที่ใช้:
- รูปสถานี
.image/stations/<station_id>.<ext>(รูปเสริม<station_id>-2.<ext>) —PHOTO_EXTSในstopDetail.init.js - รูปป้ายริมทาง
.image/stops/<pad5 กม.>.<ext>+ รูปสถานีบนการ์ด#/stops—IMG_EXTS+firstExisting()ในbusStop.init.js - รูปรถ
.image/routes/<รหัส>/car|boat.<ext>· QR.image/qrcode/<รหัส>.<ext>—CAR_EXTS/QR_EXTSในbusDetail.init.js(ทำมาก่อนแล้ว)
กติกา: เลือกนามสกุลแรกที่มีไฟล์จริง (ตรวจ HEAD ก่อนแสดง) · ไม่มีไฟล์เลย → ไม่แสดงช่องว่าง ในหน้าเว็บ (ไม่เหลือ <img> พาธลอย) · SW จัดการรูปทุกนามสกุลแบบ cache-first เหมือนกัน
หมายเหตุ: ถ้ามีทั้ง .jpg และ .jpeg ในชื่อเดียวกัน → .jpg ชนะ (รักษาพฤติกรรมเดิม)
หัวแถวทิศในหน้า #/check — ใช้ dir_label ก่อน
การ์ดในหน้า check จัดกลุ่ม ตามจุดจอด (จุดเดียวกันที่มีหลายทิศ = การ์ดเดียว หลายแถว)
หัวแถวจึงต้องใช้ dir_label (ชื่อทิศ เช่น ป่าโมกไปอ่างทอง / ป่าโมกไปอยุธยา) ไม่ใช่คำกลางว่า "ทิศทาง"
ลำดับที่ใช้แสดง: dir_label → dir_note (พร้อมป้าย "ทิศทาง") → "ที่จุด X"
records() ส่งออกทั้ง dir_label และ direction_note — หน้าที่อื่นเรียกใช้ได้
ชิปสาย (buses-line) ในหน้า #/stops → #/routes/<รหัส>
ชิป "สาย N" บนการ์ดป้าย ลิงก์ไปหน้ารายละเอียดสาย #/routes/<รหัส> (ไม่ใช่ #/check)
- สายที่ไม่มีใน
routes.json→ คงเป็น<span>(ไม่ทำลิงก์) กันลิงก์ตาย - ข้อความปุ่ม:
stops.viewRoute= "ดูรายละเอียดสาย {n}" / "View route {n}" - (หน้า
#/stops/<slug>ปุ่ม "ดูตารางเวลาสาย N" ยังใช้#/check/<รหัส>ตามเดิม — คนละบริบท)
ลิงก์ติดต่อผู้ประกอบการ (หน้ารายละเอียดสาย #/routes/<id>)
ใช้ฟิลด์ web_url ใน routes.json (มีอยู่เดิม) — ไม่ต้องแก้โค้ดเวลาเพิ่ม/เปลี่ยนลิงก์
-
ไอคอน + ชื่อ + สี เปลี่ยนตามชนิด URL อัตโนมัติ (
linkKind()ในbusDetail.init.js):ตรวจพบ ไอคอน โทนสี ชื่อที่แสดง facebook.com/fb.meic-facebooktone-sky(ฟ้า)Facebook line.me/lin.ee/linevoomic-message-circletone-greenLINE Official http(s)://อื่น ๆic-globetone-purpleเว็บไซต์ -
ปุ่ม "เปิดลิงก์" แยกต่างหาก (
route.openLink+route.link.*ใน i18n) เปิดแท็บใหม่target="_blank" rel="noopener"· โชว์ URL แบบสั้น (ตัดhttps://) -
QR ตั้งชื่อตามรหัสสาย:
.image/qrcode/<route_id>.<png|JPG|jpeg|webp>(ไล่ลองนามสกุล) หรือระบุเองที่caption<id>.json → qr_image -
ไม่มี
web_url→ แสดงเฉพาะแถว LINE+QR เหมือนเดิม (ไม่พัง)
กฎ "จุดนี้ = เวลาจุดอ้างอิง ± n นาที" (derive) — แนวทาง A
ปัญหาเดิม: จุดระหว่างทางที่ไม่มีตารางของตัวเอง มักถูก "คัดลอกเวลา" จากจุดอื่นมา → เวลาผิด (เช่น 902 จุด 15 คัดลอกจากจุด 6 ทั้ง 25 เที่ยว ทั้งที่รถวิ่งต่ออีก 30 นาที)
วิธีแก้: เขียนกฎครั้งเดียวต่อจุด ในไฟล์สายของตัวเอง แล้วให้เว็บคำนวณเสมอ (ไม่เก็บเวลาซ้ำ)
/* resource/data/scheduleslist/schedules902.json */
{ "station_id": 15,
"times": [],
"derive": { "from_station_id": 6, "offset_min": 30, "note": "รอรถที่ 7-11 หน้ากินซ่า" } }
from_station_idอ้างจุดได้ ข้ามทิศ (ใน 902 จุด 6 อยู่ทิศallแต่จุด 15 อยู่ทิศrungsit) ✓offset_minเป็นบวก (หลังจุดอ้างอิง) หรือลบ (ก่อนหน้า) · เกินเที่ยงคืน = วนกลับแบบ mod 24- กฎชนะเวลาที่เขียนไว้ (
times) — และเครื่องมือจะลบtimesที่ซ้ำให้อัตโนมัติ
เว็บแสดงผลอัตโนมัติ: ชิปเส้นประ + ตัวเอียง (is-est) + ข้อความ
time.derived = "~ ตารางจากการคำนวณ (จาก {base} {n} นาที) — อาจเปลี่ยนแปลงตามการจราจรจริง"
({base} = ชื่อจุดอ้างอิง ดึงจาก stations.json · ถ้ายังโหลดชื่อไม่ทันใช้ #<id> แทน)
เครื่องมือ: resource/tools/derive-times.py + ตาราง resource/data/derive-times.csv
route_id,station_id,from_station_id,offset_min,note
902,15,6,30,รอรถที่ 7-11 หน้ากินซ่า
--checkดูก่อน · รันเปล่า = เขียนจริง ·--audit= ตรวจว่าไฟล์ตรงตาราง + ชี้จุดที่เวลาซ้ำแต่ยังไม่มีกฎ ✓- รันซ้ำได้ (idempotent) · จุดอ้างอิงต้องมีเวลาจริง · เขียนไฟล์คง CRLF เดิม