재고 현황과 카탈로그 관리
/stock 영역은 현재 재고와 기준 정보를 함께 관리하는 운영 허브입니다. AnyVet Smart에서는 단순 수량 조회만 하는 구조가 아니라, Stock, Items, Services, Supplier, Brand, Category를 같은 재고 메뉴군 안에서 연결합니다.
이 문서가 다루는 범위
- 재고 대시보드에서 위험 재고를 빠르게 찾는 방법
- lot 단위 재고를 수정하거나 조정/출고로 넘기는 방법
- 품목, 서비스, 공급처, 브랜드, 카테고리 기준 정보를 언제 어디서 관리하는지
- 수입/내보내기 전 확인해야 하는 운영 기준
Stock 허브에서 먼저 보는 것
/stock 메인 화면은 운영자가 하루 중 가장 자주 보는 재고 모니터링 화면입니다.
상단 위젯
Expiring Soon: 앞으로 30일 이내 만료 예정인 lot를 모아 보여줍니다.Low Stock: 현재 수량이 재주문 기준(reorderLevel) 아래로 내려간 품목을 보여줍니다.Total Items: 현재 목록에 잡힌 재고 품목 수입니다.Total Value: 남아 있는 수량과 lot 원가를 기준으로 계산한 추정 자산가치입니다.
언제 이 화면을 열어야 하나
- 오전 오픈 전에 당일 위험 재고를 확인할 때
- 조제/처치 전 특정 lot의 잔량과 만료일을 확인할 때
- 발주 필요 여부를 판단할 때
- 재고 오류 제보가 들어왔을 때 근거 화면으로 사용할 때
검색과 필터 운영 방식
Stock 허브 검색바는 단순 키워드 검색보다 카테고리 운용이 중요합니다.
기본 필터
- 품목명 검색
- 카테고리 필터 선택
Show Depleted Lots토글- 정렬 기준 변경
Show Depleted Lots를 켜는 경우
- 이미 소진된 lot까지 포함해 이력을 같이 보고 싶을 때
- 만료/폐기 검토를 위해 0 수량 lot를 확인할 때
- 특정 lot 삭제 전 잔량이 실제 0인지 검증할 때
카테고리 필터를 먼저 쓰는 이유
카테고리 필터는 품목군별 운영 분리를 빠르게 해줍니다. 약품과 샵 품목이 혼재된 병원에서는 검색어보다 카테고리 전환이 더 정확한 경우가 많습니다.
Stock 테이블에서 할 수 있는 작업
Stock 테이블은 lot 기반 운영을 전제로 합니다. 같은 품목이라도 lot가 여러 개면 개별 lot의 수량, 만료일, 배치번호를 따로 다뤄야 합니다.
테이블에서 확인하는 핵심 컬럼
- 카테고리
- 품목명
- lot 수
- 판매가
- 최소 재고
- 상태
- 총 잔량
행 단위로 이어지는 작업
- lot 상세 보기
- lot 정보 수정
- lot 삭제
- 재고 조정(
Adjustment)으로 이동 - 재고 출고(
Withdrawal)로 이동
⚠️ Warning: lot 삭제는 단순 화면 정리가 아니라 재고 근거 자체를 없애는 작업입니다. 실제 운영에서는 오기입 정정이 아닌 경우
Adjustment또는Withdrawal을 먼저 검토하는 편이 안전합니다.
Import / Export를 사용할 때
메인 Stock 화면에는 Export와 Import가 모두 있습니다.
Export가 적합한 상황
- 월말 재고 검토 회의 자료 추출
- 외부 회계/구매 담당자 공유
- 대량 수정 전 백업용 스냅샷 저장
Import 전 점검할 것
- 병원 기준 카테고리와 공급처가 먼저 정리되어 있는지
- lot 추적이 필요한 품목인지
- 기존 품목과 이름/바코드 중복이 없는지
- 대량 입력 대상이 제품인지 서비스인지 구분했는지
Items 서브메뉴: 품목 마스터 관리
/stock/items는 실제 재고로 흘러가는 품목 기준정보를 만드는 화면입니다.
주로 관리하는 정보
- 품목 유형
- 기본명과 병원별 표시명
- 바코드
- 단위와 재고 단위
- POS 사용 여부
- 활성/비활성 상태
- 약품일 경우 경로, 비율, 조제 관련 속성
운영 원칙
- 현장 별칭이 필요해도 원본 품목명은 일관되게 유지합니다.
- 바코드 기반 등록을 쓴다면 중복 검사를 통과한 뒤 저장합니다.
- 재고 품목과 서비스 품목을 혼용하지 않습니다.
Services 서브메뉴: 서비스 카탈로그 관리
/stock/services는 진료, 처치, 검사, 웰니스 같은 비재고성 청구 항목을 관리합니다.
서비스 화면에서 관리하는 것
- 서비스 유형
- 가격
- 수수료/정산 기준
- POS 노출 여부
- 활성/비활성 상태
서비스 문서화가 중요한 이유
서비스가 카탈로그에 정리되어 있어야 OPD Plan, POS, 정산 보고서가 같은 기준을 공유할 수 있습니다. 임의 입력 서비스가 많아질수록 매출 분석과 수익배분 정확도가 떨어집니다.
Supplier, Brand, Category 서브메뉴의 역할
이 세 서브메뉴는 재고 운영의 기반 분류 체계입니다.
Supplier
- 발주 대상 공급처 등록
- 연락처, 세금 정보, 결제 조건 관리
- 공급처별 브랜드 연동
Brand
- 병원에서 취급하는 브랜드 기준 정리
- 공급처와 품목 매핑 기준 유지
Category
- 약품/제품/샵/사료 등 운영 분류 체계 유지
- Stock 메인 카테고리 필터의 기반 데이터 관리
실무 운영 순서 권장안
Category와Brand를 먼저 정리합니다.Supplier를 등록하고 결제 조건을 맞춥니다.Items와Services기준정보를 생성합니다.- 실제 재고는
PO입고 또는 초기 Import로 반영합니다. - 운영 중에는
/stock메인에서 lot 상태를 모니터링합니다.
자주 생기는 운영 실수
- 같은 품목을 이름만 다르게 중복 생성하는 경우
- 서비스를 품목으로 만들거나 품목을 서비스로 만드는 경우
- 재고 부족을
Withdrawal로 처리해야 하는데 lot 삭제로 끝내는 경우 Show Depleted Lots를 끈 상태에서 과거 lot이 사라졌다고 오해하는 경우