Files
web-at-transit/frontend/public/resource/data/8 other_stop.md
T
itmeadmin 138a3d15d8 พอร์ต UI จาก web-at-transit-mock เข้า Next.js + data sync เข้า Postgres/SeaweedFS
- 8 หน้า (home/stops/routes/stop/check/blog/about/credits) แปลง partials → React component ตรง mock
- ตรรกะพอร์ตเป็น src/lib/ui/*.ts (mount()) + runtime/PageRuntime
- CSS: base + pages/*.css import ต่อ route (คงลำดับ cascade ของ mock)
- asset/content: public/{image,resource/data,content,locales,vendor}
- แก้ path รูปไทล์พาร์ทเนอร์ (.image → /image) + fallback absolute
- ลบ UI เดิมที่ไม่ตรง mock (expanded/stops details/old components/globals.css)
- script/sync_data_to_postgres.mjs + sync_images_to_storage.mjs (dry-run/--apply, backup)
- docs/UI-PORT.md + DESIGN.md + README
2026-10-23 15:50:00 +07:00

98 lines
11 KiB
Markdown

# `8 other_stop.json` — บันทึกเตือนความจำ (ห้ามเพิ่ม/ห้ามลบมั่ว)
> 📌 **ไฟล์นี้เป็นบันทึกของเจ้าของข้อมูล ไม่ใช่ข้อมูลสำหรับเว็บ** — เว็บอ่านเฉพาะ `8 other_stop.json`
> ไฟล์นี้มีไว้กันการ "ช่วยเติมข้อมูล" ที่ไม่ได้รับอนุญาต (เช่น AI หรือผู้พัฒนาที่เข้ามาทีหลัง)
อัปเดตล่าสุด: **2026-10-05** · ผู้ตัดสินใจ: เจ้าของข้อมูล (ทีม Atroute)
---
## 1. ไฟล์นี้คืออะไร
`stations.json` มีจุดจอดกลางชื่อ **"จุดขึ้นรถประจำทางอื่นๆ"** (`station_id: 8`, `station_code: other_stop`)
ซึ่งเป็น**ชื่อรวม**ของทุกสายที่ไม่ได้ขึ้นที่สถานีหลัก — ของจริงของแต่ละสายอยู่ใน `8 other_stop.json` เช่น
```json
{ "route_id": "2231", "station_name_th": "วัดมหานาม", "city_th": "ไชโย", "province_th": "อ่างทอง",
"station_type": "local_stop", "latitude": 14.712584910077634, "longitude": 100.44760308824014 }
```
หน้าเว็บ (`#/stops/other_stop?route=1011`) จะขึ้น **"จุดขึ้นรถประจำทางอื่นๆ · วัดสีบัวทอง"** โดยจับคู่จากไฟล์นี้
ตัวจับคู่อยู่ที่ `ui/partials/otherStop.js` (ใช้ทั้งหน้า `#/stops/...` และ `#/routes/...`) — **อ่านไฟล์นี้เท่านั้น ไม่ต้องแก้โค้ดเมื่อเพิ่ม/ลบรายการ**
---
## 2. ⛔ ห้ามเพิ่ม 5 สายนี้ (เจ้าของข้อมูลกำหนด)
| สาย | ชื่อสาย | มี `station_id 8` ในเส้นทางไหม | สถานะข้อมูลของจุดนั้น | คำสั่ง |
| --- | --- | --- | --- | --- |
| **952** | กรุงเทพ-วิเศษชัยชาญ | มี (จุดที่ 3/3) | มีเวลา 3 เที่ยว แต่ยังไม่ระบุชื่อจุดจริง | ⛔ ห้ามเพิ่ม entry (อย่าเพิ่มเพราะเห็นว่ามีเวลา) |
| **15** | กรุงเทพ-อ่างทอง สายใน | ไม่มี | — | ⛔ ห้ามเพิ่ม — เพิ่มไปก็ไม่แสดงผล |
| **902** | กรุงเทพ-อ่างทอง สายเอเซีย | ไม่มี | — | ⛔ ห้ามเพิ่ม — เพิ่มไปก็ไม่แสดงผล |
| **464** | สุพรรณ-อ่างทอง-สระบุรี | ไม่มี | — | ⛔ ห้ามเพิ่ม — เพิ่มไปก็ไม่แสดงผล |
| **101** | อ่างทอง-ป่าโมก-อยุธยา | ไม่มี | — | ⛔ ห้ามเพิ่ม — เพิ่มไปก็ไม่แสดงผล |
**ผลเมื่อไม่มี entry:** หน้าเว็บยังทำงานปกติ — แถวของสายนั้นจะแสดงตำแหน่งในเส้นทางแทน
(เช่น `จุดจอดที่ 3/3` หรือ `Passing · 4/5`) **ไม่ใช่ข้อผิดพลาด** และไม่ต้องไปเติมให้ครบ
---
## 3. ✅ 8 รายการที่มีอยู่แล้ว — ห้ามลบ
| `route_id` ในไฟล์ | ใช้กับสาย | ชื่อจุดจริง (จุดแรก) | อำเภอ/จังหวัด | จำนวนจุด · offsets_min |
| --- | --- | --- | --- | --- |
| `2231` | 2231 | วัดมหานาม | ไชโย · อ่างทอง | 1 จุด |
| `324` | 324 | วัดไชโย | ไชโย · อ่างทอง | 1 จุด |
| `951` | 951 | ตลาดวิเศษชัยชาญ | เดิมบางนางบวช · สุพรรณบุรี (จุดแรก) | 2 จุด · ยังไม่ระบุ offset |
| `954` | 954 | ตลาดท่าช้าง | เดิมบางนางบวช · สุพรรณบุรี | 4 จุด · offsets `[0, 45, 60, null]` |
| `8` | 8 | ตลาดสรรคบุรี | สรรคบุรี · ชัยนาท (จุดแรก) | 3 จุด · ยังไม่ระบุ offset |
| `2194` | 2194 | วัดหัวเวียง | เสนา · อยุธยา | 2 จุด · offsets `[0, 30]` |
| `1011` | 1011 | วัดสีบัวทอง | แสวงหา · อ่างทอง | 3 จุด · offsets `[0, 25, 55]` |
| `641` | 641 | 7-11 บ้านแพรก | บ้านแพรก · อยุธยา (จุดแรก) | 1 จุด |
**หมายเหตุ:** `route_id` ในไฟล์ **ตรงกับรหัสสายจริงทุกตัว** — เดิมมี `1101` ซึ่งเป็นรหัสเพี้ยนของสาย `1011` แก้เป็น `1011` แล้ว
---
## 4. กติกาที่โค้ดใช้จับคู่ (`ui/partials/otherStop.js`)
1. **ตรงตัวก่อน** — `route_id` ในไฟล์ตรงกับรหัสสายจริง → ใช้เลย
2. **ไม่ตรง → เทียบแบบสลับตำแหน่งตัวเลข** เฉพาะรหัส **≥3 หลัก** และต้องหาคู่ได้ **ตัวเดียว**
(ชั้นนี้เป็น "ตัวกันพลาด" สำหรับรหัสที่พิมพ์สลับหลักในอนาคต · ค่าจริงในไฟล์ใช้รหัสตรงแล้วทุกตัว)
3. **ไม่รู้จัก / กำกวม → ไม่เดา** (คืนค่าว่าง แล้ว UI ถอยไปแสดงตำแหน่งในเส้นทาง) — เช่น `51` จะไม่ถูกจับเป็น `15`
## 5. ถ้าอนาคตจะเพิ่มรายการใหม่ (ต้องได้รับการยืนยันจากเจ้าของข้อมูลก่อน)
คีย์ที่ต้องมี: `route_id`, `station_name_th`, `city_th`, `province_th`, `station_type` (`local_stop`), `latitude`, `longitude`
คีย์เพิ่มเติม: `offsets_min` (array · นาทีจากจุดแรก · `0` = จุดแรกเอง · `null` = ยังไม่ระบุ) · `note` (ถ้ามี)
หลังเพิ่ม: หน้า `#/stops/other_stop?route=<รหัสสาย>` ต้องขึ้นชื่อจุดนั้นทันที · และ `#/routes/<รหัสสาย>` จะแสดงจุดนั้นพร้อม กม. ตามเส้นทาง
**ข้อห้าม:** อย่าเพิ่มรายการเพราะ "เห็นว่ายังไม่มี" — ถ้าไม่มีในตาราง §3 แปลว่ายังไม่ได้รับข้อมูลจากเจ้าของ
## 6. กติกา "หลายจุดต่อสาย" (สำคัญ — เจ้าของข้อมูลกำหนด)
สายเดียวผ่านได้หลายจุด (เช่น **954** = ตลาดท่าช้าง · ตลาดสามโก้ · ตลาดวิเศษชัยชาญ · ตลาดอ่างทอง
หรือ **1011** = วัดสีบัวทอง · ตลาดแสวงหา · ตลาดสดเทศบาลตำบลโพธิ์ทอง)
```json
"station_name_th": ["ตลาดท่าช้าง", "ตลาดสามโก้", "ตลาดวิเศษชัยชาญ", "ตลาดอ่างทอง"],
"latitude": 14.651061064977933, ← พิกัด "ของชื่อแรก" (ตลาดท่าช้าง)
"longitude": 100.14903762295052
```
- `station_name_th` เป็นได้ทั้ง **ข้อความเดียว** หรือ **array หลายชื่อ**
- `latitude`/`longitude` เป็นได้ทั้ง **ตัวเลขเดียว** (ของชื่อแรก) หรือ **array** จับคู่ **ตามลำดับ**
- ตัวอย่าง array: สาย 8 → `latitude: [15.0474, 14.7497, 14.6603]` + 4 ชื่อ → ชื่อที่ 4 (ตลาดอ่างทอง) ยังไม่มีพิกัด
- **ชื่อที่เกินจำนวนพิกัด = ยังไม่มีพิกัด** → เว็บแสดงชื่อพร้อมป้าย "ยังไม่มีพิกัด" (ไม่ซ่อน ไม่เดา)
- `city_th`/`province_th` ในไฟล์อธิบาย **จุดแรก** เท่านั้น (จุดอื่นไม่ทราบ)
- `offsets_min` = **นาทีจากจุดแรก** (ไม่ใช่จากจุดก่อนหน้า) → จุดแรกเป็น `0` เสมอ
**การแสดงผล:** `#/stops/other_stop?route=954` → แสดง "จุดขึ้นรถประจำทางอื่นๆ · ตลาดท่าช้าง" (ชื่อย่อ = จุดแรก)
+ รายการ **ทุกจุด** ของสายนั้น (แถวที่ไม่มีพิกัดขึ้นป้ายเตือน) · แผนที่ปักหมุดเฉพาะจุดที่มีพิกัด
+ หน้า `#/check/<สาย>` แสดงการ์ดย่อยของแต่ละจุด พร้อมเวลาที่คำนวณจากจุดอ้างอิงตาม `offsets_min`
**ข้อสังเกตของเจ้าของข้อมูล (ยังไม่แก้ ต้องยืนยัน):**
- สาย **951** และ **954** มีค่า `latitude/longitude` **เท่ากันเป๊ะ** (14.651061064977933, 100.14903762295052)
ทั้งที่จุดแรกของ 951 คือ "ตลาดวิเศษชัยชาญ" คนละที่กับ "ตลาดท่าช้าง" ของ 954 — น่าจะคัดลอกวางผิด