# 고객 원격지원 — 숫자 연결 방식

고객용 Android 1.4-test 안내 (2026-11-02).
고객 프로그램은 https://bohum.ai.kr/api/auth/v2/remote-support 에 연결합니다.
주소·연결 ID·연결키를 직접 입력하지 않습니다.
Android 1.4는 https://w.bohum.ai.kr/ 지원 링크를 추가했습니다. 기존 앱은 1.4로 업데이트해야 합니다. 웹에서 앱을 여는 것과 원격지원 수락은 별개이며 앱에서 요청을 확인한 뒤 수락합니다.
브라우저에서는 실제 연결번호를 만들거나 화면 공유·조작을 실행하지 않습니다.

## 사용 순서
1. Windows 고객은 CustomerRemoteSupport.exe를 실행합니다. Python 설치는 필요 없습니다.
2. Android 고객은 테스트 APK를 설치하고 앱을 엽니다. Android 11 이상이 필요합니다.
3. 자동으로 표시되는 8자리 연결번호만 담당 상담자에게 알려줍니다.
4. 상담자는 보험보장 프로그램 로그인 → 원격지원 → 번호 입력 → 연결 요청을 누릅니다.
5. Android 1.4은 연결 요청이 도착하면 수락을 누릅니다. 처음 필요한 접근성·알림 권한은 직접 확인한 뒤 다시 수락합니다. 권한 설정만으로 공유되지 않습니다. Windows는 기존 화면 공유와 제어 승인을 사용합니다.
6. 종료하려면 Android 1.4의 종료 또는 앱 알림·Windows의 즉시 종료를 누릅니다. 번호의 경과시간 만료는 없지만 한 번만 사용할 수 있으며, 종료·새 번호 발급·서버 재시작 시 기존 번호는 사용할 수 없습니다. 다시 연결할 때 새 번호와 수락이 필요합니다.

## 제공 범위
- Windows: 설치 없이 실행하는 EXE. 코드서명 인증서는 적용하지 않았습니다.
- Android: 1.4-test 전용 릴리스 키로 서명한 검증용 APK. 기존 1.1과 동일 인증서이며 업데이트 설치를 지원합니다. 실제 기기 검증 및 Play 프로텍트 차단 재검토는 아직 완료하지 않았습니다. 차단되면 보호 기능을 끄거나 우회하지 마세요. Google Play 등록은 하지 않습니다.
- 실제 기기 화면 공유·제어 검증은 아직 완료하지 않았습니다.
- Windows 첫 번째 모니터를 공유합니다. 관리자 권한 창/UAC 보안 화면 등은 제어가 제한됩니다.
- Android 보안 화면은 캡처되지 않을 수 있으며 비밀번호 입력칸 제어는 지원하지 않습니다.
- iPhone 고객용 앱은 포함하지 않습니다.
- 승인 전 화면 전송 없음, 무인 접속 없음, 서버에는 최신 화면 한 장만 메모리로 유지합니다.

## 개발 참고
현재 고객 앱은 통합 운영 서버용입니다. 이 폴더의 legacy server.py/viewer.html은 숫자 연결 서버가 아닙니다.
Windows 빌드: 전용 가상환경의 requirements-build-lock.txt 의존성을 사용하여 PyInstaller로 빌드합니다.
PC 동작검사: python -m unittest test_pc_customer -v
EXE 오프라인 검사: CustomerRemoteSupport.exe --self-test 결과파일.json
Android 빌드: JDK17, Gradle8.11.1, SDK36. assembleRelease 및 lintRelease 후 기존 인증서로 서명합니다.
한글 경로에서는 Gradle 옵션 "-Pandroid.overridePathCheck=true"를 전달합니다.