ตารางเวลาคำนวณได้ + หน้ารายละเอียดป้ายขับเคลื่อนด้วยข้อมูล + แผนที่ 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 · นามสกุลรูป · ชิปสาย · หน้ารายละเอียดป้ายมาจากไหน
This commit is contained in:
1 parent
88311326e6
commit
1cfaeb1526
91 files changed
+7560
-844
No files matched your search
@@ -98,6 +98,26 @@ python -m http.server 8090 # เปิด http://localhost:8090/ui/index.
|
||||
จะ render หน้าใหม่ให้อัตโนมัติ (ฟัง event `langchange`)
|
||||
- **ชื่อเฉพาะ (ชื่อสถานี/จังหวัด/สายรถ) ไม่ต้องแปล** — คงภาษาไทย
|
||||
|
||||
## ข้อมูลเส้นทางจาก GIS (QGIS → GeoJSON → แผนที่)
|
||||
|
||||
- **ห้ามแก้ `resource/data/geojson-web/*.geojson` ด้วยมือ** — เป็นไฟล์ที่ "สร้าง" จาก shapefile ใน
|
||||
`resource/data/QGIS Project/*.shp` (ตารางจับคู่ `SHP_MAP` อยู่ในสคริปต์) — user แก้ใน QGIS แล้วกด Save
|
||||
- แปลง/อัปเดตด้วยคำสั่งเดียว (ไม่ใช่ build step ของเว็บ — รันมือเมื่อข้อมูลเส้นเปลี่ยน):
|
||||
```bash
|
||||
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)
|
||||
@@ -109,3 +129,178 @@ python -m http.server 8090 # เปิด http://localhost:8090/ui/index.
|
||||
- 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` ของป้ายนั้น:**
|
||||
|
||||
```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 นาที)
|
||||
|
||||
**วิธีแก้:** เขียนกฎครั้งเดียวต่อจุด **ในไฟล์สายของตัวเอง** แล้วให้เว็บคำนวณเสมอ (ไม่เก็บเวลาซ้ำ)
|
||||
|
||||
```json
|
||||
/* 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 เดิม
|
||||
Reference in new issue
Block a user