에너지와 이음 연동

개요

앱 에너지 화면은 앱 서버가 직접 계산하지 않음. LH 제로에너지 통합관리 플랫폼(이음, EEP)에서 세대 사용량·요금·동일평형 평균을 받아 그려 줌. 목표선으로 쓰는 월 목표량만 홈넷서버에 저장됨.

앱 → 앱 서버(MAW) ─┬→ 이음(EEP)      : 사용량·요금·예측·동일평형 평균
                   └→ 홈넷서버        : 월 목표량 조회

앱 서버에는 에너지 데이터를 저장하는 테이블이 없음. 화면이 비면 원인은 항상 이음·홈넷·단지 설정 셋 중 하나임. API 경로는 공개노트/개발/모듈/MAW 세대·헬스케어 API.

에너지 종류는 전기·가스·수도·난방·온수 5가지만 화면에 쓰임. 태양광·지열·ESS 등은 코드에 정의만 있고 앱에 안 나옴.

에너지는 달력 기준이 아니라 단지 검침일 기준으로 끊음. 그래서 화면의 월 표기와 실제 조회 구간이 어긋나 보일 수 있음.

요청한 달	실제로 조회하는 달
이번 달	단지 검침일(전기·가스·난방·수도 4개) 중 가장 늦은 날이 오늘 일자보다 뒤면 전월, 아니면 당월
지난 달 이전(과거월)	요청월에서 한 달을 더 뺀 달

전기·수도·가스·난방·온수의 월 목표량임. 에너지 화면의 목표선으로 쓰임.

두 가지가 다름.

화면	받아오는 곳
우리 세대 충전 상태	홈넷서버(실시간)
단지 충전기 목록·사용 가능 여부	이음(EEP)

이음이 주는 커넥터 상태는 9종이지만 앱에는 “사용가능”과 “충전중” 두 값만 내려감
고장·사용불가도 “충전중”으로 보임. “충전기가 고장인데 충전중으로 나와요”는 의도된 축약임. 원래 상태는 감사 로그에서만 확인됨
단지에 충전기 정보가 없으면 빈 목록이 나감(오류 아님)
대시보드(앱 첫 화면)의 전기차 상태는 실제 값이 아님. 고정값이 들어가 있으므로 충전 상태 문의는 전기차 화면 기준으로 볼 것

이음 호출 타임아웃이 20초임. 이음이 느리면 앱이 그만큼 멈춤. 화면 하나가 이음 API 2~4개를 동시에 부르므로 한 건만 느려도 전체가 느려짐
이음 요청·응답은 전부 감사 로그에 남으므로 traceId로 원본을 확인할 수 있음
요금 구간 표기가 3단계(Tier1~3)로 뭉쳐짐. 원본 구간값 4도 Tier3으로 보임
지난달 사용량이 이번 달과 같게 나올 수 있음 — 공개노트/개발/모듈/MAW 앱 API 서버 “알려진 이슈” 참고
이음이 관여하는 다른 기능은 AutoDR임 → 공개노트/기능/AutoDR

tags	에너지, 이음, 전기차, 기능
aliases	에너지 화면, 에너지 사용량, 이음, EEP, 에너지플랫폼, 제로에너지, 동일평형 평균, 에너지 목표량, 목표량 설정, 검침일, 전기차 충전기, 충전 센터