Riahn Store Bridge

매장 PC 설치 — 설치 파일 하나로

미창조 직영 매장 PC에 설치합니다. 본사 관리자 화면에서 받은 매장별 설치 파일 하나가 원격 관리 도구(Tailscale·RustDesk·SSH)와 수집 확장을 한 번에 설치하고, 결과를 본사로 보냅니다. 수집 확장은 헤어짱·핸드SOS 화면을 읽기만 합니다.

CRM에서 수집할 수 있는 정보를 정리한 카탈로그입니다 — 헤어짱·핸드SOS 메뉴 지도·수집 경로. 수집 카탈로그 열기

설치 순서 — 매장 1곳당 약 15분

본사에서 매장 준비. 관리자 화면 /admin 에서 아직 쓰지 않은 매장 노드(예: 매장8)의 매장 설정에 매장 이름·직원이 쓰는 브라우저(크롬 / 엣지 / 엣지 IE 모드)·CRM(헤어짱 / 핸드SOS)을 저장합니다. 설치 내용이 이 설정을 따라갑니다.
설치 파일 받기. 같은 행의 설치주소 복사(.exe) 를 눌러 주소를 매장 PC 브라우저에 붙여 넣고 내려받습니다. 파일에 매장 토큰이 들어 있어 따로 입력할 것이 없습니다.
실행. 내려받은 파일을 실행하고 사용자 계정 컨트롤 창에서 예. 여섯 단계가 자동으로 진행됩니다(약 5~10분, 창을 닫지 마세요).
- 1/6 Tailscale(무인 모드) — 본사가 매장 PC에 닿는 사설 네트워크. 실패하면 원인 출력이 화면에 나옵니다
- 2/6 RustDesk — 본사 원격지원 서버로 설정하고, 고정 비밀번호를 만들어 적용을 확인한 뒤 본사에 저장
- 3/6 수집 확장 — C:\riahn\store-collector 에 설치하고, 새 버전이 나오면 30분마다 자동 갱신하는 예약 작업 등록
- 4/6 절전 해제 · 로그인 때 브라우저 자동 시작
- 5/6 브라우저 정책 등록 — 이때 브라우저가 한 번 다시 시작됩니다. 매장 PC처럼 도메인에 가입하지 않은 PC는 크롬·엣지 모두 정책 설치를 무시하므로 다음 단계에서 직접 불러옵니다
- 6/6 OpenSSH 서버(Tailscale 대역에서만 접속) — 끝나면 Tailscale 주소·관리자 계정명을 본사에 저장
결과 확인. 마지막 설치 결과 목록이 모두 [완료]인지 봅니다. [실패]가 있으면 그 위의 노란·빨간 문구를 사진으로 남깁니다(설치 기록은 본사 /admin → 로그로도 올라갑니다).
확장 불러오기(크롬·엣지 모두). 설치 결과 아래 ▶ 남은 할 일에 나온 브라우저에서 chrome://extensions(엣지는 edge://extensions) → 개발자 모드 켜기 → 압축해제된 확장 프로그램을 로드합니다 → C:\riahn\store-collector 선택. 반드시 이 폴더여야 새 버전이 자동으로 깔립니다(다운로드 폴더에 푼 것을 고르면 자동 갱신이 안 됩니다).
CRM 로그인. 직원이 쓰는 브라우저에서 헤어짱이나 핸드SOS에 평소처럼 로그인해 둡니다. 설치 중 브라우저가 다시 켜지면 뒤쪽에 복원된 CRM 탭은 한 번 눌러 보기 전까지 페이지가 올라와 있지 않습니다. 확장 0.5.1부터는 확장이 뒤에서 알아서 불러오지만, 로그인 뒤 CRM 탭을 한 번 눌러 두면 바로 수집이 시작됩니다. 확장은 이 로그인 상태를 그대로 쓰며 비밀번호를 저장하지 않습니다. 엣지 IE 모드 매장은 수집을 크롬으로 하므로, 최소화되어 떠 있는 크롬 창에서도 핸드SOS에 한 번 로그인해 둡니다.
나오기 전 본사 확인. /admin 에서 이 매장이 online 인지, 원격지원 칸에 RustDesk ID·비밀번호와 ssh 계정@100.x.x.x 가 보이는지, 몇 분 뒤 마지막 성공(예약)이, 핸드SOS 매장이면 매출 수집도 찍히는지 확인합니다. 가능하면 본사에서 RustDesk로 실제 접속해 봅니다.

이 확장이 하는 일과 하지 않는 일. 본사 서버가 내려주는 읽기 작업(화면 열기·본문 읽기·표 추출·조회 요청)만 수행하고, 허용된 CRM 도메인(헤어짱·핸드SOS) 밖으로는 요청하지 않습니다. 저장·수정·삭제·발송 버튼에 해당하는 요청은 만들지 않습니다. 매장 직원의 다른 탭이나 비밀번호는 읽지 않습니다. 지금은 예약과 매출(시술·점판)을 모으며, 매출은 고객명·연락처 없이 CRM 고객 번호로만 저장합니다. 본사는 노드 화면의 정지 버튼으로 언제든 즉시 멈출 수 있습니다.

문제가 생기면

아래 조치 대부분은 /admin 해당 매장 행의 버튼으로 명령을 복사해, 매장 PC의 관리자 PowerShell(시작 → PowerShell 우클릭 → 관리자 권한으로 실행)에 붙여 넣으면 됩니다. RustDesk로 원격에서도 할 수 있습니다.

증상	조치
설치 결과에 [실패] Tailscale	위에 나온 종료 코드·오류 문구를 확인하고 `Tailscale 재연결` 명령을 실행합니다. 계속 실패하면 오류 문구를 본사에 보냅니다.
본사에서 RustDesk 비밀번호가 맞지 않음	`RustDesk 서버 설정·비밀번호 재발급` 명령. "새 비밀번호를 받지 않았습니다"가 나오면 잠시 뒤 다시 실행합니다.
원격지원 칸에 `ssh <계정>@…` (계정명 미수신)	`진단 명령 복사` 를 관리자 PowerShell에서 한 번 실행하면 계정명이 올라옵니다. SSH가 설치되지 않았으면 `SSH 재설치`.
수집 오류 "Cannot access contents of the page"	브라우저가 다시 켜진 뒤 아직 한 번도 누르지 않은 CRM 탭입니다(페이지가 올라와 있지 않음). 확장 0.5.1부터는 확장이 그 탭을 뒤에서 불러와 저절로 풀립니다. 0.5.0 이하이거나 계속 나면 CRM 탭을 한 번 누릅니다. 탭이 IE 모드(주소창의 IE 아이콘)면 `IE모드 부분복구` 명령.
수집 오류 "로그인된 CRM 탭이 없습니다" · "핸드SOS 로그인 필요"	매장 브라우저에서 CRM에 다시 로그인해 탭을 열어 둡니다(엣지 IE 모드 매장은 크롬에서). 세션이 끊기면 같은 오류가 납니다.
옵션 화면 상태가 연결 안 됨	설치 파일이 토큰을 자동으로 넣습니다. 그래도 안 되면 노드 화면의 매장 토큰을 확장 옵션에 붙여 넣고 크롬을 완전히 종료 후 다시 엽니다.
크롬·엣지 시작 때 "개발자 모드 확장 (사용 중지·끄기)" 경고	정상입니다. 반드시 `취소`(또는 ×)를 누릅니다. "끄기"·"사용 중지"를 누르면 수집 확장이 꺼져 수집이 멈춥니다(9/30 분당야탑·용인동천). 이미 눌렀다면 `edge://extensions`(크롬은 `chrome://extensions`)에서 "리안 CRM 플러스"를 다시 켭니다. 직원분께도 꼭 알려 주세요.
확장 버전이 오래됨	`확장 자동 갱신 설치` 명령(이미 설치한 매장용). 설치 뒤 크롬을 한 번 다시 시작하면 그다음부터 자동입니다.
PC가 꺼져 있어 오프라인	Tailscale·RustDesk·SSH 모두 닿지 않습니다. 매장에 전원 요청.

개별 설치 파일 수동 설치·문제 해결용 — 보통은 위 설치 파일 하나로 충분합니다

수집 확장 v0.6.2

확장 폴더(zip). C:\riahn\store-collector 에 풀어 개발자 모드로 불러옵니다.

확장 다운로드 (zip)

Tailscale

Windows 최신 클라이언트. 설치 파일이 무인 모드로 자동 설치·가입합니다.

Tailscale 다운로드 (exe)

RustDesk

Windows 최신 클라이언트. 설치 파일이 서비스로 설치하고 본사 원격지원 서버로 설정합니다.

RustDesk 다운로드 (exe)