Files
web-at-transit-mock/AGENTS.md
T
Bkk1234 1cfaeb1526 ตารางเวลาคำนวณได้ + หน้ารายละเอียดป้ายขับเคลื่อนด้วยข้อมูล + แผนที่ Leaflet
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 · นามสกุลรูป · ชิปสาย · หน้ารายละเอียดป้ายมาจากไหน
2026-09-30 03:25:18 +07:00

34 KiB
Raw Blame History

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 จะพัง)

กฎบังคับ

  1. ห้ามใส่ framework/build step — repo นี้เป็น static HTML + vanilla JS เท่านั้น
  2. ทุกหน้าเป็น SPA view ผ่าน hash router — ห้ามสร้างไฟล์ HTML หน้าใหม่ ถ้าจะเพิ่มหน้าจอใหม่: สร้าง partials/<view>.html (+ <script>/<style> ในไฟล์นั้น) แล้วเพิ่ม route ใน ui/router.js (VIEWS + parseHash)
  3. ลิงก์ภายในใช้ href="#/..." เสมอ — ห้าม href="./xxx.html" (จะโหลดหน้าใหม่) และห้าม location.href/location.replace ไปหน้า html ยกเว้นใน redirect stub
  4. <style> และ <script> ของ view ให้อยู่ใน partial ของมัน — router inject แล้ว รัน <script> ให้อัตโนมัติ ถ้า script ต้องอ่าน params ให้ใช้ window.__route
  5. ทุกหน้าโหลด _shared.css — สไตล์ร่วมต้องอยู่ที่นี่ ไม่ใช่ inline ในแต่ละหน้า (ยกเว้นสไตล์เฉพาะหน้าที่จำเป็นจริง ๆ ให้อยู่ใน <style> ใน partial)
  6. class ที่ขึ้นต้น mu- = component ร่วม (เช่น .mu-card, .mu-cover, .mu-hero) — ถ้าจะเพิ่ม component ใหม่ ใช้ prefix mu- ด้วย
  7. รูปอ้างอิงผ่าน ../.image/... — อย่า copy รูปเข้า ui/
  8. ข้อมูลตัวอย่างมาจาก resource/data/*.json — ถ้าจะเพิ่มเส้นทาง/ป้าย ต้องเพิ่มข้อมูล ใน JSON ให้ตรงกัน (ไม่ hardcode เฉพาะหน้า)
  9. ข้อความ UI เป็นภาษาไทย — ภาษาอังกฤษใช้เป็น label รองเท่านั้น
  10. อ่าน DESIGN.md ก่อนแก้ UI ทุกครั้ง — มีกฎ "ห้ามทำ" ที่กันสไตล์ AI genric และโทเคนสี/ฟอนต์ตายตัว
  11. ไอคอนใช้ระบบ 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
  12. main-theme.css (อ้างอิงจาก HTML) ไม่อยู่ใน repo นี้ — ถ้าแก้สไตล์ให้แก้ที่ _shared.css แทน อย่าไปสร้าง main-theme.css ใหม่
  13. PWA / Service Worker (ui/sw.js) — ห้ามแก้กลไกโดยไม่เข้าใจ:
    • HTML/CSS/JS/partials/JSON → network-first (ออนไลน์ได้ของใหม่เสมอ, ออฟไลน์ใช้ cache)
    • รูป/ฟอนต์ → cache-first
    • เนื้อหา HTML/CSS/JS เปลี่ยน = เห็นผลทันทีโดยผู้ใช้ไม่ต้องล้างแคช (network-first)
    • เฉพาะแก้ sw.js เองเท่านั้น ต้อง bump VERSION ใน sw.js (เช่น 2026.09.02.9) → cache ใหม่ถูกสร้าง + cache เก่าถูกลบอัตโนมัติตอน activate
    • อย่าลืม: ทุกหน้า HTML ต้องมี <link rel="manifest"> + <script src="./pwa.js"> (ถ้าสร้างหน้าใหม่) และถ้าเพิ่มไฟล์ shell (หน้า/partial/CSS/JS หลัก) ให้เพิ่มใน PRECACHE
  14. หลายภาษา (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 หน้าใหม่ให้อัตโนมัติ (ฟัง event langchange)
    • ชื่อเฉพาะ (ชื่อสถานี/จังหวัด/สายรถ) ไม่ต้องแปล — คงภาษาไทย

ข้อมูลเส้นทางจาก 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 และรายการที่ห้ามลบ

ลำดับการอ่านไฟล์เมื่อเริ่มงาน

  1. AGENTS.md (ไฟล์นี้) → DESIGN.md (ถ้าแตะ UI)
  2. หน้าที่เกี่ยวข้อง (ui/*.html) + _shared.css + maintheme.png (ถ้าต้องการอารมณ์ดีไซน์)
  3. 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 ทิศ มีจุดที่กรอกเวลาจริง (ต้นทาง/จุดอ้างอิง) ส่วนจุดอื่นปล่อยว่างได้ → ระบบคำนวณให้จาก เวลา + (ผลต่าง กม. ÷ ความเร็ว) แล้วทำเครื่องหมายว่าเป็น ค่าประมาณ (ไม่ใช่ตารางผู้ประกอบการ)

ต้องมีอะไรบ้าง

  1. พิกัดของจุดนั้นใน stations.json (ถ้าเป็น 'จุดขึ้นรถประจำทางอื่นๆ' → ใช้พิกัดจาก 8 other_stop.json)
  2. ค่า km ของจุดใน schedules.json — วัดด้วย python resource/tools/stop-km.py (วัดตามเส้นจริงใน geojson-web/)
  3. ตั้ง "autoTimes": true ที่ทิศนั้น (และ "speedKmh": 40 ถ้าต้องการความเร็วอื่น) — ตั้งได้จาก GUI ช่อง "คำนวณจากต้นทาง"

กติกาในท่อกลาง (ui/partials/schedules.js)

  • จุดที่มี times[] จริง → ใช้ของจริงเสมอ (ไม่คำนวณทับ)
  • จุดที่ว่าง → หาจุดที่มีเวลาซึ่งอยู่ใกล้ที่สุด (ตาม กม.) แล้วบวก/ลบเวลาตามระยะ
  • ไม่มี km หรือไม่มีจุดอ้างอิง → ถอยไปแสดง "ยังไม่มีข้อมูล" เหมือนเดิม (ไม่พัง)
  • หน้าเว็บแสดงเวลาที่คำนวณด้วย กรอบเส้นประ + ข้อความ "~ เวลาคำนวณจากต้นทาง (ประมาณ)" เสมอ

อย่าลืม: ถ้าแก้พิกัด/เส้นทางใหม่ ให้รัน stop-km.py ซ้ำ (ค่า กม. จะเปลี่ยน)

เครื่องมือแก้ schedules.json — กติกา UX (resource/data/schedules-editor.html)

  1. ตัวเลือกจุดจอด คัดจาก station_order ของสายนั้น (ไม่ใช่สถานีทั้งจังหวัด)
    • ถ้าเป็น station_id 8 = "จุดขึ้นรถประจำทางอื่นๆ" → แสดงชื่อจุดจริงของสายนั้นจาก 8 other_stop.json (รองรับรหัสเพี้ยนสลับหลัก เช่น 1101 = สาย 1011 แบบเดียวกับ ui/partials/otherStop.js)
    • จุดที่อยู่นอก station_order ยังคงแสดงได้ (ไม่หาย) + บอกให้เห็นว่าอยู่นอกลำดับ
  2. "สร้างตารางเวลาอัตโนมัติ" เป็นการ์ดแยก ต่อทิศ (ไม่อยู่ในหัวการ์ดทิศ)
    • ขั้น 1 เลือก จุดอ้างอิง จาก dropdown ที่แสดงเฉพาะจุดในทิศนั้นที่มีตารางเวลาอยู่แล้ว (พร้อมจำนวนเที่ยว) → เก็บเป็น "baseSid"
    • ขั้น 2 ใส่ เวลาเดินทางโดยประมาณ (นาที) → เก็บเป็น "travelMin" (ระบบคำนวณความเร็วให้เอง)
    • ขั้น 3 เลือก จุดเป้าหมาย จาก station_order ของสายนั้น (บอกสถานะ: มีตารางแล้ว / ว่างอยู่ / ยังไม่มีในทิศนี้ → จะเพิ่มจุดให้) → เก็บเป็น "autoFor": [station_id] · ถ้าไม่เลือก = ทุกจุดที่ว่าง · ถ้าจุดเป้าหมายยังไม่มีเป็นจุดในทิศนั้น ระบบจะ เพิ่มจุดให้อัตโนมัติ ตอนกดใช้ตาราง
    • ขั้น 4 กด คำนวณตาราง → พรีวิว (แถวเป้าหมายมี 🎯) → เลือก "ใช้ตารางนี้ (คำนวณอัตโนมัติ)" หรือ "เติมเวลาลงข้อมูลจริง" · "เติมเวลาลงข้อมูลจริง" จะเติม เฉพาะจุดเป้าหมาย ถ้าเลือกไว้ (ไม่ทับจุดอื่น)
    • ค่าที่พิมพ์ในแผงเป็นการชั่วคราว (ไม่แตะไฟล์จนกว่าจะกดปุ่ม) · เปิด/ปิดพรีวิวไม่ทำให้ไฟล์ "ยังไม่บันทึก"
  3. ค่าที่คำนวณไม่เคยถูกเขียนลง schedules.json — km อยู่ใน resource/data/stop-km.json (generated)
  4. ตัวอ่านกลาง ui/partials/schedules.js รองรับ baseSid (จุดอ้างอิง) → baseEnd → อัตโนมัติ ตามลำดับความสำคัญ และ autoFor จำกัดว่าคำนวณเฉพาะจุดใด (ไม่ใส่ = ทุกจุดที่ว่าง)

เครื่องยนต์ตรวจวัน (จันทร์–อาทิตย์) — อยู่ที่ท่อกลางที่เดียว

อยู่ที่ ui/partials/schedules.js เท่านั้น → หน้า check/busDetail/home/stopDetail ได้ผลเหมือนกัน ไม่ต้องแก้โค้ดหน้าไหน

ลำดับการตัดสิน (แม่น → หลวม):

  1. "days": ["sat","sun"] ระบุตรง ๆ → ใช้ตามนั้น
  2. "service": "weekday" | "holiday" | "all" → เทียบกับวันนี้
  3. ไม่ระบุ → ตรวจคำอัตโนมัติ จาก dir_label + dir_note/note ของทุกจุดในทิศนั้น (เจอ "วันหยุด/นักขัตฤกษ์/ส-อา/weekend" = วันหยุด · "วันทำงาน/จ-ศ/ธรรมดา/workday" = วันทำงาน ไม่เดาถ้าเจอทั้งคู่)
  4. ตัดสินไม่ได้ → แสดงทุกวัน (ไม่ซ่อนข้อมูล) + ป้าย "ยังไม่ระบุวันของตาราง"

วันหยุด = เสาร์–อาทิตย์ + นักขัตฤกษ์ จาก 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.me ic-facebook tone-sky (ฟ้า) Facebook
    line.me / lin.ee / linevoom ic-message-circle tone-green LINE Official
    http(s):// อื่น ๆ ic-globe tone-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 เดิม