1. Giới thiệu tổng quan

Phân hệ Quản lý Tuyến đường (Road Routes Management) là phân hệ quản trị mạng lưới giao thông cốt lõi trong Hệ thống Quản lý và Giám sát Tín hiệu Giao thông Thông minh (ITMS). Phân hệ cung cấp mô hình quản trị dạng cây phân cấp đa cấp (Hierarchical Tree) kết hợp với bảng danh mục chi tiết nút giao tín hiệu và thiết bị ngoại vi, phản ánh chính xác cấu trúc thực tế của các tuyến trục chính, tuyến nhánh và phân đoạn giao thông đô thị.

Mục tiêu trọng tâm của phân hệ

• Quản lý phân cấp không gian mạng lưới: Cho phép phân chia mạng lưới giao thông theo các tầng: Tuyến giao thông huyết mạch cấp 1 (Tuyến gốc/Root), Tuyến nhánh cấp 2 (Sub-route) và các phân đoạn giao lộ cục bộ.
• Liên kết trực quan nút giao và thiết bị: Khi người vận hành chọn một tuyến đường bất kỳ trên cây, toàn bộ danh mục các tủ điều khiển tín hiệu, đèn giao thông và cảm biến thuộc tuyến sẽ được nạp tức thời vào bảng dữ liệu bên cạnh.
• Linh hoạt tái định vị cấu trúc cây (Move Route Parent): Hỗ trợ di chuyển toàn bộ một tuyến đường kèm các nhánh con cháu sang một tuyến cha mới hoặc đưa lên làm Tuyến gốc chỉ với vài thao tác, tự động áp dụng thuật toán kiểm soát chu trình đệ quy nhằm đảm bảo an toàn toàn vẹn dữ liệu.
• Chuẩn hóa mã định danh theo quy chuẩn REGEX_CODE: Mã tuyến đường được kiểm soát nghiêm ngặt theo định dạng chữ và số, bảo đảm tính duy nhất và khả năng truy vấn đồng bộ trên toàn bộ hệ thống cơ sở hạ tầng giao thông thông minh.
• Tích hợp hai chiều dữ liệu lớn với Excel: Cung cấp giải pháp nạp hàng loạt dữ liệu phân cấp thông qua cơ chế xử lý nền (Background Job) và xuất báo cáo kiểm kê mạng lưới tuyến đường ra tệp bảng tính chuẩn.

---

2. Điều kiện tiên quyết & Phân quyền truy cập

Để truy cập và thao tác hiệu quả trên phân hệ Quản lý Tuyến đường, người dùng cần đáp ứng các điều kiện sau:

• Tài khoản người dùng: Đã đăng nhập vào hệ thống ITMS với phiên làm việc hợp lệ thuộc đơn vị quản lý (Tenant) được giao quyền vận hành.
• Môi trường thiết bị: Sử dụng trình duyệt máy tính hiện đại (Google Chrome, Microsoft Edge, Firefox) với độ phân giải màn hình từ 1366x768 trở lên (khuyến nghị 1920x1080) để đảm bảo không gian hiển thị tối ưu cho bố cục chia đôi (Split Layout).
• Nguyên tắc phân quyền người dùng nghiệp vụ:
  • Hệ thống ITMS áp dụng cơ chế kiểm soát truy cập dựa trên quyền hạn chức năng cụ thể (Permission-based Access Control).
  • Quy tắc phân quyền: Mọi tài khoản người dùng, miễn là được quản trị viên cấp quyền hạn tương ứng trong nhóm quyền hoặc tài khoản cá nhân, đều có thể thực hiện được tác vụ mà không phân biệt chức danh hay vai trò (Role).
  • Bảng quyền hạn nghiệp vụ áp dụng cho phân hệ Quản lý Tuyến đường:

---

3. Bố cục giao diện & Vị trí truy cập

3.1 Đường dẫn truy cập trên thanh điều hướng

Người vận hành truy cập vào phân hệ theo các bước điều hướng sau:

1. Đăng nhập vào hệ thống ITMS từ trang đăng nhập quản trị.
2. Tại thanh điều hướng bên trái (Sidebar), tìm và nhấp chọn nhóm danh mục Quản lý tín hiệu giao thông.
3. Chọn mục Thiết lập.
4. Chọn tính năng Tuyến đường. Đường dẫn hệ thống hiển thị: /traffic-signal-management/settings/road-routes.

3.2 Bố cục màn hình chia đôi (Split Layout)

Giao diện phân hệ Quản lý Tuyến đường được thiết kế theo kiến trúc chia đôi hiện đại, gồm hai khu vực làm việc song song:

• Khu vực bên trái (Cây phân cấp Tuyến đường):
  • Thanh tìm kiếm nhanh tuyến đường theo từ khóa.
  • Nút công cụ "Excel" (hỗ trợ Nhập/Xuất dữ liệu danh mục).
  • Cây phân cấp tuyến đường bắt đầu từ node "Root", các nhánh mở rộng/thu gọn đa cấp, hộp kiểm và menu tác vụ 3 chấm trên từng node.
  • Cơ chế tự động nạp vô tận (Infinite Scrolling) khi cuộn chuột đến đáy cây.
• Khu vực bên phải (Bảng danh sách Nút giao & Thiết bị):
  • Thanh công cụ tìm kiếm và lọc trạng thái thiết bị của tuyến.
  • Bảng danh mục nút giao thông hiển thị chi tiết: Mã nút giao, Tên nút giao, Vị trí lắp đặt, Bản đồ và Trạng thái sử dụng.
  • Thanh điều hướng phân trang độc lập.

Phóng toToàn cảnh giao diện phân hệ Quản lý Tuyến đường

---

4. Hướng dẫn Tra cứu, Điều hướng Cây phân cấp & Bảng nút giao

4.1 Cơ chế điều hướng và mở rộng cây phân cấp

1. Nhấp chuột vào biểu tượng mũi tên tam giác bên cạnh mỗi node để Mở rộng (xem các tuyến con trực thuộc) hoặc Thu gọn (ẩn các nhánh con).
2. Khi danh sách tuyến đường vượt quá khung nhìn, cuộn chuột xuống dưới đáy cây. Hệ thống sẽ tự động kích hoạt tiến trình tải thêm các trang tiếp theo mà không làm gián đoạn trải nghiệm người dùng.

4.2 Tìm kiếm tuyến đường theo từ khóa

Hệ thống hỗ trợ tìm kiếm tức thời trên toàn bộ các nhánh của cây phân cấp:

1. Nhập từ khóa cần tìm (Mã tuyến hoặc Tên tuyến đường, ví dụ: Bình Dương) vào ô "Nhập để tìm kiếm..." tại thanh công cụ bên trái.
2. Hệ thống áp dụng cơ chế lọc tự động (Debounce) và chỉ hiển thị các nhánh cây chứa tuyến đường khớp với từ khóa tìm kiếm.
3. Để quay lại danh sách toàn bộ cây, người dùng chỉ cần xóa nội dung trong ô tìm kiếm.

Phóng toTra cứu tuyến đường theo từ khóa

4.3 Chọn tuyến đường để nạp bảng nút giao trực thuộc

1. Di chuột vào hàng tuyến đường cần tra cứu trên cây phân cấp.
2. Nhấp chuột vào nhãn tên của tuyến đường (Ví dụ: [TD01] Đại lộ bình dương).
3. Tuyến đường được chọn sẽ chuyển sang trạng thái nổi bật (Highlight), đồng thời bảng dữ liệu bên phải lập tức kích hoạt truy vấn và hiển thị danh mục các nút giao thông, vị trí lắp đặt và thiết bị gắn liền với tuyến đường đó.

---

5. Hướng dẫn Thêm mới tuyến đường

Hệ thống ITMS hỗ trợ khởi tạo cả Tuyến đường gốc (Root Route) và Tuyến đường nhánh con (Sub-route).

5.1 Mở biểu mẫu thêm mới từ nút Root

1. Định vị đến node Root ở vị trí cao nhất của cây phân cấp bên trái.
2. Nhấp chuột vào nút biểu tượng tác vụ 3 chấm (More options) ở góc phải của hàng Root.
3. Nhấp chọn mục Thêm mới trong menu thả xuống.

Phóng toMở menu tác vụ thêm mới tuyến đường gốc

5.2 Quy chuẩn dữ liệu và quy tắc REGEX_CODE

Khi hộp thoại "Thêm mới tuyến đường" xuất hiện, người dùng cần chuẩn bị thông tin theo đúng quy chuẩn hệ thống:

Phóng toHộp thoại Thêm mới tuyến đường ban đầu

5.3 Nhập dữ liệu hợp lệ và lưu trữ tuyến đường

1. Nhập mã định danh vào ô Mã tuyến đường (Ví dụ: TDTEST88).
2. Nhập tên gọi chính thức vào ô Tên tuyến đường (Ví dụ: Tuyến đường Thử nghiệm ITMS).
3. Kiểm tra tính chuẩn xác của các thông tin đã điền.
4. Nhấp nút Lưu trữ để gửi yêu cầu khởi tạo lên máy chủ hệ thống.

Phóng toNhập thông tin hợp lệ vào biểu mẫu thêm mới

5.4 Xác nhận kết quả khởi tạo trên cây danh mục

Sau khi máy chủ xử lý thành công:

1. Hệ thống tự động đóng hộp thoại thêm mới.
2. Hiển thị thông báo xác nhận thành công trên góc màn hình.
3. Node tuyến đường mới vừa khởi tạo lập tức xuất hiện trong cấu trúc cây phân cấp bên trái và sẵn sàng để quản lý hoặc gán nút giao.

Phóng toTuyến đường mới hiển thị thành công trên cây danh mục

---

6. Hướng dẫn Xem chi tiết & Chỉnh sửa thông tin tuyến đường

6.1 Mở menu tác vụ chỉnh sửa tên tuyến

Khi cần điều chỉnh thông tin tên của một tuyến đường đã có:

1. Định vị tuyến đường cần chỉnh sửa trên cây phân cấp.
2. Nhấp chuột vào biểu tượng nút tác vụ 3 chấm bên phải của hàng tuyến đường đó.
3. Chọn mục Chỉnh sửa tên từ danh mục tác vụ hiển thị.

Phóng toChọn tác vụ Chỉnh sửa tên từ menu node

6.2 Xem thông tin hiện tại trong hộp thoại

Hộp thoại "Chỉnh sửa tuyến đường" mở ra, tự động nạp sẵn toàn bộ thông tin hiện tại của bản ghi:

• Mã tuyến đường: Hiển thị mã hiệu định danh hiện tại của tuyến.
• Tên tuyến đường: Hiển thị tên gọi hiện tại trong ô nhập liệu có thể chỉnh sửa.

Phóng toHộp thoại Chỉnh sửa tuyến đường với dữ liệu hiện tại

6.3 Cập nhật tên mới và lưu thay đổi

1. Nhấp chuột vào ô Tên tuyến đường và tiến hành điều chỉnh nội dung tên gọi mới theo đúng yêu cầu nghiệp vụ.
2. Đảm bảo tên tuyến đường không vượt quá giới hạn tối đa 100 ký tự.
3. Nhấp nút Lưu trữ để hoàn tất việc cập nhật dữ liệu.

Phóng toThay đổi tên tuyến đường trong biểu mẫu

6.4 Xác nhận kết quả cập nhật trên giao diện

Hệ thống lập tức đồng bộ dữ liệu với máy chủ:

1. Hộp thoại chỉnh sửa tự động đóng lại.
2. Hiển thị thông báo cập nhật thành công.
3. Nhãn tên của tuyến đường trên cây phân cấp được làm mới ngay lập tức với nội dung vừa chỉnh sửa.

Phóng toKết quả cập nhật tên tuyến đường thành công

---

7. Hướng dẫn Di chuyển cấp cha tuyến đường (Move Route)

Tính năng Di chuyển (Move Route) cho phép người vận hành thay đổi vị trí của một tuyến đường trong cây phân cấp mạng lưới (Ví dụ: chuyển một tuyến từ trực thuộc tuyến A sang trực thuộc tuyến B, hoặc đưa một tuyến nhánh lên làm Tuyến gốc).

7.1 Kích hoạt chức năng di chuyển từ menu tác vụ

1. Định vị tuyến đường cần thay đổi cấu trúc phân cấp trên cây.
2. Nhấp chuột vào nút tác vụ 3 chấm của node đó.
3. Chọn mục Di chuyển trong danh mục tác vụ.

Phóng toChọn chức năng Di chuyển từ menu tác vụ

7.2 Xem danh mục lựa chọn cấp cha

Hộp thoại Chọn tuyến đường cha hiển thị toàn bộ danh mục cây mạng lưới của hệ thống, cho phép người dùng lựa chọn điểm đến mới:

• Root: Lựa chọn này đưa tuyến đường lên làm Tuyến cấp cao nhất (Tuyến gốc).
• Các tuyến đường khác: Lựa chọn này đưa tuyến đường hiện tại trở thành tuyến con (Sub-route) của tuyến được chọn.

Phóng toHộp thoại Chọn tuyến đường cha

7.3 Chọn tuyến cha đích và quy tắc ngăn ngừa vòng lặp

Để bảo đảm tính toàn vẹn của cấu trúc dữ liệu mạng lưới, hệ thống áp dụng cơ chế kiểm soát logic nghiêm ngặt:

1. Ngăn chặn vòng lặp tuần hoàn (Circular Dependency): Hệ thống tự động vô hiệu hóa chính tuyến đang di chuyển và toàn bộ các tuyến con cháu trực thuộc của nó trong danh sách lựa chọn. Người dùng không thể chọn chính nó hoặc con cháu làm cấp cha mới.
2. Nhấp chọn vào tuyến cha mong muốn (hoặc chọn Root).
3. Nhấp nút Áp dụng để xác nhận thay đổi cấu trúc.

Phóng toChọn tuyến đường cha đích để di chuyển

7.4 Xác nhận kết quả tái cấu trúc cây mạng lưới

Sau khi xử lý di chuyển thành công:

1. Hộp thoại lựa chọn tự động đóng lại.
2. Hệ thống phát thông báo chuyển cấp cha thành công.
3. Cây phân cấp bên trái tự động tái cấu trúc: Tuyến đường cùng toàn bộ các nhánh con phụ thuộc được định vị chính xác dưới node cha mới.

Phóng toCấu trúc cây được tái định vị thành công sau khi di chuyển

---

8. Hướng dẫn Xóa tuyến đường & Lưu ý an toàn

8.1 Kích hoạt chức năng xóa từ menu tác vụ

Khi một tuyến đường không còn nằm trong quy hoạch quản lý và cần loại bỏ khỏi hệ thống:

1. Định vị tuyến đường cần xóa trên cây phân cấp bên trái.
2. Nhấp chuột vào nút tác vụ 3 chấm của node đó.
3. Chọn mục Xóa từ danh mục tác vụ.

Phóng toChọn chức năng Xóa tuyến đường từ menu tác vụ

8.2 Xác nhận cảnh báo xóa dữ liệu

Hệ thống mở hộp thoại xác nhận bảo vệ an toàn dữ liệu:

• Hộp thoại hiển thị thông điệp: "Xóa tuyến đường - Bạn có chắc chắn muốn xóa tuyến đường?".
• Người dùng có thể nhấn Hủy yêu cầu nếu muốn giữ lại bản ghi.
• Nhấn nút Xóa để xác nhận loại bỏ tuyến đường khỏi hệ thống.

Phóng toHộp thoại cảnh báo xác nhận xóa tuyến đường

8.3 Xác nhận kết quả sau khi xóa

1. Hệ thống gửi yêu cầu xóa đến máy chủ và hiển thị thông báo thành công.
2. Tuyến đường bị xóa lập tức biến mất khỏi cây danh mục bên trái.
3. Nếu tuyến đường bị xóa trước đó đang được chọn hiển thị danh sách nút giao ở bảng bên phải, bảng bên phải sẽ tự động đặt lại trạng thái chờ chọn tuyến nhằm tránh xung đột dữ liệu mồ côi.

Phóng toKết quả sau khi xóa tuyến đường thành công

---

9. Hướng dẫn Xuất dữ liệu tuyến đường ra Excel

Tính năng Xuất dữ liệu hỗ trợ người dùng trích xuất toàn bộ danh mục cây phân cấp tuyến đường ra tệp bảng tính Excel (.xlsx) để phục vụ lưu trữ, lập báo cáo hoặc đối soát ngoại tuyến.

9.1 Mở menu chức năng Excel

1. Quan sát thanh công cụ ở phía trên của khung Cây phân cấp bên trái.
2. Nhấp chuột vào nút Excel.

Phóng toMở danh mục chức năng nút Excel

9.2 Kích hoạt tiến trình Xuất Excel

1. Trong danh mục chức năng thả xuống gồm hai tùy chọn ("Nhập Excel" và "Xuất Excel"), nhấp chọn mục Xuất Excel.

Phóng toNhấp chọn tác vụ Xuất Excel

9.3 Nhận tệp bảng tính xuất bản

1. Hệ thống tiến hành thu thập toàn bộ dữ liệu danh mục tuyến đường theo các tham số truy vấn hiện tại.
2. Hiển thị thông báo xác nhận tiến trình xuất file thành công.
3. Trình duyệt tự động tải xuống tệp bảng tính Excel với tên tệp định dạng chuẩn (Ví dụ: danh_sach_tuyen_duong.xlsx). Người dùng có thể mở tệp để xem cấu trúc mã tuyến, tên tuyến, cấp cha và số lượng thiết bị trực thuộc.

Phóng toKết quả xuất file Excel danh mục tuyến đường thành công

---

10. Hướng dẫn Nhập dữ liệu tuyến đường từ Excel

Tính năng Nhập dữ liệu từ Excel cho phép người dùng khởi tạo hàng loạt tuyến đường và thiết lập cấu trúc phân cấp nhanh chóng mà không cần thao tác thủ công từng bản ghi.

10.1 Mở hộp thoại Nhập Excel

1. Nhấp chuột vào nút Excel trên thanh công cụ của Cây phân cấp bên trái.
2. Nhấp chọn mục Nhập Excel từ danh mục thả xuống.

Phóng toChọn tác vụ Nhập Excel từ thanh công cụ

10.2 Tải tệp dữ liệu lên hệ thống

Hộp thoại "Nhập từ excel" mở ra với các quy định kỹ thuật cụ thể:

• Định dạng tệp hỗ trợ: .xlsx, .xls, .csv.
• Dung lượng tối đa: Không vượt quá 2MB.
• Số lượng bản ghi tối đa: Tối đa 1.000 dòng trong một lần nạp.
• Tệp mẫu chuẩn: Người dùng có thể nhấp vào liên kết "Nhấp chuột vào đây để tải xuống tệp mẫu" để tải file bảng tính chuẩn có cấu trúc cột quy định.

Thao tác tải tệp:

1. Kéo và thả tệp Excel chứa dữ liệu tuyến đường vào vùng khung nét đứt, hoặc nhấp nút Chọn file để duyệt tệp từ máy tính.
2. Nhấp nút Tải lên để gửi tệp lên hệ thống xử lý.

Phóng toHộp thoại Nhập tệp Excel và quy chuẩn tệp

10.3 Giám sát tiến trình xử lý nền

Để không làm đơ giao diện khi xử lý danh mục lớn:

1. Hệ thống tiếp nhận tệp và chuyển sang cơ chế xử lý nền (Background Worker).
2. Thông báo tiếp nhận tác vụ hiển thị trên hệ thống thông báo trung tâm, cập nhật trạng thái tiến trình xử lý theo thời gian thực thông qua kết nối WebSocket.

Phóng toHệ thống tiếp nhận tác vụ xử lý nạp dữ liệu nền

10.4 Đồng bộ kết quả vào cây mạng lưới

1. Khi tiến trình xử lý nền hoàn tất, hệ thống gửi thông báo xác nhận số lượng bản ghi nạp thành công.
2. Cây phân cấp tuyến đường bên trái tự động làm mới bộ nhớ cache và hiển thị đầy đủ danh mục các tuyến đường mới được nạp vào hệ thống.

Phóng toKết quả nạp dữ liệu Excel thành công vào hệ thống

---

11. Xử lý sự cố & Bảng câu hỏi thường gặp (FAQ)

Câu hỏi 1: Tại sao khi nhấp vào một tuyến đường trên cây, bảng bên phải không hiển thị nút giao nào?

• Giải thích: Điều này xảy ra khi tuyến đường vừa được khởi tạo và chưa được liên kết với bất kỳ nút giao thông hoặc thiết bị nào trên bản đồ số.
• Khắc phục: Truy cập phân hệ Quản lý Nút giao thông để gán các nút giao tương ứng vào tuyến đường này.

Câu hỏi 2: Tại sao một số tuyến đường bị làm mờ (disabled) trong hộp thoại Di chuyển (Move Route)?

• Giải thích: Hệ thống tự động vô hiệu hóa chính tuyến đường đang được di chuyển và toàn bộ các tuyến đường con cháu trực thuộc của nó nhằm ngăn ngừa việc tạo ra vòng lặp chu trình đệ quy vô tận trong cây phân cấp dữ liệu.
• Khắc phục: Chỉ chọn các tuyến đường cha hợp lệ nằm ngoài nhánh phân cấp của tuyến hiện tại, hoặc chọn Root để đưa tuyến lên cấp cao nhất.

Câu hỏi 3: Quy tắc đặt Mã tuyến đường như thế nào là hợp lệ?

• Giải thích: Hệ thống áp dụng cấu hình REGEX_CODE = /^[A-Za-z0-9]+$/. Mã tuyến đường chỉ được bao gồm các ký tự chữ cái (A-Z, a-z) và chữ số (0-9), tối đa 50 ký tự. Không được chứa dấu cách, dấu gạch nối (-), gạch dưới (_) hay ký tự có dấu.
• Ví dụ đúng: TD01, QL1A, VOVANVAN02.

Câu hỏi 4: Có thể xóa một tuyến đường cha đang chứa các tuyến con bên dưới không?

• Giải thích: Để đảm bảo an toàn toàn vẹn dữ liệu, nếu một tuyến đường cha đang chứa các nhánh con hoặc thiết bị phụ thuộc, hệ thống sẽ yêu cầu người vận hành di chuyển các tuyến con sang tuyến cha khác hoặc xóa các nhánh con trước khi xóa tuyến đường cha.

---

12. Kênh hỗ trợ kỹ thuật

Trong quá trình vận hành phân hệ Quản lý Tuyến đường trên hệ thống ITMS, nếu người dùng cần thêm thông tin hỗ trợ kỹ thuật hoặc báo cáo vướng mắc nghiệp vụ, vui lòng liên hệ:

• Trung tâm Điều hành & Hỗ trợ Kỹ thuật ITMS:
  • Đường dây nóng hỗ trợ: 1900 xxxx (Hoạt động 24/7)
  • Hộp thư tiếp nhận yêu cầu: support@itms.vn
  • Cổng thông tin hỗ trợ khách hàng: https://support.itms.vn
• Bộ phận Hỗ trợ Vận hành Trực tiếp:
  • Thời gian hỗ trợ hành chính: Từ thứ Hai đến thứ Sáu (08:00 - 17:30).

---

Phụ lục tài liệu

Phụ lục A: Bảng mã trạng thái phản hồi & Thông báo giao diện

---

Phụ lục B: Bảng phím tắt & Thao tác nhanh

---

Phụ lục C: Quy chuẩn cấu trúc dữ liệu & Tiêu chuẩn vận hành

1. Quy chuẩn mã định danh tuyến đường (code):
   • Định dạng tuân thủ biểu thức chính quy REGEX_CODE = /^[A-Za-z0-9]+$/.
   • Độ dài: Từ 1 đến 50 ký tự chữ cái và số, không khoảng trắng, không ký tự đặc biệt.
2. Quy chuẩn tên gọi tuyến đường (name):
   • Độ dài tối đa: 100 ký tự.
   • Nội dung rõ ràng, thể hiện đầy đủ cấp độ và tên địa danh của tuyến đường (Ví dụ: Đại lộ Bình Dương, Đường Cách Mạng Tháng 8).
3. Quy chuẩn tệp Excel nhập danh mục:
   • Định dạng: .xlsx, .xls, .csv.
   • Dung lượng: Tối đa 2MB.
   • Giới hạn: Không quá 1.000 dòng dữ liệu cho mỗi lần nạp.

---

Phụ lục D: Lịch sử cập nhật tài liệu