Model/scripts/hyde/elmhurst_README.md

Elmhurst RdSAP entry-tool automation (POC)

Automates most of the one manual step in validate-cert-sap-accuracy: re-keying elmhurst_inputs.md into Elmhurst's web RdSAP entry tool and exporting the Input Summary + SAP Worksheets PDFs (which compare_epc_paths.py then consumes). Built on Playwright (Python).

Proven end-to-end on UPRN 10092973954: filled most pages automatically, downloaded both PDFs, and compare_epc_paths.py reconciled to our engine 77 vs Elmhurst worksheet 78 (engine-on-Elmhurst-inputs 79 — the calculator reproduces accredited Elmhurst within ~1 SAP on identical inputs).

Scripts

Script	Does
start_viewer.sh	Xvfb→x11vnc→noVNC desktop on port 6080 so you can SEE/click the headed browser (DISPLAY=:99). bash scripts/hyde/start_viewer.sh
elmhurst_session.py	login / open / status — persistent login (MFA by hand once; session in .elmhurst-session/, gitignored)
elmhurst_explore.py	dump a page's DOM (field ids, options, autopostback) or --all sections — how specs are built
elmhurst_fill.py	--page <name> [--commit] [--commit-mode saveclose|next] — fill/clear a page from its PageSpec
elmhurst_download.py	downloads Input Summary + SAP Worksheets → the cert's corpus dir. Never clicks Submit (code-enforced)

Typical run (browser appears on the noVNC desktop at port 6080):

bash scripts/hyde/start_viewer.sh
DISPLAY=:99 python scripts/hyde/elmhurst_session.py login --url https://members.elmhurstenergy.co.uk/
DISPLAY=:99 python scripts/hyde/elmhurst_fill.py --page property_description --commit
DISPLAY=:99 python scripts/hyde/elmhurst_download.py

Hard-won mechanics (ASP.NET WebForms)

• Enter via the Guid URL (…online…/WebFormAddress.aspx?Guid=…); section nav is full-form __doPostBack to a Guid-less subdomain — use expect_navigation.
• Almost every field AutoPostBacks (whole-page reload): set one field, wait, re-locate the next. A 600 ms settle after each interaction stops flake.
• Never re-click the active tab (double-postback misbehaves) — goto_section is current-page-aware.
• Navigating away saves; Save & Close commits to the DATABASE (visible to other sessions). Next > only saves the in-progress session.
• Fields auto-disable when an upstream choice removes them (Room-in-Roof once no room-in-roof; cylinder once combi) — skip them, don't fight them.
• Button ids vary per page → match by id suffix ([id$='_ButtonSaveClose']).
• Setup (done in container): python -m playwright install chromium + sudo python -m playwright install-deps chromium.

What's automated vs manual

Automated (in PAGES + special actions): Property Description, Dimensions, Flats (position/floor/corridor), Walls (main + clear alt-wall), Roofs, Floors, Space Heating (boiler via the cascade dialog → BGW combi, flue, secondary), Water Heating (code; cylinder auto-clears with the combi), New Tech/Conservatory (none) — plus the consolidated clears from the markdown.

The boiler cascade dialog is driven by select_boiler_combi(): open the Main-Heating-code modal, set the leaf dropdown to BGW Post 98 Combi condens., click OK. The generic combi (SAP 104) moves SAP by ~0 vs the cert's exact PCDB model, so it's accurate enough.

Manual (🔸):

• Exact PCDB boiler model (e.g. 17929) — its search field is disabled (aspNetDisabled) in this UI state; the cascade's generic combi is the automatable substitute (negligible SAP impact).
• Control code 2110 and the MV unit — same modal-dialog pattern; can be automated the same way as the boiler when wanted (open dialog → select → OK). All 🔸 fields are flagged in elmhurst_inputs.md.

Adding a field/page

1. elmhurst_explore.py <guid-url> <buttonAction<Section>_Link> to dump ids/options.
2. Add a Field(...) (or new PageSpec) in elmhurst_fill.py.
3. --page <name> (dry-run, screenshots to elmhurst_dom/fill_<name>.png), verify, then --commit.