5. Paperhub - NeoSmartpen/neolab-data-platform GitHub Wiki

개요

페이퍼허브(Paperhub)는 Ncode™ 및 서식 관련 서비스입니다. 리소스오너는 페이퍼허브를 통해 Ncode™를 구매하고, 해당 Ncode™에 매핑할 서식 정보와 파일을 업로드할 수 있습니다. 또한 애플리케이션에서 서식을 다운로드 받아 사용할 수 있습니다.

서식은 특정 애플리케이션 사용자(회원)에게 종속된 데이터가 아닙니다. 따라서 페이퍼허브는 리소스오너 단위의 서비스로 분류됩니다. 페이퍼허브를 사용하기 위해서는 사용자(회원)의 로그인 없이 클라이언트 아이디와 클라이언트 시크릿만으로 서비스를 이용할 수 있는 서비스 인증서를 발급 받아야 합니다.

리소스오너는 서식을 등록할 때 서식의 공개 범위를 지정할 수 있습니다. 서식을 특정 애플리케이션에서만 사용할 수 있게 제한하거나, 혹은 모든 애플리케이션에서 사용할 수 있도록 공개해둘 수 있습니다.

페이퍼허브의 자세한 스펙은 REST API에서 확인할 수 있습니다.

전체 구조도

용어 · 요소 설명

• Ncode™
  Ncode™는 점 혹은 선으로 이루어진 코드입니다. Ncode™는 서식의 정보와 평면 상의 위치 좌표 값을 포함하고 있습니다. 네오스마트펜은 종이 위에 인쇄된 Ncode™를 인식하고 처리합니다. 자신만의 서식을 등록하고 사용하고 싶은 리소스오너는 코드 번호를 구매한 후, 해당 코드 번호에 서식을 매핑하여 업로드해야 합니다.

• 서식
  네오스마트펜이 인식할 수 있도록 Ncode™가 매핑된 낱장의 종이 양식입니다. 서식은 서식을 식별할 수 있는 Section, Owner, Book Code, Page Number 숫자 조합, 서식의 크기, 제단 좌표 값 등의 정보를 갖고 있습니다. 또한, 서식의 배경 및 미리보기 파일(png, pdf), nproj 파일 등 서식 사용에 필요한 파일을 포함합니다.

• 서식 그룹
  서식 그룹은 여러 장의 서식을 모은 그룹입니다. 기존의 노트와 유사한 개념입니다. 하지만 한 서식 그룹에 Section, Owner, Book Code가 서로 다른 서식도 하나의 그룹이 될 수 있다는 점에서 기존의 노트와 차이가 있습니다. 또한, 한 서식은 여러 서식 그룹에 속할 수 있다는 차이점을 갖습니다.