docs(pv): document gov-API pv_connection enum on the domain field 🟪

0 = no PV, 1 = not connected to dwelling meter, 2 = connected. Decoded
empirically from the corpus + accredited Elmhurst (the gov RdSAP schema
types it as a bare int). Points readers to the crediting gate.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Khalim Conn-Kowlessar 2026-06-29 13:50:01 +00:00
parent 9927169e23
commit 08d9e46481

View file

@ -370,7 +370,12 @@ class SapEnergySource:
wind_turbines_terrain_type: str # int in API, str (e.g. "Suburban") in site notes
electricity_smart_meter_present: bool
pv_connection: Optional[Union[int, str]] = None # int from API; str from site notes
# gov-API enum (int): 0 = no PV, 1 = PV present but NOT connected to the
# dwelling's own electricity meter (communal / separately metered), 2 = PV
# connected to the dwelling's meter. Per RdSAP 10 §11.1 / SAP 10.2 Appendix M,
# PV is credited to the dwelling's SAP only when connected (== 2); see
# `_pv_connected_to_dwelling_meter` in cert_to_inputs. str from site notes.
pv_connection: Optional[Union[int, str]] = None
photovoltaic_supply: Optional[PhotovoltaicSupply] = None
photovoltaic_arrays: Optional[List[PhotovoltaicArray]] = None
wind_turbine_details: Optional[WindTurbineDetails] = None