Skip to main content

페이퍼

본 문서는 앤트포켓의 페이퍼(paper) 기능을 안내합니다.

페이퍼는 스페이스의 제품 현황을 별도의 공유 가능한 웹페이지(URL)로 발행하는 도구입니다.

관련 메뉴 경로

1. 페이퍼를 사용하는 목적​

앤트포켓 앱 내부에서 제품 현황을 보려면 로그인 후 스페이스에 들어와야 합니다. 하지만 다음과 같은 경우 그 절차가 번거롭거나 불가능합니다.

  • 스페이스 외부의 사람과 현재 재고를 공유하고 싶을 때 (거래처, 협력 업체, 외부 영업 담당자 등)
  • 회의실 모니터·태블릿 등 항상 띄워두고 보는 환경에서 한 페이지로 현황을 확인하고 싶을 때
  • 본사·창고 담당자에게 특정 창고의 재고만 노출하고 싶을 때
  • 공유 대상에 따라 비밀번호로 접근을 제한하고 싶을 때

페이퍼는 위 상황을 해결하기 위해 다음과 같이 동작합니다.

  • 각 페이퍼는 고유한 URL({호스트}/papers/{uuid})을 가집니다.
  • 페이퍼는 별도 로그인 없이도 URL만으로 접근할 수 있습니다. (공개 범위 설정에 따라 다름)
  • 페이퍼는 발행한 시점의 데이터가 아니라 현재 시점의 재고 현황을 항상 최신으로 보여줍니다.

페이퍼의 두 가지 유형​

유형표시 내용
모든 제품현황 (item_amount)스페이스에 등록된 모든 제품을, 모든 창고를 가로 컬럼으로 두고 한 표에 표시
창고별 제품현황 (place_item_amount)선택한 특정 창고(여러 개 선택 가능)의 제품 수량만 표시

공개 범위 (Visibility)​

키이름설명
privatePrivate스페이스 멤버만 볼 수 있습니다. (기본값)
publicPublicURL을 아는 누구나 볼 수 있습니다.
protectedProtected스페이스 멤버이거나 비밀번호를 아는 사람만 볼 수 있습니다.

2. 페이퍼 사용 방법​

페이지 경로: 페이퍼 > 내가 만든 페이퍼

페이지에는 본인이 이 스페이스에서 만든 모든 페이퍼가 카드 형태로 나열됩니다.

2.1 페이퍼 생성​

화면 하단의 두 버튼 중 원하는 유형을 선택합니다.

① 모든 제품현황 페이퍼

  1. 모든 제품현황을 볼 수 있는 페이퍼 만들기 버튼을 클릭합니다.
  2. 카드가 즉시 생성되며 기본 공개 범위는 Private 입니다.

② 창고별 제품현황 페이퍼

  1. 특정 창고의 제품현황을 볼 수 있는 페이퍼 만들기 버튼을 클릭합니다.
  2. 창고 선택 다이얼로그에서 표시하고 싶은 창고를 체크박스로 하나 이상 선택합니다.
  3. 확인 을 누르면 페이퍼가 생성됩니다.

페이퍼는 만든 시점의 데이터를 박제하지 않습니다. 항상 현재의 재고관리 재고 현황을 그대로 보여주므로, 입출고/조정/이동이 일어나면 페이퍼에도 즉시 반영됩니다.

2.2 페이퍼 열어보기​

각 페이퍼 카드의 보기 버튼을 누르면 페이퍼 URL이 새 탭으로 열립니다.

  • 페이퍼 URL은 {호스트}/papers/{uuid} 형식입니다.
  • 본인은 스페이스 멤버이므로 어떤 공개 범위의 페이퍼든 항상 볼 수 있습니다.

2.3 공유: URL 복사​

카드의 공유하기: URL 복사 버튼을 누르면 페이퍼 URL이 클립보드에 복사되고 "클립보드에 링크가 복사되었습니다." 스낵바가 표시됩니다.

복사한 URL을 메신저·이메일 등으로 공유하시면 됩니다. 단, 받는 사람이 페이퍼를 볼 수 있는지는 공개 범위 설정에 따라 결정됩니다.

2.4 제목 변경​

  1. 카드 우측 상단의 연필 아이콘을 클릭합니다.
  2. 컨텍스트 메뉴에서 제목변경 을 선택합니다.
  3. 프롬프트 창에 새 제목을 입력하고 확인합니다.

제목을 비워두면 카드에 "제목없음" 으로 표시됩니다. 여러 페이퍼를 만들 예정이라면 용도에 맞게 제목을 지정해 두는 것을 권장합니다.

2.5 조회권한(공개 범위) 설정​

  1. 카드 우측 상단의 연필 아이콘 → 조회권한 설정 을 선택합니다.
  2. 다이얼로그에서 세 가지 옵션 중 하나를 라디오 버튼으로 선택합니다.
    • Private — 스페이스 멤버만 접근 가능
    • Public — URL을 가진 누구나 접근 가능
    • Protected — 스페이스 멤버 또는 비밀번호를 아는 사람만 접근 가능
  3. Protected 를 선택했다면 하단의 비밀번호 입력란이 활성화됩니다. 외부 사용자에게 알려줄 비밀번호를 입력하세요.
  4. 설정하기 를 누르면 적용됩니다.
공개 범위 선택 팁
  • 사내·팀원 위주로만 본다면 Private 으로 두세요.
  • 누구나 보아도 무방한 공개 카탈로그라면 Public 으로 설정하세요.
  • 특정 거래처에만 한시적으로 공유하려면 Protected + 비밀번호 조합을 사용하세요. 비밀번호를 바꾸면 이전 비밀번호로는 더 이상 접근할 수 없습니다.

2.6 페이퍼 삭제​

  1. 카드 우측 상단의 연필 아이콘 → 삭제 를 선택합니다.
  2. "삭제하시겠습니까?" 다이얼로그에서 예 를 누르면 즉시 삭제됩니다.
  3. 삭제된 페이퍼의 URL은 더 이상 유효하지 않습니다. 외부에 이미 공유한 링크는 모두 끊어지므로 신중히 진행하세요.

3. 자주 묻는 질문 (FAQ)​

Q. 페이퍼를 만들면 그 시점의 데이터가 박제되나요?

아닙니다. 페이퍼는 항상 현재 시점의 재고 현황을 보여줍니다. 입출고가 발생하면 페이퍼 화면을 새로 고치는 것만으로 최신 수량이 반영됩니다.

Q. 공개 범위를 Public 으로 두면 우리 회사 모든 데이터가 검색엔진에 노출되나요?

URL을 모르는 사람이 임의로 접근할 가능성은 매우 낮지만, URL을 알게 된 누구나 접근할 수 있다는 점에 유의하세요. 민감한 내부 정보라면 Protected + 비밀번호 또는 Private 사용을 권장합니다.

Q. 제가 만든 페이퍼를 다른 멤버도 관리할 수 있나요?

내가 만든 페이퍼 페이지는 본인이 만든 페이퍼만 보여줍니다. 따라서 제목 변경·공개 범위 변경·삭제는 작성자 본인이 해야 합니다. 페이퍼의 보기(URL 접속) 자체는 공개 범위 설정에 따라 가능합니다.

Q. 페이퍼를 외부 사이트나 위키에 임베드할 수 있나요?

앤트포켓이 제공하는 URL을 그대로 공유하거나, 외부 도구에서 iframe 으로 불러오는 방식이 가장 간단합니다.

부록: 용어 정리​

용어설명
페이퍼(paper)스페이스의 제품 현황을 별도 URL로 발행한 공유용 웹페이지.
모든 제품현황모든 제품·모든 창고를 한 표로 보여주는 페이퍼 유형(item_amount).
창고별 제품현황선택한 창고들만 표시하는 페이퍼 유형(place_item_amount).
Private스페이스 멤버만 접근 가능한 공개 범위.
PublicURL을 아는 누구나 접근 가능한 공개 범위.
Protected스페이스 멤버이거나 비밀번호를 아는 사람만 접근 가능한 공개 범위.
uuid페이퍼마다 부여되는 고유 식별자. URL 경로에 포함됩니다.