Kiến Trúc Hệ Thống: 3D Digital Survey Tool (Phần Mềm Khảo Sát)

Mục Đích: Tài liệu này ghi nhận lại toàn bộ kiến trúc phần mềm, stack công nghệ và luồng dữ liệu của Công cụ Khảo sát Kỹ thuật số 3D (3D Digital Survey Tool) – vũ khí giúp Sales BLVera tạo cảm giác “Wow” cho khách hàng ngay từ giai đoạn đầu.

1. Technology Stack (Công Nghệ Cốt Lõi)

Hệ thống được xây dựng để đảm bảo tính toán thời gian thực (real-time) ngay trên trình duyệt mà không cần tải thêm ứng dụng:

Frontend Framework: React (Quản lý trạng thái và luồng dữ liệu UI).
3D Engine: Three.js (Dựng hình mảng pin 3D và mô phỏng đổ bóng thời gian thực).
Compute: WebAssembly (WASM) (Xử lý các thuật toán nặng như hình học bóng râm và phương trình quỹ đạo mặt trời).
Build Tool: Vite (Tối ưu hóa bundle và code splitting).
Hosting: Static CDN (Đảm bảo tốc độ tải trang cực nhanh).

2. Rendering Pipeline (Luồng Dựng Hình 3D)

Công cụ hỗ trợ 3 chế độ dựng hình để tương thích với mọi thiết bị của khách hàng:

GPU (WebGL): Chế độ tiêu chuẩn, sử dụng phần cứng đồ họa. Mảng pin được dựng bằng InstancedMesh của Three.js, cho phép render hàng trăm tấm pin trong 1 draw call duy nhất. Duy trì ổn định ở mức 60 FPS.
CPU (WASM): Chế độ tương thích (Fallback) cho các máy tính đời cũ không hỗ trợ WebGL.
AUTO: Tự động phát hiện và chuyển đổi giữa GPU và CPU.

3. Data & State Flow (Luồng Trạng Thái & Tính Toán)

Luồng dữ liệu đi theo mô hình 1 chiều (Unidirectional) cực kỳ tối ưu:

[Survey Inputs] (Kích thước mái, hướng nhà) 
       ↓
[Calculation Engine] (Tính toán vật lý) 
       ↓
[3D Renderer] (Hiển thị trực quan Three.js)
       ↓
[BOM Generator] (Sinh Bảng khối lượng tự động)
       ↓
[ROI Calculator] (Tính điểm hòa vốn)
       ↓
[PDF/Excel Export] (Client-side rendering < 2 giây)

4. AI Smart Optimize (Tối Ưu Hóa Tự Động Bằng AI)

Module AI của công cụ tự động đề xuất cấu hình dựa trên thuật toán tối ưu hóa:

Panel count: Tối đa hóa diện tích phủ mái sau khi đã trừ đi các vật cản (bồn nước, giếng trời).
Tilt angle (Góc nghiêng): Tự động tính toán góc tối ưu dựa trên vĩ độ địa lý (Latitude) để đón bức xạ tốt nhất.
Row spacing (Khoảng cách hàng): Tự động giãn cách các hàng pin để tránh bóng râm đổ lên nhau (Shading), kết hợp với hệ số tải trọng gió.
Panel orientation: Quyết định đặt dọc (Portrait) hay ngang (Landscape) để nhét được nhiều pin nhất.

5. Performance Benchmarks (Tiêu Chuẩn Hiệu Năng)

Initial SPA Load: 3 - 5 giây (Bao gồm tải runtime WebAssembly và Three.js).
BOM Calculations: Cập nhật bảng vật tư (BOM) trong vòng < 50ms ngay khi người dùng thêm/bớt 1 tấm pin trên mô hình 3D.
PDF Generation: Tự động tạo bản Proposal PDF trực tiếp trên máy khách (Client-side) trong vòng < 2 giây, không tạo áp lực lên server.

6. Catalog Schema (Cấu Trúc Dữ Liệu Thiết Bị)

Mọi thiết bị (Tấm Pin, Inverter, Pin Lưu Trữ) được số hóa và đẩy vào công cụ 3D theo chuẩn JSON sau:

interface CatalogItem {
  type: 'PV' | 'Inverter' | 'Battery' | 'Accessory';
  brand: string;
  model: string;
  name: string;
  price: number;
  currency: 'VND' | 'USD';
  capacityKW?: number;       // Dành cho Inverter
  capacityKWh?: number;      // Dành cho Pin lưu trữ
  length?: number;           // Kích thước vật lý để dựng 3D
  width?: number;
  thickness?: number;
  unit: string;
  warrantyYears: number;
}

Kết luận: Công cụ 3D này không chỉ là bản vẽ đẹp mắt, nó là một cỗ máy tính toán BOM và ROI ngay tức thì (real-time). Nó đóng vai trò “Vũ khí chốt Sale” trực quan nhất trong bộ công cụ của BLVera.