junte/Model
1
0
Fork 0
mirror of https://github.com/Hestia-Homes/Model.git synced 2026-06-08 11:17:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Model/docs/sap-spec
History
Khalim Conn-Kowlessar 3363f63f5e docs: handover for systematic section-by-section RdSAP 10 review 
The slice-by-slice "fix the biggest residual" approach has hit a
ceiling at SAP MAE ~4.6 because the cert-calibration prices absorb
multiple structural deviations from spec. Any spec-correct fix in one
component breaks the calibration for others. Three failed slices this
session (standing charges, cat=10 routing, combi zero-loss) made the
pattern unambiguous.

Pivot: systematic section-by-section spec verification. Read the
RdSAP 10 + SAP 10.2 spec in order, check each table / formula /
footnote against the corresponding code, fix gaps one at a time.
Build the spec-correct engine first; re-derive cert-cal calibration
once at the end as a thin Elmhurst-compatibility layer.

Handover doc covers:
- Critical framing (deterministic, not assessor judgement)
- Current state (SAP MAE 4.61, PE MAE 43.32 at f4a8d2a0)
- Why the slice-by-slice approach won't converge
- Scope decisions (RdSAP 10 + SAP 10.2 only; park full-SAP + PCDB)
- Section-to-code mapping
- Known dead-ends to skip
- Cert-calibration vs spec-correctness tension and how to resolve it
- The 7 golden fixtures and their compensating-error caveats
- Trace mode recommendation (ADR-0009's `intermediate` field)
- Specific §1-3 starting tasks
- Workflow recap

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-19 07:30:27 +00:00
..
CALCULATOR_DESIGN_SKETCH.md ADR-0009: pivot to deterministic SAP 10.3 calculator (Accepted) 2026-05-17 21:27:21 +00:00
HANDOVER_FRESH_REVIEW.md docs: handover for fresh-context SAP calculator review 2026-05-18 19:03:40 +00:00
HANDOVER_SYSTEMATIC_REVIEW.md docs: handover for systematic section-by-section RdSAP 10 review 2026-05-19 07:30:27 +00:00
PARITY_FINDINGS.md S-B2: parity probe + first-pass findings (100-cert baseline) 2026-05-18 13:59:23 +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
SPEC_COVERAGE.md docs: SAP 10.2 / RdSAP 10 spec coverage map 2026-05-18 16:55:17 +00:00