이 가이드는 산업의 개념을 플랫폼에 현재 있는 객체(부케, 라인, 패키지, 파트너 계정, 노드, API)에 대응시킵니다. 이는 개념적 대응이며 산업 전용 기능이 아닙니다. 또한 파트너 계정은 위임 계정이며 격리된 테넌트가 아닙니다.
개념적 대응
패널에는 매장이나 가맹점주라는 이름의 항목이 없습니다. 표는 어떤 객체가 어떤 역할을 하는지 보여주며, 아래 장들은 그 순서대로 설정합니다.
| 내 산업에서는 | 플랫폼에서는 | 패널에서의 위치 |
|---|---|---|
| 매장 채널 또는 교육 컬렉션 | 부케: 패키지가 부여하는 채널, 영화, 시리즈의 이름 있는 묶음 | Bouquets, Streams와 Movies / Series에서 생성 |
| 매장 채널 | 실시간 채널: 소스, EPG, 출력 형식을 가진 스트림 | Streams → 실시간 스트림 추가(소스 URL 또는 RTMP 푸시) |
| 교육·제품 영상 | VOD 카탈로그: 시즌과 에피소드가 있는 영화와 시리즈, 카테고리, 메타데이터 | Movies와 Series, 또는 VOD 인제스트 작업 |
| 매장 스크린 또는 직원 액세스 | 라인: 패키지, 부케, 만료일, 연결 제한, 출력을 가진 하나의 액세스 | Lines → 추가, 또는 활성화 코드, 또는 Reseller API |
| 가맹점주 계정 | 파트너 계정(리셀러): 크레딧, 권한, 자체 라인을 가진 위임 대시보드 | Users → 리셀러 추가, 권한은 Groups에서 설정 |
| 지역 노드 | 스트리밍 노드: 패널에서 등록하는 엣지 서버. 현장 또는 건물당 하나 | Servers → 노드 추가(SSH로 설치) |
| 라인당 스크린 또는 기기 수 | 라인의 최대 연결 수: 동시에 시청할 수 있는 기기 수 | 라인의 최대 연결 수 |
사전 준비
설치 전에 준비할 것.
- 본사 서버(Ubuntu 22.04 또는 24.04), 설치 프로그램, 매장이 많고 각 매장에서 접속할 수 있는 지역별 서버.
- 매장 채널 콘텐츠(인코더 또는 반복 소스), 온보딩과 제품 교육 녹화본, 매장의 스크린 또는 미디어 플레이어.
- 프랜차이즈 구조에 대한 결정. 어느 지역에 노드를 둘지, 각 가맹점주에서 누가 라인을 관리할지.
인프라 구축
먼저 본사, 그다음 지역.
- 본사 서버에서 설치 프로그램을 실행하고 재생 기본 주소를 TLS가 적용된, 매장에서 접속할 수 있는 주소로 설정합니다.
- 매장 채널을 Streams에, 교육 녹화본을 Movies에 추가하고 웹 플레이어에서 확인합니다.
- Servers에서 지역마다 노드를 등록합니다. 패널이 SSH로 설치하거나 노드가 일회용 코드로 등록하며, 그 지역의 매장을 노드로 보냅니다.
- 본사 콘텐츠 팀용으로 카탈로그 권한은 있고 매장 라인 권한은 없는 파트너 계정을 만듭니다.
콘텐츠 정리
매장 채널과 교육 라이브러리.
- 매장 채널용 실시간 스트림을 만들고 전용 부케에 넣습니다.
- 주제별 카테고리와 교육 과정마다 시리즈 하나(수업마다 에피소드 하나)를 만들고, 직무(영업 직원, 매니저, 신입)마다 부케를 하나씩 추가합니다.
- 매장 스크린용 패키지 하나와 직무별 패키지를 만들고, 각각 부케를 부여하며 이용 기간을 기간으로 설정합니다.
- 가맹점주가 자기 매장과 직원에게 재판매할 수 있는 패키지를 부여합니다.
파트너(리셀러) 설정
가맹점주마다 파트너 계정 하나.
- 라인으로 권한을 제한하고 카탈로그는 변경할 수 없는 그룹을 만듭니다.
- Users → 리셀러 추가에서 각 가맹점주를 그 그룹, 패키지, 크레딧 잔액과 함께 추가합니다.
- 여러 지역을 가진 가맹점주는 지역마다 서브 리셀러를 추가할 수 있으며, 각각 자기 매장을 가집니다.
매장·직원 라인 설정
스크린마다, 직원마다 라인 하나.
- Lines → 추가에서 매장 스크린마다 매장 이름과 매장 패키지로 라인 하나를 만듭니다. 가맹점주도 자기 매장에 대해 같은 방식으로 합니다.
- 최대 연결 수를 매장의 스크린 수로, 직원은 2(매장과 휴대폰)로 설정합니다.
- 매장에 고정 주소가 있다면 매장 라인을 그 주소에 묶어, 자격 증명이 다른 곳에서 작동하지 않게 합니다.
- 스크린의 플레이어를 한 번만 설정하고(M3U, Xtream Codes API 또는 웹 플레이어 주소) 자격 증명은 매장의 파일에 보관합니다.
교육·제품 영상
직원용 라이브러리.
- 교육 과정은 시리즈로, 제품 영상은 영화로 업로드하거나 VOD 인제스트 작업으로 미디어 루트에 인제스트합니다.
- 녹화본을 카테고리를 통해 알맞은 직무의 부케에 넣습니다.
- 라이브러리를 가맹점주에게 공개하기 전에 테스트 라인으로 각 직무에 무엇이 보이는지 확인합니다.
매장 채널
모든 스크린을 위한 채널 하나.
- 매장 채널을 본사 인코더의 RTMP 또는 반복 소스가 공급하는 실시간 스트림으로 추가합니다.
- 실시간로 진행하는 교육 세션에는 캐치업을 활성화하고, 끝난 뒤 녹화본을 라이브러리에 업로드합니다.
- 지역의 노드가 채널을 오리진에서 한 번만 받아 매장에 전송하므로 매장의 회선이 포화되지 않습니다.
만료와 갱신
액세스는 매장 또는 계약을 따릅니다.
- 라인은 패키지 기간이 끝나면 만료됩니다. 가맹점주가 패키지 또는 크레딧으로 갱신합니다.
- 폐점한 매장이나 퇴사하는 직원의 라인은 비활성화합니다.
- 프랜차이즈 관리 또는 HR 시스템을 웹훅에 등록해 만료가 임박했거나 이미 만료된 라인을 확인합니다.
프랜차이즈·HR 시스템과의 연동
시스템이 라인을 제어하고 플레이어가 재생합니다.
- 프랜차이즈 관리 또는 HR 시스템용 Reseller API 키를 만듭니다. 이 시스템이 create_line, renew_line, enable_line, disable_line을 호출하며 쓰기마다 요청 ID를 붙입니다.
- 가맹점주에게 서비스를 청구한다면 커머스 커넥터를 사용합니다. 다른 시스템은 Reseller API와 웹훅을 사용합니다.
- 시청자용 싱글 사인온은 없습니다. 직원은 자신의 라인 자격 증명으로 플레이어에 로그인합니다.
보안 고려 사항
각 매장을 자기 라인에 둡니다.
- 패널은 TLS가 적용된 리버스 프록시 뒤에서 제공하고 TRUSTED_PROXIES를 설정해 감사 로그와 IP 규칙이 실제 주소를 보게 합니다.
- 본사의 모든 계정에 2단계 로그인을 적용하고, 가맹점주에게는 자기 라인으로 제한된 권한 그룹을 부여합니다.
- 라인별 연결 제한, 서명되고 만료되는 재생 링크, 매장 스크린의 주소 고정.
- 오프사이트 사본이 있는 암호화된 데이터베이스 백업을 켜고, 감사 로그로 라인과 카탈로그의 변경을 검토합니다.
문제 해결
가장 먼저 확인할 일반적인 항목.
- 매장 스크린이 검게 나옴: 라인이 활성 상태이고 만료되지 않았는지, 주소 고정, 두 번째 기기가 라인을 쓰고 있다면 연결 제한을 확인합니다.
- 한 지역에서 버퍼링: 지역 노드의 하트비트와 매장이 그 노드로 연결되는지 확인합니다.
- 가맹점주가 라인을 만들지 못함: 크레딧 잔액, 그룹 권한, 배정된 패키지를 확인합니다.
- 감사 로그에 프록시의 주소가 표시됨: TRUSTED_PROXIES를 그 프록시로 설정하고 패널을 재시작합니다.