This paper presents the system architecture and operating logic of The Home-Energy Check-Up (New Zealand), a web-based public decision-support prototype designed to help New Zealand households identify avoidable energy-cost leakage, complete a short guided home inspection, and generate a prioritized behavior-first energy roadmap. The application is implemented as a single-file Python Streamlit system with session-state navigation, a household input dataclass, conservative low-high saving estimators, a seven-check inspection layer, a recommendation-ranking layer, visual analytics, anonymous Google Sheets persistence, downloadable reports, and a certificate-of-completion interface. The system does not claim to be a certified energy audit, New Zealand Building Code H1 verification method, Healthy Homes compliance statement, or guaranteed bill-forecasting engine. Instead, it operationalizes a practical educational workflow: start with money, collect only the minimum required household profile, convert user answers into a score and action set, estimate annual savings using transparent formulas, and convert behavior savings into a staged save-to-upgrade pathway. The manuscript details the front-end, state-management, calculation, data-storage, visualization, recommendation, deployment, privacy, and limitation layers of the prototype. It also identifies research-grade improvements required before the tool is used for validated impact assessment, including external validation against measured energy data, robust concurrent data writes, clearer uncertainty calibration, accessibility testing, and formal user evaluation. The contribution is a reproducible architecture for translating household energy advice into an interactive, gamified, data-light decision-support pathway for New Zealand homes.

翻译：本文介绍了"家庭能源检查（新西兰）"的系统架构与运行逻辑。该工具是一个基于网络的公共决策支持原型，旨在帮助新西兰家庭识别可避免的能源成本泄漏，完成简短的指导式住宅检查，并生成以行为优先的阶梯式能源路线图。该应用程序采用单文件Python Streamlit系统实现，包含会话状态导航、家庭输入数据类、保守的低-高节能估算器、七项检查层、建议排序层、可视化分析、匿名Google Sheets持久化存储、可下载报告及完成证书界面。该系统并非声称是经过认证的能源审计报告、新西兰建筑规范H1验证方法、"健康住宅"合规声明或可靠的账单预测引擎；而是将实用的教育性工作流付诸实践：以资金为切入点，仅收集最少的必要家庭信息，将用户回答转化为评分与行动集，通过透明公式估算年度节能，并将行为节能转化为阶梯式"储蓄→升级"路径。本文详述了该原型的用户界面、状态管理、计算、数据存储、可视化、建议生成、部署、隐私及局限性各层，并指出了在工具用于有效影响力评估前所需的研究级改进，包括与实测能源数据的外部验证、稳健的并发数据写入、更清晰的不确定性校准、可访问性测试及正式用户评估。本研究的贡献在于提供了一种可复现的架构，将家庭能源建议转化为一种交互式、游戏化、数据精简的决策支持路径，适用于新西兰住宅场景。