Model/docs/sap-spec
Khalim Conn-Kowlessar d44af109a9 Docs: SAP calculator module README + API integration test handover
The SAP 10.2 / RdSAP 10 calculator is closed at 930/930 pin tests green.
Tidying the docs for hand-off to the API-integration agent.

New: docs/sap-spec/SAP_CALCULATOR.md
  Canonical module overview — public API surface, two-cascade
  architecture (Rating UK-avg, Demand postcode), simulator-use-case
  example, file map, validation contract + hard rules, fixture cohort
  notes, spec page references. Replaces the scattered "what's the
  shape" knowledge that was previously only in commit messages.

Rewritten: docs/sap-spec/HANDOVER_NEXT.md
  Old handover (work queue for slices 26-36) is obsolete. Replaced
  with the next agent's brief: build an API → SAP scoring integration
  test using the 6 Elmhurst fixtures. Includes a copy-paste reference
  scoring path, expected outputs per fixture, list of files to read
  on day 1, and scope guardrails.

Refreshed module docstrings:
  - cert_to_inputs.py: now describes both cascades, the deferred-edge-
    case list reflects current state (RR/secondary/§15 living-area
    rounding all DONE; thermal-mass and control-temp adjustment still
    deferred).
  - calculator.py: per-end-use CO2/PE factor machinery documented;
    stale "single-fuel approximation" claim removed (closed in slice 32).
  - sap/README.md: validation paragraph now says "930/930 green" and
    points to SAP_CALCULATOR.md instead of the obsolete HANDOVER_NEXT.

Verified the API examples in both docs produce the expected per-fixture
outputs (SAP=62, EI=60, Carbon=3104.1222, PE=16931.7227 for 000474).
Wider regression: 1585/1585 PASS, zero failures.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-24 10:04:34 +00:00
..
HANDOVER_NEXT.md Docs: SAP calculator module README + API integration test handover 2026-05-24 10:04:34 +00:00
pcdb10.dat pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_105_gas_oil_boilers.jsonl §4 HW slice 1: PCDB Table 3b combi-loss override 2026-05-21 22:26:41 +00:00
pcdb_table_122_solid_fuel_boilers.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_143_micro_cogen.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_313_flue_gas_heat_recovery.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_353_waste_water_heat_recovery.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_362_heat_pumps.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_391_high_heat_retention_storage_heaters.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_506_heat_interface_units.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
rdsap-10-specification-2025-06-10.pdf ADR-0009: pivot to deterministic SAP 10.3 calculator (Accepted) 2026-05-17 21:27:21 +00:00
sap-10-2-full-specification-2025-03-14.pdf slice S-B9: SAP 10.2/10.3 Table 12 spec-correct prices + Table 12a fix 2026-05-18 15:14:11 +00:00
sap-10-3-full-specification-2026-01-13.pdf ADR-0009: pivot to deterministic SAP 10.3 calculator (Accepted) 2026-05-17 21:27:21 +00:00
SAP_CALCULATOR.md Docs: SAP calculator module README + API integration test handover 2026-05-24 10:04:34 +00:00