Use shared auth and proxy Home Assistant webhooks

README.md

@@ -0,0 +1,30 @@
+# Find My Device
+
+Home Assistant에 기록된 Fold7 위치, 배터리, 활동 상태, 이동 경로를 지도에 표시하는 개인용 나의 찾기 페이지입니다.
+
+## 기능
+
+- 현재 위치 지도 표시
+- GPS 정확도 원 표시
+- 최근 24시간 및 사용자 지정 기간 이동 경로 표시
+- 배터리, 워치 배터리, 활동 상태, 걸음 수, 이동 거리 표시
+- 자동 위치 갱신 웹훅 제어
+- 강제 업데이트 요청
+- 한국어/영어 전환
+- Wake Lock 지원
+
+## 구조
+
+- `debug.html`: 페이지 삽입용 HTML 조각
+- `php/api.php`: Home Assistant 상태/히스토리 조회 API
+- `js/main.js`: 지도 렌더링, 상태 갱신, 히스토리 표시
+- `css/style.css`: iOS 설정 화면 스타일
+- `img/`: 지도 마커 및 언어 아이콘
+
+## 공통 모듈 연동
+
+인증과 Home Assistant 호출은 `/custom/common`을 사용합니다. 브라우저 JS에는 더 이상 API Bearer 토큰이나 Home Assistant 웹훅 식별자를 직접 넣지 않습니다.
+
+## 운영 메모
+
+이 프로젝트는 위치, 주소, 배터리, 활동 기록을 포함하므로 private 저장소와 개인 접근 환경에서만 운영합니다.