QUANGANHCONS — DỮ LIỆU MÔ PHỎNG MẪU 100 kWp
Ngày phát hành nội dung: 02/11/2026
Configuration ID: pv-100
Snapshot dự toán tham chiếu: QAC-SOL-EST-20261102-D8AA0A54
Phiên bản mô phỏng: qac-solar-energy-supplement/1.0.0

ĐẦU VÀO RIÊNG CỦA HỒ SƠ
Công suất danh nghĩa của nội dung: 100.0 kWp.
DC lắp thực: 100.48 kWp. Trần AC: 90.0 kW.
Nhóm tải: industrial; các giá trị tải theo giờ nằm trong load-assumptions-24h.csv.
Tọa độ mẫu TP.HCM: 10.8231, 106.6297; không phải địa chỉ công trình đã khảo sát.
PVGIS v5.3 / ERA5 / năm lịch sử 2023 / 1 kWp nguồn / crystSi / nghiêng10° / hướng Nam0° / loss14% / mountingplace=free / built-in terrain horizon.
Không BESS, không phát ngược, không tính doanh thu điện dư. Tải là giả định biên tập.

KẾT QUẢ NĂM TRONG CỬA SỔ 8.760 GIỜ
PV khả dụng sau trần AC: 141245.354957 kWh.
PV tự dùng: 124616.859411 kWh.
PV dư phải hạn chế: 16628.495546 kWh.
Tải giả định: 283488.000000 kWh.
Điện lấy từ lưới: 158871.140589 kWh.
Tỷ lệ tự dùng PV: 88.227227%.
Tỷ lệ tải được PV đáp ứng: 43.958425%.
Đây không phải kết quả đo thực, dự báo hoặc bảo đảm sản lượng.

CẤU TRÚC TỆP
energy-summary.json: nguồn, tất cả đầu vào, mô hình, tổng năm/tháng/ngày, ví dụ giờ, công thức–thay số–kết quả và giới hạn.
hourly.csv: 8.760 bản ghi, mỗi dòng đại diện một khoảng giờ.
monthly.csv: tổng 12 tháng theo lịch UTC.
representative-day.csv: 24 khung giờ trung bình theo giờ Việt Nam, 365 quan sát/khung giờ.
load-assumptions-24h.csv: phụ tải GIẢ ĐỊNH theo giờ, tách thứ Hai–thứ Bảy và Chủ nhật.
monthly-energy.svg, representative-day.svg: biểu đồ vector mở độc lập trong trình duyệt.
source/pvgis-5.3-era5-hcm-2023-1kwp.json: nguyên response JSON từ API chính hãng, không sửa.
source/pvgis-source-provenance.json: truy vấn đầy đủ, HTTP status, ngày tải và SHA-256 response.
source/load-model-assumptions.json: trọng số/lịch tải và các giả định chung.

ĐƠN VỊ VÀ QUY ƯỚC CỘT
CSV mã hóa UTF-8 có BOM, dấu phẩy tách cột, dấu chấm thập phân. Khi Excel dùng vùng Việt Nam, nhập bằng Data → From Text/CSV và chọn UTF-8/comma.
timestamp_midpoint_utc: thời điểm giữa khoảng giờ, UTC (HH:30).
timestamp_midpoint_vietnam: cùng thời điểm ở UTC+07:00.
interval_hours: độ dài khoảng giờ = 1 giờ.
month_utc: tháng1–12 theo UTC. hour_local/local_hour_start: giờ0–23 tại Việt Nam. weekday_local_monday_0:0=thứ Hai…6=Chủ nhật.
source_power_w_per_kwp: công suất W của phép chạy PVGIS với hệ1kWp; đã gồm system loss14%.
poa_irradiance_w_m2 / poa_direct_w_m2 / poa_diffuse_w_m2 / poa_reflected_w_m2: bức xạ trên mặt nghiêng theo W/m².
poa_irradiation_kwh_m2: năng lượng bức xạ tích phân theo kWh/m².
air_temperature_c:°C; wind_10m_m_s:m/s; radiation_reconstruction_flag:cờ0/1 của nguồn PVGIS.
pv_scaled_kw: công suất PV đã scale theo DC lắp thực, trước trần AC.
ac_clipping_kw: phần công suất mất do trần AC.
pv_available_kw: công suất khả dụng sau trần AC, trước hạn chế không phát ngược.
load_kw: công suất tải giả định.
pv_self_consumed_kw: công suất PV dùng trực tiếp cho tải.
potential_surplus_kw: công suất PV khả dụng còn dư sau tự dùng.
zero_export_curtailment_kw: công suất PV dư bị hạn chế trong kịch bản không phát ngược; bằng potential_surplus_kw.
grid_import_kw: công suất lấy từ lưới. grid_export_kw:luôn0 trong kịch bản này.
Các cột hậu tố _kwh là tổng công suất×1giờ trên nhóm tương ứng, không phải kW. Các cột _kw_mean là công suất trung bình cùng khung giờ địa phương. _percent dùng đơn vị phần trăm (0–100). export_revenue_vnd=0VNĐ.
Do mỗi bước là1giờ, số kW bình quân của một hàng bằng số kWh của chính khoảng đó; vẫn phải giữ đúng đơn vị khi cộng theo thời gian.

KIỂM TRA VÀ GIỚI HẠN
PV khả dụng = PV tự dùng + PV dư hạn chế.
Tải = PV tự dùng + lấy từ lưới.
PV đã scale = PV khả dụng + clipping.
Tổng tháng = tổng8.760giờ. Tổng24giờ trung bình×365 = tổng8.760giờ.
Các đẳng thức được kiểm tra trước khi đóng gói. Cần giữ đầy đủ thông báo giả định và nguồn khi trích số liệu.

QUANGANHCONS — PHẦN BỔ SUNG MÔ PHỎNG NĂNG LƯỢNG / TẢI
Ngày nội dung: 02/11/2026

1. PHẠM VI
10 cấu hình PV không BESS: 3, 5, 10, 20, 30, 50, 100, 250, 500 và 1.000 kWp danh nghĩa. DC lắp thực và AC danh định đọc từ customer-publish.json đã xuất bằng Solar 8.21.0. Phần bổ sung này không phải kết quả native của engine, không sửa dự toán, giá, XLSX hoặc PDF đã QA.

2. NGUỒN THỰC
Đã tải trực tiếp API công khai PVGIS v5.3, HTTP 200, đủ 8.760 bản ghi giờ năm 2023. Giữ nguyên response JSON và SHA-256 trong pvgis-source-provenance.json. Tọa độ giả định TP.HCM 10.8231,106.6297; PVGIS-ERA5, 1 kWp, crystSi, angle=10, aspect=0 (Nam), loss=14, mountingplace=free, terrain horizon. Dữ liệu là khí tượng lịch sử tái phân tích 2023 và công suất PV mô hình, không sensor, không TMY, không forecast. Phiên bản API được ghim; PVGIS 6 đã có cập nhật ngày 19/10/2026, nên không gọi 5.3 là API mới nhất.

Kết quả nguồn: 1.405,70616 kWh/kWp; bức xạ trên mặt pin 1.902,4427 kWh/m²; công suất giờ tối đa 741,51 W cho 1 kWp; cờ tái dựng bức xạ đều bằng 0.

3. MÔ HÌNH
P_scaled = P_PVGIS_W / 1000 × DC_lắp_thực.
P_available = min(P_scaled, AC_danh_định).
P_self = min(P_available, P_load).
P_surplus = max(P_available − P_load, 0).
Không BESS, không phát ngược: P_curtail=P_surplus; P_export=0.
P_grid = max(P_load − P_available, 0).
E = tổng P × 1 giờ. Doanh thu điện dư = 0; không tính tiết kiệm tiền hoặc hoàn vốn.
Tổn thất 14% đã nằm trong công suất PVGIS, không trừ lặp hoặc nhân thêm hiệu suất inverter.

Nhà ở (3/5/10/20): 4 kWh/ngày trên mỗi kWp DANH NGHĨA, chia theo 24 trọng số trong load-model-assumptions.json; ngày nào cũng giống nhau. Ví dụ 5 kWp dùng 20 kWh/ngày. Đây là giả định biên tập, không định mức hoặc kết quả khảo sát.
Sản xuất (30–1.000): tải nền 0,08 kW/kWp danh nghĩa, giờ sản xuất chính 0,80, có giảm giờ nghỉ trưa và chuyển ca; thứ Hai–thứ Bảy làm việc, Chủ nhật tải nền. Bảng đủ 24 giờ nằm trong từng profile. Không mô phỏng lễ hoặc mùa.

Thời gian nguồn là điểm giữa mỗi khoảng giờ (HH:30 UTC). Tải lấy theo giờ Việt Nam UTC+7. Tổng tháng theo lịch UTC của bộ nguồn. Cửa sổ dữ liệu 01/01/2023 00:00–01/01/2024 00:00 UTC, tương ứng 01/01/2023 07:00–01/01/2024 07:00 tại Việt Nam. Không âm thầm xoay dữ liệu để gọi là năm lịch địa phương.
Ngày đại diện là trung bình 365 điểm cho mỗi khung giờ địa phương, không phải một ngày đo thật. Tự dùng tính từng giờ rồi mới lấy trung bình; không lấy min của hai đường cong trung bình.

4. TỆP DÙNG ĐỂ GHÉP WEBSITE
Mỗi pv-*/energy-supplement.html có sẵn nội dung, bảng tháng, lịch tải 24 giờ, 9 công thức–thay số–kết quả và 2 SVG nội tuyến. Có thể đặt vào phần mô phỏng năng lượng của trang đúng cấu hình.
energy-summary.json: số liệu, định danh, giả định, nguồn và giới hạn đầy đủ.
hourly.csv: 8.760 bản ghi mỗi cấu hình, timestamp UTC/VN và các dòng năng lượng.
monthly.csv: 12 tháng UTC, bức xạ, sản lượng, tự dùng, dư hạn chế, tải và điện lưới.
representative-day.csv: 24 giờ trung bình theo giờ Việt Nam.
load-assumptions-24h.csv: phụ tải giả định theo thứ Hai–thứ Bảy và Chủ nhật.
monthly-energy.svg và representative-day.svg: hai biểu đồ vector; PNG là bản xem/QA.
energy-comparison-10pv.csv: bảng so sánh 10 mẫu.

5. KIỂM TRA
energy-qa-and-results.json: 10/10 qua giới hạn AC, cân bằng PV/tải, clipping, tổng tháng = năm, trung bình ngày ×365 = năm, đủ 8.760 giờ liên tiếp, không xuất điện/doanh thu dư. Có 90 thẻ công thức ba bước bổ sung.
charts-visual-qa.json: kiểm tra 20 biểu đồ, chữ Việt, đơn vị, legend, nguồn và ghi chú.
Giá trị clipping bằng 0 trong cả 10 mẫu vì đỉnh công suất giờ của bộ nguồn thấp hơn trần AC; không kết luận clipping thực tế dưới giờ bằng 0.

6. GIỚI HẠN BẮT BUỘC GIỮ KHI ĐĂNG
Tọa độ, tải, nhiệt thông gió, tổn thất và điều khiển zero-export là giả định mẫu. Chưa gồm bóng che vật cản gần, đường cong chính xác theo model, ngừng máy, suy giảm theo năm, điện áp/dòng/MPPT từng thiết bị, dữ liệu công tơ, sự cố lưới. Không phải thiết kế được duyệt hoặc bảo đảm sản lượng. Thay bằng dữ liệu địa điểm và phụ tải thực trước khi chốt công trình.

7. TÁI LẬP
python solar_execution/engine_work/energy_supplement/build_energy_supplement.py
Đọc response đã lưu, không cần mạng và không sửa engine/site. fetch_pvgis.py là tác vụ tải nguồn riêng; không cần chạy lại để tái lập.

Nguồn chính hãng:
https://joint-research-centre.ec.europa.eu/photovoltaic-geographical-information-system-pvgis/using-pvgis-5/api-non-interactive-service_en
https://joint-research-centre.ec.europa.eu/photovoltaic-geographical-information-system-pvgis/using-pvgis-5/pvgis-5-user-manual_en
https://joint-research-centre.ec.europa.eu/photovoltaic-geographical-information-system-pvgis/using-pvgis-5/pvgis-5-tools/hourly-radiation_en
https://photovoltaic-geographic-information-system.ec.europa.eu/api/release-notes
