HandyCafe Docs
owner

재고

재고 페이지는 카페의 상품 및 자재 구매를 기록합니다. 거래처로부터 상품을 입고할 때마다(캔 음료, 과자 박스, 청소 용품 등 모든 품목) 재고 시스템에 구매 내역을 기록합니다. 이를 통해 구매 품목, 지불 금액, 공급처에 대한 영구적인 기록이 생성됩니다.

재고 항목 필드

각 재고 항목은 구매의 개별 품목을 나타냅니다.

필드 설명
invoice_no 거래처의 송장 또는 영수증 번호입니다. 같은 배송에 포함된 여러 재고 항목이 동일한 송장 번호를 공유할 수 있습니다.
supplier_name 거래처 또는 공급업체의 이름입니다. 거래처 페이지의 거래처 레코드와 연결할 수 있는 텍스트 필드입니다.
name 구매한 품목의 이름 또는 설명입니다(예: "콜라 330ml", "샌드위치 빵", "종이컵").
unit 수량의 측정 단위입니다(예: "개", "kg", "리터", "박스", "케이스").
quantity 구매한 단위 수입니다. 소수 수량을 지원하는 소수점 필드입니다(예: 2.5 kg).
unit_price 최소 통화 단위(예: 센트)로 표시된 단가입니다. 이 항목의 총 비용은 quantity * unit_price입니다.
currency 구매 통화입니다. 시스템 통화가 기본값입니다.
category 그룹화를 위한 선택적 카테고리 라벨입니다(예: "음료", "식품", "청소용품", "장비").
notes 로트 번호, 브랜드명, 품질 메모, 유통기한 등 추가 정보를 위한 자유 텍스트 필드입니다.

거래처 연결

재고 항목의 supplier_name 필드는 거래처 페이지의 거래처 레코드에 대응합니다. 이 필드는 텍스트 입력(엄격한 외래 키가 아님)이지만, 입력 시 기존 거래처 이름을 제안하여 일관성을 유지하도록 합니다.

재고 항목 전체에서 거래처 이름을 일관되게 유지하면 나중에 거래처별 구매 내역을 필터링하고 각 공급업체와의 지출 패턴을 파악할 수 있습니다.

새 구매 기록

새 재고 구매를 기록하려면 다음을 수행합니다.

  1. 사이드바에서 재고 페이지로 이동합니다.
  2. 도구 모음에서 항목 추가 버튼을 클릭합니다.
  3. 거래처 영수증의 송장 번호를 입력합니다. 같은 송장에서 여러 품목을 기록하는 경우 각 항목에 동일한 송장 번호를 사용합니다.
  4. 거래처 이름을 선택하거나 입력합니다. 입력 시 기존 거래처가 자동으로 제안됩니다.
  5. 품목 이름, 단위, 수량, 단가를 입력합니다.
  6. 선택적으로 카테고리를 설정하고 메모(로트 번호, 브랜드, 품질 관찰 사항)를 추가합니다.
  7. 항목을 저장합니다.

시스템은 생성 타임스탬프와 함께 항목을 기록합니다. 구매한 품목이 상품 카탈로그의 상품과 일치하는 경우 재고 로그 시스템을 통해 해당 상품의 재고 수준을 업데이트할 수 있습니다.

재고 내역 조회

재고 페이지는 모든 구매 기록을 시간순(최신 순)으로 표시합니다. 다음 기능을 사용할 수 있습니다.

  • 검색: 품목 이름, 거래처 이름 또는 송장 번호로 검색합니다.
  • 카테고리별 필터: 특정 카테고리의 구매 내역만 표시합니다(예: 모든 음료 구매).
  • 기간별 필터: 특정 기간 내의 구매 내역을 조회합니다.
  • 거래처별 필터: 특정 공급업체의 모든 구매 내역을 확인합니다.

재고와 상품 재고 연동

카탈로그의 상품과 일치하는 품목의 재고 구매를 기록하면 시스템은 해당 상품에 reason = 'purchase'인 재고 로그 항목을 생성할 수 있습니다. 이를 통해 상품의 in_stock 값이 구매 수량만큼 증가하고, 추적을 위해 재고 로그 항목이 재고 레코드에 다시 연결됩니다.

이 연동을 통해 재고 페이지에서 입고를 기록하면 주문 인터페이스에서 캐셔에게 표시되는 상품 재고 수준이 자동으로 업데이트됩니다.

메모 필드 활용

재고 항목의 메모 필드는 유연한 주석 영역으로 활용됩니다. 일반적인 용도는 다음과 같습니다.

  • 로트 또는 배치 번호: 추적을 위해 제조사의 로트 번호를 기록합니다. 특히 식품에 유용합니다.
  • 브랜드 정보: 품목 이름이 일반적인 경우 특정 브랜드를 기록합니다(예: "콜라"가 구매 시기에 따라 다른 브랜드일 수 있음).
  • 품질 관찰: 입고 시 발견된 문제를 표시합니다(예: "캔 2개 찌그러짐", "유통기한 임박").
  • 유통기한: 유통기한이 있는 상품의 유효 일자를 기록합니다.