47 lines
3.0 KiB
Markdown
47 lines
3.0 KiB
Markdown
# Custom Launcher
|
|
|
|
사이트 본문에 작은 iOS 스타일 배너로 삽입되는 런처입니다.
|
|
|
|
```html
|
|
<meta charset="UTF-8">
|
|
<link href="/custom/common/css/launcher.css" rel="stylesheet" />
|
|
<div id="findMyShortcut" class="find-container"></div>
|
|
<script src="/custom/launcher/js/main.js"></script>
|
|
```
|
|
|
|
## 기능
|
|
|
|
- 나의 찾기 이동
|
|
- PC 켜기
|
|
- 콕 찌르기
|
|
- 차량 모니터 이동
|
|
- 공통 암호 로그인
|
|
- 공통 암호 변경
|
|
- 4자리 숫자 PIN 입력과 커스텀 숫자 키패드
|
|
- 사이트 관리자 로그인 상태에서만 관리 버튼 표시
|
|
- 사이트 관리자 로그인 상태에서는 미니앱 실행 시 공통 암호 생략
|
|
- 사이트 관리자 세션으로 미니앱 진입 시 공통 접근 쿠키 자동 발급
|
|
|
|
## 구조
|
|
|
|
- `api.php`: 로그인, 로그아웃, 암호 변경, 관리자 세션 확인, 콕 찌르기 카운트/웹훅 처리
|
|
- `js/main.js`: 4개 아이콘 렌더링, 인증 흐름, 암호 변경 UI
|
|
- `css/style.css`: 기존 삽입 코드 호환용 공용 CSS import
|
|
- `img/`: 런처 아이콘 이미지
|
|
|
|
## 공통 모듈 연동
|
|
|
|
인증, 암호 hash 저장, Home Assistant 호출은 `/custom/common` 모듈을 사용합니다. 런처는 더 이상 Home Assistant 토큰이나 웹훅을 브라우저로 직접 노출하지 않습니다.
|
|
|
|
런처 CSS 원본은 `/custom/common/css/launcher.css`를 사용합니다. 기존 운영 HTML이 `/custom/launcher/css/style.css`를 참조해도 호환 파일이 공용 CSS를 import합니다.
|
|
|
|
## 운영 메모
|
|
|
|
메인 버튼은 기존 4개를 유지합니다. Rhymix 사이트 관리자 로그인 상태에서는 미니앱 실행 시 공통 암호를 묻지 않습니다. 이때 `/custom/launcher/api.php?adminSession=1` 또는 `session=1` 응답에서 공통 접근 쿠키를 함께 발급해, 이동한 미니앱 내부 세션 검사에서도 바로 통과합니다.
|
|
|
|
암호는 숫자 4자리만 허용합니다. 로그인과 암호 변경 입력창은 `inputmode=numeric`, `[0-9]*` 패턴, 커스텀 숫자 키패드를 사용하며 Android/iPhone에서 문자 키보드가 뜨지 않도록 `readonly` 입력창에 화면 키패드로 값을 넣습니다. 서버 API도 4자리 숫자가 아닌 암호를 거부합니다.
|
|
|
|
로그인은 확인 버튼 없이 4자리가 입력되면 즉시 검증하고 성공 시 원래 선택한 미니앱으로 이동합니다. 암호 변경 화면도 변경/확인 버튼 없이 현재 암호, 새 암호, 새 암호 확인 순서로 4자리 입력이 끝날 때마다 다음 칸으로 이동하며, 마지막 칸까지 입력되면 바로 변경을 검증합니다. 이미 값이 들어간 입력창을 누르면 로그인 화면은 해당 칸을 지우고, 암호 변경 화면은 클릭한 칸부터 뒤 칸까지 지운 뒤 다시 입력받습니다. 현재 입력 중인 칸은 상태 문구와 파란 테두리로 표시합니다.
|
|
|
|
암호 변경은 배너 우하단의 작은 `관리` 링크에서 처리하며, 이 링크는 사이트 관리자 로그인 상태에서만 표시합니다. 암호 변경 시에는 현재 공통 암호 입력을 계속 요구합니다.
|