Thử một phương án, giữ lại bằng chứng.
Đây là project mô phỏng xã/phường giả định. Tất cả công trình, tọa độ, phương tiện, hồ sơ và bản tin cảm biến đều được sinh bằng phần mềm.
1. Khởi động
Giải nén project, cài Python 3.11 trở lên rồi chạy START_WINDOWS.bat. Trình duyệt mở địa chỉ cục bộ. Không cần pip, tài khoản, khóa API hay tải bản đồ. Giữ cửa sổ Python mở trong lúc sử dụng. Đóng bằng Ctrl+C; nhật ký lệnh đã hoàn tất được lưu trong data/runs.
2. Vận hành và chọn đối tượng
Bấm Chạy mô phỏng. Nút bước chạy đúng một bước rồi dừng. Tốc độ 30× nghĩa là mục tiêu 30 giây mô phỏng cho một giây thực; máy chậm có thể chạy thấp hơn. Nhấp đối tượng trên GIS hoặc 3D để thấy cùng một mã và mẫu quan sát. Mô hình 3D phóng đại chiều cao ×3 và kích thước phương tiện để dễ quan sát, không phải mô hình đo đạc.
3. Thêm đối tượng có hoạt động
Chọn mẫu Điểm thu gom; đổi tốc độ phát sinh hoặc vị trí; Tạo bản nháp → Kiểm tra → Kích hoạt. Chạy thêm một bước để thấy lượng rác thay đổi. Tương tự, quầy mới nhận hồ sơ, xe mới nhận chuyến và trạm sạc mới phục vụ xe có năng lượng thấp. Xe/đường sử dụng vị trí nút và liên kết khai báo; tọa độ click không làm thay đổi hình học của đường tham chiếu.
Mẫu đường cần hai nút khác nhau. Các nút mạng có sẵn trong V02; giao diện chưa có chức năng thêm nút. Tạm dừng hoặc kết thúc có kiểm tra phụ thuộc và công việc đang xử lý. Muốn đổi tham số đã tạo, hãy tạo đối tượng mới từ mẫu; V02 chưa cung cấp trình sửa tham số đối tượng.
4. Lưu, phân nhánh và so sánh
Tạm dừng ở thời điểm cần thử. Mở tab Thử nghiệm, đặt tên và Lưu ảnh chụp. Tạo nhánh A từ mốc này, áp dụng kịch bản cơ sở, chạy 60 bước. Mở lại nhánh gốc, chọn đúng ảnh chụp, tạo nhánh B và áp dụng kịch bản tăng tải; chạy cùng 60 bước. Chọn nhánh A làm tham chiếu rồi bấm So sánh. Hai nhánh phải có cùng thời điểm mô phỏng.
Nút Kiểm tra phát lại chạy lại toàn bộ nhật ký lệnh trong một bản sao độc lập và so hash trạng thái sau từng lệnh. Đây là kiểm tra tính tái lập, không phải chức năng kéo thanh thời gian đến mọi khung hình. Muốn quay về mốc cũ để vận hành, tạo nhánh từ ảnh chụp.
5. Báo cáo
Xuất báo cáo tạo thư mục mới trong Reports gồm chỉ số CSV, mẫu quan sát gần nhất, phép cân bằng hồ sơ/rác, snapshot, nhật ký lệnh đầy đủ và bản sao mã nguồn. Mỗi báo cáo có hướng dẫn phát lại bằng dòng lệnh.
6. Phạm vi khoa học
Phân tích V02 dùng giá trị gần nhất, xu hướng tuyến tính và ngưỡng. Chưa huấn luyện hoặc đánh giá mô hình học máy. Mô hình giao thông, thu gom và phục vụ là mô hình cơ sở minh họa, cần hiệu chỉnh khi sử dụng dữ liệu thực. Hai adapter hiện tại đều truyền dữ liệu giả lập. Lộ trình kết nối thật, các giới hạn và đối chiếu KPI xem tại docs/.