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

307 lines
34 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)
## วิธีเปิดดูผลงาน
```bash
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 ของเว็บ — รันมือเมื่อข้อมูลเส้นเปลี่ยน):
```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)
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` ของป้ายนั้น:**
```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 เดิม