Thai Street Designer

เว็บออกแบบแนวคิดทางแยกและวงเวียน สำหรับการจราจรชิดซ้าย

ทิศทางปัจจุบัน (13 ต.ค. 2569)

repository นี้เป็นฐานเดียวของผลิตภัณฑ์ โดยรวมแนวคิดจาก street-concept-designer และ road-concept-builder เข้ามาในรูปแบบสเปก ไม่ใช่โค้ด เป้าหมายคือ workspace เดียวแบบ road-first ที่วิศวกรใช้งานได้โดยไม่ต้องอ่านคู่มือ ระหว่างนี้งดเพิ่มฟีเจอร์ใหม่จนกว่า workspace ใหม่จะผ่านการยอมรับ

• เหตุผลการตัดสินใจ: ADR-0001
• แผนงาน: Consolidation Roadmap
• สเปก: UX Architecture · Golden Workflows · Selection & Snapping · Pavement Marking · Glossary · Standards
• สำหรับ coding agent: AGENTS.md

รายละเอียดการปรับปรุงก่อนหน้าและข้อจำกัด: Remediation report

สำหรับการรับช่วงพัฒนาต่อ ให้เริ่มจาก AGENTS.md และ Project Context แล้วอ่าน HANDOFF.md, Architecture, Slip Lane Design Basis และ Product v1 Release Audit ก่อนแก้โค้ด โดย repository/branch/commit/PR เป็น source of truth ไม่ใช่ความจำจากบทสนทนาเดิม

Product v1 workflow

หน้าหลักคือ หน้าออกแบบ (/ และ /design) แบบวาดถนนก่อน (road-first): ถนนเป็นเจ้าของแนวและหน้าตัด ทางแยกเกิดเองตรงที่ถนนตัดกัน

1. วาดถนน (ดูดเข้าปลายถนน/แนวถนน ล็อกมุม 15° พิมพ์ความยาว) และเลือกหน้าตัดสำเร็จรูปหรือพิมพ์ค่า
2. ทางแยกสร้างให้อัตโนมัติพร้อมแจ้งเตือน ย้อนกลับได้ หรือเปลี่ยนเป็นทางต่างระดับ
3. คลิกปากทางเพื่อเพิ่มเลนเลี้ยวขวา/ซ้ายหรือ Slip lane และลากจุดบนแบบปรับระยะเก็บรถและรัศมีมุม
4. “แก้ทางแยกขั้นสูง” เปิด /junction สำหรับ 3 มิติของทางแยก ทางข้าม สัญญาณไฟ วงเวียน ช่องเปิดเกาะกลาง ลูกศร และ Slip lane ขั้นสูง แล้วนำค่ากลับมาเป็นขั้นตอนเดียวที่ย้อนได้
5. สภาพเดิม / ทางเลือก A, B… เปรียบเทียบพร้อมไฮไลต์จุดที่ต่าง
6. มุมมอง 3 มิติ ภาพอ้างอิงพร้อมตั้งมาตราส่วน แผนที่พื้นหลัง หน้าตัดตามระยะทาง
7. ส่งออกรูป PNG/SVG สำหรับรายงาน และรายงานสรุปแบบ (HTML) · บันทึก/เปิดไฟล์โครงการ (เปิดไฟล์จากหน้า Network เดิมได้)

หน้า /network เดิมปลดแล้ว (URL พาไปหน้าออกแบบ) งานที่เคยบันทึกไว้ในเบราว์เซอร์นำเข้าเป็นทางเลือกเพิ่มได้ ส่วน /roads ยังเป็นห้องทดลองแนวถนน ไม่ใช่ส่วนหลักของผลิตภัณฑ์ ดูรายการความสามารถที่ย้ายหรือตัดออกใน docs/spec/RETIREMENT_PARITY.md

Product v1 ได้รับการยอมรับและ merge เข้า main ผ่าน PR #1 แล้วเมื่อ 2026-09-30 (merge commit 98198c443b4aee96fcb25c64d5c426aa03bb8d0b). รายละเอียด release gate และข้อจำกัดที่ตั้งใจไว้บันทึกใน docs/PRODUCT_V1_RELEASE_AUDIT.md

แก้ทางแยกขั้นสูง (/junction)

เลือกทางแยกหรือวงเวียน เปิด/ปิดขาถนนให้เหลือ 3 หรือ 4 ขา จากนั้นคลิกขาถนนบนแบบเพื่อแก้ไข

• ถนน: เปลี่ยนชื่อ มุม ความยาว เลน ทางเท้า Slip lane และแถบหน้าตัด
• เส้นจราจร: เกาะกลาง ทางม้าลาย สัญญาณไฟ เส้นหยุด และลูกศร
• ริมทาง: ต้นไม้และเสาไฟ ระยะห่าง ระยะเยื้อง และการสลับฝั่ง
• ลากจุดสีเขียวปลายขาที่เลือกเพื่อเปลี่ยนมุมและความยาว ใช้การจับมุม 1/5/15 องศา หรือล็อกความยาว
• ตัวเลขยืนยันเมื่อกด Enter หรือออกจากช่อง ลากพื้นที่ว่างเพื่อเลื่อนภาพ
• Undo ย้อนการลากทั้งครั้ง บันทึกอัตโนมัติบนเบราว์เซอร์เครื่องเดิม และบันทึก/เปิด JSON เพื่อย้ายเครื่อง
• 3D: ลากปุ่มซ้ายเพื่อเลื่อน ลากปุ่มกลางเพื่อหมุน เลื่อนล้อเพื่อซูม มีระดับทางเท้า เกาะกลาง ต้นไม้ และเสาไฟ
• การแสดงผล / ส่งออก: เปิดปิดชื่อถนน สเกล ลูกศร PNG โปร่งใส JPEG พื้นขาวไม่มีกริด SVG คงพื้นหลังแบบเดิม SVG เป็นผัง 2D; PNG/JPEG ส่งออกตามมุมมอง 2D หรือ 3D ที่เลือก

ขอบเขตรุ่นนี้

ขาถนนเป็นเส้นตรงแยกมุมได้ มีระยะห่างมุมขั้นต่ำ 40 องศาเพื่อกันแบบซ้อนกัน กรณีที่พื้นที่ไม่พอสำหรับโค้ง Slip lane หรือเส้นทึบ 30 เมตรจะคงแบบเดิมและแสดงเหตุผล

หน้าตัดใช้กติกาคงที่ ซ้าย = ขาเข้าแยก / กลาง = เกาะกลาง / ขวา = ขาออกแยก ไม่กลับด้านตามทิศภูมิศาสตร์ ผู้ใช้เลือกองค์ประกอบจากผังหรือหน้าตัดและแก้ความกว้างจากหน้าตัดได้โดยตรง เลนหลักของแต่ละทิศทางใช้ความกว้างร่วมกัน ส่วนเลนเสริม/เลนรับสามารถกำหนดความกว้างแยกได้ แถบเพิ่มเติม ได้แก่ ไหล่ทาง เลนจักรยาน เลนมอเตอร์ไซค์ และพื้นที่คั่น

3D เป็นแบบฉายขนานจากพิกัดสามมิติ ใช้ Canvas และผัง SVG ชุดเดียวกัน ถนนอยู่ระดับเดียว ยังไม่มีภูมิประเทศ ความลาดชัน สะพาน การจำลองรถ การคำนวณแสง หรือการส่งออกโมเดล 3D ต้นไม้/เสาไฟเป็นชุดอัตโนมัติ ยังไม่มีการย้ายวัตถุทีละชิ้น

แบบนี้สำหรับสื่อสารแนวคิด ยังไม่ใช่แบบรับรองมาตรฐานวิศวกรรม

Source

• core/junction/model.ts: ข้อมูลแบบหลัก, schema v6, validation ระดับข้อมูล และ migration JSON รุ่นเก่า
• core/junction/geometry.ts: base junction geometry เท่านั้น — ขอบถนน ทางเท้า ปากแยก median/pocket datums; ห้ามนำ Slip logic กลับเข้ามา
• core/junction/slip-model.ts: source of truth ของ Design.slips: SlipLane[] และ lifecycle เพิ่ม/ลบ/แก้ Slip
• core/junction/slip-geometry.ts: Slip overlay geometry, tangent/width transition, approach auxiliary, departure/acceleration, crossing และ validation เฉพาะ Slip
• core/junction/design-validation.ts: รวม base-junction validation กับ Slip-overlay validation
• app/junction/drawing.tsx: ผัง SVG; render base junction และ Slip overlay แยกกัน
• core/junction/selection.ts / object-layer.tsx: selection และ drag interaction ที่อ้าง geometry ชุดเดียวกับ renderer
• app/junction/section-view.tsx / scene3d.tsx: หน้าตัดและ 3D ที่ consume Slip overlay โดยไม่แก้ base road
• core/junction/objects.ts: ตำแหน่งต้นไม้/เสาไฟร่วม 2D/3D และหลบพื้นที่ Slip overlay
• app/junction/page.tsx: เครื่องมือ ประวัติการแก้ไข autosave และส่งออก
• app/roads/page.tsx: พื้นที่ทำงานวาดถนนอิสระ (Free Draw / Network)

Slip lane architecture (schema v6)

Slip lane เป็น design-level overlay ไม่ใช่ field ใน Arm และไม่ใช้ generic Pocket เป็น source of truth อีกต่อไป กฎเหล็กคือการเพิ่ม/ลบ/ปรับ Slip ต้องไม่เปลี่ยน edges(d) ของ base junction; regression test ตรวจ edges(withSlip) === edges(base) แบบโครงสร้างตรงกัน

This is the beginning of the README. Read the rest at the original. Read the full README ↗