Model/packages
Khalim Conn-Kowlessar 607e52a354 Cohort residual slice 1: 000490 secondary heating cascade closes -£104 cost gap
Lodges `secondary_heating_type=691` (Electricity Electric Panel) on
000490 `build_epc()` to match the U985 worksheet's "Secondary Heating:
Electricity Electric Panel, convector or radiant heaters, SAP Code 691,
Efficiency 100%". Pre-fix the cert lodged no secondary system →
`_secondary_fraction` returned 0.0 → all useful space heat routed to
main 1 → main_fuel +1357 kWh over PDF, secondary -1118 under PDF, cost
-£104 under PDF (-12.9% residual).

Post-fix: Table 11 fraction 0.1000 for gas-combi category cascade fires
→ main 1 = 11491.89 kWh, secondary = 1126.21 kWh. Total cost £807.42
vs PDF £807.54 (Δ -£0.12, -0.015%). SAP integer 58 vs PDF 57 (delta 1,
was 6); continuous 57.57 vs 57.40 (delta 0.18).

E2E test updates:
- New worksheet-level pin `result.secondary_heating_fuel_kwh_per_yr ≈
  U985 (215) = 1118.3275` at abs=10 (loose — absorbs the +0.7% upstream
  useful space heating overshoot which propagates 1:1 to (215). Tightens
  to abs=1e-3 when the useful bias closes).
- Per-fixture constant `LINE_215_SECONDARY_HEATING_FUEL_KWH = 1118.3275`.
- 000490 SAP integer ceiling tightened 3 → 1; continuous 3.0 → 0.5.
- Removed xfail on `test_elmhurst_000490_end_to_end_sap_score_currently_
  within_3_points` and `test_000490_cert_to_inputs_fuel_cost_closes_to_
  within_5pct` — both now pass.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-22 09:53:33 +00:00
..
domain Cohort residual slice 1: 000490 secondary heating cascade closes -£104 cost gap 2026-05-22 09:53:33 +00:00
fetchers added potential file scaffolding: 2026-05-15 10:56:53 +00:00
repos added potential file scaffolding: 2026-05-15 10:56:53 +00:00
utils added potential file scaffolding: 2026-05-15 10:56:53 +00:00
README.md added potential file scaffolding: 2026-05-15 10:56:53 +00:00

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/.