Mastershort/neonplan3d

NeonPlan 3D – 시각적 홈 제어를 위한 Home Assistant 통합

개요 – NeonPlan 3D는 Home Assistant 통합으로, Home Assistant 내에서 직접 집의 평면도를 그리고 즉시 네온 스타일의 3D 렌더링을 볼 수 있습니다. 3D 뷰는 대화형입니다: 조명을 전환하고, 블라인드를 이동하고, 문을 열고, 카메라를 확인하고, 가전 제품의 상태를 표시할 수 있습니다.

주요 기능

• 평면도 편집기 – 방, 벽, 문, 창문, 계단, 지붕, 야외 영역을 그립니다; 자유 형태와 자동 벽 생성을 지원합니다.
• 라이브 3D 뷰 – 객체를 탭하여 제어(조명, 블라인드, 문), 색상으로 구분된 상태, 카메라 스냅샷, 온도/습도/CO₂ 히트맵을 표시합니다.
• 가구 라이브러리 – 50개 이상의 내장 모델과 선택적 가구 팩(방, 차량, 스마트 홈 기기). 램프는 뷰에서 색상 빛을 방출합니다.
• 대시보드 카드 – custom:neonplan3d-card는 모든 Lovelace 대시보드에 배치할 수 있습니다; 많은 시각적 옵션(테마, 품질, 폭발 뷰, 알림, 날씨 등)은 비주얼 편집기 또는 YAML로 구성할 수 있습니다.
• 벽걸이 태블릿 / 키오스크 모드 – 벽걸이 태블릿(예: Fire 태블릿)에 최적화되어 있으며, 유휴 복귀, 야간 디밍, 전체 화면 키오스크 UI를 제공합니다.
• 알림 및 자동화 – 연기, 가스, 물, 비로 인한 창문 열림 경고를 표시합니다; Home Assistant 장면 및 스크립트와 통합됩니다.
• 확장 기능 – 선택적 유료 팩(추가 가구, 카메라 콕핏, 실외 날씨, 라이브 TV 화면과 같은 Pro 애드온)은 라이선스 키로 제공되며 자동으로 업데이트됩니다.

설치

• HACS(Home Assistant 커뮤니티 스토어)를 통해 권장: 리포지토리를 사용자 정의 통합으로 추가, 설치, Home Assistant 재시작, 그런 다음 설정 → 기기 및 서비스에서 통합을 추가합니다.
• 수동 설치도 가능: custom_components/neonplan3d 폴더를 복사합니다.
• Home Assistant 2025.1 이상이 필요합니다.

개인정보 보호

• 모든 평면도 데이터, 이미지 및 팩은 Home Assistant의 .storage 폴더에 로컬로 저장됩니다.
• 유일한 외부 호출은 유료 팩의 라이선스 키를 입력할 때입니다; 서비스는 키와 익명 설치 해시를 사용하여 mastershort.de에 하루에 한 번 연락합니다.

개발

• 프론트엔드는 npm으로 구축; 테스트는 npm test와 Python 쪽의 pytest-homeassistant-custom-component로 실행합니다.
• 미리보기 모드(preview/index.html)를 사용하면 Home Assistant 인스턴스 없이 브라우저에서 3D UI를 볼 수 있습니다.

대상 사용자

• 스마트 홈 기기를 시각적이고 태블릿 친화적인 방식으로 모니터링하고 제어하려는 Home Assistant 사용자.
• "네온" 미학을 좋아하거나 자동화 디버깅을 위해 평면도를 빠르게 그려야 하는 사람.

링크

• 데모: https://neonplan3d.mastershort.de/
• 매뉴얼(영어/독일어): https://mastershort.de/en/neonplan3d/manual/
• Discord 커뮤니티, 로드맵 및 이슈 트래커는 README에 링크되어 있습니다.

---

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것입니다; 추가 주장은 없습니다.