# HL-DEMO-001 / Scan-to-HBIM workflow / V3.0.0

HỒ SƠ HƯỚNG DẪN / BÀI TẬP TỔNG HỢP - Không phải khảo sát thực địa; không dùng thi công hoặc tự chứng nhận HBIM.

## Bắt đầu
Đọc So-tay-Scan-to-HBIM.pdf. Mỗi T01–T14 có task.md, worksheet.json, evidence.png và tệp minh họa/đầu ra. Các worksheet là biểu mẫu trống, không phải nghiệm thu. T05–T08, T10–T13 có thao tác chạy thật trên dữ liệu tổng hợp; các công việc hiện trường chưa thực hiện.

## Bài thử SYN-C01
Dữ liệu quan sát được sinh bằng hàm toán học, có nhiễu, vùng thiếu và hai hệ tọa độ. Không lấy từ nhà V2 hay từ IFC. Sau đó ước lượng đăng ký, lọc, khớp tiết diện/trục rồi mới dựng IFC. Bài thử này không chứng minh chất lượng đo thực tế. T03 có 6 điểm fit + 2 điểm giữ lại, tất cả tổng hợp. T12 tính khoảng cách tới mặt bên trụ lý tưởng vô hạn, không kiểm mặt đầu hoặc vùng không có điểm. Không dùng các trị số làm thông số năng lực Heritage Labs.

## Tệp và công cụ
PLY ASCII: tọa độ mét, mở bằng phần mềm đọc point cloud hỗ trợ PLY; không có intensity, ảnh quét, dữ liệu máy gốc hoặc hệ địa lý. IFC4: một IfcColumn, hình đùn tiết diện tròn, trục nghiêng, quan hệ tầng, HL_Provenance và liên kết tài liệu. Đã mở lại/tạo hình bằng IfcOpenShell; chưa kiểm trong Revit/Archicad. JSON/Markdown có thể chỉnh sửa bằng trình soạn thảo. Không có E57/RVT hoặc DWG giả.

## Tái lập
scripts/practice.py là mã chạy bài thử; cần Python, numpy, scipy, matplotlib, ifcopenshell. Xem phiên bản trong T14/environment.json. Chạy trong bản sao thư mục gói bằng `python scripts/practice.py`; không chạy đè bản đã phát hành. Kết quả số có thể khác rất nhỏ theo phiên bản thư viện; không so SHA của IFC làm kiểm số vì GUID mới.

## Quyền và giới hạn
Không có dữ liệu khảo sát riêng hoặc bộ dữ liệu công khai được tái phân phối. Hình là bảng tự biên soạn hoặc đồ thị tính toán; không có ảnh AI/ảnh chụp giao diện giả. Nguồn chỉ dẫn trong sources.json, không tái bản tài liệu gốc. Các quy trình là đề xuất nội bộ, chưa chứng nhận tuân thủ tiêu chuẩn.

## Chuyển sang dự án thật
Tạo mã dự án mới; xác nhận quyền, mục đích, người khảo sát/kiểm/duyệt, dữ liệu máy gốc, mốc/điểm kiểm, vùng phủ và bộ yêu cầu thông tin. Thử một cấu kiện trước khi nhân rộng. Không đổi nhãn bài tổng hợp thành khảo sát thực.

## Riêng tư
Web giữ owner-only. Gói tải có thể bị chia sẻ thủ công; nhãn nguồn gốc luôn phải đi cùng tệp. Chưa có CDE nhiều vai trò, kho sao lưu dự phòng hay diễn tập phục hồi dữ liệu thực.
