mirror of
https://github.com/Hestia-Homes/Model.git
synced 2026-06-08 11:17:27 +00:00
First slice of the SAP10 Calculator Session A (ADR-0009). Ships the three SAP 10.3 Appendix U monthly tables across 22 climate regions (region 0 = UK average; 1-21 named per spec) as a pure-data module under the new domain/sap/ package: - Table U1: mean external temperature (°C) - Table U2: wind speed (m/s) - Table U3: mean global solar irradiance on horizontal plane (W/m²) - Table U3 footer: monthly solar declination (°, region-independent) Lookups validate region (0..21) and month (1..12) and raise ValueError on out-of-range inputs. 11 AAA tests cover happy-path lookups across multiple regions/months plus boundary and error cases. |
||
|---|---|---|
| .. | ||
| domain | ||
| fetchers | ||
| repos | ||
| utils | ||
| README.md | ||
Shared packages
Workspace packages consumed by services/*. Each package is its own Python distribution with its own pyproject.toml; services import via the workspace dependency mechanism ({ workspace = true }).
| Package | Purpose |
|---|---|
domain/ |
Shared domain types — Property, BaselinePerformance, Plan, Scenario, EpcPropertyData, etc. No persistence, no IO, no business logic. |
repos/ |
Persistence layer — one repo per aggregate. Owns the SQL. Depends on domain. |
fetchers/ |
External API clients (gov EPC, Ofgem, Google Solar, etc.). Depend on domain for response shapes. |
utils/ |
Cross-cutting infra — logging, S3, CloudWatch URL builders, SQS task helpers. |
Adding a new shared package
Only when a real second consumer materialises. Don't pre-shatter (repos-epc, repos-property, ...) — split when a deployment needs to drop a dep, not before.
See ../ara_backend_design.md §11 for the broader monorepo layout and ../CONTEXT.md for the domain glossary that names the types living in domain/.