mirror of
https://github.com/Hestia-Homes/Model.git
synced 2026-06-08 11:17:27 +00:00
76717dfc3a
Stage 2 of First Run. Establishes each Property's Baseline Performance from persisted source data and writes it back — reads only from repos, never a Fetcher or HTTP (ADR-0003), so it is byte-identical whether Ingestion ran milliseconds ago or last week. Domain (`domain/baseline/`): - `Performance` VO — the four rated quantities: SAP / EPC Band / CO2 / Primary Energy Intensity. `lodged_performance(epc)` reads them off the EPC's recorded fields (PEUI = `energy_consumption_current`). - `BaselinePerformance` (ADR-0004) — the paired `lodged` + `effective` Performance + `rebaseline_reason`, plus the no-derivation part of the energy block (`space_heating_kwh` / `water_heating_kwh`, off the RHI, deterministic per ADR-0006). Both halves always populated. - `Rebaseliner` port + `StubRebaseliner`: the re-score-on-override seam (ADR-0011). SAP10 certs pass through (effective == lodged, reason "none"); a pre-SAP10 cert raises `RebaselineNotImplemented` rather than fabricating a plausible-but-wrong "none" — ML rebaselining is not wired yet. Mirrors the repo's strict-raise culture. Persistence: new `BaselineRepository` port + `BaselinePostgresRepository` + flat-column `baseline_performance` SQLModel (one row per Property). Per ADR-0004's amendment this is a standalone table, NOT columns on the retiring `property_details_epc`. Production migration is FE-owned (Drizzle) — docs/migrations/baseline-performance-table.md. Docs (grill-with-docs): corrected CONTEXT.md Lodged/Effective Performance to Primary Energy Intensity (the term collided with its own _Avoid_ entry under "heat demand") + fixed stale RHI field names; amended ADR-0004 Consequences for the standalone-table decision. Fuel split + bills (rest of EPC Energy Derivation) deferred to a follow-up — they need a Fuel Rates source (Ofgem-cap ETL) that does not exist yet. TDD, one test -> one impl: 7 tests (lodged read, rebaseliner pass-through + raise, orchestrator establish-and-persist + pre-SAP10 raise, Postgres round-trip + absent). pyright strict clean; AAA layout. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
77 lines
3 KiB
Python
77 lines
3 KiB
Python
from __future__ import annotations
|
|
|
|
from typing import ClassVar, Optional, cast
|
|
|
|
from sqlmodel import Field, SQLModel
|
|
|
|
from datatypes.epc.domain.epc import Epc
|
|
from domain.baseline.baseline_performance import BaselinePerformance
|
|
from domain.baseline.performance import Performance
|
|
from domain.baseline.rebaseliner import RebaselineReason
|
|
|
|
|
|
class BaselinePerformanceModel(SQLModel, table=True):
|
|
"""The ``baseline_performance`` row — one per Property (ADR-0004).
|
|
|
|
Flat typed columns (not a JSONB blob) so the FE can both surface the block
|
|
and query the lodged-vs-effective pair. The production migration is FE-owned
|
|
(Drizzle); see docs/migrations/baseline-performance-table.md.
|
|
"""
|
|
|
|
__tablename__: ClassVar[str] = "baseline_performance" # pyright: ignore[reportIncompatibleVariableOverride]
|
|
|
|
id: Optional[int] = Field(default=None, primary_key=True)
|
|
property_id: int = Field(unique=True, index=True)
|
|
|
|
lodged_sap_score: int
|
|
lodged_epc_band: str
|
|
lodged_co2_emissions: float
|
|
lodged_primary_energy_intensity: int
|
|
|
|
effective_sap_score: int
|
|
effective_epc_band: str
|
|
effective_co2_emissions: float
|
|
effective_primary_energy_intensity: int
|
|
|
|
rebaseline_reason: str
|
|
|
|
space_heating_kwh: float
|
|
water_heating_kwh: float
|
|
|
|
@classmethod
|
|
def from_domain(
|
|
cls, baseline: BaselinePerformance, property_id: int
|
|
) -> "BaselinePerformanceModel":
|
|
return cls(
|
|
property_id=property_id,
|
|
lodged_sap_score=baseline.lodged.sap_score,
|
|
lodged_epc_band=baseline.lodged.epc_band.value,
|
|
lodged_co2_emissions=baseline.lodged.co2_emissions,
|
|
lodged_primary_energy_intensity=baseline.lodged.primary_energy_intensity,
|
|
effective_sap_score=baseline.effective.sap_score,
|
|
effective_epc_band=baseline.effective.epc_band.value,
|
|
effective_co2_emissions=baseline.effective.co2_emissions,
|
|
effective_primary_energy_intensity=baseline.effective.primary_energy_intensity,
|
|
rebaseline_reason=baseline.rebaseline_reason,
|
|
space_heating_kwh=baseline.space_heating_kwh,
|
|
water_heating_kwh=baseline.water_heating_kwh,
|
|
)
|
|
|
|
def to_domain(self) -> BaselinePerformance:
|
|
return BaselinePerformance(
|
|
lodged=Performance(
|
|
sap_score=self.lodged_sap_score,
|
|
epc_band=Epc(self.lodged_epc_band),
|
|
co2_emissions=self.lodged_co2_emissions,
|
|
primary_energy_intensity=self.lodged_primary_energy_intensity,
|
|
),
|
|
effective=Performance(
|
|
sap_score=self.effective_sap_score,
|
|
epc_band=Epc(self.effective_epc_band),
|
|
co2_emissions=self.effective_co2_emissions,
|
|
primary_energy_intensity=self.effective_primary_energy_intensity,
|
|
),
|
|
rebaseline_reason=cast(RebaselineReason, self.rebaseline_reason),
|
|
space_heating_kwh=self.space_heating_kwh,
|
|
water_heating_kwh=self.water_heating_kwh,
|
|
)
|