상품

상품 카탈로그는 인터넷 카페 또는 게이밍 센터에서 판매하는 품목을 나열합니다. 여기에는 음식, 음료, 스낵, 액세서리 및 고객에게 제공하는 모든 물리적 상품이 포함됩니다. 각 상품에는 가격, 카테고리, 세율, 재고 수준이 정의되어 있습니다. 상품은 주문 시스템과 통합되어 캐셔가 주문을 생성하고, 판매를 추적하고, 재고를 관리할 수 있습니다.

상품은 메인 내비게이션의 재고 페이지에 있는 제품 탭에서 관리합니다. 이 탭은 표 보기와 그리드 보기를 제공합니다. 그리드 카드에는 상품 사진, 가격, 그리고 재고 있음 또는 재고 없음 배지가 표시됩니다.

상품 필드

각 상품 레코드에는 다음 정보가 포함됩니다.

필드	설명
`name`	주문 인터페이스에 표시되는 상품 이름입니다. 고유해야 합니다(대소문자 구분 없음).
`category`	관련 상품을 그룹화하는 텍스트 라벨입니다(예: "음료", "스낵", "액세서리"). 필터링 및 보고에 사용됩니다.
`unit`	재고 추적을 위한 측정 단위입니다(예: "개", "kg", "리터", "캔", "병").
`barcode`	스캐너 연동을 위한 선택적 바코드 값입니다. 캐셔가 상품 바코드를 스캔하여 주문에 빠르게 추가할 수 있습니다.
`sale_price`	최소 통화 단위(예: 센트)의 판매 가격입니다. 단위당 고객에게 청구되는 금액입니다.
`vat_rate`	이 상품에 적용되는 부가세(부가가치세) 퍼센트입니다(예: 18%의 경우 18). 각 판매의 세금 구성 요소를 계산하는 데 사용됩니다.
`stock`	소수점 수량으로 표시되는 현재 재고 수준입니다. 주문이 접수되고 입고가 기록될 때 자동으로 업데이트됩니다. 재고는 상품 자체에서 편집하지 않습니다. 재고 페이지의 재고 상태 탭을 사용하세요.
`min_stock`	재주문 임계값입니다. 재고 수준이 이 값에 도달하거나 그 이하로 내려가면 재고 상태 탭에서 상품이 중요 항목으로 표시됩니다. 0은 임계값이 없음을 의미합니다.
`description`	추가 상품 상세 정보를 위한 선택적 텍스트 설명입니다.
`photo`	그리드 보기와 카페테리아 메뉴에 표시되는 선택적 상품 사진입니다.

판매에서 상품 제거

더 이상 제공하지 않을 상품은 제품 탭의 판매에서 제거 작업으로 제거합니다. 확인 창은 이 작업이 카탈로그에서 상품을 삭제하며 되돌릴 수 없음을 안내합니다. 해당 상품이 포함된 과거 주문은 항목 스냅샷을 유지하므로 과거 판매 데이터가 보존됩니다.

재고 추적

HandyCafe는 모든 상품의 재고 수량을 실시간으로 유지합니다. 이 값은 다음에 따라 시스템에서 자동으로 업데이트됩니다.

판매: 주문을 통해 상품이 판매되면 주문된 수량만큼 재고가 감소합니다.
입고: 새 재고가 입고되어 재고 페이지의 입고 탭에 기록되면 그에 따라 재고가 증가합니다.
수동 조정: 재고 상태 탭의 재고 수정, 폐기, 수량 확인 작업으로 파손, 손상, 재고 불일치 등을 반영합니다.

재고는 상품 편집기에서 편집할 수 없습니다. 모든 재고 변경은 재고 상태 탭을 거치므로 모든 변경이 이동 기록에 남습니다.

상품 재고 로그

상품 재고 수준의 모든 변경은 상품 재고 로그에 기록되어 완전한 감사 추적이 생성됩니다.

사유	설명
`sale`	고객 주문으로 인한 재고 감소입니다. 특정 주문 레코드에 연결됩니다.
`purchase`	재고 구매로 인한 재고 증가입니다. 특정 재고 항목에 연결됩니다.
`adjustment`	캐셔 또는 관리자에 의한 수동 재고 조정입니다.
`waste`	파손, 손상 또는 폐기로 인한 재고 감소입니다.
`return`	고객 반품 또는 주문 취소로 인한 재고 증가입니다.

각 로그 항목에는 수량 변동(증가는 양수, 감소는 음수), 변동 후 새 재고 수준, 변경한 사람, 사유를 설명하는 선택적 메모가 기록됩니다.

상품 카테고리

상품은 자유 텍스트 필드를 사용하여 카테고리별로 그룹화됩니다. 일반적인 카테고리는 다음과 같습니다.

음료 (탄산음료, 물, 에너지 드링크)
핫 드링크 (커피, 차, 핫초코)
스낵 (감자칩, 사탕, 초콜릿 바)
식품 (샌드위치, 랩, 핫밀)
액세서리 (헤드셋, USB 드라이브, 마우스 패드)

카테고리는 주문 인터페이스에서 필터링에 사용됩니다. 캐셔가 카테고리 간에 빠르게 전환하여 적절한 상품을 찾을 수 있습니다. 카테고리는 판매 보고서에서의 그룹화에도 사용됩니다.

별도의 카테고리 관리 인터페이스는 없습니다. 카테고리는 상품에 카테고리 이름을 지정할 때 암시적으로 생성됩니다. 카테고리 이름을 변경하려면 기존 이름을 사용하는 모든 상품의 카테고리 필드를 업데이트합니다.

상품 생성

카탈로그에 새 상품을 추가하려면 다음을 수행합니다.

사이드바에서 재고 페이지를 열고 제품 탭으로 전환합니다.
새로운 제품 버튼을 클릭합니다.
이름(고유해야 함)을 입력합니다.
카테고리를 선택하거나 입력합니다.
측정 단위를 선택합니다.
판매 가격(고객에게 청구되는 금액)을 설정합니다.
부가세율을 설정합니다.
스캐너 지원을 위해 선택적으로 바코드를 입력하고 사진을 추가합니다.
저장을 클릭합니다.

초기 재고는 여기에서 설정하지 않습니다. 개시 수량은 입고로 기록하거나 재고 상태 탭의 수량 확인 작업으로 기록하세요. 배송에 카탈로그에 아직 없는 품목이 포함된 경우 영수증 줄에서 바로 상품을 생성할 수도 있습니다.

상품 편집

목록에서 상품을 선택하면 편집기가 열립니다. 이름, 가격, 카테고리, 부가세율, 바코드, 사진 등 모든 필드를 업데이트할 수 있습니다. 변경 사항은 즉시 적용됩니다. 가격을 업데이트하면 새 가격이 이후의 모든 주문에 적용됩니다. 판매에서 제거 작업은 확인 후 카탈로그에서 상품을 삭제합니다.

과거 주문은 가격 변경의 영향을 받지 않습니다. 각 주문 항목은 판매 시점의 unit_price를 스냅샷으로 저장합니다.

주문과의 연동

캐셔가 주문을 생성하고 상품을 추가하면 다음이 수행됩니다.

상품의 현재 판매 가격과 부가세율이 주문 항목에 스냅샷으로 복사됩니다.
행 합계가 단가 * 수량으로 계산됩니다.
주문이 완료되면 상품의 재고 수준이 주문된 수량만큼 감소합니다.
주문에 연결된 reason = 'sale'인 재고 로그 항목이 생성됩니다.

주문이 나중에 취소되거나 환불되면 반품 재고 로그 항목을 통해 재고를 복원할 수 있습니다.