대장호크 · 스포클립 중앙 관제

경보

서버

전사 집계

재료비 · 마진 · 보관 매장별 이달 사용량 · 재료비 · 마진과 분석 결과물 보관 비용 — 읽기만

호크 설정 전 매장 호크 · CCTV 설정을 한 표로 — 읽기만

호크 관제 매장 행을 클릭하면 호크별 화면이 펼쳐집니다

실시간 감시 중 · 10분 주기 전수 검사 검사 항목: ① 초점 흐림② 색 이상③ 화각 틀어짐④ 줌 변화⑤ 화면 정지⑥ 검음·가림⑦ 밝기 급변⑧ 무신호

앱 시설 셋업 스포클립 앱 원장(체육관·코트·호크·태블릿·미디어·티켓·스케줄) 관리

🧭 새 시설을 여는 중이라면 여기가 아닙니다 — 업주 → + 신규 사이트 추가 «하나»로 끝납니다 — 주소·터널·로그인, 호크 IP·배치, 앱 체육관·코트·호크 등록과 코드 발급까지 그 마법사 안에서 이어집니다(2026-08-19). 전체 순서는 관리 · 설정 → 설치 방법에 있습니다.
이 화면은 이미 있는 앱 원장을 고칠 때 씁니다 — 시설 정보·운영시간 수정, 호크 위치·바라보는 방향·시야각, 미디어 설정, 코트 티켓 가격, 주간 녹화 스케줄(엑셀), 태블릿, 광고주·광고, 그리고 호크가 없는 체육관 관리.

신규 사이트 추가 시설·호크·앱 등록·코드 발급까지 여기서 끝냅니다

업주(사이트) 관제 행 클릭 시 전체화면 상세

30초 자동새로고침

시설	관리자 이메일	회원	이달매출	미납	골드사용	클립	구독	버전	가동	슈퍼바이저	마지막 수신

원격 제어 HAWK 잠금·해제

원격접속(RustDesk) 공통 비번

전 박스 통일

여기서 바꾸면 전 박스가 30초 내 적용합니다. 접속 = 각 업주 상세의 🖥 원격 ID + 이 비번. 유출 시 즉시 여기서 교체하세요. 저장된 비번은 보안상 다시 보이지 않습니다(설정 여부만 표시).

새 PC 접속 설정 — RustDesk ▸ 설정 ▸ 네트워크 ▸ ID/릴레이 서버

ID 서버15.165.67.235

릴레이 서버15.165.67.235

API 서버비워두기 값을 넣으면 접속이 지연됩니다

KeymrPcQ350bMKcajKpu5mXbA6Panna2XCH3+JzMpt++VM=

앱 백엔드 연동

체육관·코트·호크 원장(스포클립 앱)

새 매장은 업주 → + 신규 사이트 추가 하나로 끝납니다(앱 등록·호크 코드까지 그 안에서). 여기는 앱 관리자 계정을 넣거나, 이미 있는 앱 원장(운영시간·스케줄 엑셀·티켓·광고·태블릿)을 고칠 때만 씁니다.

자동 로그인 유지

한 번 로그인하면 이 기간 동안 다시 로그인하지 않아도 됩니다. (다음 로그인부터 적용)

업주(op) 운영 페이지 로그인 유지

업주가 매일 이메일 재로그인하던 불편 해소

운영 페이지(opN)은 클라우드플레어 이메일 인증입니다. 이 기간 동안은 기기별로 한 번만 로그인하면 됩니다. 저장 시 기존 업주 앱에 즉시 반영되고, 이 값이 박스 앱 로그인 유지 기간까지 전 지점 공통으로 일원 관리됩니다(로그인 유지는 이 한 곳에서만 설정).

업주 구글 로그인

이메일 코드 대신 '구글로 로그인' 원클릭(선택)

Google Cloud에서 OAuth 클라이언트를 발급해 넣으면, 업주 로그인 화면에 '구글로 로그인'이 추가됩니다(이메일 코드도 계속 사용 가능). ① Google Cloud Console → API 및 서비스 → 사용자 인증 정보 → OAuth 클라이언트 ID(웹) 생성 ② 아래 '승인 리디렉션 URI'를 그 클라이언트에 등록 ③ 발급된 클라이언트 ID/보안 비밀을 아래에 붙여넣고 연동.

승인 리디렉션 URI (구글 OAuth 클라이언트에 등록):
불러오는 중…

클라이언트 ID

클라이언트 보안 비밀

마스터 이메일

이 이메일로 구글 로그인하면 전 매장이 보이고, 로그인 후 «들어갈 매장»을 고릅니다(업주는 자기 매장으로 바로 입장)

개발팀·본사 인원을 여기에 넣으면 됩니다. 기본 마스터(설정 파일 boss_config.json)는 자물쇠 표시이고 화면에서 지울 수 없습니다 — 지우면 본인이 콘솔에서 잠기기 때문입니다.

불러오는 중…

통합 운영 주소 (op.spoclipai.com)

매장 번호 없이 주소 하나 + 구글 로그인. 끄면 즉시 옛 opN 주소로 복귀

여기는 주소·게이트만 다룹니다. 매장 관리자 이메일은 각 시설 안에서 설정합니다(대표 2026-08-28) — 업주 목록의 「관리자 이메일」 칸에서 한눈에 보이고, 시설을 열어 🔑 업주 로그인 → 변경에서 바꿉니다. 단일 소스는 그대로 D1 owner_login 입니다. 구글 웹 클라이언트(id/secret)는 boss_config.json에 넣고 워커를 재배포해야 합니다.

불러오는 중…

허용 이메일 표는 업주 목록으로 옮겼습니다 — 매장마다 한 줄로 보이고, 시설 상세에서 바꿉니다.

설치 방법 대장호크 4 · 새 PC 3 · 현장 4

새 PC 에는 설치 파일 하나와 설정 파일 2개만 넣습니다. IP·DNS·업데이트·킵 게이트웨이는 박스가 스스로 합니다.

⬇

새 매장 설치 파일

현재 발행본 확인 중…

1 대장호크에서 — 준비물 (4가지 · 설정 파일을 손으로 고치거나 따로 배포하는 단계는 없습니다)

1

사이트 만들기 — 왼쪽 업주 → + 신규 사이트 추가

사이트 주소(영문 · 예 topyeong → 홍보 주소 topyeong.spoclipai.com)와 시설·코트·호크를 넣고 🚀 생성. 주소·터널·업주 구글 로그인·박스 신원이 만들어지고 앱 등록(②)까지 이어서 합니다.

운영 주소는 op.spoclipai.com 하나입니다 — 업주는 등록한 구글 계정으로 들어갑니다(매장 번호 없음).

2

🏟 앱 등록 — 체육관·코트·호크 코드

①의 마법사가 같이 합니다. 건너뛰었거나 코드가 덜 붙었으면 업주 상세 셋업 탭 → 🏟 앱 등록에서 마저 채웁니다.

3

🔗 서버 연결 — 업주 상세 셋업 탭 → 「🔗 서버 연결 · 박스 키」

연결하고 박스 키 코드 받기를 누릅니다. 코드는 그 화면에서 한 번만 보이고 72시간 안에 박스가 받아 가야 합니다 — 설치하는 날 누르세요.

4

📦 박스 설정 파일 2개 받기 — ③ 바로 아래

③을 누른 그 화면에서 이어서 「📦 박스 설정 파일」 → secrets.yaml·tunnel_token.txt 받기. (화면을 새로고침하면 ③의 코드가 사라집니다 — 그때는 ③부터 다시)

2 새 PC 에서 (3가지)

5

설치 파일 받아 압축 풀기

맨 위 「새 매장 설치 파일」을 받아 풉니다 — spoclip-box.exe 가 들어 있는 폴더가 나옵니다.

6

그 폴더에 파일 2개 넣기

④에서 받은 secrets.yaml·tunnel_token.txt 를 spoclip-box.exe 옆에 둡니다.

7

설치 — install.bat 더블클릭 ("관리자 권한?" → 예)

그 폴더의 mgmt\install.bat 입니다. 또는 그 폴더에서 연 관리자 PowerShell 한 줄:
powershell -NoProfile -ExecutionPolicy Bypass -File .\mgmt\install-appliance.ps1

나머지는 자동입니다 — 매장 번호 인식·설치·자동시작·10분마다 업데이트·DNS 표준·터널.

3 현장에서 (4가지)

8

꽂고 켜기

랜선·전원만 연결. IP·DNS는 박스가 스스로 잡습니다 — 손으로 넣지 마세요.

9

호크 IP 넣기 — 박스 화면 /setup

박스 PC 브라우저에서 http://127.0.0.1:8710/setup 을 열어 호크 IP와 RTSP 계정·비번을 넣고 저장 → 30초 안에 영상이 뜹니다. 호크 자리 · 바라보는 쪽은 이 대장호크 셋업 탭 코트 그림에서 끌어다 놓으세요 — 박스가 받아 OP · 리플레이에 그립니다. (호크 IP 는 박스가 정본 · 자리 · 방향 · 화각은 대장호크가 정본)

10

앱에 등록 — 셋업 탭 「🔗 앱에서 코드 받기」

처음이면 아래 「🏟 앱 체육관·코트 연결」에서 체육관·코트를 한 번 고르고, 그다음부터는 버튼 하나입니다. 짐·코트·호크 코드가 채워지면 저장 → 앱 업로드가 스스로 켜집니다.

⚠ 이미 앱에 있는 호크는 «시리얼»로 알아봅니다 — 시리얼을 먼저 넣으세요. 안 넣으면 같은 호크가 두 개로 등록됩니다.

11

킵 게이트웨이 — 전원만 꽂으면 끝

전원·랜선만 연결하세요. 호크 IP를 저장하는 순간 박스가 스스로 찾아 설정합니다.

✅ 다 됐는지 4가지 — ①셋업 탭에 빨간 경고 없음 ②업주 목록에서 「방금」 + 최신 버전 ③킵을 눌러 클립이 생기면 완료 ④op.spoclipai.com 으로 그 매장에 들어가진다 (2.0.8 부터는 이때 박스의 PIN·아이디 로그인이 스스로 닫힙니다).
첫 설치면 「구독 정지」 안내창이 뜨는 게 정상입니다 — 그 창에서 카드 등록(무료 1개월 0원)하면 열립니다.

🆘 안 될 때 · 현장 IP 규칙 · 업데이트

영상이 안 뜬다 → 호크 IP·RTSP 계정부터 확인.

대장호크에 안 올라온다 → 그 호크 PC에서 실행하고 마지막 줄을 보세요. 「표준 네트워크 OK」면 정상, 아니면 관리자 PowerShell에서 -Apply를 붙여 다시.
cd C:\spoclip; powershell -NoProfile -ExecutionPolicy Bypass -File tools\net-standard.ps1 -SiteId hawkN

킵이 안 들어온다 → 그 호크 PC에서 한 줄(게이트웨이 2대여도 전부 잡습니다).
cd C:\spoclip; curl.exe -s -X POST http://127.0.0.1:8710/keep/gwfix

현장 IP 규칙 — ①호크는 고정 IP(DHCP 풀 밖) ②호크 PC도 고정 또는 DHCP 예약 ③호크·PC·게이트웨이는 같은 대역
④ DNS에 공유기 주소를 넣지 마세요 — 공유기가 DNS를 안 하면 호크·화면은 멀쩡한데 보고만 조용히 끊깁니다(2026-08-05 실사고, 5시간 40분).

업데이트 — 개발 PC에서 tools\publish-all.ps1 한 번이면 전 박스가 10분 내 자동 교체(실패 시 자동 롤백). 설정·녹화·CRM 데이터는 보존됩니다.

원격접속(RustDesk) 공통 비번

앱 백엔드 연동

자동 로그인 유지

업주(op) 운영 페이지 로그인 유지

업주 구글 로그인

마스터 이메일

통합 운영 주소 (op.spoclipai.com)

업주 CS 연락처

화면 테마

자동 새로고침

관제 정보