스마트홈 위키

시스템 구성

Properties2
tags아키텍처, 개발환경
aliases아키텍처, 시스템 구성도, 기술 스택, LGTM, Loki, Tempo, Mimir, 서버 구성, 모듈 목록, APW MAW SCW OAW, 레포 대응

10 min read

배경

스마트홈 플랫폼 전체가 어떻게 이어져 있는지 한 장으로 봄. 팀은 기술개발팀 스마트홈 운영 4명임.

기술 스택: Vue.js 2.6(관리자 웹 LMC·SMC. 저장소의 frontend-vue3는 템플릿 원본 상태로 운영본 아님) / Spring Boot + MyBatis(API) / PostgreSQL / Redis / Java 8 / Node 16. 개발 도구는 공개노트/개발/개발환경 세팅.

[사용자]
  ├── homez 앱 (iOS/Android)
  │       └── API 서버 (Spring Boot, WAS)
  │               ├── PostgreSQL
  │               ├── Redis (세션·토큰 갱신 정보)
  │               └── 홈넷 연동 API ─┬─ 코맥스 서버
  │                                  ├─ 코콤 서버
  │                                  └─ 현대통신 서버
  │                                     (각 서버 → 단지 내 게이트웨이/월패드)
  ├── 관리자 웹 (Vue.js)
  └── 모니터링 (LGTM)
          ├── Loki    로그
          ├── Grafana 시각화
          ├── Tempo   트레이싱
          └── Mimir   메트릭

홈넷 서버는 외부망이라 WAS에서 Squid 프록시를 거쳐 나감. 인증서 점검 명령도 프록시 옵션이 필요함. 기본매뉴얼/운영/홈넷 서버 인증서 만료

홈넷서버로 나가는 길이 앱마다 다름 (2026-09-18 확정)

앱경로응답 타임아웃
입주민 앱앱 → MAW → 홈넷서버 직접 (APW에는 홈넷 토큰만 받으러 감)3초
가전사 앱(삼성·LG)가전사 → PIW → APW 홈넷 프록시 → 홈넷서버10분

입주민 앱은 APW 홈넷 프록시를 쓰지 않음. 기기 제어·승강기 호출·방문 내역·입출차·방문주차·전기차·에너지 목표량이 전부 MAW에서 홈넷서버로 직접 나감. “제어가 오래 걸린다”의 기준값이 경로마다 다르므로 어느 앱에서 온 문의인지 먼저 가를 것. 공개노트/기능/홈넷 서버 연동

앱의 에너지 화면(사용량·요금·동일평형)과 단지 전기차 충전기 목록은 MAW가 이음(에너지플랫폼) 에 직접 물어 옴(응답 타임아웃 20초) → 공개노트/기능/에너지와 이음 연동. 세대 업무·헬스케어 API 목록은 공개노트/개발/모듈/MAW 세대·헬스케어 API, 건강 메뉴 동작은 공개노트/기능/헬스케어.

외부 연동: LH 에너지 플랫폼(단지 기준정보, 일 배치), 바로처리(하자 접수), LG ThinQ(가전제어 체험단), 뿌리오(문자).

모듈 (WAS)

레포는 3개: lh-home-2022-svr(아래 표의 서버 모듈 전부), lh-home-2022-web(LMC, SMC), lh-home-2022-app(homez 앱). 문서 레포 lh-home-2022-doc는 로컬에 없음.

약어이름역할호출 관계
MAWMobile App WAS앱 요청 처리, 홈넷서버 요청 포워딩. 공개노트/개발/모듈/MAW 앱 API 서버앱 → MAW → 홈넷서버/이음/APW
APWAPI WAS외부 시스템 연계 서버. OAuth 리소스 서버. 공개노트/개발/모듈/APW 연계 서버홈넷서버·에너지플랫폼 → APW, 내부(MAW/SCW/LMW) → APW → 뿌리오/FCM/홈넷서버
OAWOAuth2 WAS홈넷서버용 access token 발급·검증, 가전사 연동 로그인·JWT 발급. 공개노트/개발/모듈/OAW 인증 서버홈넷서버·가전사 → OAW, APW → OAW
SCWScheduler WAS주기 작업(날씨, 단말기 수집, DR, 살피미, 복약 알림). 공개노트/개발/모듈/SCW 스케줄러 서버SCW → 홈넷서버/이음/공공데이터포탈/APW
PIWPartner API WAS삼성·LG 가전사에 조명·난방·가스·환기·외출·방범 상태·제어 제공. 공개노트/개발/모듈/PIW 연계 서버가전사 클라우드 → PIW
SCISmartThings C2C Connector (Node.js)삼성 SmartThings 연동 SmartApp. 공개노트/개발/모듈/SCI 삼성 커넥터SmartThings → SCI
THATemporary Homenet API개발용 홈넷서버 흉내(echo) 서버. 공개노트/개발/모듈/THA 홈넷 시뮬레이터테스트용
batch, DB 함수lh-smah-batch, PostgreSQL 함수DB 집계 배치. cmn.tb_proc_m에 등록된 프로시저를 주기마다 호출함. 공개노트/개발/모듈/통계 배치 서버 / 집계·정리 프로시저와 앱 날씨 조회 함수 본체는 공개노트/개발/모듈/통계 집계 DB 함수DB 내부. 기본매뉴얼/운영/tomcat과 배치 기동
LMW/LMCLH Manager WAS/ClientLH 관리자, 단지 관리소장, 홈넷서버 설치자용 관리자 웹. Vue 2.6 SPA + lhmngr.war(포트 8085, API 접두사 /api/v1). 홈넷·SMS·푸시는 내부 API 서버(localhost:8084)를 거쳐 APW로 나감. 스케줄러·배치를 전혀 돌리지 않는 요청-응답 웹임(집계는 전부 다른 모듈이 채움). 공개노트/개발/모듈/LMC 관리자 웹, 화면별 동작은 공개노트/개발/모듈/LMC 기능 상세브라우저 → LMC → LMW
SMW/SMCSystem Manager WAS/Client시스템 관리자(운영팀) 웹, smc-enc(설정값 암호화 도구). sysmngr.war(포트 8086). 공개노트/개발/모듈/SMC 통합운영시스템, 공개노트/개발/모듈/비밀번호와 전화번호 암호화브라우저 → SMC → SMW

도메인 포워딩

도메인대상용도
homez-api.lh.or.kr:8094APW (/api/ccg/authcheck만 OAW)홈넷서버·외부 시스템 연계
homez-m.lh.or.kr:8091MAW앱
homez-op.lh.or.kr:443SMC시스템 관리자 웹
homez.lh.or.kr:443LMCLH 관리자 웹
homezdev-op.lh.or.kr, homezdev.lh.or.kr개발 SMC / LMC개발

서버

호스트명과 IP는 위키에 적지 않음. 서버 별칭·용도·IP는 구글 시트 공유 드라이브/140.OS/서비스 파트 서버현황 에 정리돼 있음(2026-09-17 확인). 로그 위치와 기동은 기본매뉴얼/운영/WAS 로그 확인, 기본매뉴얼/운영/tomcat과 배치 기동.

2026-01 기준 클라우드 자원: VM 23대, 공인 IP 8개, 스냅샷 5개, 디스크 42개.

  • Tomcat 경로는 /usr/local/tomcat-{apw|oaw|scw|maw}/. 기동은 대부분 startup_proxy.sh(내부망→외부망 호출이 Squid 프록시를 타야 해서)이고, 수신 전용인 OAW만 startup.sh 씀.
  • Jenkins 빌드 잡 이름은 (DEV|PROD)-lh-smah-server-{apw|scw|oaw} 형태. MAW·LMC·SMC·앱의 배포 방식은 각각 다름. LMC·SMC는 백엔드 ./gradlew bootWar와 프론트 npm run build를 따로 돌리는 구성이고 Jenkins 잡 이름은 확인 필요(공개노트/개발/배포와 빌드).
  • DB는 PostgreSQL smahdb. 개발 lh-smahdev-rdb01(10883), 운영 lh-smah-rdb02(10882). 접속 IP·계정은 담당자 문의.
  • FCM은 Firebase 프로젝트 lh-smarthome-app. SMS는 뿌리오 구버전 API.
  • local/dev 프로필은 push·SMS가 properties에 적힌 계정으로만 발송됨(오발송 방지). prd만 실제 회원에게 발송.

협력사 (2024-06 인수인계 기준, 확인 필요)

구분회사비고
클라우드Didim365OS·네트워크 변경은 Didim 고객센터 Q&A 게시판으로 요청
에너지플랫폼(이음)SQI소프트 + 헤리트eep.lh.or.kr. DR, 단지 기준정보. apiKey 인증(tb_cstt_m)
홈넷사공개노트/홈넷사/코맥스·공개노트/홈넷사/코콤·공개노트/홈넷사/현대HT 등연동 현황은 공개노트/기능/홈넷 서버 연동
층간소음비쥬드림2024-06 규격 초안 검토 중

확인 필요

위 도메인 포워딩·협력사·Jenkins 빌드 대상은 2024-06 인수인계 문서 기준으로, 2026-09 현재와 다를 수 있음. 특히 코콤·현대HT 연동 현황, THA의 현재 용도(2026-09 WISE 목업 추정)는 담당자 확인 필요.

관련

공개노트/기능/홈넷 서버 연동 공개노트/개발/개발환경 세팅 공개노트/개발/배포와 빌드 기본매뉴얼/운영/grafana로 로그 보기 기본매뉴얼/운영/tomcat과 배치 기동

백링크