Cenaly Hardware Bridge — 매장 하드웨어

브라우저만으로는 POS 프린터로 영수증을 인쇄하거나, 금전 서랍을 열거나, 저울에서 무게를 읽을 수 없습니다. 이 작업을 해결하는 것이 Cenaly Hardware Bridge입니다. 이는 POS 컴퓨터에 설치되어 백그라운드에서 실행되며, 관리자 페이지/POS 페이지와 매장의 로컬 하드웨어를 연결하는 작은 무료 앱입니다.

열기: 관리자 패널 → 하드웨어 (admin.cenaly.com).

연결되는 것#

기기	용도
영수증 프린터 (POS 프린터)	판매 및 반품 영수증, 사전 영수증, X/Z 보고서, 패키지 명세서
주방 프린터	스테이션별 티켓 및 60×40 스티커 — 주방 및 홀 인쇄 참조
금전 서랍	판매 시 및 수동으로 열기
바코드 스캐너	입고, 판매, 마킹
저울	입고 시 상품 무게 및 배식 시 요리 무게
고객 디스플레이	고객에게 금액과 구성을 표시
은행 단말기	카드 결제, 합계 대사 및 일 마감
재정 등록기	국가별 재정 영수증 — 재정화 참조
EGAIS (러시아)	범용 전송 모듈과의 교환
카메라	POS 위험 작업에 대한 짧은 동영상 클립 — 손실 관리 참조

인쇄 대기열#

브리지를 통한 인쇄는 "보내고 기대하는" 방식이 아닙니다. 브리지에는 재시작 후에도 유지되는 재시도 기능이 있는 작업 대기열이 있습니다: 프린터가 꺼져 있거나 용지가 떨어져도 작업이 손실되지 않으며, 기기가 다시 작동하면 인쇄됩니다.

이로 인해 인쇄에는 "성공/실패"가 아닌 다섯 가지 다른 결과가 있습니다: 인쇄됨, 대기열에 접수됨(아직 용지 없음!), 브라우저로 인쇄됨, 재정 POS가 인쇄 중(아래 참조), 인쇄되지 않음. POS 상단에 대기 중인 작업 수가 표시된 대기열 인디케이터가 보입니다.

작업은 멱등성을 가집니다: 동일한 문서를 다시 보내도 두 번째 용지가 출력되지 않습니다.

재정 등록기는 예비 영수증 프린터가 아닙니다. 지점에 별도의 영수증 프린터가 없는 경우, 브리지는 재정 POS를 통해 우리 영수증을 인쇄하지 않습니다: 재정 영수증은 재정 POS가 자체적으로 인쇄하며, 우리 문서는 다른 용지입니다. 이러한 상황에서 POS는 "영수증은 재정 POS가 자체적으로 인쇄합니다"라고 표시합니다. 등록기를 통해서는 테스트 인쇄와 사전 영수증만 허용되며, 이들에는 재정 문서가 아니라는 표시가 인쇄됩니다.

세부 사항, 스테이션에 프린터 연결, 키릴 문자 및 조지아어용 코드 페이지 — 주방 및 홀 인쇄.

브리지 설치#

이 PC에서 브리지를 찾지 못하면 페이지에서 설치를 제안합니다:

사용 중인 OS에 맞는 버전을 다운로드하십시오 — Windows, Linux (x64) 또는 Linux (ARM64) (macOS는 계획 중). 검증용 SHA-256이 표시됩니다.
앱을 실행하십시오. Windows — 더블 클릭: 브리지가 백그라운드로 전환되어(트레이 아이콘) 상태 페이지를 엽니다. Linux — «하드웨어» 페이지의 한 줄 명령(curl … | sudo … bash)으로 백그라운드 서비스로 바로 설치하는 것이 더 안정적입니다. PC 부팅 시 시작되고 자동으로 재시작됩니다. 다운로드한 파일을 직접 실행하는 방법(chmod +x 후 실행)도 작동하지만, 브리지는 터미널이 열려 있는 동안만 유지되고 재부팅 후에는 돌아오지 않습니다. Linux에서는 상태 페이지를 직접 여십시오 — http://127.0.0.1:9100.
상태 페이지에서 브리지가 실행 중인지 확인하십시오. 같은 PC에서 관리자 페이지를 열고 원하는 지점과 «하드웨어» 섹션을 선택하십시오: 브라우저가 자동으로 연결됩니다.
관리자 페이지로 돌아와 «다시 검색» 을 누르십시오 — POS가 이 PC에서 브리지를 자동으로 찾아 연결합니다.

Windows에서 다운로드/실행 시 경고가 표시되면 이는 예상된 동작입니다: «저장»을 선택하고, 실행 시에는 «자세히» → «무조건 실행»을 선택하십시오. Linux용으로는 백그라운드 서비스로 설치하는 한 줄 명령이 있습니다.

컴퓨터에서 브리지를 제거하는 방법 (Linux). «하드웨어» 페이지의 같은 한 줄 명령에 하위 명령을 붙여 사용합니다 — 페이지에서는 «Linux — 브리지 중지 또는 삭제» 아래에 숨겨져 있습니다:

… | sudo bash -s -- stop — 서비스를 중지하고 자동 시작에서 해제합니다. 파일과 설정은 그대로 유지되며, 다시 켜려면 start;
… | sudo bash -s -- uninstall — 서비스를 해제하고 프로그램 자체를 삭제합니다. 설정과 POS 연결은 남아 있으며, 스크립트가 그 위치를 출력합니다;
… | sudo bash -s -- uninstall --purge — 위와 동일하며 설정도 삭제합니다: 하드웨어 목록과 지점 연결. 이후 POS를 다시 연결해야 합니다;
… | sudo bash -s -- status — 브리지가 작동 중인지, 어떤 주소인지 확인합니다(9100이 사용 중이면 브리지는 다음 빈 포트를 사용하며, 9109까지).

Windows에서는 일반 «프로그램 설치 및 제거»(«Cenaly Bridge» 레코드)를 사용합니다 — 제거 프로그램이 자동 시작도 함께 제거합니다.

관리자 페이지를 열지 않는 컴퓨터의 브리지(창고 서버, 프린터 옆 별도 PC)는 자동 검색으로 연결할 수 없습니다 — 자동 연결은 같은 컴퓨터의 브리지와 POS 페이지 사이에서만 작동합니다. 이 경우 소유자가 관리자 페이지에서 일회용 연결 코드(15분간 유효)를 발급하여 브리지 상태 페이지에 입력합니다.

브리지는 귀하의 브랜드에 연결됩니다: 다른 브랜드 도메인에서 다운로드한 브리지는 귀하의 관리자 페이지를 처리하지 않으며, 브리지가 이미 같은 소유자의 다른 지점에 연결되어 있으면 페이지에서 이를 표시하고 버튼 하나로 이곳에 다시 연결할 것을 제안합니다.

세 가지 연결 방법#

연결 대상	수행할 작업
브리지가 있는 PC의 브라우저	«하드웨어»에서 원하는 지점을 여십시오. 로컬 페어가 자동으로 생성됩니다.
다른 PC의 브리지	소유자가 «다른 컴퓨터의 브리지 연결»을 누른 후, 해당 PC에서 «계정 및 지점 → 코드로 연결»에 코드를 입력합니다. 코드는 15분간 유효합니다.
같은 네트워크의 Android 앱	브리지 페이지에서 «Wi-Fi 기기»를 열고 «기기 페어링»을 누릅니다. 앱에 PIN을 입력하고, 단말기 접근 시 지문을 확인합니다. PIN은 10분간 유효합니다.

«기기» 섹션의 직원 로그인 코드는 별개의 메커니즘입니다. PIN 또는 코드가 만료되면 해당 버튼으로 새로 생성하십시오.

관리 및 확인#

브리지가 연결되면 페이지에서 다음을 볼 수 있습니다:

기기 — 각 기기의 상태 목록(연결됨 / 주의 / 오류 / 찾을 수 없음);
하드웨어 점검 — 인쇄, 스캔, 무게의 빠른 테스트;
하드웨어 설정;
활동 — 실시간 이벤트 피드(스캔, 무게, 인쇄);
업데이트 — 새 브리지 버전이 나오면 여기에서 바로 설치할 수 있습니다.

프린터를 추가할 때 용도를 선택하십시오: 영수증용, 주방용 또는 라벨용. 역할은 기기 카드에 표시됩니다. 이는 브리지 내부의 용도를 지정하며, 개별 워크스테이션 간 하드웨어 배분은 다른 수준의 설정입니다. 설정 읽기에 실패하면 마법사가 다시 시도할 것을 제안하고 기존 목록을 저장합니다.

검색된 하드웨어는 비활성화하거나 삭제할 수 있습니다. «비활성화»는 모든 설정과 함께 기기를 목록에 남기지만 드라이버가 로드되지 않습니다: COM 포트가 비고, 폴링이 없으며, 역할은 다른 기기에 넘어갑니다 — 버튼 하나로 다시 켤 수 있습니다. «삭제»(확인 필요)는 기기를 완전히 제거하며, 알려진 하드웨어의 자동 감지가 다음 브리지 시작 시 이를 다시 가져오지 않습니다. 이전에 설정했지만 현재 검색에서 보이지 않는 하드웨어는 별도 그룹으로 표시됩니다 — 그렇지 않으면 관리할 방법이 없기 때문입니다.

계정당 브리지는 여러 개일 수 있으며, 각각 역할이 지정됩니다: 범용, 하드웨어, 카메라 또는 전화 통신. 지점의 브리지는 별도 목록으로 나열됩니다 — 이름을 바꾸고 기본 브리지로 지정할 수 있습니다.

전체 계정의 하드웨어와 클라우드 작업#

«이 컴퓨터»의 브리지 외에도 페이지에는 계정 하드웨어 레지스트리가 있습니다. 이는 네트워크의 모든 지점에 걸친 모든 브리지, 기기, 카메라의 통합 표로, 무엇이 어디에 있는지, 브리지가 온라인인지, 어느 지점의 하드웨어를 담당하는지 확인할 수 있습니다. 브리지가 온라인일 때 기기를 다른 지점으로 옮길 수 있으며, 오프라인 브리지의 경우 레지스트리는 정보를 표시만 하고 변경하지는 않습니다.

레지스트리의 각 컴퓨터마다 «PC 세부 정보» 카드가 펼쳐집니다. 여기에는 컴퓨터 이름, IP와 MAC, 운영체제, 모델, 프로세서, 슬롯별 메모리, 여유 공간과 상태가 표시된 저장 장치, 연결된 모든 하드웨어, 그리고 모든 COM 포트가 포함되며, 어느 포트가 누구에게 점유되었고 어느 포트가 비어 있는지 표시됩니다. «프린터가 있었는데 이제 보이지 않는다»거나 POS PC의 공간이 부족할 때 가장 먼저 확인해야 할 곳입니다. 데이터는 브리지 자체가 수집하며, 구버전 브리지에서는 하드웨어 목록이 비어 있을 수 있는데, 이 경우 브리지를 업데이트하면 됩니다.

로컬 채널(브라우저 ↔ 이 PC의 브리지) 외에도 클라우드 채널이 있습니다. 명령이 서버를 통해 브리지로 전달되므로 다른 기기에서 영수증을 인쇄하거나 프린터를 확인할 수 있습니다. 예를 들어 홀 직원이 자신의 휴대폰으로 카운터의 POS 프린터에서 인쇄하는 경우입니다. 페이지에서는 브리지의 «클라우드 연결»과 별도의 클라우드 테스트 인쇄 버튼으로 확인할 수 있습니다.

옆 컴퓨터의 프린터로 인쇄하기. 프린터가 물리적으로 다른 PC에 연결되어 있다면 네트워크로 «공유»하거나 케이블을 끌 필요가 없습니다. 레지스트리의 «다른 PC에서 인쇄» 기능은 이 컴퓨터에 다른 프린터에 대한 참조를 생성합니다. 소유 컴퓨터, 지점, 이름을 선택하면 해당 행이 «클라우드 → 소유 PC»로 표시되고, 작업은 그 컴퓨터의 대기열로 인쇄됩니다. 공유 폴더, VPN, 컴퓨터 간 직접 연결이 필요 없으며, 두 브리지가 같은 지점을 담당하면 충분합니다.

POS 원격 화면. 같은 페이지에서(또는 업무 채팅의 초대를 통해) POS 컴퓨터의 화면을 볼 수 있습니다. 예를 들어 POS에 무엇이 표시되는지 직접 확인하기 위해서입니다. 결정권은 항상 상대방에게 있습니다. 상대방 소유자가 자신의 원격 접속을 켜지 않으면 연결 버튼이 없고, 각 세션마다 별도의 동의가 필요하며, «다시 묻지 않기»는 의도적으로 없습니다. 보기와 제어는 서로 다른 두 가지 권한이며, 창을 닫으면 세션이 확실히 종료됩니다.

자주 묻는 질문#

연결 코드를 입력해야 하나요?#

보통은 아닙니다. 브리지는 POS를 여는 같은 PC에서 실행되며, «다시 검색» 버튼으로 POS가 브리지를 자동으로 찾습니다. 코드는 관리자 페이지를 열지 않는 컴퓨터의 브리지에만 필요합니다. 이 경우 소유자가 일회용 코드를 발급하여 브리지 페이지에 입력합니다.

브리지는 어떤 OS에서 작동하나요?#

Windows와 Linux(x64 및 ARM64)입니다. macOS 버전은 계획 중입니다.

하드웨어가 보이지 않습니다. 무엇을 확인해야 하나요?#

브리지가 실행 중인지(상태 페이지) 확인하고 «다시 검색»을 누릅니다. 각 기기의 상태와 빠른 점검은 «하드웨어» 페이지에서 확인할 수 있습니다. 기기가 나타나지 않으면 하드웨어 레지스트리에서 해당 컴퓨터의 «PC 세부 정보» 카드를 여십시오. 여기에는 컴퓨터 자체가 인식하는 모든 하드웨어와, 어느 포트가 누구에게 점유되었는지 표시된 모든 COM 포트가 보이며, 이 정보만으로도 문제가 케이블, 포트, 또는 포트를 점유한 다른 프로그램에 있는지 파악하는 데 보통 충분합니다.